4.63 chg-gsmmap-scrn
Use this command to change the attributes of GSM Map Screening CgPA and CdPA entries that are used to filter out or allow SCCP messages containing Map Op-Codes, CgPA GTA+NPV+NAIV, CdPA GTA+NPV+NAIV, and forbidden parameters.
Parameters
Note:
See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.- opname (mandatory)
- The user-defined name for the operation code. The opname value references the operation code (opcode) defined with the
ent-gsms-opcode
command. GSM MAP Screening is performed on the specified address or addresses for the referenced operation code.
- force (optional)
- Check Mated Application Override. This parameter must be used to complete command execution if the npc/npca/npci/npcn and nssn parameter combination specified in the command is not already defined in the SCCP Application entity set (Remote Point Code/Mated Application Table).
- naction (optional)
- The new screening action to take if a message is forbidden as defined by the forbid parameter.
- Range:
-
- atierr
- Do not route the MSU. An ATI (Any Time Interrogation) reject message is generated to the originator. This value is valid only for ATI MAP operation codes.
- discard
- Do not route the MSU. The MSU is discarded (thrown away) and an appropriate UIM is issued.
- dupdisc
- Route the original message to the duplicate node. The original message will not be sent to the original node. If, however, the duplicate node is not available for routing, the MSU is discarded.
- duplicate
- Route the message as normal to the original destination and route a copy of the original message to the duplicate node. If the MSU fails to route to the duplicate node, a UIM is generated indicating the duplicate routing failure.
- forward
- Route the original message to the forward node. The original message will not be sent to the original node. If, however, the forward node is not available for routing, the MSU is routed to the original node.
- pass
- Route the message as normal to the destination; a UIM will be issued. This is intended to be a test mode and is recommended when setting up GSM Map Screening during the initial phase to assure that no MSUs will be inadvertently thrown away.
- route
- Route the message as normal to the original destination node; no UIM will be generated. The original destination is the node to which normal GTT would be sent if no GSM MAP actions are taken.
- Default:
- No change to current value
- nforbid (optional)
- The new forbidden parameter value. Indicates a forbidden parameter for the specified entry. If a forbidden parameter is detected, the message is handled with the action defined by the action/naction parameter.
- Range:
-
- all
- All parameters are forbidden. Take the specified screening action defined by the naction parameter for messages arriving at the system.
- none
- None of the parameters are forbidden. Route the message to its destination.
- state
- Take the specified screening action defined by the naction parameter for messages arriving at the system that contain state as the forbidden parameter for the entered address/operation code combination.
Note:
The state parameter is valid only for GSM ATI messages. - location
- Take the specified screening action defined by the naction parameter for messages arriving at the system that contain location as the forbidden parameter for the entered address/operation code combination.
Note:
This value is valid only for GSM ATI messages.
- Default:
- No change to current value
- npc (optional)
- New ANSI point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm).
- npc/npca/npci/npcn/npcn24 (optional)
- New point code. The npc/npca/ npci/npcn /npcn24 and nssn parameters are used when the new screening action (naction) is forward, duplicate, or dupdisc (duplicate and discard). These parameters allow the user to change the defined node to which the input message will be routed.
- npci (optional)
- New ITU international destination point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id).
- npcn (optional)
- New ITU national destination point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members) separated by dashes (m1-m2-m3-m4) as defined by the
chg-stpopts:npcfmti
flexible point code option. A group code must be specified when the ITUDUPPC feature is turned on (nnnnn-gc,m1-m2-m3-m4-gc). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).
- npcn24 (optional)
- New 24-bit ITU national point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).
- nri (optional)
- New routing indicator. This parameter specifies whether a subsequent global title translation is required.
Example
chg-gsmmap-scrn:opname=xyz:cgsr=fela:naction=pass
chg-gsmmap-scrn:opname=xyz:cgsr=fela:cdsr=fall:naction=discard
chg-gsmmap-scrn:opname=test2:cgsr=pcn1:npcn=s-333:nssn=254
chg-gsmmap-scrn:opname=test1:naction=forward:npc=2-2-2:nssn=20:nmapset=12
chg-gsmmap-scrn:opname=test2:naction=duplicate:npc=1-1-2:nssn=20:cgsr=cg1:nmapset=dflt
chg-gsmmap-scrn:opname=test3:cgsr=ad:nri=ssn
chg-gsmmap-scrn:opname=test4:cgsr=ksl:ntt=12
Dependencies
At least one optional parameter must be specified.
If the cdsr parameter is specified, at least one additional optional parameter must be specified.
If the ncdsr parameter is specified, then the cdsr parameter must be specified.
If the cdsr parameter is specified, then the ncgsr parameter cannot be specified.
The ncgsr parameter and the ncdsr parameter cannot be specified together in the same command.
The specified cgsr parameter value must exist in the database.
The specified cdsr parameter value must exist in the database.
The specified ncgsr parameter value cannot already exist in the database.
The specified ncdsr parameter value cannot already exist in the database.
The GSM Map Screening feature must be turned on before this command can be entered.
The Enhanced GSM Map Screening (EGMS) feature must be turned on before the cdsr, ncdsr, pc, and pca parameters can be specified.
The specified opname parameter value must exist in the GSM Map Op-Code table.
A value of state or location cannot be specified for the nforbid parameter unless the operation code (opcode) referenced by the opname parameter is 71. The opcode=71 parameter signifies an ATI MAP operation code.
A value of atierr cannot be specified for the naction parameter unless the operation code (OPCODE) referenced by opname is 71.
If specified, the npc/npca/npci/ npcn/npcn24 parameter must be a full point code.
If the naction parameter is specified, and its value is forward, duplicate, or dupdisc, then the npc/npca/npci/npcn/npcn24 parameter and the nssn parameter must be specified.
The npc/npca/npci/npcn/npcn24 and nssn parameters must be specified before the force parameter can be specified.
If the npc/npca/npci/npcn/npcn24 parameter and the nssn parameter are specified, and the force parameter is not specified as yes, the PC-SSN must be populated in the SCCP Application entity set (Remote Point Code / Mated Application Table).
The GSM Map screening table must be accessible.
The GSM Map Op-Code table must be accessible.
The Route table must be accessible.
If specified, the npc/npca/npci/npcn/npcn24 parameter value must exist as a destination in the Ordered Route entity set (ANSI only), or must reside in a cluster that exists as a destination in the Ordered Route entity set (for global title routing).
The npc/npca/npci/npcn/npcn24 and nssn parameters can be specified only if the naction parameter is specified and its value is forward, duplicate, or dupdisc.
The opname parameter must be entered.
The cgsr parameter must be entered.
The opname parameter must be alphanumeric.
The (n)cgsr and (n)cdsr parameters must begin with an alphabetic character.
The (n)cgsr and (n)cdsr parameters must have 1-4 alphanumeric characters each.
If the value of the naction parameter is forward, duplicate, or dupdisc, then the nmapset parameter must be specified.
The naction parameter must have a value of forward, duplicate, or dupdisc before the npc/npca/npci/npcn/npcn24, nssn,nri, ntt, or naction parameters can be specified.
If the naction parameter has a value of forward, duplicate, or dupdisc, then the npc/npca/npci/npcn/npcn24 parameter and the nssn parameter must be specified.
The Flexible GTT Load Sharing feature must be enabled before the nmapset parameter can be specified.
The specified new MAP set must exist in the MAP table.
If the value of the nmapset parameter is not dflt, or if the nmapset=dflt parameter is specified, but the value of the force parameter is not yes, then the values for the npc and nssn parameters must exist in the new MAP set.
If the nmapset, nri, or ntt parameter is specified, and the naction parameter is not specified, then the action parameter (see the ent-gsmmap-scrn
command) must have a value of forward, duplicate, or dupdisc.
The MAP table must be accessible.
The force parameter can be specified only if the nmapset parameter is specified.
If the value of the naction parameter is forward, duplicate, or dupdisc, then the value specified for the npc/npca/npci/npcn/npcn24 parameter cannot be associated with a proxy point code.
If the nri=ssn parameter is specified, then the nssn=none parameter cannot be specified.
If the nforbid=none parameter is specified, then the naction parameter must have a value of pass.
If the Flexible GTT Load Sharing feature is enabled, and the new or previously provisioned subsystem number has a value of none, then MAP set and point code combination must already exist in the MAP table.
If the Flexible GTT Load Sharing feature is not enabled, and the new or previously provisioned subsystem number has a value of none, then the point code must already exist in the MAP table.
Notes
Unlike GTT (Global Title Translation) entries, the GSM MAP Screening commands do not support splits of ranges during deletion or changes of entries.
In this command, only ITU-international and ITU national point codes support the spare point code subtype prefix (s-).
Output
chg-gsmmap-scrn:opname=test4:cgsr=ksl:ntt=12
tekelecstp 08-08-20 19:13:01 EST EAGLE 39.2.0
GSM MAP Screening Table (1 of 4000) is 1% full
CHG-GSMMAP-SCRN: MASP A - COMPLTD
;
Related Topics