rtrv-spc

Use this command to retrieve an SPC (secondary point code) from the active database.

Parameters

Note:

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

spc (optional)

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

Synonym:

spca

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.

spc/spca/spci/spcn/spcn24/spcn16 (optional): The secondary point code.

spci (optional)

ITU international secondary 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.

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

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

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

Example

rtrv-spc

rtrv-spc:spc=5-3-3

rtrv-spc:spcn24=98-98-98

rtrv-spc:spcn=s-00345

rtrv-spc:spcn16:121-10-30

Dependencies

The MPC feature must be turned on before this command can be entered.

The SPC table must be accessible.

The value of the spc parameter must be a full point code.

Notes

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

Output

This example shows output for all provisioned secondary point codes. SPC-N is a flexible point code format as defined with the chg-stpopts:npcfmti parameter.

rtrv-spc


    rlghncxa03w 03-03-18 08:50:12 EST  EAGLE 31.0.0
    SPC (Secondary Point Codes)

    SPCA
         001-010-010
         002-010-010
         003-010-010

    SPC-I
           01-253-05
           02-254-06
           03-255-07

    SPC-N
          120-01-0-1
          100-02-1-0

    SPC-N24
         099-099-099

    Secondary Point Code table is (9 of 40) 25% full 

;

This example shows output for all provisioned secondary point codes. Spare point codes are included.

rtrv-spc


    rlghncxa03w 05-01-18 08:50:12 EST  EAGLE 31.12.0
    SPC (Secondary Point Codes)

    SPCA
         001-001-001
         001-123-003

    SPC-I
             1-001-1
           s-1-001-1
             2-003-4
           s-4-003-4

    SPC-N
               00234
             s-00345

    SPC-N24
         011-011-011

    Secondary Point Code table is (9 of 40) 22% full. 

;

This example shows the only provisioned secondary point code:

rtrv-spc


    rlghncxa03w 05-03-18 08:50:12 EST  EAGLE 31.0.0
    SPC (Secondary Point Codes)
 
    SPCA
    none

    SPC-I
    none
    
    SPC-N
    none

    SPC-N24
        099-099-099

    Secondary Point Code table is (1 of 40) 2% full. 

;

This example shows output for a specific ANSI secondary point code:

rtrv-spc:spc=5-3-3


    rlghncxa03w 03-03-18 08:50:12 EST  EAGLE 31.3.0
    SPC (Secondary Point Codes)
         005-003-003

    Secondary Point Code table is (8 of 40) 25% full. 

;

This example shows output when the specified secondary point code is not provisioned:

rtrv-spc:spc=5-3-1


    rlghncxa03w 03-03-18 08:50:12 EST  EAGLE 31.3.0
    SPC (Secondary Point Codes)

    Secondary Point Code specified is not provisioned

    Secondary Point Code table is (3 of 40) 8% full. 

;

This example shows information for a specific ITU-N secondary spare point code:

rtrv-spc:spcn=s-00345


    rlghncxa03w 03-03-18 08:50:12 EST  EAGLE 31.12.0
    SPC (Secondary Point Codes)
             s-00345

    Secondary Point Code table is (2 of 40) 5% full. 

;

This example shows output for a specific 24-bit ITU-N secondary point code:

rtrv-spc:spcn24=98-98-98


    rlghncxa03w 03-03-18 08:50:12 EST  EAGLE 31.0.0
    SPC (Secondary Point Codes)
         098-098-098

    Secondary Point Code table is (2 of 40) 5% full. 

;

This example shows output for a specific 16-bit ITU-N point code:


rtrv-spc:spcn16=121-10-15

    rlghncxa03w 03-03-18 08:50:12 EST  EAGLE 31.0.0
    SPC (Secondary Point Codes)
         098-098-098

    Secondary Point Code table is (2 of 40) 5% full. 

;

Legend

SPC—Secondary point code
SPCA—ANSI secondary point code
SPC-I—ITU international secondary point code
SPC-N—ITU national secondary point code
SPC-N24—24-bit ITU national secondary point code
SPC-N16--16-bit ITU national secondary point code

4.584 rtrv-spc