4.298 ent-gsmmap-scrn

Use this command to assign the GSM (Global System for Mobile Telecommunication) MAP (Mobile Application Part) screening entries that filter or allow TCAP messages for certain MAP operation codes. The messages are filtered or allowed based on CgPA GTA+NPV+NAIV, CdPA GTA+NPV+NAIV, and forbidden (forbid) parameters. Each CgPA entry is associated with one or more CdPA entries and one or more CgPA entries are associated with a MAP Opcode. This command provisions both CgPA and CdPA entries into the database.

Parameters

Note:

See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.
cgsr (mandatory)
CGPA screening reference. This parameter specifies a CGPA entry for an OPNAME.
Range:
ayyy

1 alphabetic character and up to 3 optional alphanumeric characters

opname (mandatory)
Operation code name. This parameter 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.
Range:
ayyyyyyy

Up to 8 alphanumeric characters

action (optional)
The screening action to take if a message is forbidden as defined by the forbid parameter.
Range:
atierr
Generate an ATI reject message. This option is only valid for ATI MAP operation codes.
discard
Discard the MSU
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
cdsr (optional)
CDPA screening reference. A CDPA entry for a combination of CGSR and OPNAME.
Range:
ayyy

1 alphabetic character and up to 3 optional alphanumeric characters

eaddr (optional)
Ending CDPA address. This parameter is used with the npv, naiv, cgsr, and cdsr parameters.
Range:
1-15 digits

Valid digits are 0–9, a-f, A-F

forbid (optional)
Forbidden parameter value. A forbidden parameter for the entered address. If a forbidden parameter is detected, then the message is rejected by the action defined by the action parameter.
Range:
all
All parameters are forbidden. Take the specified screening action defined by the action 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:

The location parameter is valid only for GSM ATI messages.
Default:
all
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

naiv (optional)
Nature of Address value for the address or range of CgPA and CdPA addresses. If a message is screened and does not contain matching npv and naiv values, the message is rejected. The message is rejected with the default action defined by the ent-gsms-opcode command for the operation code (opcode) parameter entry referenced by the operation name (opname) parameter.

This parameter must be specified with the npv parameter.

Range:
0 - 127, *
Default:
*
npv (optional)
Numbering Plan value for the address or range of CgPA and CdPA addresses. If a message is screened and does not contain matching npv and naiv values, the message is rejected. The message is rejected with the default action defined by the ent-gsms-opcode command for the operation code (opcode) parameter entry referenced by the operation name (opname) parameter.

This parameter must be specified with the naiv parameter.

Range:
0 - 15, *
Default:
*
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 Point Code and SSN parameters are used to enter the 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.

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

Range:
gt
ssn
System Default:
ssn
saddr (optional)
Starting origination address.

With the npv, naiv, and cgsr parameters, this parameter is for a single CGPA entry or the starting CGPA address in the range to be screened.

With the npv, naiv, and cdsr parameters, this parameter is for a single CDPA entry or the starting CDPA address in the range to be screened.

Range:
1-15 digits, *

Valid digits are 0–9, a-f, A-F

Default:
*
ssn (optional)
Subsystem Number. The Point Code and SSN are used to change the defined node where the input message will be routed.
Range:
002 - 255, none
Default:
none
tt (optional)
Translation type. The value that the CdPA TT is set to as the result of Enhanced GSM Map Screening.

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

Range:
0 - 255, none
Default:
none

Example

The following example adds a MAP OPNAME of ATI with a range of allowed addresses, defines a forbidden parameter for that range of addresses and an action to take if the forbidden parameter is detected, and sets the NPV and NAIV values. This example is wrapped to the next line for readability:

ent-gsmmap-scrn:saddr=919461:eaddr=919462:opname=ati:action=discard:forbid=state :npv=1:naiv=4:cgsr=fela

The following example adds a MAP OPNAME of ATI of with a range of allowed addresses, defines a forbidden parameter for that range of addresses and an action to take if the forbidden parameter is detected, and sets the NPV and NAIV values. The command also defines an ITU International Point Code with Subsystem Number 5, and forbids by location messages that have an action of forward. This example is wrapped to the next line for readability:

ent-gsmmap-scrn:saddr=919461:eaddr=919462:opname=ati:action=forward:pci=1-1-1 :ssn=5:force=yes:forbid=location:cgsr=fela

The following example adds a MAP OPNAME of XYZ with an allowed hexadecimal address of abcdefabcdefabc, defines the action discard to take if a forbidden parameter is detected, and sets the NPV and NAIV values. The command also defines a CGSR of FELA. This example is wrapped to the next line for readability:

ent-gsmmap-scrn:opname=xyz:saddr=abcdefabcdefabc:npv=10:naiv=10:cgsr=fela :action=discard

ent-gsmmap-scrn:opname=test2:cgsr=t1:cdsr=cd3:saddr=125:pci=s-1-1-1:ssn=10 :action=duplicate

ent-gsmmap-scrn:opname=test2:cgsr=cg1:cdsr=cd1:saddr=125:pci=1-1-1:ssn=10 :action=duplicate:mapset=11

ent-gsmmap-scrn:opname=test3:cgsr=ad:action=forward:pc=1-1-2:ssn=12:ri=gt

ent-gsmmap-scrn:opname=test4:cgsr=ksl:action=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.

The EGMS feature must be turned on before:

  • The saddr=* parameter can be specified.
  • Values for the saddr and eaddr parameters can contain hexadecimal digits.
  • The cdsr parameter can be specified.
  • The pc/pca parameter can be specified.

If the eaddr parameter is specified, the saddr parameter must be specified.

If the eaddr parameter is specified, then its value must contain the same number of digits as the value of the saddr parameter.

If the eaddr parameter is specified, its value must be greater than the saddr parameter value.

If the saddr=* parameter is specified, then the eaddr parameter cannot be specified.

If the opname parameter is specified, its value must exist in the GSM MAP Op-Code table.

A value of state or location cannot be specified for the forbid parameter unless the operation code (opcode) referenced by the opname parameter is 71.

The action=atierr parameter cannot be specified unless the operation code (opcode) referenced by the opname parameter is 71.

The GSM MAP Screening table cannot be full.

The GSM MAP Screening table must have at least two free entries to provision a CgPA entry, because a default wildcard CdPA entry is created for each CgPA entry.

If a single entry is specified for the CgPA/CdPA (the eaddr parameter is not specified), then the combination of saddr/npv/naiv and opname parameters cannot already exist in the GSM MAP screening table.

If a range entry is specified for the CgPA/CdPA (the eaddr parameter is specified), then the saddr/eaddr/npv/naiv and opname combination cannot already exist or overlap another range entry in the GSM MAP screening table.

If a CdPA entry is being created, then the CGSR must already exist for the specified OPNAME.

If a CgPA entry is being created, the CGSR cannot already exist for the specified OPNAME.

The specified cdsr cannot already exist for the specified cgsr.

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

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

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

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

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 be populated in the SCCP Application entity set (Remote Point Code/MAP Table).

The values for the npv and naiv parameters must both be numbers or asterisks (*).

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 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 opname parameter must consist of alphanumeric characters.

The opname parameter must be entered.

The cgsr parameter must be entered.

The saddr and eaddr parameters must each be between 1 - 15 digits in length.

The npv parameter must be in range (0 - 15, *).

The naiv parameter must be in range (0 - 127, *).

The saddr parameter must have valid hexadecimal digits (0 – 9, a-f, A-F, or *).

The eaddr parameter must have valid hexadecimal digits (0 – 9, a - f, A - F).

The cgsr and cdsr parameters must each begin with an alphabetic character.

The cgsr and cdsr parameters must each consist of 1-4 alphanumeric characters.

If the action parameter has a value of forward, duplicate, or dupdisc, then the mapset parameter must be specified.

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

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

The specified MAP set must exist.

If the value of the mapset parameter is not dflt, then the specified PC/SSN must exist in the specified MAP set.

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 action 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 forbid=none parameter is specified, then the action=pass parameter must 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

GSM screening entries are handled differently from other screening entries such as GWS (gateway screening) in the system database. The following differences apply to provisioning GSM screening entries:

  • GSM screening entries can be either single entries or range entries.
  • Single entries have precedence in screening over range entries. Thus the single entries are searched first and if a match is found, the range entries are never searched.
  • Range entries can overlap single entries.

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

Output

ent-gsmmap-scrn:opname=test2:cgsr=cg1:cdsr=cd1:saddr=125:pci=1-1-1:ssn=10:ac tion=duplicate:mapset=11

    tekelecstp 06-05-29 13:24:41 EST  EAGLE 35.0.0
    GSM Map Screening table is (1 of 4000) 1% full
    ENT-GSMMAP-SCRN: MASP A – COMPLTD 
;
ent-gsmmap-scrn:opname=test3:cgsr=ad:action=forward:pc=1-1-2:ssn=12:ri=gt

    tekelecstp 08-01-18 17:03:01 EST  EAGLE 38.0.0
    GSM MAP Screening Table (4 of 4000) is 1% full
    ENT-GSMMAP-SCRN: MASP A - COMPLTD 
;
ent-gsmmap-scrn:opname=test4:cgsr=ksl:action=forward:mapset=dflt:pc=1-2-3:ssn=12:tt=11

    tekelecstp 08-08-20 19:13:01 EST  EAGLE 39.2.0
    GSM MAP Screening Table (1 of 4000) is 1% full
    ENT-GSMMAP-SCRN: MASP A - COMPLTD 
;