4.97 chg-ls

Use this command to change the attributes for a specified linkset in the system database. The new values overwrite the existing values. All parameters required for MTP distribution will be used whether they are explicitly specified or obtain from existing provisioning.

Parameters

Note:

See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.
lsn (mandatory)
Linkset name. Each linkset name must be unique in the system.
Range:
ayyyyyyyyy

1 alphabetic character followed by up to 9 alphanumeric characters

action (optional)
This parameter adds or deletes the SAPC, mate IPGWx linkset name, or the value specified for the rcontext parameter.
Range:
add
delete
Default:
No change to the current value
System Default:
add
adapter (optional)
Adapter layer for links provisioned in an IPSG linkset.
Range:
m3ua
m2pa
Default:
No change to the current value
System Default:
m2pa
apc (optional)
ANSI point code 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:
apca
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.

apc/apca/apci/apcn/apcn24 /apcn16 (optional)
Adjacent point code.
apci (optional)
ITU international point code 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.

apcn (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, private point code, or private and 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

apcn24 (optional)
24-bit ITU national point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). The prefix indicates a private point code (prefix-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

apcn16 (optional)
16-bit ITU national point code with subfields unit number-sub number area-main number area (un-sna-mna). The prefix indicates a private point code (prefix-un-sna-mna).
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
apcntype (optional)
ITU-N Adjacent Point Code Type. The format used for changeover and changeover acknowledgement messages.
Range:
itun
ITU National Adjacent Point Code type
itunchina
ITU National China Adjacent Point Code type
Default:
itun
asl8 (optional)
Adjacent SLS 8-bit indicator. This parameter specifies whether the adjacent node is sending MSUs with 8-bit SLSs.
Range:
yes
no
Default:
No change to the current value
asnotif (optional)
AS notification. This parameter specifies whether AS notifications are sent for an IPSG linkset.
Range:
yes
no
Default:
yes

If the adapter=m2pa parameter is specified, the default value is no.

If the adapter=m3ua parameter is specified, the default value yes.

bei (optional)
Broadcast exception indicator. This parameter specifies whether TFP (transfer prohibited) messages are allowed to be broadcast on the linkset.
Range:
yes
TFPs are not broadcast
no
TFPs are broadcast
Default:
No change to the current value
cggtmod (optional)
Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required for the specified linkset.
Range:
yes
no
Default:
No change to the current value
cgpnblset (optional)
Calling party blacklist set.
Range:
1-255, none
System Default:
none
chgmtp3opc (optional)
Change MTP3 OPC. This parameter specifies whether to change MTP3 OPC with SPC or not.
Range
on
off
Default
No change to the current value
clli (optional)
Far-end Common Language Location Identifier (CLLI). The CLLI assigned to the linkset.
Range:
ayyyyyyyyyy

1 alphabetic character followed by up to 10 alphanumeric characters

Default:
No change to the current value
gnameset (optional)
Generic Name Set type. The new settype for an IPSG-M3UA linkset.
Range:
seta
setb
both
none
System Default:
none

Note: After the upgrade, the default value of gnameset will be set to BOTH as previous releases have BOTH as default value.

gsmscrn (optional)
GSM MAP screening. This parameter specifies whether GSM MAP screening is allowed.
Range:
on
GSM map screening is allowed
off
GSM map screening is not allowed
Default:
No change to the current value
gttmode (optional)
Global Title Translation Mode. This parameter specifies a GTT Mode hierarchy for each link set.
Range:
cd
CdPA GTT only
cg
CgPA GTT only
acdcd
Advanced CdPA GTT, CdPA GTT
acdcgcd
Advanced CdPA GTT, CgPA GTT, CdPA GTT
acdcdcg
Advanced CdPA GTT, CdPA GTT, CgPA GTT
cgacdcd
CgPA GTT, Advanced CdPA GTT, CdPA GTT
cgcd
CgPA GTT, CdPA GTT
cdcg
CdPA GTT, CgPA GTT
fcd
FLOBR CdPA only
fcg
FLOBR CgPA only
fcgfcd
FLOBR CgPA, FLOBR CdPA
fcdfcg
FLOBR CdPA, FLOBR CgPA
sysdflt
System wide default value
Default:
No change to current value.
gwsa (optional)
Gateway screening action. This parameter specifies whether gateway screening (GWS) is on or off for the specified linkset.
Range:
on
off
Default:
No change to the current value
gwsd (optional)
Gateway screening MSU discard. This parameter specifies whether the discarding of MSUs that bypass the gateway screening function due to load-shedding is on or off. This parameter is also used with the redirect function; MSUs that cannot be screened are discarded if gwsd=on is specified.
Range:
on
off
Default:
off
gwsm (optional)
Gateway screening messaging. This parameter specifies whether messages are generated for each message screened by gateway screening.
Range:
on
off
Default:
No change to the current value
ipsg (optional)
IP signaling gateway adjacent point code. This parameter specifies whether a linkset is entered for an IPSG card. The specified adjacent point code is an IP gateway adjacent point code.
Range:
yes
no
Default:
no
islsrsb (optional)

Incoming rotated signaling link selection (SLS) bit. The bit (1-4) for ITU and (1–8) for ANSI link sets to rotate as the new SLS LSB (Least Significant Bit) of the incoming linkset. The SLS is not modified in the outgoing message. 

Table 4-32  shows how the rotation affects the four bits of the ITU SLS during linkset selection.

Table 4-33 shows how the rotation affects the four bits of the ANSI SLS during linkset selection.

This parameter is used for ITU or ANSI messages on a per-linkset basis.

Range:
1 - 8

ITU linkset— 1 - 4

ANSI linkset— 1 - 8

The rsls8=yes parameter must be specified (see the chg-lsopts command) before a value greater than 5 can be specified.

Default:
No change to the current value
System Default:
1
itutfr (optional)
ITU TFR (Transfer Restricted) procedure indicator. This parameter specifies whether the TFR procedure is on or off on a per-linkset basis. This parameter is valid for ITU national linksets only.
Range:
on
off
Default:
No change to the current value
l3tset (optional)
Link timer set. This parameter is defined with the chg-l3t command.
Range:
1
Default:
No change to the current value
lst (optional)
Linkset type of the specified linkset. This parameter specifies whether the specified link is an access link, bridge link, cross link, diagonal link, or extended link, as defined in Telcordia GR-246-CORE, T1.111.5.
Range:
a
Access links
b
Bridge links
c
Cross links
d
Diagonal links
e
Extended links
Default:
No change to the current value
lsusealm (optional)
IPTPS linkset alarm threshold percent. The percent of the linkset TPS (iptps) at which an alarm is generated to indicate that the actual linkset TPS is approaching the configured iptps value for the linkset.
Range:
10 - 100
Default:
No change to the current value
System Default:
100
matelsn (optional)
Mate linkset name.
Range:
ayyyyyyyyy

1 alphabetic character followed by up to 9 alphanumeric characters

Default:
No change to the current value
maxslktps (optional)

Maximum per signaling link TPS. The maximum capacity a link is permitted when sufficient unused capacity is present on the host card.

Note:

This parameter cannot be specified for links in non-IPSG linksets.

If the HIPR2 High Rate Mode feature is turned off, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 500,000. If the HIPR2 High Rate Mode feature is turned on, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 750,000. If the HIPR2 High Rate Mode and 1M System TPS features are turned on, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 1,000,000.

Range:
25 - 12,000

Note:

The maximum value that can be specified for this parameter depends on the type of IPSG card that is used:
  • E5-ENET-B card when the E5-ENET-B IPSG High Throughput feature is turned off-6500 TPS
  • E5-ENET-B card when the E5-ENET-B IPSG High Throughput feature is turned on-9500 TPS
  • SLIC card - 12,000 TPS
Default:
No change to the current value
System Default:
6500
mtprse (optional)
ANSI or ITU MTP Restart equipped. This parameter specifies whether the node adjacent to the linkset is equipped with MTP Restart.
Range:
yes
equipped
no
not equipped
Default:
No change to the current value
multgc (optional)
Multiple group codes. The parameter specifies whether multiple group codes can be specified.
Range:
yes
no
nis (optional)
Network Indicator Spare. This parameter specifies whether the Network Indicator Spare option is on or off for the specified linkset. When this option is enabled, the Network Spare value for network indicator for both ANSI and ITU-National (ITU-N) links is supported by the system.
Range:
on
off
Default:
off
nlsn (optional)
New linkset name.
Range:
ayyyyyyyyy

Up to 10 alphanumeric characters; the first character must be a letter

Default:
No change to the current value
randsls (optional)
Random SLS (signaling link selection). This parameter is used to apply random SLS generation on a per linkset basis.

Specifying this parameter enables random SLS generation on a per linkset basis only if the randsls=perls parameter has been specified in the chg-stpopts command. For more details, refer to Database Administration - SS7 User's Guide, Per-Linkset Random SLS.

Range:
off
disables random SLS generation on a specified linkset
class0
enables random SLS generation for Class0 SCCP traffic on a specified linkset
all
enables random SLS generation for Class0 and Class1 SCCP traffic on a specified ITU linkset and for Class0 and ISUP traffic on a specified ANSI linkset
Default:
No change to the current value
rcontext (optional)
Routing Context. The new routing context for an IPSG-M3UA linkset.
Range:
0 - 4294967295
Default:
No change to the current value
sapci (optional)
ITU international secondary adjacent point code 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.

sapci/sapcn/sapcn24/spcn16 (optional)
Secondary adjacent point code.
sapcn (optional)
ITU national secondary adjacent 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, private point code, or private and 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

sapcn24 (optional)
24-bit ITU national secondary adjacent point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). The prefix indicates a private point code (prefix-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

scrn (optional)
Gateway screening screen set. The gateway screening screen set assigned to this linkset.

When using this parameter to change Gateway Screening from an old screenset name with Gateway Screening Allowed Mode gwsa=off to a new screenset name with gwsa=on, the command must first be entered to assign the screenset name to NONE (scrn=none). This assignment prevents any rules from the old screenset from being applied during the interim period that it takes for the new screenset to load.

Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

none -deletes the screen set association

Default:
No change to the current value
slktps (optional)

Reserved per signaling link TPS for IPSG Linkset. The capacity guaranteed for each link in the linkset. 

Note:

This parameter is required for each link in an IPSG linkset and cannot be specified for links in non-IPSG linksets.

Note:

The sum of guaranteed capacities for the links hosted by an IPSG card cannot exceed the IPSG card capacity.

Note:

If the HIPR2 High Rate Mode feature is turned off, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 500,000. If the HIPR2 High Rate Mode feature is turned on, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 750,000. If the HIPR2 High Rate Mode and 1M System TPS features are turned on, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 1,000,000.
Synonym:
rsvdslktps
Range:
0 - 12,000

Note:

The maximum value that can be specified for this parameter depends on the type of IPSG card that is used:
  • E5-ENET-B card when the E5-ENET-B IPSG High Throughput feature is turned off-6500 TPS
  • E5-ENET-B card when the E5-ENET-B IPSG High Throughput feature is turned on-9500 TPS
  • SLIC card - 12,000 TPS
Default:
No change to the current value
slkusealm (optional)
IPTPS signaling link alarm threshold percent. The percent of the link TPS at which an alarm is generated to indicate that the actual link TPS is approaching the alarmed IPTPS (slktps/rsvdslktps or maxslktps) configured for the link.
Range:
10 - 100
Default:
No change to the current value
System Default:
80
slsci (optional)
5-bit to 8-bit SLS conversion indicator. This parameter specifies whether the 5-bit to 8-bit SLS conversion feature is used to select links for outgoing messages direct to the given linkset. When enabled, the system replaces any 5-bit SLS values contained in received messages, with a random 8-bit value before the 5-bit SLS values are used by the STP to select the outgoing link in that linkset.
Range:
yes
enabled
no
disabled
Default:
No change to the current value
slsocbit (optional)
Other CIC (Circuit Identification Code) Bit. If the SLSOCB feature is turned on, this parameter specifies whether the Other CIC Bit option is to be used during link selection. If the option is to be used, specify which bit (5– 16) of the CIC is to be used as the other CIC bit. During link selection, the specified bit acts as the most significant bit of the new SLS and bits 2 through 4 of the received CIC become the least significant bits of the new SLS. This parameter is used for ITU-ISUP messages. The SLS is not modified in the outgoing message. Table 4-11 shows a received CIC where bit 9 is the other CIC bit (slsocbit=9). The new SLS is 0100:

Table 4-11 slsocbit example (chg-ls)

16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1
0 0 0 0 1 0 0 0 1 0 0 1 1 0 0 1
New SLS 0 1 0 0
Range:
5 - 16
Default:
No change to the current value
slsrsb (optional)

Rotated SLS (Signaling Link Selection) Bit. The bit (1–4) to rotate as the new SLS LSB (Least Significant Bit). The SLS is not modified in the outgoing message.

Table 4-35  shows how the rotation affects the SLS during linkset selection.

This parameter is used for ITU messages on a per-linkset basis.

Range:
1 - 4
Default:
No change to the current value
sltset (optional)
SLTM record. The SLTM record to be associated with the linkset.
Range:
1 - 20

0 –sets the linkset to SLT reflect mode

Default:
No change to the current value
spc (optional)
ANSI secondary point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm).
Synonym:
spca
Range:

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

p-, 000-255, none

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 for ni = 001-005.

When chg-sid:pctype=ansi is specified, nc = 000 is valid if ni = 006-255.

Enter none to delete the point code.

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

spc/spca/spci/spcn/spcn24/spcn16 (optional)
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, none

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

Enter none to delete the point code.

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

spcn (optional)
ITU national secondary 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, none

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

Enter none to delete the point code.

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

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

Enter none to delete the point code.

spcn16 (optional)
16-bit ITU national point code with subfields unit number sub number area main number area (un-sna-mna).
Range:
000--127, none
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
Enter none to delete the point code.
tfatcabmlq (optional)
TFA/TCA broadcast minimum link quantity. The minimum number of links in the given linkset, or in the combined linkset in which the linkset resides, that must be available to user-part messages traffic. This parameter value is used by the STP to consider the first-choice ordered routes using that linkset as Allowed rather than Restricted.

If this parameter's provisioned or default value is 0, then the TFA/TCA broadcast minimum link quantity is calculated by the system to be either 1 for linksets containing 2 or fewer links, or half (rounded-up) of the number of links configured in the linkset for linksets containing more than 2 links.

If this parameter value is set to a specific value greater than 0, then the system does not calculate a TFA/TCA broadcast minimum link quantity. The specified value is used.

Range:
0, 1 - 16
Default:
No change to current value.
System Default:
0
tpsalmtype (optional)
IPSG IPTPS threshold alarm type. The IPTPS threshold that can be alarmed.
Range:
rsvdslktps
the SLKTPS/RSVDSLKTPS threshold is alarmed
maxslktps
the MAXSLKTPS threshold is alarmed
Default:
No change to the current value
System Default:
rsvdslktps
visualizedata (optional)
Linkset based Visualization option.
Range:
off
Visualization is off on this linkset
risky
Only risky opcodes (based on FS11) will be visualize on this linkset
all
All opcodes will be visualize on this linkset
System Default:
off

Example

Changes linkset WY644368 to use APC 144-202-5:

chg-ls:lsn=wy644368:apc=144-202-005

Changes link set WY644368 to Link Set Type A:

chg-ls:lsn=wy644368:lst=a

Adds an SAPC to a linkset:

chg-ls:lsn=linkset:sapcn=1234-fr:action=add

chg-ls:lsn=c002:gwsm=on: nis=on

chg-ls:lsn=nc003:sltm=reg:lst=b

Adds a 24-bit ITU-N SAPC to a linkset:

chg-ls:lsn=ls1:sapcn24=5-5-5

Deletes a 24-bit ITU-N SAPC from a linkset:

chg-ls:lsn=ls1:sapcn24=5-5-5:action=delete

Assigns a mate linkset to a linkset:

chg-ls:lsn=linkset:matelsn=matelinkset

Changes an ITUN24 linkset to an APCNTYPE for China:

chg-ls:lsn=ls2:apcntype=itunchina

chg-ls:lsn=nc003:slsci=yes:tfatcabmlq=2

chg-ls:lsn=lsitu1:gsmscrn=off

chg-ls:apca=p-011-2-3:lsn=lsa1:lst=a

chg-ls:lsn=ls1:randsls=all

Indicates that calling party GT modification is required:

chg-ls:lsn=ls1:apc=1-1-1:cggtmod=yes

Changes the linkset's SPC value:

chg-ls:lsn=lsl:spc=100-23-48

Changes the adapter of a specified IPSG linkset:

chg-ls:lsn=ls2:adapter=m2pa

Changes the AS notification status and routing context value for an IPSG-M3UA linkset:

chg-ls:lsn=m3ua33:rcontext=9999:action=add

Converts the linkset to IPSG:

chg-ls:lsn=m2pa33:ipsg=yes

This command changes the Incoming SLS Bit Rotation value to 6 for ANSI link sets:

chg-ls:lsn=ls1:islsrsb=6

Changes the GTTMODE value to FLOBR CdPA when the FLOBR feature is turned on:

chg-ls:lsn=ls3:gttmode=fcd

Converts the linkset to SLT reflect mode:

chg-ls:lsn=ls1:sltset=0

Change adapter type of a 16-bit ITU national linkset type:

chg-ls:lsn=ls1:apcn16=121-5-15:adapter=m3ua

Change linkset chgmtp3opc parameter:

chg-ls:lsn=ls112:chgmtp3opc=off

Change linkset gnameset parameter:

chg-ls:lsn=ls112:gnameset=setb

Change linkset cgpnblset parameter:

chg-ls:lsn=ls112:cgpnblset=3

Change gnameset parameter to NONE:

chg-ls:lsn=ls112:gnameset=none

Dependencies

A valid screenset name must be associated with the linkset, or the scrn parameter must be specified with a valid screenset name before the gwsa, gwsm, and gwsd parameters can be specified.

The gwsa=on parameter must be specified before the gwsd=on parameter can be specified.

At least one optional parameter must be specified.

If the lsrestrict=off parameter is specified (see the chg-ss7opts command), the tfatcabmlq database value for C linksets cannot be changed from the system default of 0. If the lsrestrict=on parameter is specified, the tfatcabmlq value for C linksets (lst=c) can be set to 1 - 16. If the tfatcabmlq value for one or more C linksets in the system is changed, the lsrestrict parameter cannot be changed from on to off until all of the changed C linkset tfatcabmlq values are set back to 0. C linksets are never the primary route (except to reach the STP’s mate).

The tfatcabmlq parameter value cannot exceed the total number of assigned links in the linkset.

The linkset name must be in the database.

The screen set name specified by the scrn parameter must be valid and must be in the database.

Adjacent point codes must be full point codes.

The adjacent point code must be defined as a destination point code.

The adjacent point code cannot match the site point code.

The domain of the new adjacent point code must be the same as the previous adjacent point code unless there are no links in the linkset.

Only one linkset can be defined for an adjacent point code.

An SAPC cannot be deleted when routes exist for its SS7 domain.

If the gwsa=off and gwsm=off parameters are specified, all MSUs are passed. If the gwsa=off and gwsm=off parameters are specified for all linksets, gateway screening and the GWS redirect function for the DTA feature are disabled.

If the gwsa=on and gwsm=off parameters are specified, MSUs are screened but messages are not generated.

Caution:

Even though gateway screening is in the screen test mode, as defined by the parameters gwsa=off and gwsm=on, the gateway screening action in the stop action set specified by the actname parameter of the screen set is performed at the end of the screening process.

The mtprse parameter can be specified only if the MTP restart feature, MTPRS (for ANSI), or ITUMTPRS (for ITU), is turned on. The rtrv-feat command can be used to verify whether the feature is turned on (MTPRS=YES or ITUMTPRS=YES in the output).

If the ipgwapc=yes or ipsg=yes parameter is specified, then the mtprse=yes parameter cannot be specified.

The clli and apc/apca/apci/apcn/apcn24/apcn16 parameters must be specified together in the command.

The value of the clli parameter must match the clli of the current site.

The asl8=yes parameter can be assigned only to an SS7 linkset (a linkset containing an adjacent point code in the SS7 domain).

The apcn parameter format must match the format assigned with the chg-stpopts:npcfmti parameter.

An SAPC parameter can be specified only for ITU-N and ITU-N24 linksets.

The slsocbit parameter is valid only for ITU linksets.

The slsrsb parameter is valid only for ITU linksets.

The GSM Map Screening feature must be turned on before the gsmscrn parameter can be specified.

The Enhanced GSM Map Screening feature must be turned on before the gsmscrn=on parameter can be specified for an ANSI linkset.

The itutfr parameter is valid only for ITU national linksets.

The group code of DPC(s) must match the group code of the APC/SAPC when the multgc=no parameter is specified.

If the adjacent point code’s group code is changed, the multgc=yes parameter must be specified, or there must be no routes using the linkset.

The multgc parameter value can be changed to no only if there are no routes with group codes different from the adjacent point code’s group code.

Only one ITU-N APC/SAPC is allowed with the multgc=no parameter.

Only one ITU-I or 24-bit ITU-N APC/SAPC is allowed per linkset.

The apcntype parameter can be specified only for ITU-N and ITU-N24 linksets.

A linkset cannot have both a 14-bit ITU-N and a 24-bit ITU-N APC/SAPC unless it contains only IPGWI links. These links support 14-bit ITU-N and 24-bit ITU-N traffic simultaneously.

A linkset with the ipgwapc=no parameter cannot have both a 14-bit ITU-N and a 24-bit ITU-N APC/SAPC if no links are provisioned.

The SAPC cannot be a 24-bit ITU-N point code if the linkset contains E1 ATM links, which do not support 24-bit ITU-N traffic.

The ipgwapc=yes or ipsg=yes parameter must be specified before the lsusealm parameter can be specified.

The ipgwapc=yes or ipsg=yes parameter must be specified before the slkusealm parameter can be specified.

The same value cannot be specified for the lsn and matelsn parameters.

If the action=add parameter is specified, the specified mate linkset cannot already be assigned as the mate of the specified linkset.

When the action=add parameter is specified, the specified mate linkset cannot already be the mate of another linkset.

The specified mate linkset must be an existing linkset in the database.

A mated linkset can have only one assigned link.

Mated linksets can contain only SS7IPGW or IPGWI links.

Mated linksets must have APCs of the same network type.

The card that has the link assigned to the specified linkset must be inhibited before the action=add parameter can be specified to assign the specified mate linkset to the specified linkset.

The card that has a link in the mate linkset must be inhibited before the action=delete parameter can be specified to delete the mate linkset assignment.

If the action=delete parameter is specified to delete a mate linkset assignment, the specified mate linkset must be the mate of the specified linkset in the database.

If the action=delete parameter is specified, then the sapc, matelsn, or rconext parameter must be specified. The parameters cannot be specified together in the command.

The mtprse parameter can be specified only if the MTP restart feature ITUMTPRS (for ITU) is turned on. The rtrv-feat command can be used to verify whether the feature is turned on (ITUMTPRS=YES in the output).

The slsocbit parameter is valid only if the SLSOCB feature is turned on.

The adjacent point code cannot match the capability point code.

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

The Linkset table is corrupt or cannot be found.

The Route table is corrupt or cannot be found.

An APC cannot be changed to a point code that has exception routes provisioned.

The Route Exception table is corrupt or cannot be found.

The Origin-based SCCP Routing feature must be turned on before the gttmode parameter can have a value of acdcd, cgacdcd, acdcgcd, acdcdcg, cgcd, cdcg, or cg.

All links assigned to the linkset must be removed before changing the apcntype parameter value from apcn to apcn24 or from apcn24 to apcn.

If one or more of the links in the specified linkset are in service, then the apc/apca/apci/apcn/apcn24/apcn16 parameter cannot be specified.

If apcn is specified for the Adjacent Point Code then the format of apcn must match the format dictated by the npcfmti parameter via the chg-stpopts command.

Gateway linksets must be configured from a SEAS terminal.

If the system is configured for ANSI formatted point code, the network indicator value of the foreign point code parameter must be 6 or greater when the cluster value is 0.

The value of the apc/apca/apci/apcn/apcn24/apcn16 or sapc/sapca/sapci/sapcn/sapcn24 parameter cannot be assigned to more than one linkset.

The new apc/apca/apci/apcn/apcn24/apcn16 parameter must have the same point code type as the apc/apca/apci/apcn/apcn24/apcn16 parameter currently specified for the linkset.

The value of the apc/apca/apci/apcn/apcn24/apcn16 parameter must exist in the Point Code table.

The lst parameter must have a value of b, c, or d if a network or cluster route is configured through the linkset.

If the multgc=yes parameter is specified, then an IPGWI or IPLIMI link must be specified.

If the ITUDUPPC feature is off, then the multgc=yes parameter cannot be specified.

If the multgc=yes parameter is specified, then the apci, apcn, apcn16, or apcn24 parameter must be specified.

The value of the sapc/sapca/sapci/sapcn/sapcn24 parameter must exist in the Destination Point Code table.

The apc/apca/apci/apcn/apcn24 or sapc/sapca/sapci/sapcn/sapcn24 parameter can be defined only once per linkset.

The maximum number of sapc/sapca/sapci/sapcn/sapcn24 entries is 1000.

The value of the specified lsn parameter cannot already exist in the database.

The specified matelsn parameter must already be equipped in the linkset database.

If the linkset is not mated to the linkset specified by the matelsn parameter, then the action=delete parameter cannot be specified.

The value specified for the spc parameter must be a valid full point code.

The values specified for the spc and apc parameters must have the same network type.

If the sapc, matelsn, rcontext, or action parameter is specified, then those four parameters are the only optional parameters that can be specified. If the action parameter is specified, then the sapc or rcontext or matelsn parameter must be specified. If the ipsg parameter is specified, then no other optional parameters can be specified.

The Multiple Linksets to Single Adjacent PC (MLS) feature must be turned on before the spc parameter can be specified.

The value specified for the spc parameter must already exist in the SPC table.

The SPC table must be accessible.

The point code type of the value specified for the spc parameter must be the same as the point code type of the value of the existing spc parameter.

The value specified for the spc parameter cannot already be specified as a secondary point code for an adjacent destination point code.

The value specified for the apc parameter must differ from the adjacent point code of the linkset specified by the lsn parameter.

The value specified for the spc parameter must differ from the secondary point code of the linkset specified by the lsn parameter.

If a proxy linkset is used, then the apc, sapc, action, and lst parameters cannot be specified.

The specified combination of the apc and spc parameters must be unique for each linkset.

The specified combination of the apc and sapc parameters must be unique for each linkset.

The AMGTT feature or the AMGTT CgPA Upgrade feature must be turned on before the cggtmod parameter can be specified.

The ipsg=yes parameter must be specified before the adapter parameter can be specified.

The ipsg=yes and adapter=m3ua parameters must be specified before the asnotif parameter can be specified.

The ipsg=yes and adapter=m3ua parameters must be specified before the rcontext parameter can be specified.

If the IPSG linkset contains links, then the adapter parameter cannot be specified.

The ipsg=yes parameter must be specified before the slktps/rsvdslktps or maxslktps parameter can be specified.

If the ipsg=yes and adapter=m3ua parameters are specified, then the lst=a parameter must be specified.

A maximum of 1 IPGW linkset or a maximum of 6 of any other linksets are allowed between any APC and the EAGLE.

If the HIPR2 High Rate Mode feature is turned off, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 500,000. If the HIPR2 High Rate Mode feature is turned on, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 750,000. If the HIPR2 High Rate Mode and 1M System TPS features are turned on, then the sum of the TPS values assigned to all linksets in the system must be less than or equal to 1,000,000.

The value specified for the slktps/rsvdslktps parameter cannot cause the card to exceed the total maximum capacity of the card.

If the ipsg=yes and adapter=m3ua parameters are specified, then the multgc=yes parameter cannot be specified.

If the ipsg=yes and adapter=m3ua parameters are specified, then the tfatcabmlq parameter cannot be specified.

If the action=delete parameter is specified to delete the routing context, then the value specified for the rcontext parameter must be the value used by the specified linkset in the database.

The link must be equipped.

The Link table is corrupt or cannot be found.

If the linkset already contains IPSG links, then the ipsg=no parameter cannot be specified.

If the ipsg=yes and adapter=m3ua parameters are specified, then a secondary adjacent point code cannot be specified for the linkset.

If one or more links in a specified linkset are in service, then the rcontext parameter cannot be specified.

Multiple signaling links in a single linkset cannot share the same association.

If multiple linksets share an association, then the rcontext parameter cannot be specified for only one linkset. 

The value specified for the rcontext parameter must already exist in the database.

If a linkset shares an association with another linkset, then a unique value for the rcontext parameter must be specified for each linkset.

If the ipsg=yes parameter is specified, then the slktps/rsvdslktps parameter must be specified.

If the multgc=yes parameter is specified, then all links assigned to the linkset must be of the same type.

If any of the links are not in the OOS state, then the rcontext parameter cannot be specified.

The ISLSBR feature must be enabled before the islsrsb parameter can be specified.

The FLOBR feature must be turned on before the gttmode parameter can have a value of fcd, fcg, fcgfcd, or fcdfcg.

The SAPC table is corrupt or cannot be found.

The rsls8=yes parameter (see the chg-lsopts command) must be specified for an ANSI linkset before a value greater than 5 can be specified for the islsrsb parameter.

If an ITU linkset is used, then a value of 1 – 4 must be specified for the islsrsb parameter. 

The value specified for the slktps/rsvdslktps parameter must be less than or equal to the value specified for the maxslktps parameter.

The sltset=0 parameter can be specified only for a type A linkset (lst=a).

The value specified for the slktps/rsvdslktps and maxslktps parameters must be within the allowed range.

The ITUTFR (command ent/chg-ls) cannot be specified for a linkset to be configured for APCN16.

The NIS (command ent/chg-ls) cannot be specified for a linkset to be configured for APCN16.

The PPC specified must not be a private point code.

The MTP Restart Equipped (MTPRSE) parameter is only valid for adjacent ANSI nodes in the SS7 domain.

The adapter type specified must be either m3ua or m2pa.

The GTT destination must exist in the DSTN table.

Notes

Any optional parameter that is not specified is not changed.

The links that directly connect the system with a distant node are grouped into one or more linksets. A linkset can contain up to 8 (international standards) or 16 (national standard) signaling links, depending on how the system attributes were defined when the network was created.

Signaling link test acknowledgments (SLTA) are the same type of maintenance message as the SLTMs received on the link.

MTP restart provides an orderly process for bringing signaling links back into service after the system has been isolated and restarted. A greater preference is given to restoring the STP to network service in an orderly fashion than to the speed of recovery. The time required is system dependent as shown:

  • up to 64 LIMs—62 seconds (Link Alignment Delay)
  • 64 - 127 LIMs—97 seconds
  • 128 - 191 LIMs—132 seconds
  • more than 191 LIMs—167 seconds

When two linksets are used as a combined linkset, each linkset should have the same slsci and asl8 values and the same slsocbit and islsrsb/slsrsb values.

Caution:

This is not enforced in the system and there is no warning mechanism if the values of these parameters are not the same for each linkset.

The slsrsb parameter alone does not provide an even distribution of ITU-ISUP messages across all links within a linkset. The system uses all four bits of the SLS to determine the actual link to route messages. Because the static bit is simply rotated within the SLS, all possible values of the SLS field will still not be realized. The slsocbit parameter must also be used to provide an even distribution across all links within the linkset. If both parameters are used for a given linkset, the SLS field is processed in the following order:

  • The SLS is modified using the Other CIC Bit option.
  • The modified SLS is modified again using the Rotated SLS Bit option.
  • The modified SLS is used by the existing linkset and link selection algorithms to select a link.
  • The ISUP message is sent out of the link containing the original, unmodified SLS field.

To modify a secondary adjacent point code, sapc has to be first deleted, then added again.

A 24-bit ITU-N point code can be provisioned as an SAPC only if the APC is not already a 24-bit ITU-N point code.

Only one 24-bit ITU-N point code is allowed to be provisioned as an SAPC.

For a linkset containing either low speed CCS7ITU links if the APC is a 14-bit ITU-N point code, then a 24-bit ITU-N point code cannot be provisioned as an SAPC.

For a linkset containing either low speed CCS7ITU links, if the APC is a 24-bit ITU-N point code, then a 14-bit ITU-N point code cannot be provisioned as a SAPC.

For a linkset containing either low speed CCS7ITU links, if the APC is an ITU-I point code, then either a 24-bit ITU-N point code or a 14-bit ITU-N point code can be provisioned as an SAPC, but not both.

In this command, only ITU-international and ITU national point codes support the spare point code subtype prefix (s-) and the private and spare point code subtype prefix (ps-). All of the point code types support the private (internal) point code subtype prefix (p-).

The ITU National and ITU National China Adjacent Point Code types indicate the format that is used for changeover and changeover acknowledgement messages. China specifies a 16-bit field for data in changeover messages. The FSN occupies the first 12 bits. The trailing 4 bits are spare and are coded as 0. ITU uses a 24-bit field for data in the extended changeover/changeover acknowledgement messages. The FSN is encoded in the first 12 bits. The last 12 bits of the field are spare and are coded as zero.

The randsls parameter value applies to SCCP ITU-T messages and Class0 and ISUP ANSI messages when random SLS generation is set to occur on a per linkset basis (the randsls=perls parameter is specified in the chg-stpopts command).

If the randsls=perls parameter is specified, it is recommended that the linksets in a combined linkset be provisioned with the same randsls value to avoid undesired SLS distribution.

The tfatcabmlq=0 parameter specifies that the system broadcasts TFAs or TCAs only when half the links in the given linkset, or in the combined linkset in which it resides, become available.

A gateway linkset can be configured only from a SEAS terminal and not from a system terminal.

If the gwsa=off and gwsm=on parameters are specified, then all MSUs pass. Error messages are generated if an MSU matches a screening condition.

If the gwsa=on and gwsm=off parameters are specified, then MSUs are screened but messages are not generated.

If the gwsa=off and gwsm=on parameters are specified, then gateway screening is defined to be in the screen test mode. The gateway screening action in the stop action set specified by the actname parameter of the screen set is performed at the end of the screening process.

If the asl8=yes and the lst=a (a linkset containing access signaling links) parameters are specified, then the originator of the MSUs is generating 8-bit SLSs. For other linkset types, the asl8=yes parameter indicates that the adjacent STP is converting 5-bit SLSs to 8-bit SLSs. The SLS in MSUs received by the system on a linkset that has the asl8=yes parameter assigned is not converted. These MSUs are assumed to contain 8-bit SLSs.

If the gwsa=on, gwsm=on, and gwsd=off parameters are specified, then MSUs are screened, and error messages are generated if an MSU is passed when it should have been screened.

The chgmtp3opc parameter is applied on the outgoing linkset.

The chgmtp3opc parameter will be nullified if the sccpopts:mtprgtt option is set to fullgtt.

Incoming SLS Bit Rotation

If the ISLSBR feature is turned on, and Incoming SLS Bit Rotation is applied to an MSU, then the outgoing SLS bit rotation is not applied for that MSU. If the ISLSBR feature is turned off, or Incoming SLS Bit Rotation is not applied to an MSU, then the outgoing SLS bit rotation is applied for that MSU.

The valid ISLSRSB values are 1 – 4 for ITU linksets and 1 – 8 for ANSI linksets.

The randsls parameter is applied on incoming linksets for ANSI messages and on outgoing linksets for ITU messages.

Output

This example shows the output when the secondary point code is changed:

chg-ls:lsn=lsl:spc=100-23-48

    rlghncxa03w 07-07-18 08:16:14 EST  EAGLE 37.5.0
    CAUTION: Linkset SPC has changed - verify remote node’s route.
    Link set table is (114 of 1024) 1% full

    CHG-LS: MASP A - COMPLTD

This example shows the output when GTT mode is changed to FLOBR CdPA:

chg-ls:lsn=ls3:gttmode=fcd

    tekelecstp 09-04-12 13:34:33 EST  EAGLE 41.0.0
    Link set table is (5 of 1024) 1% full.
 
    CHG-LS: MASP A - COMPLTD 
;