4.564 rtrv-scr-opc

Use this command to show an allowed OPC screening reference and associated attributes (originating point code, next screening function identifier, next screening function reference).

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 OPC screening references.
Range:
yes
no
Default:
Display all
area (optional)
ITU international area. The area in the point code represented by zone-area-id.
Range:
000 - 255, *

* —the full range of values from 000–255

id (optional)
ITU international ID. The ID in the point code represented by zone-area-id.
Range:
0 - 7, *

* —the full range of values from 0–7

mna (optional)
16-bit ITU national main number area. The mna in the point code represented by un-sna-mna.
Range:
0 -- 31, *

* —the full range of values from 0–31

msa (optional)
24-bit ITU national main signaling area. The main signaling area in the point code represented by msa-ssa-sp.
Range:
000 - 255, *

* —the full range of values from 000-255

nc (optional)
Network cluster identifier value. This parameter displays entries containing this specific cluster of the point code represented by ni-nc-ncm.
Range:
0 - 255, *

* —the full range of values from 0–255

Default:
Display all
ncm (optional)
Network cluster member identifier value. This parameter displays entries containing this specific cluster member of the point code represented by ni-nc-ncm.
Range:
0 - 255, *

*—the full range of values from 0–255

Default:
Display all
ni (optional)
Network identifier value. This parameter displays entries containing this specific network of the point code represented by ni-nc-ncm.
Range:
0 - 255

* —the full range of values from 0–255

Default:
Display all
npc (optional)
ITU national point code.

Note:

Gateway screening allows the ITU national point code to be displayed and entered in the database only as a single number. If you are using multiple-part ITU national point codes, see Converting ITU National Point Code Formats in Appendix A.
Range:
00000 - 16383, *

* —the full range of values from 00000–16383

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:
blkopc
Blocked OPC is the next screening category.
sio
Allowed SIO is the next screening category
dpc
Allowed DPC is the next screening category.
blkdpc
Blocked DPC is the next screening category
cgpa
Allowed calling party address 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 or fail. This parameter cannot be specified if nsfi is stop or fail, or the copy=yes parameter is specified.
Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

Default:
Display all
pcst (optional)
Point code subtype. This parameter indicates whether the specified ITU international or ITU national point code has no subtype prefix or has the spare point code prefix (s-).
Range:
none
s
Default:
none
sna (optional)
16-bit ITU national sub number area. The sna in the point code represented by un-sna-mna.
Range:
0 -- 15, *

* —the full range of values from 0–15

sp (optional)
24-bit ITU national signaling point. The signaling point in the point code represented by msa-ssa-sp.
Range:
000 - 255, *

* —the full range of values from 000-255

sr (optional)
The allowed OPC screening reference name
Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

Default:
Display all.
ssa (optional)
24-bit ITU national sub signaling area. The sub signaling area i in the point code represented by msa-ssa-sp.
Range:
0 - 255, *

* — the full range of values from 000-255

un (optional)
16-bit ITU-national unit number. The un of the point code represented by un-sna-mna.
Range:
0 -- 127, *

* —the full range of values from 0–127

zone (optional)
ITU international zone. The zone in the point code represented by zone-area-id.
Range:
0 - 7, *

* —the full range of values from 0–7

Example

rtrv-scr-opc

rtrv-scr-opc:sr=iec:ni=240:nc=001:ncm=010&&018

rtrv-scr-opc:sr=iec:id=4

rtrv-scr-opc:all=yes

rtrv-scr-opc:sr=opc1:actname=cr

rtrv-scr-opc:sr=opc1:npc=128:nsfi=fail:pcst=s

rtrv-scr-opc:sr=opc2:un=1:sna=2:mna=3

Dependencies

ANSI point code value 000-000-000 and ITU-International point code value 0-000-0 are not allowed.

If the ni=* parameter is specified, the nc=* and ncm=* parameters must be specified.

If the nc=* parameter is specified, then the ncm=* parameter must be specified.

If the zone=* parameter is specified, then the area=* and id=* parameters must be specified.

If the area=* parameter is specified, then the id=* parameter must be specified.

If the msa=* parameter is specified, then the ssa=* and sp=* parameters must be specified.

If the ssa=* parameter is specified, then the sp=* parameter must be specified.

If the un=* parameter is specified, then the sna=* and the mna=* must be specified.

If the sna=* parameter is specified, then the mna=* parameter must be specified.

If the ni parameter is specified as an asterisk or as a range, the nc and ncm parameters must be specified as an asterisk or as the full range 000 – 255.

If the nc parameter is specified as an asterisk, the ncm parameter must be specified as an asterisk or as the full range 000 – 255.

If the nc parameter is specified as a single value or a range, a single value must be specified for the ni parameter.

If the nc parameter is specified as a range, the ncm parameter must be specified as an asterisk or as the full range 000 – 255.

If the ncm parameter is specified as a single value, or a range other than the full range of 000 – 255, the ni and nc parameters must be specified with a single value.

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

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

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

The value of the actname parameter must already 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 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 specified screening reference must be in the allowed OPC entity set.

The Spare Point Code Support feature must be enabled before the pcst parameter can be specified.

The spare point code subtype prefix (s-) is not supported for ANSI point codes (parameters ni, nc, ncm) or for 24-bit ITU national point codes (parameters msa, ssa, sp) for 16-bit ITU national point codes (parameters un, sna, mna). The pcst parameter cannot be specified for ANSI, ITU-N16 or ITU-N24 point codes.

If the pcst parameter is specified, point codes with the specified subtype prefix (no prefix or s-) must exist in the database.

Any specified ni parameter must already exist in the allowed OPC entity for the screening reference.

Any specified nc parameter must already exist in the allowed OPC entity for the screening reference.

Any specified ncm parameter must already exist in the allowed OPC entity for the screening reference.

Any specified npc parameter must already exist in the allowed OPC entity for the screening reference.

Any specified nsfi parameter must already exist in the allowed OPC entity for the screening reference.

Any specified nsr parameter must already exist in the allowed OPC entity for the screening reference.

Any specified pcst parameter must already exist in the allowed OPC entity for the screening reference.

Any specified area, sna or ssa parameter must already exist in the allowed OPC entity for the screening reference.

Any specified id, mna or sp parameter must already exist in the allowed OPC entity for the screening reference.

Any specified zone, un or msa parameter must already exist in the allowed OPC entity for the screening reference.

If the nsfi=fail parameter is specified, then the ni, nc, ncm, area, zone, id, msa, ssa, sp, un, sna, mna, and npc parameters cannot have a value of c.

The Gateway Screening Stop Action table must be accessible.

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, a list of allowed OPC references is produced indicating whether they are referenced or not.

If a single allowed OPC screening reference is specified, the specified entity set requested is shown.

If all=yes and no other parameter is specified, detailed information for all of the screening reference entities in the allowed OPC entity set are shown.

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

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

A range of values is specified by separating the values that define the range by two ampersands (&&); for example, ni=025&&100 specifies all network indicators for ANSI point codes from 25 - 100.

The spare point code subtype prefix s- is supported only for ITU international and ITU national point codes. The pcst parameter indicates whether the specified point code has no subtype prefix or has the spare point code prefix.

Output

rtrv-scr-opc

    rlghncxa03w 03-03-13 13:12:38 EST  EAGLE 31.3.0
    SCREEN = ALLOWED OPC
    SR    REF  RULES
    IEC   YES     2
    WRD2  YES     1
    WRD3  NO      4
    WRD4  YES     9 
;
rtrv-scr-opc:sr=iec:ni=240:nc=001:ncm=010&&018

    rlghncxa03w 03-03-13 13:13:21 EST  EAGLE 31.3.0
    SCREEN = ALLOWED OPC
    SR    NI       NC       NCM      NSFI    NSR/ACT
    IEC   240      001      010&&020 STOP    ------- 
;
rtrv-scr-opc:sr=iec:id=4

    rlghncxa03w 03-03-13 13:13:56 EST  EAGLE 31.3.0
    SCREEN = ALLOWED OPC
    SR    ZONE     AREA     ID       NSFI    NSR/ACT
    IEC   1        003      4        BLKOPC  blk1 
;
rtrv-scr-opc:all=yes

    rlghncxa03w 03-03-13 13:14:18 EST  EAGLE 31.3.0
    SCREEN = ALLOWED OPC
    SR    NI       NC       NCM      NSFI    NSR/ACT
    IEC   240      001      010      STOP    -------
    IEC   241      010      *        CGPA    cg04 

    SR    ZONE     AREA     ID       NSFI    NSR/ACT
    IEC   1        003      4        BLKOPC  blk1
    IEC   1        003      5        STOP    -------

    SR    NPC                        NSFI    NSR/ACT
    IEC   00235                      CGPA    cg04
    IEC   00240                      CGPA    cg01

    SR    NI       NC       NCM      NSFI    NSR/ACT
    WRD2  243      015      001      STOP    -------
    WRD3  243      105      002      CGPA    WRD4 
;
rtrv-scr-opc:sr=opc1:actname=cr

    rlghncxa03w 03-03-13 13:16:13 EST  EAGLE 31.3.0
    SCREEN = ALLOWED OPC
    SR    NI       NC       NCM      NSFI    NSR/ACT
    opc1  010      010      010      STOP    CR
    opc1  010      010      012      STOP    CR 
;
rtrv-scr-opc:sr=op55

    tekelecstp 03-03-06 11:30:42 EST  EAGLE 31.0.0
    SR    MSA      SSA      SP       NSFI    NSR/ACT
    op55  007      077      007      BLKOPC  bo55 
;
rtrv-scr-opc:sr=opc1:npc=128:nsfi=fail

    tekelecstp 05-01-06 11:30:42 EST  EAGLE 31.12.0
    SR      NPC                      NSFI    NSR/ACT
    opc1  s-00128                    FAIL    ------- 
;
rtrv-scr-opc:sr=opc2:

    eaglestp 28-02-13 13:13:56 EST  EAGLE 45.1.0
    SCREEN = ALLOWED OPC
    SR    UN        SNA     MNA       NSFI    NSR/ACT
    opc2  001       02      01        STOP    ------
;

Legend

For a summary report:

  • 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-opc:all=yes command, or specify the specific screening reference.
  • RULES—Number of screening rules in that screening table

For a detailed report:

  • SCREEN = ALLOWED OPC—Screen type
  • SR—Identifies the various screen sets being used. It can be up to four characters in length
  • NI - NC - NCM—Point code referenced within the screen. For international point codes, these columns are ZONE-AREA-ID. For 24-bit ITU national point codes, these columns are MSA-SSA-SP. For 16-bit ITU national point codes, these columns are UN-SNA-MNA. For national point codes, these columns become the single column NPC.
  • 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.