rtrv-scrset

Use this command to show the attributes of one or more screen sets in the screen set entity set.

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 screen sets (except “placeholder” screen sets that contain only one rule with nsfi=stop specified in the rule).

Range:

yes
no

Default:

no

destfld (optional)

This parameter displays the indicator that specifies whether to apply the automatic allowed affected destination screening for network management messages against the routing table, self point codes, and capability point codes. When this parameter is on in the screen set rule, the automatic screening is applied at the end of the provisioned screen set.

Range:

yes
no

Default:

Display all

nsfi (optional)

This parameter indicates the next screening category that is used in the gateway screening process, or that the gateway screening process should stop. In this command, information is displayed for one or more screen sets containing rules with the specified nfsi parameter value.

Note:

When nsfi=stop is specified, the command displays only the “placeholder” screen sets that have only one rule, with nsfi=stop specified in the rule. This is a way to locate those “placeholder” screen sets, so that you can add or change the rules to accomplish appropriate screening.

Range:

opc: Display rules with Allowed OPC as the next screening category.
blkopc: Display rules with Blocked OPC as the next screening category.
sio: Display rules with Allowed SIO as the next screening category.
dpc: Display rules with Allowed DPC as the next screening category.
blkdpc: Display rules with Blocked DPC as the next screening category.
stop: Display only “placeholder” screen sets that have only one rule in the screen set, with nsfi=stop specified as the next screening category.

Default:

Display all

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 used to display information for one or more screen sets with rules that have the specified nsr parameter value.

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

scrn (optional)

Screen set name.

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

Default:: Display all

Example

rtrv-scrset

rtrv-scrset:scrn=scr1

rtrv-scrset:nsr=opc4

rtrv-scrset:nsfi=dpc

rtrv-scrset:actname=copy

Dependencies

The screen set name must already exist.

The nsfi=stop parameter must be specified before the actname parameter can be specified.

The nsr parameter cannot be specified if the actname parameter is specified.

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

The nsfi parameter must be valid for the SCRSET entity.

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

The nsr parameter cannot be entered if the nsfi parameter value equals stop.

The GWSOA parameter combination should be known and valid.

Notes

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

If no parameters are specified for the rtrv-scrset command, the output shows all the screen sets, the screening function identifier of the root screening table, the screening reference of the root screening table, the memory usage (percentage), the number of entries in the screen set and the overall gateway screening statistics, followed by a summary of statistics for each screen set.

For the rtrv-scrset:all=yes command, the output consists of every screen set and every screening reference in each screen set (except “placeholder” screen sets that have only one rule with nsfi=stop specified in the rule). The all=yes and nfsi=stop parameters cannot be specified in the same command.

If the scrn, nsfi, or nsr parameter is entered, summary information for all screens that match the specified parameters is shown.

When the % FULL is over 100%, the screen is inaccessible. A screenset over 100% capacity size will not bind correctly. A screenset can become provisioned over capacity when linking one screen reference to another causes the size to become too large. To reduce a screenset that is over 100% capacity, screen rules must be deleted (see the dlt-scr-xxx commands)

Output

rtrv-scrset:nsfi=opc


    rlghncxa03w 03-03-14 16:37:54 EST  EAGLE 31.3.0
    SCRN  NSFI    NSR/ACT   RULES  DESTFLD
    att1  OPC     att1       111   Y
    atx1  OPC     atx1         2   Y
    bam1  OPC     bam1         3   Y
    ctt1  OPC     ctt1         1   Y
    ctw1  OPC     ctw         39   Y
    mci1  OPC     mci1         3   Y
    wtl1  OPC     wtl1       339   Y 
;

rtrv-scrset:nsr=dpc3


    rlghncxa03w 03-03-14 16:38:28 EST  EAGLE 31.3.0
    SCRN  NSFI    NSR/ACT   RULES
    ss01  DPC     dpc3         3
    ss02  DPC     dpc3         3
    ss03  DPC     dpc3         3
    ss04  DPC     dpc3         3
    ss05  DPC     dpc3         3 
;

rtrv-scrset:scrn=ss53


    rlghncxa03w 03-03-14 16:39:04 EST  EAGLE 31.3.0
    SCRN  NSFI    NSR/ACT   RULES  DESTFLD
    ss53  BLKDPC  bkd2         2   Y
          CGPA    cgp1         3
          TT      tt1          3
          TT      tt2          3
          TT      tt3          4
          CDPA    cdp1         3
          CDPA    cdp2         3
          CDPA    cdp3         4
          AFTPC   end1         9 
;

rtrv-scrset:scrn=gws1


    e1070402 02-07-22 10:06:09 EST  EAGLE 30.0.0
    rtrv-scrset:scrn=gws1
    Command entered at terminal #4.
    SCRN  NSFI    NSR/ACT  RULES DESTFLD
    gws1  OPC     opc1     17    Y
          BLKOPC  bop1     1812
          SIO     sio1     80
          DPC     dpc1     17
          BLKDPC  bdp1     1812
          CGPA    cga1     34
          TT      tt01     256
          CDPA    cda1     17
          CDPA    cdb1     6
          AFTPC   apc1     17
          ISUP    isu1     17 
;

The number of screen sets has increased from 255 to 1023. In the following example, the % full is over 100% and the screen is inaccessible.

rtrv-scrset

    tekelecstp 02-01-04 23:34:41 MST  UNKNOWN 46.1.0-65.14.0
    ENTIRE GWS DATABASE IS 1% FULL
    CDPA + AFTPC TABLES ARE 0% FULL
    SCREEN SET TABLE IS (4 OF 1023) 1% FULL
    THERE ARE 0 SEAS SCREEN SETS USED (prefix 00nn)
    THERE ARE 4 EAGLE SCREEN SETS USED

    THE FOLLOWING ARE OVER 80% FULL:
    SCRN  NSFI    NSR/ACT  FULL  RULES  TABLES  DESTFLD
    s1    OPC     op1      101%  8192   3       Y
    set1  OPC     op10      97%  7894   6       Y

    SCRN  NSFI    NSR/ACT  FULL  RULES  TABLES  DESTFLD
    a600  SIO     si1        1%  16     1       Y
    a610  SIO     si1        1%  16     1       Y
    s1    OPC     op1      101%  8192   3       Y
    set1  OPC     op10      97%  7894   6       Y

Legend

SCRN—Name of the screen set
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
FULL—Capacity of allowed memory a given screen set occupies, expressed as a percentage
RULES—Number of entries in the screen set
TABLES—Number of tables in the screen set
DESTFLD—Displays whether to apply the automatic allowed affected destination screening for network management messages against the routing table, self point codes, and capability point codes. When this parameter is on, the automatic screening is applied at the end of the provisioned screen set.

4.567 rtrv-scrset