4.557 rtrv-scr-blkdpc
Use this command to show the blocked destination point code (BLKDPC) screening references in the BLKDPC 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 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. 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 used in the gateway screening process, or it indicates that the gateway screening process should stop.
- Range:
-
- cgpa
- Allowed calling party address is the next screening category
- destfld
- Allowed destination field (DESTFLD) is the next screening category
- fail
- The received message should be discarded.
- isup
- ISUP message type (ISUP) 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 and cannot be entered if nsfi is stop or fail, or the copy=yes parameter is specified.
- pcst (optional)
- Point code subtype. This parameter specifies 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. This parameter specifies 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 specified in the point code represented by msa-ssa-sp.
Example
rtrv-scr-blkdpc
rtrv-scr-blkdpc:sr=iec:ni=240:nc=001:ncm=010&&018:nsfi=stop:actname=rdct
rtrv-scr-blkdpc:sr=iec
rtrv-scr-blkdpc:all=yes
rtrv-scr-blkdpc:sr=bdp1:npc=128:nsfi=fail:pcst=s
rtrv-scr-blkdpc:sr=bl01:un=1:sna=2:mna=3
Dependencies
A complete point code must be specified, and must be one and only one of the five point code parameter combinations: ni-nc-ncm, zone-area-id, msa-ssa-sp, un-sna-mna, or npc, except in the special case of entering c for "continue."
If the ni=c parameter is specified, then the nc and the ncm parameters must have a value of c or must not be specified. If the ni=c parameter is specified, and the nc and the ncm parameters are not specified, then the nc and ncm parameters default to a value of c.
If the zone=c parameter is specified, then the area and id parameters must have a value of c or must not be specified. If the zone=c parameter is specified, and the area and the id parameters are not specified, then the area and id parameters default to a value of c.
If the msa=c parameter is specified, then the ssa and sp parameters must have a value of c or must not be specified. If the msa=c parameter is specified, and the ssa and the sp parameters are not specified, then the ssa and sp parameters default to a value of c.
If the un=c parameter is specified, then the sna and mna parameters must have a value of c or must not be specified. If the un=c parameter is specified, and the sna and the mna parameters are not specified, then the sna and mna parameters default to a value of c.
ANSI point code value 000-000-000 and ITU-International point code value 0-000-0 are not allowed.
If the area=* parameter is specified, then the id=* parameter must be specified.
If the value of the nsfi parameter is stop or fail, then the nsr parameter cannot be specified.
If the actname parameter is specified, the nsr parameter cannot be specified.
If the actname parameter is specified, then the nsfi=stop parameter must be specified.
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.
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 ni parameter is specified as an asterisk (ni=* ) 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 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.
The value of the sr parameter must already exist in the BLKDPC 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 or ITU-N24 point codes.
Any specified id, mna or sp parameter must already exist in the database.
If the pcst parameter is specified, point codes with the specified subtype prefix (no prefix or s- ) must 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 zone, un or msa parameter must already exist in the database.
Any specified ni parameter must already exist in the database
Any specified nsr parameter must already exist in the database
Any specified nsfi parameter must already exist in the database
Any specified npc parameter must already exist in the database
Any specified area, sna, or ssa parameter must already exist in the database.
Any specified pcst parameter must already exist in the database
The Gateway Screening Stop Action table must be accessible.
If the zone=* parameter is specified, then the area=* and id=* parameters must be specified.
If the msa=* parameter is specified, then the ssa=* and the 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=* parameters must be specified.
If the sna=* parameter is specified, then the mna=* parameter must be specified.
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 blocked DPC screening references is displayed indicating whether they are referenced or not.
If only the all=yes parameter is specified, detailed information for every rule in every blocked DPC screening table is output.
If the all parameter is specified and other parameters are also 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 character c is used in the blocked DPC screens to allow the screening process to continue for messages with point codes that do not match any point codes in the blocked DPC screens. When screening for a blocked DPC and the point code being screened does not match any of the point codes in the blocked DPC screens, the message is not rejected and the screening process continues. There must be an entry in the blocked DPC screens to allow the screening process to continue. This entry consists of a screening reference, point code, nsfi, and nsr . The point code has the value c.
If the character c is specified for any subfield of a three-subfield point code, all three subfields must have the value c. No other values can be used. For example, a point code c is not allowed. The point code must be c . The asterisk (*) value cannot be used with the character c (for example, a point code c is not allowed).
In all cases, if c for "continue" is entered for the first subfield in the point code, the other subfields default to c in the database.
When the point code does not match any entries in the blocked DPC screens, the screening process is directed to the screening reference with the point code c . The nsfi and nsr in this entry are examined to determine the next step in the screening process.
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-blkdpc
rlghncxa03w 03-03-13 13:12:38 EST EAGLE 31.3.0
SCREEN = BLOCKED DPC
SR REF RULES
IEC YES 2
WRD2 YES 1
WRD3 NO 4
WRD4 YES 9
;
rtrv-scr-blkdpc:sr=iec:ni=240:nc=001:ncm=010&&018
rlghncxa03w 03-03-13 13:13:21 EST EAGLE 31.3.0
SCREEN = BLOCKED DPC
SR NI NC NCM NSFI NSR/ACT
IEC 240 001 010&&020 STOP -------
;
rtrv-scr-blkdpc:actname=rdct
rlghncxa03w 03-03-13 13:13:21 EST EAGLE 31.3.0
SCREEN = BLOCKED DPC
SR NI NC NCM NSFI NSR/ACT
IEC C C C STOP RDCT
;
rtrv-scr-blkdpc:nsr=is02
tekelecstp 02-08-30 09:25:54 EST EAGLE 30.0.0
rtrv-scr-blkdpc:nsr=is02
Command entered at terminal #4.
SCREEN = BLOCKED DPC
SR NI NC NCM NSFI NSR/ACT
bdp3 C C C ISUP is02
;
rtrv-scr-blkdpc:sr=bdp1:npc=128:nsfi=fail
tekelecstp 05-01-25 15:57:51 EST EAGLE 31.12.0
SCREEN = BLOCKED DPC
SR NPC NSFI NSR/ACT
bdp1 s-00128 FAIL -------
;
rtrv-scr-blkdpc:sr=bl01
tekelecstp 13-07-05 16:48:31 EST 45.0.0-64.69.0
rtrv-scr-blkdpc:sr=bl01
Command entered at terminal #4.
SCREEN = BLOCKED DPC
SR UN SNA MNA NSFI NSR/ACT
bl01 004 05 06 FAIL -------
bl01 C C C 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-blkdpc:all=yes
command, or specify the specific screening reference. - RULES—Number of screening rules in that screening table
For a detailed report:
- SCREEN = BLOCKED DPC—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, columns are ZONE - AREA - ID. For 24-bit ITU national point codes, columns are MSA-SSA-SP. For 16-bit ITU national point codes, columns are UN-SNA-MNA. For national point codes, 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.
Related Topics