rtrv-scr-sio

Use this command to show the attributes of one or more nic/si/h0/h1 combinations that are allowed for SS7 messages from another network.

Parameters

actname (optional)

Name of the gateway screening stop action set. Stop actions must be administered using this parameter with the gateway screening stop action table (see chg-gws-actset and rtrv-gws-actset).

Range:

ayyyyy

1 alphabetic character followed by up to 5 alphanumeric characters.

none —Display gateway screening rules that do not have an assigned gateway screening stop action set

all (optional)

Displays all allowed SIO screening references.

Range:

yes
no

Default:

no

h0 (optional)

H0 heading code. A single value or a range of values can be specified.

Range:: 0 - 15, *
* — all possible values from 0–15
Default:: Display all

h1 (optional)

H1 heading code. A single value or a range of values can be specified.

Range:: 0 - 15, *
* —all possible values from 0–15
Default:: Display all

nic (optional)

Network indicator code.

Range:: 0 - 3, *
* — all possible values from 0–3
Default:: Display all

nsfi (optional)

This parameter specifies the next screening category that is used in the gateway screening process, or it indicates that the gateway screening process should stop.

Range:

blkdpc: Blocked DPC is the next screening category.
cgpa: Allowed calling party address is the next screening category.
cdpa: Allowed called party address is the next screening category.
destfld: Allowed destination field (DESTFLD) is the next screening category.
dpc: Allowed DPC is the next screening category.
isup: ISUP message type (ISUP) is the next screening category.
stop: The gateway screening process ends and the message proceeds through normal routing.

Default:

Display all screening references

nsr (optional)

Next screening reference. This parameter indicates which screening reference in the specified screening category (nsfi) is to be used in the screening process.

This parameter is mandatory if nsfi is other than stop; cannot be entered if nsfi=stop.

Range:: ayyy
1 alphabetic character followed by up to 3 alphanumeric characters
Default:: Display all

pri (optional)

Message priority. A single value or a range of values can be specified.

Range:: 0 - 3
* —all possible values from 0–3
Default:: Display all

si (optional)

Service indicator.

Range:: 0 - 15, *
*—all possible values from 0–15
Default:: Display all

sr (optional)

Allowed SIO screening reference name

Range:: ayyy
1 alphabetic character followed by up to 3 alphanumeric characters
Default:: Display all

Example

rtrv-scr-sio

rtrv-scr-sio:sr=iec:nic=1:si=3:pri=2&&3

rtrv-scr-sio:sr=sio1:nic=1:si=1

rtrv-scr-sio:sr=sio1:nic=1:si=1:h0=1:h1=*

rtrv-scr-sio:sr=sio1:si=1:h0=1:h1=1

rtrv-scr-sio:all=yes

rtrv-scr-sio:sr=iec:nic=1:si=1:actname=crncf

Dependencies

If the si parameter is not equal to 00, 01, or 02, the h0 and h1 parameters cannot be specified.

If the nic, si, and h0/h1 parameters are specified, the SIO screening reference must be in the allowed SIO entity set.

The nic parameter must be specified if the si parameter is specified.

The nic and si parameters must be specified if the h0 and h1 parameters are specified.

If an asterisk value is specified for the h0 parameter, the h1 parameter cannot be specified.

If the nsfi=stop parameter is specified, then the nsr parameter cannot be specified.

If the actname parameter is specified, then the nsfi=stop parameter must be specified.

If the nsr parameter is specified, then the actname parameter cannot be specified.

If the actname parameter is specified with the screening reference name parameter, the specified value for the actname parameter must be assigned to that screening reference name.

The value of the actname parameter must be defined in the gateway screening stop action table with the chg-gws-actset command. These values are shown in the ACT NAME field of the rtrv-gws-actset command output.

If the sr parameters are specified, the SIO screening reference must be in the allowed SIO entity set.

The Gateway Screening Stop Action table must be accessible.

Valid nsfi parameter combinations must be specified.

The GWSOA parameter combination should be known and valid.

For SEAS commands, the pri parameter specified must be in the range 0-3, *.

For SEAS commands, the h0 parameter specified must be in the range 0-15, *.

For SEAS commands, the h1 parameter specified must be in the range 0-15, *.

Notes

This command can be canceled using the F9 function key or the canc-cmd command. See canc-cmd for more information.

An asterisk as a parameter value in this command displays only entries that have an asterisk as the same parameter value in the entry.

If no parameters are specified, a list of allowed SIO references is output indicating whether they are referenced or not.

If only the all=yes parameter is specified, detailed information for every rule in every allowed SIO screening table is displayed.

If the all parameter is specified and other parameters are also specified, the all parameter is ignored.

Output

rtrv-scr-sio


    SCREEN = ALLOWED SIO
    SR    REF  RULES
    s     NO      1
    s999  NO      1
    si    NO      1
    si01  NO      1
    si1   NO      1
    sio1  NO      3
    swl1  NO      1
    swl2  NO      1 
;

rtrv-scr-sio:sr=iec:nic=1:si=3:pri=2&&3


    rlghncxa03w 03-03-15 08:36:43 EST  EAGLE 31.3.0
    SCREEN = ALLOWED SIO
    SR    NIC PRI   SI  H0     H1     NSFI    NSR/ACT
    IEC   1   0&&2  3   --     --     BLKDPC  WDB2
    IEC   1   3     3   --     --     DPC     ABC2 
;

rtrv-scr-sio:sr=sio1:nic=1:si=1:h1=1:pri=1:h0=15:nsfi=blkdpc:nsr=bdp1


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED SIO
    SR    NIC  PRI   SI  H0     H1     NSFI    NSR/ACT
    sio1  1    1     1   15     01     BLKDPC  bdp1 
;

rtrv-scr-sio:sr=sio1:h0=1:h1=1


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED SIO
    SR    NIC  PRI   SI  H0     H1     NSFI    NSR/ACT
    sio1  1    1     1   01     *      STOP    -------
    sio1  2    1     1   01     *      STOP    ------- 
;

rtrv-scr-sio:sr=sio1:nic=1:si=1


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED SIO
    SR    NIC  PRI   SI  H0     H1     NSFI    NSR/ACT
    sio1  1    1     1   01     *      STOP    -------
    sio1  1    1     1   02     01     STOP    ------- 
;

rtrv-scr-sio:sr=sio1:nic=1:si=1:h0=1:h1=*


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED SIO
    SR    NIC  PRI   SI  H0     H1     NSFI    NSR/ACT
    sio1  1    1     1   01     *      STOP    ------- 
;

rtrv-scr-sio:sr=iec:nic=1:si=1:actname=crncf


    rlghncxa03w 03-03-19 21:16:37 EST  EAGLE 31.3.0
    SCREEN = ALLOWED SIO
    SR    NIC  PRI   SI  H0     H1     NSFI    NSR/ACT
    iec   1    1     1   15     01     STOP    CRNCF 
;

rtrv-scr-sio:si=5


    tekelecstp 02-08-28 16:47:06 EST  EAGLE 30.0.0
    SCREEN = ALLOWED SIO
    SR    NIC  PRI   SI  H0     H1     NSFI    NSR/ACT
    si01  1    1     5   --     --     STOP    ------
    si02  1    1     5   --     --     ISUP    is01 
;

Legend

For a summary report:

SR—The screen sets being used
REF—Indicates whether a screen is referenced by another screen. If NO, the screen is not used. For more detailed output, use the rtrv-scr-sio:all=yes command, or specify the specific screening reference.
RULES—Number of screening rules in that screening table

For a detailed report:

SCREEN = ALLOWED SIO—Screen type
SR—The screen sets being used
NIC—Network indicator code in the service information octet
PRI—Priority of a single message or the beginning message priority in a range of priorities in the service information octet
SI—Service indicator for the service information octet, which are the last two bits of the subservice field
H0—H0 heading code
H1—H1 heading code
NSFI—Next screening category to be used
NSR/ACT—Name of the next screening reference (NSR - up to four characters) or action to be taken (ACT - up to six characters), if the message passes this screen.

4.565 rtrv-scr-sio