4.96 chg-loopset

Use this command to change the loopset data in the database. This command updates the Loopset Table. A single instance of this command can be used to append up to 6 point codes to the loopset (a loopset can contain a total of 12 point codes), replace all data in the loopset, or change one or two point codes in the loopset.

Parameters

name (mandatory)
Loopset name. Sn entry in the Loopset table.

The name=none parameter cannot be specified.

Range:
ayyyyyyy

1 alphabetic and up to 7 alphanumeric characters.

apcl (optional)
ANSI appending point code list with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). The prefix subfield indicates a private point code (prefix-ni-nc-ncm). This parameter allows up to 6 comma-delimited entries in the point code list.
Synonym:
apcla
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

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.

apcli (optional)
ITU international appending point code list with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id). This parameter allows up to 6 comma delimited entries in the point code list.
Range:
s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

apcln (optional)
ITU national appending point code list 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). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
s-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

apcln24 (optional)
24-bit ITU national appending point code list with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

apc1n16 (optional)
16-bit ITU national point code with subfields unit number-sub number area-main number area (un-sna-mna). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un--000--127
sna--000--15
mna---000--31
force (optional)
This parameter must be specified to modify a loopset that is being used by GTT.
Range:
yes
mode (optional)
Mode of operation. This parameter specifies whether the message is discarded when an SCCP loop is detected.
Range:
notify
Generates a UIM without discarding the message.
discard
Generates a UIM and discards the message.
npc1 (optional)
ANSI new point code 1 with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). The prefix subfield indicates a private point code (prefix-ni-nc-ncm).
Synonym:
npc1a
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

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.

npc1i (optional)
ITU international new point code 1 with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id).
Range:
s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

npc1n (optional)
ITU national new point code 1 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-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

npc1n24 (optional)
24-bit ITU national new point code 1 with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

npc1n16 (optional)
16-bit ITU national point code with subfields unit number-sub number area-main number area (un-sna-mna). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un--000--127
sna--000--15
mna--000--31
npc2 (optional)
ANSI new point code 2 with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). The prefix subfield indicates a private point code (prefix-ni-nc-ncm).
Synonym:
npc2a
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

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.

npc2i (optional)
ITU international new point code 2 with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id).
Range:
s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

npc2n (optional)
ITU national new point code 2 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-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

npc2n24 (optional)
24-bit ITU national new point code 2 with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

npc2n16 (optional)
16-bit ITU national point code with subfields unit number-sub number area-main number area (un-sna-mna). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un--000--127
sna--000--15
mna--000--31
pc1 (optional)
ANSI point code 1 with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). The prefix subfield indicates a private point code (prefix-ni-nc-ncm).
Synonym:
pc1a
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

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.

pc1i (optional)
ITU international point code 1 with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id).
Range:
s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

pc1n (optional)
ITU national point code 1 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-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

pc1n24 (optional)
24-bit ITU national point code 1 with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

pc1n16 (optional)
16-bit ITU national point code with subfields unit number-sub number area-main number area (un-sna-mna). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un--000--127
sna--000--15
mna--000--31
pc2 (optional)
ANSI point code 2 with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). The prefix subfield indicates a private point code (prefix-ni-nc-ncm).
Synonym:
pc2a
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

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.

pc2i (optional)
ITU international point code 2 with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id).
Range:
s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

pc2n (optional)
ITU national point code 2 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-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

pc2n24 (optional)
24-bit ITU national point code 2 with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

pc2n16 (optional)
16-bit ITU national point code with subfields unit number-sub number area-main number area (un-sna-mna). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un--000--127
sna--000--15
mna--000--31
rpcl (optional)
ANSI replacing point code list with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). The prefix subfield indicates a private point code (prefix-ni-nc-ncm). This parameter allows up to 6 comma-delimited entries in the point code list.
Synonym:
rpcla
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

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.

rpcli (optional)
ITU international replacing point code list with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

rpcln (optional)
ITU national replacing point code list 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). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
s-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

rpcln24 (optional)
24-bit ITU national replacing point code list with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

rpc1n16 (optional)
16-bit ITU national point code with subfields unit number-sub number area-main number area (un-sna-mna). This parameter allows up to 6 comma-delimited entries in the point code list.
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un--000--127
sna--000--15
mna--000--31

Example

This example sets the mode to discard and appends the listed point codes to the loopset RTP1 if the set is not being used by GTT.

chg-loopset:name=rtp1:mode=discard:apcl=3-7-3,5-7-5,7-4-7,5-4-5

This example replaces the point codes in the set with the listed point codes for the loopset RTP1 if the set is not being used by GTT.

chg-loopset:name=rtp2:rpcl=3-2-3,5-7-8,7-8-7,3-5-3

This example sets the mode to DISCARD in the loopset RTP2 if the set is not being used by GTT.

chg-loopset:name=rtp2:mode=discard

This example replaces PC1 with NPC1 in the loopset RTP1 if the set is not being used by GTT.

chg-loopset:name=rtp1:pc1=3-3-3:npc1=3-3-9

This example replaces PC1 and PC2 with NPC1 and NPC2 in the loopset RTP2 if the set is not being used by GTT.

chg-loopset:name=rtp2:pc1=3-2-3:npc1=3-3-9:pc2=7-8-7:npc2=7-7-9

This example sets the mode to NOTIFY in the loopset RTP2 even if the set is being used by GTT.

chg-loopset:name=rtp2:mode=notify:force=yes

chg-loopset:name=rtpn16:pc1n16=3-2-3:npc1n16=3-3-9:pc2n16=7-8-7:npc2n16=7-7-9

Dependencies

If the loopset is being used by GTT, and the rpcl, pc1/pc2/npc1/npc2, or mode parameter is specified, then the force=yes parameter must be specified.

If the pc2 parameter is specified, then the pc1 parameter must be specified.

If the npc1 or npc2 parameter is specified, then the corresponding pc1 or pc2 parameter must be specified.

The command requires at least one optional parameter.

The rpcl and apcl parameters cannot be specified together in the command.

If the pc1 or pc2 parameter is specified, then the apcl and rpcl parameters cannot be specified.

The value of the name parameter must already exist in the database.

The SCCP Loop Detection feature must be enabled before this command can be entered.

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

A maximum of 6 point codes can be added using this command with the apcl parameter. The Loopset entry can contain a maximum of 12 point codes.

The Loopset table can hold a maximum of 1,000 loopset entries, with each entry containing up to 12 point codes. Additional loopset entries and point codes cannot be added when the table is full.

The Loopset table must be accessible.

The values for the apcl and rpcl parameters cannot consist of any invalid point codes. The valid point codes must be consecutively specified and separated by commas.

The name=none parameter cannot be specified.

At least one valid point code must be specified as a value for the apcl and rpcl parameters.

The values specified for the apcl and rpcl parameters must be unique.

If the npc1/pc1 or npc2/pc2 parameters are specified together, then the value of the npc parameter cannot equal the value of the pc parameter.

A valid point code must be specified for the pc1, pc2, npc1 or npc2 parameter.

Equal values cannot be specified for the pc1 and pc2 parameters.

Equal values cannot be specified for the npc1 and npc2 parameters.

The GTT table must be accessible.

When adding point codes using the apcl parameter, or changing point codes using the pc1/npc1 or pc2/npc2 parameters, the new point code type must match the point code type of the loopset where the point codes are being added or changed.

The value of the apcl parameter cannot already exist in the loopset.

The value of the pc1 or pc2 parameter must already exist in the loopset.

Notes

There is no J7 FAK dependency on the apcln16/rpcln16/pc1n16/npc1n16/pc2n16/npc2n16 parameters. The command can be entered successfully when the J7 FAK is not enabled.

There is no J7 FAK dependency on the apcln24/rpcln24/pc1n24/npc1n24/pc2n24/npc2n24 parameters. The command can be entered successfully when the J7 FAK is enabled.

There is no J7 FAK dependency on the apcl/apcla/rpcla/pc1a/npc1a/pc2a/npc2a parameters. The command can be entered successfully when the J7 FAK is enabled.

Output

This example replaces the existing point codes with new point codes in loopset RTP2 when that set is not being used by GTT:

chg-loopset:name=rtp2:pc1=3-2-3:npc1=3-3-9:pc2=7-8-7:npc2=7-7-9

    rlghncxa03w 07-02-10 08:41:17 EST  EAGLE Rel 35.6.0
    LOOPSET table is (12 of 1000) 1% full 
    CHG-LOOPSET: MASP A – COMPLTD 
;