4.556 rtrv-scr-aftpc
Use this command to show the allowed affected point code (AFTPC) screening references in the AFTPC 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
andrtrv-gws-actset
).
- mna (optional)
- 16-bit ITU national main number area. The mna in the point code represented by un-sna-mna.
- msa (optional)
- 24-bit ITU national main signaling area. The main signaling area in the point code represented by msa-ssa-sp.
- nc (optional)
- Network cluster identifier value. This parameter displays entries containing the specific cluster of the point code represented by ni-nc-ncm.
- 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.
- ni (optional)
- Network identifier value. This parameter displays entries containing this specific network of the point code represented by ni-nc-ncm.
- 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.
- 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.
- 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.
- 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-).
- sna (optional)
- 16-bit ITU national main number area. The sna in the point code represented by un-sna-mna.
- sp (optional)
- 24-bit ITU national signaling point. The signaling point in the point code represented by msa-ssa-sp.
- ssa (optional)
- 24-bit ITU national sub signaling area. The ssa specified in the point code represented by msa-ssa-sp.
Example
rtrv-scr-aftpc
rtrv-scr-aftpc:sr=iec:ni=240:nc=001:ncm=010&&014:ssn=012
rtrv-scr-aftpc:sr=iec
rtrv-scr-aftpc:all=yes
rtrv-scr-aftpc:sr=iec:ni=240:nc=001:ncm=010:ssn=012:actname=copy
rtrv-scr-aftpc:sr=aft1
rtrv-scr-aftpc:sr=aft1:zone=1:area=2:id=3:nsfi=stop:ssn=1:pcst=s
rtrv-scr-aftpc:sr=aft2:un=1:sna=2:mna=3
Dependencies
If the nsfi parameter is specified, the parameter value must be stop.
ANSI point code value 000-000-000 and ITU-International point code value 0-000-0 are not allowed.
If nc=* is specified, ncm=* must be specified.
If ni=* is specified, nc=* and nc=* must be specified.
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, sp=* must be specified.
If un=* is specified, sna=* and mna=* must be specified.
If sna=* is specified, mna=* must be specified.
The character c is not a valid value for the ni, nc, ncm, zone, area, id, msa, ssa, sp, un, sna, mna, and npc parameters.
The nsr parameter cannot be specified if the actname parameter is specified.
The nsr parameter cannot be specified if the nsfi=stop parameter is specified.
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 actname parameter is specified with the sr parameter, the specified value for the actname parameter must be assigned to that screening reference name.
If specified, the sr parameter value must exist in the AFTPC screen 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) or for 16-bit ITU national point codes (parameters un, sna, mna). The pcst parameter cannot be specified for ANSI, ITU-N16, and ITU-N24 point codes.
Any specified ni, nc, ncm, zone, area, id, msa, ssa, sp, un, sna, mna, ncp, nsfi, and nsr parameters must already exist in the AFTPC 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.
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.
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.
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 defined 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.
If no parameters are specified, a list of allowed AFTPC references is produced indicating whether they are referenced or not.
If only the all=yes parameter is specified, detailed information for every rule in every allowed AFTPC screening table is displayed.
If the all parameter is specified and other parameters are also specified, the all parameter is ignored.
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 ot has the spare point code prefix.
Output
rtrv-scr-aftpc
rlghncxa03w 03-03-13 13:12:38 EST EAGLE 31.3.0
SCREEN = ALLOWED AFTPC
SR REF RULES
IEC YES 2
WRD2 YES 1
WRD3 NO 4
WRD4 YES 9
;
rtrv-scr-aftpc:sr=iec:ni=240:nc=001:ncm=010&&014:ssn=012:actname=copy
rlghncxa03w 03-03-14 15:23:18 EST EAGLE 31.3.0
SCREEN = ALLOWED AFTPC
SR NI NC NCM SSN NSFI NSR/ACT
IEC 240 001 010&&012 012 STOP COPY
;
rtrv-scr-aftpc:sr=aft1:zone=1:area=2:id=3:nsfi=stop:ssn=1:pcst=s
tekelecstp 05-01-05 10:19:51 EST EAGLE 31.12.0
SCREEN = ALLOWED AFTPC
SR ZONE AREA ID SSN NSFI NSR/ACT
aft1 s-1 002 3 1 STOP ------
;
rtrv-scr-aftpc:sr=aft1
tekelecstp 05-01-05 10:19:51 EST EAGLE 31.12.0
SCREEN = ALLOWED AFTPC
SR ZONE AREA ID SSN NSFI NSR/ACT
aft1 s-2 002 3 1 STOP ------
SR NPC SSN NSFI NSR/ACT
aft1 s-00128 1 STOP ------
;
rtrv-scr-aftpc:sr=aft2
eaglestp 28-02-13 10:19:51 EST EAGLE 45.1.0
SCREEN = ALLOWED AFTPC
SR UN SNA MNA SSN NSFI NSR/ACT
aft2 001 02 01 1 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-blkdpc:all=yes
command, or specify the specific screening reference. - RULES—Number of screening rules in that screening table
For a detailed report:
- SCREEN = ALLOWED AFTPC—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.
- SSN—Subsystem number associated with the point code identified by ni-nc-ncm
- 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
Related Topics