4.561 rtrv-scr-destfld
Use this command to show the attributes of one or more allowed affected destination field (DESTFLD) screening references and associated attributes (destination point code, next screening function identifier, next screening function reference) that are allowed to receive SS7 messages from another network.
Parameters
- actname (optional)
- The 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
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 the specific cluster member of the point code represented by ni-nc-ncm.
- ni (optional)
- Network identifier value. This parameter displays entries containing the 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. For multiple-part ITU national point codes, see Converting ITU National Point Code Formats in Appendix A.
- 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.
- 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 sub signaling area in the point code represented by msa-ssa-sp.
Example
rtrv-scr-destfld
rtrv-scr-destfld:sr=iec:ni=240:nc=001:ncm=010&&018
rtrv-scr-destfld:sr=iec:id=4:actname=cncf
rtrv-scr-destfld:all=yes
rtrv-scr-destfld:sr=dst1:zone=1:area=2:id=3:nsfi=stop:pcst=s
rtrv-scr-destfld:sr=dst1
rtrv-scr-destfld:sr=iec:un=125:sna=1:mna=10
Dependencies
If the actname parameter is specified, the nsfi=stop parameter must be specified.
The nsfi=stop parameter must be specified.
The nsr parameter cannot be specified in the command if the nsfi parameter has a value of stop or fail.
If the actname parameter is specified, 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.
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.
ANSI point code value 000-000-000 and ITU-International point code value 0-000-0 are not allowed.
If the zone=* parameter is specified, then the area=* and the 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 the sp=* parameters must be specified.
If the un=* parameter is specified, then the sna=* and the mna=* parameters must be specified.
If the ssa=* parameter is specified, then the sp=* parameter must be specified.
If the sna=* parameter is specified, then the mna=* parameter must be specified.
The specified screening reference (sr) must be in the allowed DESTFLD 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 na, 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 area, sna or ssa parameter must already exist in the database.
Any specified id, sp or mna parameter must already exist in the database.
Any specified zone, un or msa parameter must already exist in the database.
Any specified nc parameter must already exist in the database.
Any specified ncm parameter must already exist in the database.
Any specified ni parameter must already exist in the database.
Any specified npc parameter must already exist in the database.
Any specified nsfi parameter must already exist in the database.
Any specified nsr parameter must already exist in the database.
Any specified pcst parameter must already exist in the database.
If the nsfi=fail parameter is specified, then the nni, nc, nncm, narea, nzone, nid, nmsa, nssa, nsp, nun, nsna, nmna, 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, 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-destfld
rlghncxa03w 03-03-13 13:12:38 EST EAGLE 31.3.0
SCREEN = ALLOWED DESTFLD
SR REF RULES
IEC YES 2
WRD2 YES 1
WRD3 NO 4
WRD4 YES 9
;
rtrv-scr-destfld:sr=iec:ni=240:nc=001:ncm=010&&018
rlghncxa03w 03-03-13 13:13:21 EST EAGLE 31.3.0
SCREEN = ALLOWED DESTFLD
SR NI NC NCM NSFI NSR/ACT
IEC 240 001 010&&020 STOP -------
;
rtrv-scr-destfld:sr=iec:id=4:actname=cncf
rlghncxa03w 03-03-13 13:13:56 EST EAGLE 31.3.0
SCREEN = ALLOWED DESTFLD
SR ZONE AREA ID NSFI NSR/ACT
IEC 1 003 4 STOP CNCF
;
rtrv-scr-destfld:all=yes
rlghncxa03w 03-03-13 13:14:18 EST EAGLE 31.3.0
SCREEN = ALLOWED DESTFLD
SR NI NC NCM NSFI NSR/ACT
IEC 240 001 010 STOP CNCF
IEC 241 010 * STOP -------
SR ZONE AREA ID NSFI NSR/ACT
IEC 1 003 4 STOP -------
IEC 1 003 5 STOP CR
SR NPC NSFI NSR/ACT
IEC 00235 STOP CNCF
IEC 00240 STOP -------
;
rtrv-scr-destfld:sr=dst1:zone=1:area=2:id=3:nsfi=stop:pcst=s
tekelecstp 05-01-06 11:40:26 EST EAGLE 31.12.0
SCREEN = ALLOWED DESTFLD
SR ZONE AREA ID NSFI NSR/ACT
dst1 s-1 002 3 STOP ------
;
rtrv-scr-destfld:sr=dst1
tekelecstp 05-01-06 11:40:26 EST EAGLE 31.12.0
SCREEN = ALLOWED DESTFLD
SR ZONE AREA ID NSFI NSR/ACT
dst1 s-1 002 3 STOP ------
SR NPC NSFI NSR/ACT
dst1 s-00128 STOP ------
;
rtrv-scr-destfld:sr=ds01
tekelecstp 13-07-05 16:27:55 EST 45.0.0-64.69.0
rtrv-scr-destfld:sr=ds01
Command entered at terminal #4.
SCREEN = ALLOWED DESTFLD
SR UN SNA MNA NSFI NSR/ACT
ds01 001 14 01 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-destfld:all=yes
command, or specify the specific screening reference. - RULES—Number of screening rules in that screening table.
For a detailed report:
- SCREEN = ALLOWED DESTFLD—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.