rtrv-sid

Use this command to retrieve site identification characteristics of the system. It shows the point code assigned to this system, the CLLI code of the system, the capability code of the STP, and the type of point codes supported by the system.

Parameters

Note:

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

cpc (optional)

ANSI capability point code in the form of network indicator-network cluster-network cluster member (ni-nc-ncm).

Synonym:

cpca

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.

Default:

Display all

cpc/cpca/cpci/cpcn/cpcn24/cpcn16 (optional): Capability point code. The code used by the SS7 protocol to identify a group of functionally related STPs in the signaling network to which the STP belongs.

cpci (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.

Default:

Display all

cpcn (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

Default:

Display all

cpcn24 (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

Default:

Display all

cpcn16 (optional)

16-bit ITU national point code with subfields unit number sub number area main number area (un-sna-mna).

Range:: 000---127; Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).; un---000---127; sna---000---15; mna---000---31
Default:: Display all

cpctype (optional)

Capability point code type. This parameter displays the CPCs that are provisioned for the specified service.

Range:

stp
lnp
inp
eir
gport
gflex
mnp
atinpq
vflex
aiq

Default:

stp

Example

rtrv-sid

rtrv-sid:cpc=3-3-3

rtrv-sid:cyctype=inp

rtrv-sid:cpcn=s-00456

rtrv-sid:cpcn16=1-2-3

Dependencies

The STP destination point codes and capability point codes can be specified only as full point codes.

The ANSI point code 0-0-0 and the ITU-I point code 0-000-0 are invalid for STP capability point codes.

The LNP feature must be turned on beore the cpctype=lnp parameter can be specified.

The INP feature must be turned on beore the cpctype=inp parameter can be specified.

The EIR feature must be turned on beore the cpctype=eir parameter can be specified.

The Spare Point Code Support feature must be enabled before an ITU-I or ITU-N spare point code can be retrieved.

The STP MAS Configuration table is corrupt or cannot be found.

If the cpcn parameter is specified, the format of the specified point code must match the format that was assigned with the chg-stpopts:npcfmit command.

The STP Site Identification table is corrupt or cannot be found.

The ATINP feature must be enabled before the cpctype=atinpq parameter can be specified.

The V-Flex feature must be turned on before the cpctype=vflex parameter can be specified.

The A-Port or the IS41 GSM Migration (IGM) feature must be enabled, before the cpctype=mnp parameter can be specified.

The ANSI41 AIQ feature must be enabled before the cpctype=aiq parameter can be specified.

Notes

If the cpc/cpca/cpci/cpcn/cpcn24/cpcn16 parameter is not specified, all site identification characteristics are displayed.

If the STP capability point code is specified and not provisioned, the report contains only the PCA, PCI, PCN, PCN16, PCN24, CLLI, and PCTYPE fields, with the message:


Capability Point Code specified is not provisioned.

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

Output

The rtrv-sid command CPC output is sorted using three sort keys.

The first sort key is by the cpctype service, ordered by: aiq, eir, gflex, inp, stp (own STP, unlabeled), and gport or mnp depending on whether A-Port, ATINP, G-Port or V-Flex is enabled.
The second sort key is by network type, ordered by: ANSI, ITU-I, ITU-N, then ITU-N24.
The third sort key is by point code value, ordered low to high.

In the following output examples:

When a 24-bit ITU-N site identification STP point code is configured, the PCN header is changed to PCN24.
The s- point code prefix indicates an ITU national or international spare point code or spare capability point code.
ANSI41 AIQ, EIR, G-Flex, G-Port, INP, LNP and V-Flex capability point codes are indicated in parentheses after the capability point code header.
STP capability point codes have no parentheses after the header.

This example shows all site identification characteristics provisioned in the system at the time the command was entered. The output includes spare point codes.

rtrv-sid


    tekelecstp 04-06-14 15:18:11 EST  EAGLE 31.12.0
       PCA             PCI          PCN                CLLI              PCTYPE
       005-067-000     1-023-4      01234              tekelecstp        ANSI
                     s-1-023-4    s-01234
 
      CPCI
     s-4-056-0

      CPCN
     s-00456 

;

This example shows an STP capability point code:

rtrv-sid:cpc=5-5-4


    rlghncxa03w 03-03-18 09:33:58 EST  EAGLE 31.3.0
       PCA             PCI             PCN            CLLI          PCTYPE
       008-013-008     -------         -----          tklcstn14     OTHER

       CPCA
       005-005-004 

;

This example shows an LNP capability point code:

rtrv-sid:cpc=3-3-3


    rlghncxa03w 03-03-10 09:33:58 EST  EAGLE 31.3.0
       PCA             PCI             PCN            CLLI          PCTYPE
       008-013-008     -------         -----          tklcstn14     OTHER

       CPCA (LNP)
       003-003-003 

;

This example shows output when no match for the specified capability point code is found in the Site ID table:

rtrv-sid:cpc=100-100-100


    rlghncxa03w 03-03-18 09:33:58 EST  EAGLE 31.3.0
       PCA             PCI             PCN            CLLI          PCTYPE
       008-013-008     -------         -----          tklcstn14     OTHER

    Capability Point Code specified is not provisioned. 
;

This example shows a display of a site identification STP point code with a group code (the ITUDUPPC feature must be on):

rtrv-sid


    rlghncxa03w 03-03-18 09:33:58 EST  EAGLE 31.3.0
       PCA             PCI             PCN            CLLI          PCTYPE
       008-013-008     -------         128-15-1-1-si  tklcstn14     OTHER 
;

This example shows all provisioned INP capability point codes:

rtrv-sid:cpctype=inp


    rlghncxa03w 03-03-18 09:33:58 EST  EAGLE 31.3.0
       PCA             PCI             PCN            CLLI          PCTYPE
       -------         2-150-4         12345          tklcstn14     OTHER
                                    
       CPCN (INP)
       1234 34567

       CPCI (INP)
       3-050-2         4-100-3 
;

This example shows a specific 24-bit ITU-N capability point code:

rtrv-sid:cpcn24=33-33-33


    rlghncxa03w 02-03-18 09:33:58 EST EAGLE 31.0.0
       PCA             PCI             PCN24             CLLI          PCTYPE
       001-001-001     -------         011-011-011       tekelecstp    ANSI

       CPCN24
       033-033-033 
;

This example contains capability point codes provisioned with cpctype=gflex, cpctype=gport, and cpctype=aiq:

rtrv-sid


    tekelecstp 09-12-09 15:46:50 EST  EAGLE 42.0.0
       PCA             PCI          PCN                CLLI              PCTYPE
       001-001-001     2-002-2      00333              tekelecstp        ANSI

       CPCI (GFLEX)
       2-002-3           2-002-4

       CPCA (AIQ)
       001-002-003       001-002-004

       CPCA (GPORT)
       001-001-002       001-001-003 
;

rtrv-sid


    tekelecstp 04-06-14 15:18:11 EST  EAGLE 31.12.0
       PCA             PCI             PCN            CLLI          PCTYPE
       008-013-008     -------         -----          tklcstn14     OTHER

       CPCA
       005-005-002      005-005-004      005-005-005

       CPCA (LNP)
       005-005-002      005-005-004      005-005-005 
;

This example retrieves a specific spare ITU-N capability point code:

rtrv-sid:cpcn=s-00456


    rlghncxa03w 05-01-07-18 09:33:58 EST  EAGLE 31.12.0
       PCA             PCI          PCN                CLLI              PCTYPE
       005-067-000     1-023-4      01234              tekelecstp        ANSI
                     s-1-023-4    s-01234

       CPCN
     s-00456

      CPCN (EIR)
    s-123 
;

This example shows all site identification characteristics provisioned in the system at the time the command was entered when the J7 feature is enabled. The output includes spare point codes.

rtrv-sid


    tekelecstp 13-08-13 15:36:39 EST  EAGLE 45.1.0-64.71.0
    rtrv-sid
    Command entered at terminal #4.
       PCN16           PCI          PCN                CLLI              PCTYPE
       001-01-01       2-002-2      12345              tekelecstp        ANSI
                     s-2-003-1    s-12341

       CPCI
       3-004-5

       CPCN
       03203

       CPCN16
       003-04-01         003-04-03

;

Legend

PCA—ANSI point code of the STP.
PCI—ITU-TSS international point code of the STP.
PCN—ITU-TSS national point code of the STP.
PCN16---16-bit ITU national point code of the STP.
PCN24—24-bit ITU national point code of the STP.
CPCA—ANSI capability point code used by the SS7 protocol to identify a group of functionally related STPs in the signaling network
CPCN—ITU-TSS national capability point code used by the SS7 protocol to identify a group of functionally related STPs in the signaling network.
CPCI—ITU-TSS international capability point code used by the SS7 protocol to identify a group of functionally related STPs in the signaling network.
CPCN24—ITU-TSS 24-bit national capability point code used by the SS7 protocol to identify a group of functionally related STPs in the signaling network.
CPCN16---ITU-TSS 16-bit national capability point code used by the SS7 protocol to identify a group of functionally related STPs in the signaling network.
(EIR)—Equipment Identity Register (EIR) point code.
(INP)—INAP Number Portability (INP) point code.
(LNP)—Local number portability (LNP) point code.
(GFLEX)—G-Flex (GFLEX) point code.
(GPORT)—G-Port (GPORT) point code.
(MNP)—MNP point code.
(VFLEX)—V-Flex (VFLEX) point code.
(ATINP)—ATINP feature (ATINPQ) point code.
(AIQ)—ANSI41 AIQ feature (AIQ) point code.
CLLI—Common language location identifier of the STP
PCTYPE—Type of point code used by the STP. There are two types of point codes that the EAGLE STP can use, ANSI and OTHER. The value ANSI means the EAGLE STP supports point codes that meet the ANSI standard. The value OTHER means that the EAGLE STP supports point codes that do not meet the ANSI standard.

4.577 rtrv-sid