rtrv-scr-cgpa

Use this command to show the allowed calling party address (CGPA) screening references in the CGPA entity set.

Parameters

Note:

The nc, ncm, and ni parameters can be specified as a single value, range of values, or an asterisk (*). An * value indicates the full range of values. The area, id, msa, ni, nsr, ri, sp, ssa, ssn, un, sna, mna, and zone parameters can be specified as a single value or as an *.

actname (optional)

The name of the gateway screening stop action set. Stop actions must be administered using this parameter in conjunction 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 CGPA screening references.

Range:

yes
no

Default:

no

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 specified 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 display 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: cdpa, stop, tt

cdpa —Allowed called party address point code is the next screening category.

stop —The gateway screening process ends and the message proceeds through normal routing.

tt —Allowed translation type point code is the next screening category.

Default:

Display all

nsr (optional)

The next screening reference 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 entered 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 indicator. This parameter indicates whether the ITU international or ITU national point codes to be displayed must have the spare point code prefix (s-).

Range:

none: No spare point code prefix required.
s: Spare point code prefix required.

Default:

none

ri (optional)

Routing indicator. Routing instructions to the receiving signaling point. In gateway screening, messages may be screened based on the value of the routing indicator.

Range:

gt: Allow a called party address with a routing indicator value of "global title."
dpc: Allow a called party address with a routing indicator value of “DPC/SSN.”
*: Allow both routing indicator values.

Default:

Display all

sccpmt (optional)

SCCP message type.

Range:

9: UDT
10: UDTS
17: XUDT
18: XUDTS
*: All possible allowed values (9, 10, 17, 18)

Default:

Display all SCCP message types

sna (optional)

16-bit ITU national main 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 CGPA 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 specified in the point code. represented by msa-ssa-sp.

Range:: 0 - 255, *
* — the full range of values from 000-255

ssn (optional)

Subsystem number.

Range:: 0 - 255, *
* — the full range of values from 0–255
Default:: Display all.

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-cgpa:sr=iec:ni=240:nc=001:ncm=010:ssn=012

rtrv-scr-cgpa:sr=iec:ni=240:nc=001:ncm=010:actname=copy

rtrv-scr-cgpa:sr=cgp1

rtrv-scr-cgpa:sr=cgpa:zone=1:area=2:id=3:ssn=1:sccpmt=9:ri=*:nsfi=stop:pcst=s

rtrv-scr-cgpa:sr=cgp1:un=1:sna=2:mna=1:ssn=1:sccpmt=9:nsfi=stop:ri=*

Dependencies

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 the nc parameters must be specified with a single value.

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

If the actname parameter is specified, the nsfi=stop parameter must 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.

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

If zone=* is specified, area=* and id=* must be specified.

If area=* is specified, id=* must be specified.

If msa=* is specified, ssa=* and sp=* must be specified.

If ssa=* is specified or re-specified, sp=* must also be specified.

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

If sna=* is specified, mna=* must be specified.

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

Any specified ni, nc, ncm, zone, area, id, msa, ssa, sp, un, sna, mna, ncp, nsfi, ri, ssn, and nsr parameters must already exist in the CGPA entity for the screening reference.

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

The specified screening reference (sr) must be in the allowed CGPA entity set.

If the nsfi=stop parameter is specified, the nsr parameter cannot 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) or for 16-bit ITU national point codes (parameters un, sna, mna). The pcst and npcst parameters cannot be specified for ANSI, ITU-N16 or ITU-N24 point codes.

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.

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, the system displays a summary output.

If only the all=yes parameter is specified, the system displays a detailed output.

If the all parameter and any point code parameter are specified, the all parameter is ignored.

An asterisk 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-cgpa:sr=iec:ni=240:nc=001:ncm=010:ssn=012


    rlghncxa03w 03-03-14 15:58:16 EST  EAGLE 31.3.0
    SCREEN = ALLOWED CGPA
    SR    NI      NC       NCM      SSN     RI   SCCPMT   NSFI    NSR/ACT
    IEC   240     001      010      012     DPC  009&&010 STOP    ------- 
;


		  rtrv-scr-cgpa:sr=iec:ni=240:nc=001-004:ri=dpc:sccpmt=000&&010


    rlghncxa03w 03-03-14 15:58:16 EST  EAGLE 31.3.0
    SCREEN = ALLOWED CGPA
    SR    NI      NC       NCM      SSN     RI   SCCPMT   NSFI    NSR/ACT
    IEC   240     001      010      012     DPC  017&&018 STOP    -------
    IEC   240     002&&003 *        004     DPC  009      STOP    ------- 
;

 rtrv-scr-cgpa:actname=none


    rlghncxa03w 03-03-14 15:58:16 EST  EAGLE 31.3.0
    SCREEN = ALLOWED CGPA
    SR    NI      NC       NCM      SSN     RI   SCCPMT   NSFI    NSR/ACT
    IEC   240     001      010      012     DPC  017      STOP    -------
    IEC   240     001      010      014     GT   *        STOP    -------
    IEC   241     002      011      014     GT   *        CDPA    CDP1 
;


		  rtrv-scr-cgpa:sr=cg01:nsfi=tt:nsr=tt01:ri=gt:ssn=1:sccpmt=9:msa=255:ssa=255:sp=255


    tekelecstp 03-03-05 14:41:37 EST  EAGLE 31.0.0
    SCREEN = ALLOWED CGPA
    SR    MSA      SSA      SP       NSFI    NSR/ACT
    cg01  255      255      255      1        GT   9        TT      tt01 
;


		  rtrv-scr-cgpa:sr=cgpa:zone=1:area=2:id=3:ssn=1:sccpmt=9:ri=*:nsfi=stop:pcst=s


    tekelecstp 05-01-05 14:41:37 EST  EAGLE 31.12.0
    SCREEN = ALLOWED CGPA
    SR      ZONE   AREA     ID       SSN      RI   SCCPMT   NSFI    NSR/ACT
    cgpa  s-1      002      3        1        *    9        STOP    ------ 
;

 rtrv-scr-cgpa:sr=cgp1


    tekelecstp 05-01-05 14:41:37 EST  EAGLE 31.12.0
    SCREEN = ALLOWED CGPA
    SR      ZONE   AREA     ID       SSN      RI   SCCPMT   NSFI    NSR/ACT
    cgp1  s-2      002      3        1        *    *        STOP    ------

    SR      NPC                      SSN      RI   SCCPMT   NSFI    NSR/ACT
    cgp1  s-00128                    1        *    *        STOP    ------ 
;

rtrv-scr-cgpa:sr=cgp1:


    eaglestp 28-02-13 14:41:37 EST  EAGLE 45.1.0
    SCREEN = ALLOWED CGPA
    SR      UN   SNA     MNA       SSN      RI   SCCPMT   NSFI    NSR/ACT
    cgp1    001  02      01        1        *    9        STOP    ------ 
;

Legend

For a summary report:

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

For a detailed report:

SCREEN = ALLOWED CGPA—Screen type
SR —Identifies the 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.
SSN—Subsystem number associated with the point code identified by the ni-nc-ncm
RI—Routing indicator in the called party address
SCCPMT—SCCP message type
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.560 rtrv-scr-cgpa