ent-gsms-opcode

Use this command to assign the concerned GSM (Global System for Mobile Telecommunication) MAP (mobile application part) screening operation codes and the default screening action for the operation code. This command allows the craftsperson to provision a list of all operation codes that the system uses in performing GSM screening.

Parameters

Note:

See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.

opcode (mandatory)

MAP operation code. This parameter refers to the actual decimal value of the MAP operation codes from the TCAP layer of GSM MAP messages.

Range:: 0 - 255, *
If a decimal Map Opcode is not found in the database, then the asterisk (wildcard *), if provisioned, will constitute a match when screening the MSUs.

opname (mandatory)

Operation code name. The opname value is defined with the ent-gsmmap-scrn command.

Range:: ayyyyyyy
Up to 8 alphanumeric characters

dfltact (optional)

Default screening action for a MAP operation code. The default screening action is used when a matching CGPA address+NPV+NAIV entry is not found in the GSM MAP screening table.

Range:

atierr: Do not route the MSU. An ATI (Any Time Interrogation) reject message is generated. This option is only valid 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.
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:

discard

force (optional)

Check Mated Application Override. This parameter must be used to complete command execution if the pc/pca/pci/pcn/pcn24 and ssn parameter combination (if the ssn parameter has a value other than none) specified in the command is not already defined in the SCCP Application entity set (Remote Point Code/Mated Application Table).

Range:

yes
no

Default:

no

mapset (optional)

MAP set ID.

Range:: 1 - 36000, dflt
dflt —Default MAP set

pc (optional)

ANSI point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm).

Synonym:

pca

Range:

000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

When chg-sid:pctype=ansi is specified, ni = 000 is not valid.

When chg-sid:pctype=ansi is specified, nc = 000 is not valid if ni = 001–005.

When chg-sid:pctype=ansi is specified, nc = 000 is valid if ni = 006–255.

The point code 000-000-000 is not a valid point code.

pc/pca/pci/pcn/pcn24 (optional): Point code. The pc/pca/pci/ncn/pcn24 and ssn parameters allow the user to change the defined node to which the input message will be routed.

pci (optional)

ITU international point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id).

Range:

s-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

pcn (optional)

ITU national 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).

Range:

s-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

pcn24 (optional)

24-bit ITU national point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).

Range:

000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

msa—000–255

ssa—000–255

sp—000–255

ri (optional)

Routing indicator. This parameter specifies whether a subsequent global title translation is required.

Note:

This parameter can be specified only when the value specified for the dfltact parameter is forward, duplicate, or dupdisc.

Range:

gt
ssn

System Default:

ssn

ssn (optional)

Subsystem Number. The pc/pca/pci/pcn/pcn24 and ssn parameters are used to change the defined node where the input message will be routed.

Range:: 002 - 255
Default:: none

tt (optional)

Translation type. The value that the CdPA TT is set to as the result of Enhanced GSM Map Screening.

The parameter can be specified only if the value specified for the dfltact parameter is forward, duplicate, or dupdisc.

Range:: 0 - 255, none
Default:: none

Example

This example adds a MAP operation code of 71 with a name of ATI with a default action of DISCARD:

ent-gsms-opcode:opcode=71:opname=ati:dfltact=discard

This example adds a MAP operation code of 71 with a name of ATI, a default action of FORWARD, an international point code of 1, a subsystem number of 5, and forces:

ent-gsms-opcode:opcode=71:opname=ati:dfltact=forward:pci=1-1-1:ssn=5:force=yes

This example adds a MAP operation code of 71 with a name of ATI, a default action of DUPLICATE, an international point code of 1, a subsystem number of 5, and forces:

ent-gsms-opcode:opcode=71:opname=ati:dfltact=duplicate:pci=1-1-1:ssn=5:force=yes

This example adds a MAP operation code of 71 with a name of ATI, a default action of DUPDISC, an international point code of 1, a subsystem number of 5, and forces:

ent-gsms-opcode:opcode=71:opname=ati:dfltact=dupdisc:pci=1-1-1:ssn=5:force=yes

This example adds a MAP operation code of * with a name of XYZ, a default action of DUPLICATE, an ANSI point code of 8, a subsystem number of 20:

ent-gsms-opcode:opcode=*:opname=xyz:pca=8-8-8:dfltact=duplicate:ssn=20

This example adds a MAP operation code of 22 with a name of ATI with a default action of DISCARD:

ent-gsms-opcode:opcode=22:opname=ati:dfltact=discard

This example shows a spare point code:

ent-gsms-opcode:opname=test3:opcode=3:pci=s-1-1-1:dfltact=duplicate:ssn=10:force

This example shows a MAP set value. The Flexible GTT Load Sharing feature is ON.

ent-gsms-opcode:opname=test3:opcode=3:pc=1-1-1:dfltact=duplicate:ssn=10:mapset=7

This example adds a MAP operation code of 27 with a name of TEST3, a default action of FORWARD, an ANSI point code of 1, a subsystem number of 12 and a routing indicator of GT:

ent-gsms-opcode:opname=test3:opcode=27:dfltact=forward:pca=1-1-2:ssn=12:ri=gt

This example shows a translation type value:

ent-gsms-opcode:opname=test4:opcode=32:dfltact=forward:mapset=dflt:pc=1-2-3:ssn=12:tt=11

Dependencies

The GSM Map Screening feature must be turned on before this command can be entered.

A valid value must be specified for the dfltact parameter.

The opcode parameter value must be specified as a number in the range 0-255 or as *.

The reserved word none cannot be specified as a value for the opname parameter.

The pc/pca/pci/pcn/pcn24 and ssn parameters can be specified only if the dfltact parameter is specified and its value is forward, duplicate, or dupdisc.

If the dfltact parameter is specified with a value of forward, duplicate, or dupdisc, then the pc/pca/pci/pcn/pcn24 and ssn parameter must be specified.

The force parameter can be specified only if the pc/pca/pci/pcn/pcn24 and the ssn parameters are specified.

The dfltact=atierr parameter cannot be specified unless the value of the operation code referenced by the opname parameter is 71. The atierr option is valid only for ATI MAP operation codes, and the opcode=71 parameter signifies an ATI MAP operation code.

The value specified for the opcode parameter cannot already exist in the GSM Map Op-Code table.

The value specified for the opname parameter cannot already be used in the GSM Map Op-Code table.

If the pc/pca/pci/pcn/pcn24 and ssn parameters are specified, and the force parameter is not specified as yes, then the PC-SSN must exist in the SCCP Application entity set (Remote Point Code / Mated Application Table).

The Enhanced GSM Map Screening feature must be enabled and turned on before the opcode=* parameter can be specified.

If specified, the pc/pca/pci/pcn /pcn24 parameter value must be a full point code.

The GSM MAP Op-Code table must be accessible.

The Route table must be accessible.

If specified, the pc/pca/pci/pcn/pcn24 parameter value must exist as a destination in the Ordered Route entity set or reside in a cluster (ANSI only) that exists as a destination in the Ordered Route entity set (for global title routing).

The Enhanced GSM Map Screening feature must be enabled and turned on when the PC/PCA is specified.

The opname parameter must consist of alphanumeric characters.

The opname parameter must be no more than 8 characters in length.

If the mapset, ri, or tt parameter is specified, then the value specified for the dfltact parameter must be forward, duplicate, or dupdisc.

If the dfltact parameter is specified as forward, duplicate, or dupdisc, then the mapset parameter must be specified.

The Flexible GTT Load Sharing feature must be enabled before the mapset parameter can be specified.

The specified MAP set must exist.

If the mapset parameter is not specified as dflt, or if the mapset=dflt parameter is specified, and the force parameter is not specified as yes, then the specified PC/SSN must exist in the specified MAP set.

The MAP table must be accessible.

If the dfltact parameter has a value of forward, duplicate, or dupdisc, then the value specified for the pc/pca/pci/pcn/pcn24 parameter cannot be associated with a proxy point code.

If the ri=ssn parameter is specified, then the ssn=none parameter cannot be specified.

If the FGTTLS feature is enabled, the mapset parameter is specified and the ssn parameter is not specified or has a value of none, then the specified MAPSET/PC combination must already exist in the MAP table.

If the FGTTLS feature is not enabled and the ssn parameter is not specified or has a value of none, then the specified point code must already exist in the MAP table.

Notes

Origination Addresses are considered to be the SCCP CGPA address as well as the Numbering Plan and Nature of Address values.

In this command, only ITU-international and ITU national point codes support the spare point code subtype prefix (s-).

Output

ent-gsms-opcode:opname=test3:opcode=3:pc=1-1-1:dfltact=duplicate:ssn=10:mapset=7


    tekelecstp 06-05-29 13:21:58 EST  EAGLE 35.0.0
    ENT-GSMS-OPCODE: MASP A – COMPLTD 
;

ent-gsms-opcode:opname=test3:opcode=27:dfltact=forward:pca=1-1-2:ssn=12:ri=gt


    tekelecstp 08-01-18 16:56:43 EST  EAGLE 38.0.0
    ENT-GSM-OPCODE: MASP A - COMPLTD 
;

ent-gsms-opcode:opname=test4:opcode=32:dfltact=forward:mapset=dflt:pc=1-2-3:ssn=12:tt=11


    tekelecstp 08-08-20 19:13:01 EST  EAGLE 39.2.0
    ENT-GSM-OPCODE: MASP A - COMPLTD 
;

4.299 ent-gsms-opcode