4.488 rtrv-gsmmap-scrn

Use this command to retrieve the GSM (Global System for Mobile Telecommunication) MAP (Mobile Application Part) Screening CgPA and CdPA entries and their attributes from the active system database.

Parameters

opname (mandatory)
User-defined name for the operation code. This value references the operation code defined with the ent-gsms-opcode command.
Range:
ayyyyyyy

Up to 8 alphanumeric characters

action (optional)
Screening action to take if a message is forbidden as defined by the forbid parameter.
Range:
pass
Route the message as normal to the destination.
discard
Discard the MSU.
atierr
Generate an ATI reject message. This option is only valid for ATI MAP operation codes.
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.
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.
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.
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 routed to the original node.
Default:
Display all screening actions
cdsr (optional)
CdPA Screening Reference.
Range:
ayyy

1 alphabetic character followed by up to 3 optional alphanumeric characters

cgsr (optional)
CgPA Screening Reference.
Range:
ayyy

1 alphabetic character followed by up to 3 optional alphanumeric characters

eaddr (optional)
Ending origination address, in association with npv and naiv for the CGPA address to be screened.
Range:

1–15 hexadecimal digits. Valid digits are 0–9, a-f, A-F

forbid (optional)
Forbidden parameter value. Indicates a forbidden parameter for the entered address. If a forbidden parameter is detected 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.
location
Take the specified screening action defined by the action parameter for messages arriving at the system that contain location as the forbidden parameter value for the entered address/operation code combination. This value is valid only for GSM ATI messages.
none
None of the parameters are forbidden. Route the message to its destination.
state
Take the specified screening action defined by the action parameter for messages arriving at the system that contain state as the forbidden parameter value for the entered address/operation code combination. This value is valid only for GSM ATI messages.
Default:
Display all forbidden parameter values
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.
Range:
0 - 127, *
npv (optional)
Numbering Plan value for the address or range of CgPA and CdPA addresses.
Range:
0 - 15, *
ri (optional)
Routing indicator. This parameter specifies whether a subsequent global title translation is required.
Range:
gt
ssn
saddr (optional)
Starting origination address in association with npv and naiv for the single entry or range of entries of the CGPA address to be screened.
Range:
1 - 15 digits, *

1–15 hexadecimal digits. Valid digits are 0–9, a-f, A-F

Default:
*
tt (optional)
Translation type. This parameter specifies the value that the CdPA translation type is set to as the result of Enhanced GSM Map Screening.
Range:
0 - 255, none
Default:
Display all translation types

Example

The following example retrieves all CgPA entries for the specified OPNAME:

rtrv-gsmmap-scrn:opname=e

The following example retrieves the specified CgPA range entry for the specified OPNAME:

rtrv-gsmmap-scrn:opname=ati:saddr=919462000000000:eaddr=919463000000000

The following example retrieves all CdPA entries for the specified CGSR:

rtrv-gsmmap-scrn:opname=xyz:cgsr=fela

The following example retrieves the specified CDSR entry for the specified CGSR:

rtrv-gsmmap-scrn:opname=xyz:cgsr=fela:cdsr=cal4

The following examples retrieves the specified RI for the specified OPNAME:

rtrv-gsmmap-scrn:opname=e:ri=ssn

rtrv-gsmmap-scrn:opname=e:mapset=dflt:ri=gt

rtrv-gsmmap-scrn:opname=rr:cgsr=au:cdsr=aj

rtrv-gsmmap-scrn:opname=test4:tt=12

Dependencies

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

The Enhanced GSM Map Screening (EGMS) feature must be enabled before:

  • The cgsr parameter can be specified.
  • The cdsr parameter can be specified.
  • The saddr=* parameter can be specified.
  • The saddr and eaddr parameters can contain hexadecimal digits.

The specified opname parameter value must exist in the GSM Map Op-Code table.

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

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

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

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

If the saddr parameter is specified, the cgsr and cdsr parameters cannot be specified.

The saddr, npv, and naiv parameters must be specified together in the command.

If any of the saddr/eaddr/npv/naiv and cdsr parameters are specified, then the forbid and action parameters cannot be specified.

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

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

The GSM Map Op-Code table must be accessible.

The GSM Map Screening table must be accessible.

If the cdsr parameter is specified, then the cgsr parameter must be specified.

The specified cgsr parameter value must exist in the database.

The specified cdsr parameter value must exist in the database.

The opname parameter must consist of alphanumeric characters.

The opname parameter must be entered.

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.

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

The specified MAP set must exist.

Notes

None

Output

GSM MAP Screening single entries and range entries shown in separate sections of the output. All single entries are shown first in a summary report; all range entries follow.

rtrv-gsmmap-scrn:opname=e

    tekelecstp 08-08-22 00:33:10 EST  EAGLE 39.2.0

    Single CgPA Entries for OPNAME: e

    ----------------------------------------

    SADDR           NP NAI FORBD ACT      PCA           SSN CGSR RI     TT
    1111            2  3   all   fwd      001-001-002   12  ad   gt     11

    SADDR           NP NAI FORBD ACT      PCI           SSN CGSR RI     TT

    SADDR           NP NAI FORBD ACT      PCN           SSN CGSR RI     TT

    SADDR           NP NAI FORBD ACT      PCN24         SSN CGSR RI     TT

    SADDR           NP NAI FORBD ACT  CGSR

    Range CgPA Entries for OPNAME: e
    ---------------------------------------

    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CGSR
    1234            3452            *  *   all   fwd      001-001-002   12  as
    RI=gt  TT=11

    SADDR           EADDR           NP NAI FORBD ACT      PCI           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN24         SSN CSGR

    SADDR           EADDR           NP NAI FORBD ACT   CGSR

    GSM MAP Screening Table (8 of 4000) is 1% full 
;
The following example shows the output when the Flexible GTT Load Sharing feature is on. rtrv-gsmmap-scrn:opname=dd

    tekelecstp 08-08-22 00:45:11 EST  EAGLE 39.2.0

    Single CgPA Entries for OPNAME: dd
    ----------------------------------------

    SADDR           NP NAI FORBD ACT      PCA           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCI           SSN CGSR    MAPSET   RI
    *               *  *   all   fwd      1-221-2       13  ab      DFLT     gt
    TT=11

    SADDR           NP NAI FORBD ACT      PCN           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCN24         SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT  CGSR

    Range CgPA Entries for OPNAME: dd
    ---------------------------------------

    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCI           SSN CGSR
    1234            3452            *  *   all   fwd      1-221-2       13  ak
    MAPSET=DFLT RI=gt  TT=11

    SADDR           EADDR           NP NAI FORBD ACT      PCN           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN24         SSN CSGR

    SADDR           EADDR           NP NAI FORBD ACT   CGSR

    GSM MAP Screening Table (14 of 4000) is 1% full 
;

This example shows the output for a specific MAP set. The Flexible GTT Load Sharing feature is on.

rtrv-gsmmap-scrn:opname=rr:mapset=1

    tekelecstp 08-01-22 00:59:18 EST  EAGLE 38.0.0

    Single CgPA Entries for OPNAME: rr
    ----------------------------------------
    
    SADDR           NP NAI FORBD ACT      PCA           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCI           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCN           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCN24         SSN CGSR    MAPSET   RI

    Range CgPA Entries for OPNAME: rr
    ---------------------------------------

    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CGSR
    1234            3452            *  *   all   fwd      001-001-002   12  au
    MAPSET=1 RI=gt  TT=11

    SADDR           EADDR           NP NAI FORBD ACT      PCI           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN24         SSN CSGR

    GSM MAP Screening Table (26 of 4000) is 1% full 
;

This example shows the output for the subsystem number routing indicator.

rtrv-gsmmap-scrn:opname=e:ri=ssn

    tekelecstp 08-08-21 15:40:00 EST EAGLE 39.2.0
    
    Single CgPA Entries for OPNAME: e
    ----------------------------------------

    SADDR           NP NAI FORBD ACT      PCA           SSN CGSR    RI     TT
    *               *  *   all   fwd      001-001-002   12  ad      ssn    11

    SADDR           NP NAI FORBD ACT      PCI           SSN CGSR    RI     TT

    SADDR           NP NAI FORBD ACT      PCN           SSN CGSR    RI     TT

    SADDR           NP NAI FORBD ACT      PCN24         SSN CGSR    RI     TT
    
    Range CgPA Entries for OPNAME: e
    ---------------------------------------

    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CGSR
    *               *               *  *   all   fwd      001-001-002   12  d   
    RI=ssn TT=11

    SADDR           EADDR           NP NAI FORBD ACT      PCI           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN           SSN CGSR
    
    SADDR           EADDR           NP NAI FORBD ACT      PCN24         SSN CSGR
    
    SADDR           EADDR           NP NAI FORBD ACT   CGSR    

    GSM MAP Screening Table (4 of 4000) is 1% full 
;

This example shows the output for the global translation routing indicator and a specified mapset:

rtrv-gsmmap-scrn:opname=e:mapset=dflt:ri=gt

    tekelecstp 08-08-22 00:57:57 EST  EAGLE 39.2.0

    Single CgPA Entries for OPNAME: e
    ----------------------------------------

    SADDR           NP NAI FORBD ACT      PCA           SSN CGSR    MAPSET   RI
    1111            2  3   all   fwd      001-001-002   12  ad      DFLT     gt
    TT=11

    SADDR           NP NAI FORBD ACT      PCI           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCN           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCN24         SSN CGSR    MAPSET   RI

    Range CgPA Entries for OPNAME: e
    ---------------------------------------

    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CGSR
    1234            3452            *  *   all   fwd      001-001-002   12  as
    MAPSET=DFLT RI=gt  TT=11

    SADDR           EADDR           NP NAI FORBD ACT      PCI           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN24         SSN CSGR

    GSM MAP Screening Table (26 of 4000) is 1% full 
;

This example shows the output for called and calling party screening references:

rtrv-gsmmap-scrn:opname=rr:cgsr=au:cdsr=aj

    tekelecstp 08-08-22 00:58:55 EST  EAGLE 39.2.0
    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CDSR
    1234            3452            *  *   all   fwd      001-001-002   12  aj
    MAPSET=1 RI=gt  TT=11
    GSM MAP Screening Table (26 of 4000) is 1% full 
;

This example shows the output for a calling party screening reference.

rtrv-gsmmap-scrn:opname=dd:cgsr=ak

    tekelecstp 08-08-22 00:44:34 EST  EAGLE 39.2.0

    Single CdPA Entries for OPNAME: dd and CGSR: ak
    -------------------------------------------------------

    SADDR           NP NAI FORBD ACT      PCA           SSN CDSR RI     TT

    SADDR           NP NAI FORBD ACT      PCI           SSN CDSR RI     TT
    3476            *  *   all   fwd      1-221-2       13  gu   gt     11

    SADDR           NP NAI FORBD ACT      PCN           SSN CDSR RI     TT

    SADDR           NP NAI FORBD ACT      PCN24         SSN CDSR RI     TT

    SADDR           NP NAI FORBD ACT   CDSR

    Range CdPA Entries for OPNAME: dd and CGSR: ak
    ------------------------------------------------------

    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CDSR

    SADDR           EADDR           NP NAI FORBD ACT      PCI           SSN CDSR
    1234            3452            *  *   all   fwd      1-221-2       13  gh
    RI=gt  TT=11

    SADDR           EADDR           NP NAI FORBD ACT      PCN           SSN CDSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN24         SSN CDSR

    SADDR           EADDR           NP NAI FORBD ACT   CDSR

    GSM MAP Screening Table (14 of 4000) is 1% full 
;

This example shows the output for a specified translation type.

rtrv-gsmmap-scrn:opname=test4:tt=12

    tekelecstp 08-08-18 17:26:42 EST  EAGLE 39.2.0
    
    Single CgPA Entries for OPNAME: test4
    ----------------------------------------
    SADDR           NP NAI FORBD ACT      PCA           SSN CGSR    RI     TT
    *                *  *   all  fwd      001-001-002   12  ad      ssn    12
   
    SADDR           NP NAI FORBD ACT      PCI           SSN CGSR    RI     TT
   
    SADDR           NP NAI FORBD ACT      PCN           SSN CGSR    RI     TT

    SADDR           NP NAI FORBD ACT      PCN24         SSN CGSR    RI     TT

    SADDR           NP NAI FORBD ACT  CGSR    

    Range CgPA Entries for OPNAME: test4
    ---------------------------------------

    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CGSR
    *               *               *  *   all   fwd      001-001-002   -   d   
    RI=ssn TT=12

    SADDR           EADDR           NP NAI FORBD ACT      PCI           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN           SSN CGSR
    
    SADDR           EADDR           NP NAI FORBD ACT      PCN24         SSN CSGR
    
    SADDR           EADDR           NP NAI FORBD ACT   CGSR    

    GSM MAP Screening Table (4 of 4000) is 1% full 
;

This example shows the output for a specified translation type and a specified mapset.

rtrv-gsmmap-scrn:opname=e:mapset=dflt:tt=12

    tekelecstp 08-01-22 00:57:57 EST  EAGLE 39.2.0

    Single CgPA Entries for OPNAME: e
    ----------------------------------------

    SADDR           NP NAI FORBD ACT      PCA           SSN CGSR    MAPSET   RI
    1111            2  3   all   fwd      001-001-002   12  ad      DFLT     ssn
    TT=12

    SADDR           NP NAI FORBD ACT      PCI           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCN           SSN CGSR    MAPSET   RI

    SADDR           NP NAI FORBD ACT      PCN24         SSN CGSR    MAPSET   RI

    Range CgPA Entries for OPNAME: e
    ---------------------------------------

    SADDR           EADDR           NP NAI FORBD ACT      PCA           SSN CGSR
    1234            3452            *  *   all   fwd      001-001-002   12  as
    MAPSET=DFLT RI=ssn TT=12

    SADDR           EADDR           NP NAI FORBD ACT      PCI           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN           SSN CGSR

    SADDR           EADDR           NP NAI FORBD ACT      PCN24         SSN CSGR

    GSM MAP Screening Table (26 of 4000) is 1% full 
;

Legend

  • Single Entries/Range Entries—GSM MAP screening single entries and range entries are output in separate sections of the retrieval report. All single entries are output first during a summary report and then all range entries follow.
  • CgPA—Calling Party Address entry
  • CdPA—Called Party Address entry
  • OPNAME—User-defined MAP operation code name.
  • SADDR—Start origination address.
  • EADDR—End origination address. This column is displayed for range entries only.
  • NPV—Numbering plan value.
  • NAIV—Nature of address indicator value.
  • FORBID orFORBD—Indicates a forbidden parameter for the entered address. If a forbidden parameter is detected the message is rejected by the action defined by the action parameter. (Some values are abbreviated; for example, locat means location .)
  • ACTION orACT—Screening action, if forbidden. Possible actions are pass, discard (disc), atierr, route, forward, duplicate (dupl), and dupdisc.
  • PC orPCA—ANSI Point Code
  • PCI—ITU International Point Code
  • PCN—ITU National Point Code
  • PCN24—24-bit ITU National Point Code
  • SSN—Subsystem Number
  • CGSR—CgPA Screening Reference
  • CDSR—CdPA Screening Reference
  • MAPSET—MAP set
  • RI—Routing Indicator
  • TT—Translation Type