rtrv-scr-cdpa

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

Parameters

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 CDPA 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 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:

aftpc: Allowed affected point code is the next screening category
stop: The gateway screening process ends and the message proceeds through normal routing

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

scmgfid (optional)

SCCP management (SCMG) format ID, which consists of a 1-octet field and uniquely defines the function and format of each SCMG message. The following SCCP message types are screened against the Allowed CDPA table and all others are passed: UDT, UDTS, XUDT, XUDTS

Range:: 1 - 255, *
*—the full range of values from 1-255
Default:: All SCMG format IDs are shown.

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)

Displays all allowed CDPA screening references.

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-cdpa

rtrv-scr-cdpa:sr=iec:ni=240:nc=001:ncm=010:ssn=001

rtrv-scr-cdpa:sr=iec:ni=240:nc=001:ssn=002&&005

rtrv-scr-cdpa:sr=iec

rtrv-scr-cdpa:sr=iec:actname=copy

rtrv-scr-cdpa:sr=cdp1:zone=1:area=2:id=3:ssn=1:nsfi=stop:scmgfid=1:pcst=s

rtrv-scr-cdpa:sr=cdp1

rtrv-scr-cdpa:sr=cdp2:un=1:sna=2:mna=3

Dependencies

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.

The nsr parameter cannot be specified when nsfi=stop .

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

If area is specified or respecified as an asterisk, id must also be an asterisk.

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

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

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

If sna=* is specified, mna=* 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 the nc parameters must be specified with a single value.

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

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 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 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) or 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.

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 function identifier (nsfi) must be in the allowed CDPA entity set.

The Gateway Screening Stop Action table must be accessible.

If specified, the sr parameter value must exist in the AFTPC screen entity set.

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.

The REF column of the output of this command displays YES when the screen is referenced by another screen; otherwise, it displays NO.

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


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED CDPA
    SR    NI       NC       NCM      SSN      SCMGFID   NSFI   NSR/ACT
    IEC   240      001      010      001      002&&003 STOP    ------- 
;

rtrv-scr-cdpa:sr=iec:ni=240:nc=001:ssn=002&&005


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED CDPA
    SR    NI       NC       NCM      SSN      SCMGFID   NSFI   NSR/ACT
    IEC   240      001      010      002      ------   STOP    -------
    IEC   240      001      011      002&&003 ------   STOP    ------- 
;

rtrv-scr-cdpa:sr=iec


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED CDPA
    SR    NI       NC       NCM      SSN      SCMGFID   NSFI   NSR/ACT
    IEC   240      001      010      12       ------   STOP    -------
    IEC   241      010      *        *        ------   AFTPC   IAFT 
;

rtrv-scr-cdpa


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED CDPA
    SR     REF  RULES
    IEC    YES     2
    WRD2   YES     1
    WRD4   YES     4 
;

rtrv-scr-cdpa:sr=iec:actname=copy


    rlghncxa03w 03-03-07 12:05:33 EST  EAGLE 31.3.0
    SCREEN = ALLOWED CDPA
    SR    NI       NC       NCM      SSN      SCMGFID   NSFI   NSR/ACT
    IEC   245      001      010      001      002&&003 STOP    COPY
    IEC   246      001      010      001      002&&003 STOP    COPY

    U0 - CNCF 
;

rtrv-scr-cdpa:sr=cdp1:zone=1:area=2:id=3:ssn=1:nsfi=stop:scmgfid=1:pcst=s


    rlghncxa03w 05-01-07 12:05:33 EST  EAGLE 31.12.0
    SCREEN = ALLOWED CDPA
    SR      ZONE   AREA     ID       SSN      SCMGFID  NSFI    NSR/ACT
    cdp1  s-1      002      3        1        1        STOP    ------ 
;

rtrv-scr-cdpa:sr=cdp1


    rlghncxa03w 05-01-07 12:05:33 EST  EAGLE 31.12.0
    SCREEN = ALLOWED CDPA
    SR      ZONE   AREA     ID       SSN      SCMGFID  NSFI    NSR/ACT
    cdp1  s-2      002      3        1        1        STOP    ------

    SR      NPC                      SSN      SCMGFID  NSFI    NSR/ACT
    cdp1  s-00128                    1        1        STOP    ------ 
;

rtrv-scr-cdpa:sr=cdp2:


    eaglestp 28-02-13 12:05:33 EST  EAGLE 45.1.0
    SCREEN = ALLOWED CDPA
    SR      UN   SNA     MNA       SSN      SCMGFID  NSFI    NSR/ACT
    cdp2    001  02      01        1        1        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-cdpa:all=yes command, or specify the specific screening reference.
RULES—Number of screening rules in that screening table

For a detailed report:

SCREEN = ALLOWED CDPA—Screen type
SR—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 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.
SCMGFID—SCMGFID format ID
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.559 rtrv-scr-cdpa