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.
- 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
- eaddr (optional)
- Ending origination address, in association with npv and naiv for the CGPA address to be screened.
- 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
- ri (optional)
- Routing indicator. This parameter specifies whether a subsequent global title translation is required.
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
Related Topics