4.119 chg-scr-blkdpc
Use this command to change the attributes of a specific screening reference in the blocked DPC category. Attributes that can be changed are the blocked destination point code, next screening function identifier, and the next screening reference.
Parameters
Note:
See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.- actname (optional)
- Action name. 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
).
- force (optional)
- When there are more than 200 affected screensets, this parameter will decide whether to execute the command successfully or not.
- 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 value. The msa of the point code represented by msa-ssa-sp.
- nc (optional)
- Network cluster value. This parameter specifies one or more nc values for the network indicator and network cluster member values specified in the ni and ncm parameters. It specifies the nc of the point code represented by ni-nc-ncm.
- ncm (optional)
- Network cluster member value. This parameter specifies one or more ncm values for the network indicator and network cluster values identified in the ni and nc parameters. It specifies the ncm of the point code represented by ni-nc-ncm.
- ni (optional)
- Network indicator value. This parameter specifies one or more ni values for the network cluster and network cluster member values identified in the nc and ncm parameters. It specifies the ni of the point code represented by ni-nc-ncm.
- nmna (optional)
- New 16-bit ITU national main number area. The new mna in the point code represented by un-sna-mna.
- nmsa (optional)
- New 24-bit ITU-national main signaling area value. The new msa of the point code represented by msa-ssa-sp.
- nnc (optional)
- New network cluster. This parameter specifies one or more nnc values for the screening reference specified in the sr parameter. It specifies the nc of the point code represented by ni-nc-ncm.
- nncm (optional)
- New network cluster member. This parameter specifies one or more ncm values for the screening reference specified in the sr parameter. It specifies the new ncm of the point code represented by ni-nc-ncm.
- nni (optional)
- New network identifier. This parameter specifies one or more nni values for the screening reference specified in the sr parameter. It specifies the new ni of the point code represented by ni-nc-ncm.
- nnpc (optional)
- New 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 use multiple-part ITU national point codes, see Converting ITU National Point Code Formats in Appendix A for information on converting the point code format.
- npcst (optional)
- New point code subtype. Indicates whether the specified new ITU international or ITU national point code has no subtype prefix or has the spare point code prefix (s-).
- 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:
-
- cgpa
- Allowed CGPA is the next screening category
- fail
- Discard the received message
- destfld
- Allowed destination field (DESTFLD) is the next screening category
- isup
- ISUP message type (ISUP) is the next screening category
- stop
- The gateway screening process ends and the message proceeds through normal routing
- Default:
- No change to the current value
- nsna (optional)
- New 16-bit ITU national sub number area. The new sna in the point code represented by un-sna-mna.
- nsp (optional)
- New 24-bit ITU national signaling point. The new sp of the point code represented by msa-ssa-sp.
- nsr (optional)
- Next screening reference. Indicates which screening reference in the specified screening category (nsfi) is to be used in the screening process.
- nssa (optional)
- New 24-bit ITU national sub signaling area. The new ssa of the point code represented by msa-ssa-sp.
- nun (optional)
- New 16-bit ITU national unit number. The new un in the point code represented by un-sna-mna.
- nzone (optional)
- New ITU-international zone. The new zone for the point code represented by zone-area-id.
- pcst (optional)
- Point code subtype. zindicates 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 sub number area. The sna in the point code represented by un-sna-mna.
- sp (optional)
- 24-bit ITU national signaling point. The sp in the point code represented by msa-ssa-sp.
- ssa (optional)
- 24-bit ITU national sub signaling area. The ssa in the point code represented by the format msa-ssa-sp.
Example
chg-scr-blkdpc:sr=iec:ni=240:nc=010:ncm=010:nni=240:nnc=003:nncm=030
chg-scr-blkdpc:sr=iec:ni=c:nc=c:ncm=c:nsfi=cgpa:nsr=wrd2
chg-scr-blkdpc:sr=iec:ni=240:nc=010:ncm=010:nsfi=stop:actname=cr
chg-scr-blkdpc:sr=bdp1:npc=128:nsfi=fail:pcst=s:npcst=none
chg-scr-blkdpc:sr=iec:un=121:sna=10:mna=15:nun=50:nsna=5:nmna=10
Dependencies
Caution:
Even though gateway screening is in the screen test mode, as defined by the parameters gwsa=off and gwsm=on, the gateway screening action in the stop action set specified by the actname parameter of the screen set will be performed at the end of the screening process.The Gateway Screening Rules table can contain a maximum of 360,600 rules.
A complete point code must be specified, using the ni-nc-ncm, zone-area-id, msa-ssa-sp, un-sna-mna, or npc combination unless a value of c is specified.
A new point code entry must be specified by one and only one, of the five point code parameter combinations: nni-nnc-nncm, nzone-narea-nid, nun-nsna-nmna, nmsa-nssa-nsp, or nnpc. If the new point code entry is a different point code type than the existing point code entry, all subfields of the new point code type must be specified.
ANSI point code value 000-000-000 and ITU-International point code value 0-000-0 are not allowed.
At least one optional parameter must be specified.
The blocked DPC specified by ni-nc-ncm, zone-area-id, msa-ssa-sp, un-sna-mna or npc must already exist in the screening reference or within an existing range of DPCs.
The new blocked DPC or DPC range defined by ni-nc-ncm, zone-area-id, msa-ssa-sp, un-sna-mna or npc cannot already exist in the screening reference or within an existing range of DPCs.
If an asterisk (*) is specified for the new blocked DPC, nothing that matches the specified range of DPCs can already exist in the DPC screening table for the screening reference.
If the actname parameter is specified, the nsfi=stop parameter must be specified.
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.
If the area=* parameter is specified, then the id=* parameter must be specified.
If the msa=* parameter is specified, then the ssa=* and sp=* parameters must be specified.
If the un=* parameter is specified, then the sna=* and mna=* parameters must be specified.
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 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 ofcor must not be specified. If the un=c parameter is specified, and the sna and mna parameters are not specified, then the sna and mna parameters default to a value ofc.
If the nc parameter is specified as a range, the ncm parameter must be specified as an asterisk or as the full range (0–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 an asterisk, the ncm parameter must be specified as an asterisk or as the full range (0–255).
If the ncm parameter is specified as a single value, or a range other than the full range of 0–255, the ni and nc parameters must be specified with a single value.
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 (0–255).
If the ni=c parameter is specified, then the nc and ncm parameters must have a value of c or must not be specified. If the ni=c parameter is specified, and the nc and ncm parameters are not specified, then the nc and ncm parameters default to a value of c.
If the specified ni-nc-ncm, zone-area-id, un-sna-mna, or msa-ssa-sp is not equal to c-c-c, or if the npc=c parameter is not specified, then the nsfi=fail parameter must be specified, and the nsr parameter cannot be specified.
If the nnc parameter is specified as a range, the nncm parameter must be specified as an asterisk or as the full range (0–255).
If the nnc parameter is specified as a single value or a range, a single value must be specified for the nni parameter.
If the nnc parameter is specified as an asterisk, the nnm parameter must be specified as an asterisk or as the full range (0–255).
If the nncm parameter is specified as a single value, or a range other than the full range of 0–255, the nni and nnc parameters must be specified with a single value.
If the nni parameter is specified as an asterisk or as a range, the nnc and nncm parameters must be specified as an asterisk or as the full range (0–255).
If the value of the nsfi parameter is not stop or fail, then the nsr parameter must be specified.
If the nsfi=fail parameter is specified, then the nni, nc, nncm, narea, nzone, nid, nmsa, nssa, nsp, npc, nun, nsna, and nmna parameters cannot have a value of c.
The specified screening reference (sr) must already exist in the database.
The Spare Point Code Support feature must be enabled before the pcst parameter can be specified.
The pcst and npcst parameters cannot be specified with c for a blocked screen reference (sr).
The spare point code subtype prefix (s-) is not supported for ANSI point codes (parameters ni, nc, ncm) 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.
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.
If the zone=* parameter is specified, then the area=* and id=* parameters must be specified.
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 id parameters are not specified, then the area and id parameters default to a value of c.
The nsfi=fail parameter cannot be specified when changing a continue entry.
The nsfi and nsr parameters cannot be specified when changing a screening entry that is other than the continue entry (c-c-c).
The value of the nsfi parameter must be valid for the BLKDPC entity type.
The Gateway Screening Stop Action table is corrupt or cannot be found.
If the specified ni-nc-ncm, zone-area-id,msa-ssa-sp, or un-sna-mna is equal toc-c-cor if the npc=c parameter is specified, the nsfi=fail parameter cannot be specified, and the nni, nnc, nncm, nzone, narea, nid, nmsa, nssa, nsp nun, nsna, nmna, and nnpc parameters cannot be specified. Point codec-c-cand npc=c cannot be changed to a numbered point code.
The nsfi and nsr parameters must point to an existing screen, or the nsfi=stop parameter must be specified, and the nsr parameter cannot be specified.
The J7 support feature must be enabled before the un/sna/mna/nun/nsna/nmna parameters are specified.
The J7 support feature must not be enabled before the msa, ssa, sp, nmsa, nssa, or nsp parameters are specified.
The GWSOA parameter combination should be known and valid.
Notes
When a blocked DPC screening reference is created, the first entry for a point code must be c-c-c or npc=c parameter. Subsequent entries must be specific point codes.
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 is npc=c or subfields equal to c-c-c. When the character c is specified, the nsfi and nsr parameters must be specified.
If the character c is specified for the parameters ni-nc-ncm, zone-area-id, un-sna-mna, or msa-ssa-sp, the character c is the only value that can be specified for all three parameters. No other values can be used. For example, a point code c-c-255 is not allowed. The point code must be c-c-c. The asterisk (*) value cannot be used with the character c (for example, a point code c-c-* is not allowed).
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-c-c or npc=c. The nsfi and nsr in this entry are examined to determine the next step in the screening process.
If the current ni-nc-ncm, zone-area-id, un-sna-mna, or msa-ssa-sp is equal to c-c-c or npc=c, only the nsfi and nsr can be changed. Otherwise, only the blocked DPC can be changed.
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.
An asterisk cannot be specified for a parameter value in this command unless an asterisk was specified for the parameter value in the ent-scr-blkdpc
command.
If the screen set reaches 100% capacity (indicated by the 100% Full message), the system allows subsequent entries. An error occurs, however, when downloading the screen set to an LIM. Ensure that screen sets do not exceed 100% capacity. Remove screen set entries until the capacity is below 100%.
The spare point code subtype prefix (s-) is supported only for ITU international and ITU national point codes. The pcst and npcst parameters indicate whether the specified point code has no subtype prefix or has the spare point code prefix.
There is no feature dependency on ANSI point code parameters i.e., ni, nc, ncm, nni, nnc, or nncm. The command can be entered successfully whether the J7 feature is enabled or not enabled.
If there are more than 200 affected screensets and the force parameter is set to yes, then the following warning message is displayed: "WARNING: Command may take up to 30 minutes" and the command proceeds successfully.
If there are more than 200 affected screensets and the force parameter is set to no, then the following notice is displayed: "Notice: Force parameter is required for affected screensets greater than 200" and the command is aborted.
Output
chg-scr-blkdpc:sr=ss01:ni=240:nc=010:ncm=010:nni=240:nnc=003:nncm=030
rlghncxa03w 04-01-07 11:43:04 EST EAGLE 31.3.0
CHG-SCR-BLKDPC: SCREEN SET AFFECTED - SS01 25% FULL
CHG-SCR-BLKDPC: MASP A - COMPLTD
;
When there are more than 200 affected screensets and the force parameter is no:
chg-scr-blkdpc:sr=ss01:ni=240:nc=010:ncm=010:nni=240:nnc=003:nncm=030:force=no
Command entered at terminal #17.
;
tekelecstp 15-07-15 12:19:42 MST EAGLE5 46.3.0.0.0-66.10.0
CHG-SCR-BLKDPC: MASP A - Cannot access standby fixed disk.
CHG-SCR-BLKDPC: MASP A - Simplex database update.
Notice: Force parameter is required for affected screensets greater than 200
CHG-SCR-BLKDPC: MASP A - Command Aborted
When there are more than 200 affected screensets and the force parameter is yes:
chg-scr-blkdpc:sr=ss01:ni=240:nc=010:ncm=010:nni=240:nnc=003:nncm=030:force= yes
Command entered at terminal #17.
;
tekelecstp 15-07-15 14:10:31 MST EAGLE5 46.3.0.0.0-66.10.0
CHG-SCR-BLKDPC: MASP A - Cannot access standby fixed disk.
CHG-SCR-BLKDPC: MASP A - Simplex database update.
WARNING: Command may take upto 30 minutes.
-----------------------------------------
;
Command Accepted - Processing
tekelecstp 15-07-15 14:10:31 MST EAGLE5 46.3.0.0.0-66.10.0
Notice: The number of screensets affected is 201.
CHG-SCR-BLKDPC: SCREEN SET AFFECTED - s1 1% FULL
CHG-SCR-BLKDPC: SCREEN SET AFFECTED - s10 1% FULL
CHG-SCR-BLKDPC: SCREEN SET AFFECTED - s100 1% FULL
CHG-SCR-BLKDPC: SCREEN SET AFFECTED - s101 1% FULL
CHG-SCR-BLKDPC: SCREEN SET AFFECTED - s102 1% FULL
---------------------------------------------------
---------------------------------------------------
(List of affected screensets)
Related Topics