Changing the Attributes of a Loopset

This procedure is used to modify a loopset in the following ways using the chg-loopset command.

Change the mode of operation
Replace all the point codes
Replace a specific point code
Replace two specific point codes
Append additional point codes

The chg-loopset command uses these parameters.

:name – The name of the loopset to be modified, shown in the rtrv-loopset output.

:force – This parameter has two values, yes or no. The value yes allows the attributes of a loopset to be changed if the loopset is assigned to entries in either the rtrv-gtt or rtrv-gta outputs. The value no requires that references to the loopset must be removed from the GTT or GTA entries before the attributes of the loopset are changed. Perform one of these procedures to remove a reference to the loopset, depending on whether or not the EGTT feature is on. The status of the EGTT feature is shown in the rtrv-feat command output.

If the EGTT feature is not on – Enter the rtrv-gtt command to verify the loopset references. Perform the Changing a Global Title Translation procedure and change the loopset reference to NONE or to another loopset name, or remove the global title translation by performing the Removing a Global Title Translation procedure.
If the EGTT feature is on – Enter the rtrv-gta command to verify the loopset references. Perform Changing Global Title Address Information and change the loopset reference to NONE or to another loopset name, or remove the entry by performing the Removing Global Title Address Information procedure.

:pcl/pcla/pcli/pcln/pcln24 – The point code, either an ANSI point code (pcl/pcla), ITU-I or ITU-I spare point code (pcli), a 14-bit ITU-N or 14-bit ITU-N spare point code (pcln), or a 24-bit ITU-N (pcln24) point code, assigned to the loopset shown in the rtrv-loopset output that is to be replaced by a new point code. This point code is the first or the only point code that can be replaced when the chg-loopset command is used to replace two specific point codes or a single point code.

:pc2/pc2a/pc2i/pc2n/pc2n24 – The point code, either an ANSI point code (pc2/pc2a), ITU-I or ITU-I spare point code (pc2i), a 14-bit ITU-N or 14-bit ITU-N spare point code (pc2n), or a 24-bit ITU-N (pc2n24) point code, assigned to the loopset shown in the rtrv-loopset output that is to be replaced by a new point code. This point code is the second point code that can be replaced when the chg-loopset command is used to replace two specific point codes.

:rpcl/rpcla/rpcli/rpcln/rpcln24 – The point code, either an ANSI point code (rpcl/rpcla), ITU-I or ITU-I spare point code (rpcli), a 14-bit ITU-N or 14-bit ITU-N spare point code (rpcln), or a 24-bit ITU-N (rpcln24) point code, that is used to simultaneously replace all the point code(s) assigned to the loopset shown in the rtrv-loopset output.

:npcl/npcla/npcli/npcln/npcln24 – The point code, either an ANSI point code (npcl/npcla), ITU-I or ITU-I spare point code (npcli), a 14-bit ITU-N or 14-bit ITU-N spare point code (npcln), or a 24-bit ITU-N (npcln24) point code that replaces the first or the only specified point code when the chg-loopset command is used to replace two specific point codes or a single point code.

:npc2/npc2a/npc2i/npc2n/npc2n24 – The point code, either an ANSI point code (npc2/npc2a), ITU-I or ITU-I spare point code (npc2i), a 14-bit ITU-N or 14-bit ITU-N spare point code (npc2n), or a 24-bit ITU-N (npc2n24) point code that replaces the second specified point code when the chg-loopset command is used to replace two specific point codes.

:apcl/apcla/apcli/apcln/apcln24 – The point code, either an ANSI point code (npcl/npcla), ITU-I or ITU-I spare point code (npcli), a 14-bit ITU-N or 14-bit ITU-N spare point code (npcln), or a 24-bit ITU-N (npcln24) point code that can be appended to the set of point codes assigned to the loopset shown in the rtrv-loopset output.

:mode – The mode of operation of the SCCP Loop Detection feature. This parameter can have either of the two values Notify and Discard.

Display the loopsets in the database by entering this command. This is an example of the possible output
rtrv-loopset:num=1000:force=yes

Note:
>If the rtrv-loopsetcommand is entered with no other parameters specified, a maximum of 50 entries are displayed. To display more than 50 entries, the force=yes parameter must be specified with the rtrv-loopset command and the num parameter value must be greater than 50. Since there can be a maximum of 1000 loopsets in the database, to display all the loopsets in the database, the force=yes and num=1000 parameters must be specified with the rtrv-loopsetcommand.

This is an example of the possible output.
```
rlghncxa03w 06-10-18 08:52:38 GMT  EAGLE Rel 35.6.0
LoopSet   Mode     Point Codes
==========================================================================
rtp1      notify   005-005-005       007-007-007      (ANSI)
                   003-004-003       003-007-003
                   005-007-005       007-004-007
                   005-004-005

rtp2      notify   002-002-002       003-003-003      (ANSI)
                   004-004-004       005-005-005

LOOPSET table is (2 of 1000) 1% full
```
If error message E4565 is displayed or if no loopsets are displayed, this procedure cannot be performed.

Note:
If the force=yes parameter will be specified with the chg-loopset command, a loopset can be changed without changing or deleting the association, if any, of the loopset with a GTT or a GTA. Skip steps 2 through 6 and go to step 7.
Verify whether or not the EGTT feature is turned on by entering the rtrv-feat command. If the EGTT featured is turned on, the EGTT field should be set to on.

Note:
The rtrv-feat command output contains other fields that are not used by this procedure. If you wish to know about all the fields displayed by the rtrv-feat command, refer to the rtrv-feat command description in Commands User's Guide.

Note:
If the EGTT feature is not turned on, skip step 3 and step 4 and go to step 5.

Display the GTT sets in the database using the rtrv-gttset command. This is an example of the possible output.

rlghncxa03w 09-07-07 00:27:31 GMT EAGLE5 41.1.0

GTTSN      NETDOM  SETTYPE  NDGT
setans015  ansi    CDGTA    6
set1       ansi    CDGTA    6

GTT-SET table is (2 of 2000) 1% full.

Display the global title address (GTA) information for a GTT set from step 3. Execute the rtrv-gta command with the gttsn parameter value shown in the output of step 3 and with the name of the loopset being changed, specified with the loopset parameter. For this example, enter this command.
rtrv-gta:gttsn=set1:loopset=rtp1

This is an example of the possible output.
```
rlghncxa03w 09-05-07 00:27:31 GMT EAGLE5 41.0.0

GTTSN      NETDOM  SETTYPE  NDGT
set1       ansi    CDGTA    6

GTT TABLE IS   1 % FULL (2 of 269999)

START GTA END GTA   XLAT   RI     PCA
919460    919460    DISC
919461    919461    DPC    SSN    002-002-002
     SSN=--- CCGT=no  NTT=---
     LOOPSET = rtp1    FALLBACK=sysdflt  TESTMODE=off
     OPTSN=-------- CGSELID=---- CDSELID=----- OPCSN=---------

Command Retrieved 2 Entries
```
If any of the displayed entries reference the loopset being modified, for those entries, perform Changing Global Title Address Information and change the loopset reference to NONE or to another loopset name, or remove the entry by performing the Removing Global Title Address Information procedure.

If the displayed entries do not reference the loopset being removed, repeat this step with the other GTT set names displayed in step 3.

When all the GTT set names have been displayed and all applicable global title translation entries have been changed or removed in this step, go to step 7.

Display the translation types in the database using the rtrv-tt command.

This is an example of the possible output.

rlghncxa03w 07-03-25 09:42:31 GMT  EAGLE5 35.6.0
TYPEA      TTN        NDGT
1          lidb       5
2          c800       10
3          d700       6
5          scp1       6
10         scp2       6
15         scp3       3

ALIAS      TYPEA
30         5
40         10
50         3
65         3

TYPEI      TTN        NDGT
105        itudb      8

ALIAS      TYPEI
7          105

TYPEN      TTN        NDGT
120        dbitu      7

ALIAS      TYPEN
8          120

Display the global title translations in the database using the rtrv-gtt command specifying a translation type from the rtrv-tt command output shown in step 5 and with the name of the loopset being removed, specified with the loopset parameter. For this example, enter this command.
rtrv-gtt:typea=10:loopset=rtp1

This is an example of the possible output.
```
rlghncxa03w 08-10-25 09:43:31 GMT  EAGLE5 39.2.0
TYPEA  TTN        NDGT  
10     scp2       6

GTT TABLE IS  10 % FULL    (27000 of 269999)

START GTA             END GTA               XLAT   RI     PC
615370                615380                DPCSSN SSN    003-003-003
     MAPSET=6      SSN=254 NGT=---
     LOOPSET = rtp1

Command Retrieved 1 Entries
```
If any of the displayed entries reference the loopset being modified, for those entries, perform the Changing a Global Title Translation procedure and change the loopset reference to NONE or to another loopset name, or remove the global title translation by performing the Removing a Global Title Translation procedure.

If the displayed entries do not reference the loopset being removed, repeat this step with the other translation types displayed in step 5.

When all the translation types have been displayed and all applicable global title translation entries have been changed or removed in this step, go to step 7.

If all the point codes of the loopset are being replaced simultaneously, specify the chg-loopset command with the name of the loopset with the rpc1 parameter.

For this example, enter this command to replace all the point codes of the loopset simultaneously.

chg-loopset:name=rtp1:rpc1a=003-003-003,001-001-001,002-002-002

This message should appear.

rlghncxa03w 07-02-19 10:37:19 GMT  35.6.0
LOOPSET table is (1 of 1000) 1% full
CHG-LOOPSET: MASP A - COMPLTD

If a single specified point code value is to be modified in the loopset, specify the chg-loopset command with the name of the loopset, the point code you wish to change and the new point code.

For this example, enter this command to modify a single point code in the loopset.

chg-loopset:name=rtp1:pc1=003-003-003:npc1=003-004-005

This message should appear.

rlghncxa03w 07-02-19 10:50:36 GMT  35.6.0
LOOPSET table is (1 of 1000) 1% full
CHG-LOOPSET: MASP A - COMPLTD

If two specified point code values are to be modified in the loopset, specify the chg-loopset command with the name of the loopset, the two point codes you wish to change and the new point codes.

For this example, enter this command to modify two specific point codes in the loopset.

chg-loopset:name=rtp1:pc1=003-004-005:npc1=003-004-007:pc2=001-001-001:npc2=001-003-004

This message should appear.

rlghncxa03w 07-02-19 10:59:08 GMT  35.6.0
LOOPSET table is (1 of 1000) 1% full
CHG-LOOPSET: MASP A - COMPLTD

If only the mode parameter is to be modified in the loopset, specify the chg-loopset command with the name of the loopset, the new value of the mode parameter.

For this example, enter this command to modify two specific point codes in the loopset.

chg-loopset:name=rtp1:mode=discard

This message should appear.

rlghncxa03w 07-02-19 11:04:52 GMT  35.6.0
LOOPSET table is (1 of 1000) 1% full
CHG-LOOPSET: MASP A - COMPLTD

If point codes are to be appended in the loopset, specify the chg-loopset command with the name of the loopset, the point codes to be appended.

For this example, enter this command to append the point codes to the loopset.

chg-loopset:name=rtp1:apcla=7-7-7,3-3-3,5-5-5

rlghncxa03w 07-02-19 11:19:26 GMT  35.6.0
LOOPSET table is (1 of 1000) 1% full
CHG-LOOPSET: MASP A - COMPLTD

Refer to the following table for the chg-loopset parameter combinations.

Table 2-60 Changing a Loopset Parameter Combinations

Changing Mode only	Replacing All Point Codes	Replacing One Specific Point Code	Replacing two Specific Point Codes	Appending Point Codes
Mandatory Parameters
Name (See Note 1)	Name (See Note 1)	Name (See Note 1)	Name (See Note 1)	Name (See Note 1)
Mode	RPCL/RPCLA/ RPCLI/RPCLN/ RPCLN24	PC1/PC1A/ PC1I/PC1N/ PC1N24	PC1/PC1A/ PC1I/PC1N/ PC1N24	APCL/APCLA/ APCLI/APCLN/ APCLN24
		NPC1/NPC1A/ NPC1I/NPC1N/ NPC1N24	NPC1/NPC1A/ NPC1I/NPC1N/ NPC1N24
			PC1/PC1A/ PC1I/PC1N/ PC1N24
			NPC2/NPC2A/ NPC2I/NPC2N/ NPC2N24
Optional Parameters
Force=yes	Mode	Mode	Mode	Mode
	Force=yes	Force=yes	Force=yes	Force=yes
Parameter Values: Name – Loopset name Mode – Mode of operation APCL/APCLA/APCLI/APCLN/APCLN24 – Appending point code list RPCL/RPCLA/RPCLI/RPCLN/RPCLN24 – Replacing point code List PC1/PC1A/PC1I/PC1N/PC1N24 – Point code to be replaced first PC2/PC2A/PC2I/PC2N/PC2N24– Point code to be replaced after the replacement of the first point code when two specific point codes are replaced NPC1/NPC1A/NPC1I/NPC1N/NPC1N24– Point code that replaces the first specified point code or the only point code when two specific point codes or a single specified point code is replaced NPC2/NPC2a/NPC2I/NPC2N/NPC2N24– Point code that replaces the second specified point code when two specific point codes are replaced FORCE – yes, no. Default = no
Notes: The `name` parameter can take up to 8 alphanumeric characters. The first character must be an alphabetic character. The `rpcl` parameter allows the replacement of a maximum of six point code in a loopset. The `apcl` parameter allows a maximum of six point codes to be appended to a loopset per execution of the `chg-loopset` command. A maximum of 12 point codes can be appended to any loopset using the `apcl` parameter.

Note:

If the loopset being modified in this step is referenced by an entry shown in either the rtrv-gtt or rtrv-gta outputs, and those entries have not been removed or the loopset assignment for these entries has not been changed, the force=yes parameter must be specified with the chg-loopset command.

Verify the changes using the rtrv-loopset command with the name of the loopset specified in step 7.

In this example enter this command.

rtrv-loopset:name=rtp1

The following message should appear if you have replaced all the point codes in step 7.

rlghncxa03w 07-02-19 19:42:34 GMT  35.6.0
LoopSet    Mode     Point Codes
==========================================================================
rtp1     discard    003-003-003       002-002-002      (ANSI)
                    001-001-001

The following message should appear if you have modified a single specific point code in step 7.

rlghncxa03w 07-02-19 19:49:47 GMT  35.6.0
LoopSet    Mode     Point Codes
==========================================================================
rtp1     discard    003-004-005       002-002-002      (ANSI)
                    001-001-001

The following message should appear if you have modified two specific point codes in step 7.

rlghncxa03w 07-02-19 19:56:57 GMT  35.6.0
LoopSet    Mode     Point Codes
==========================================================================
rtp1     discard    003-004-007       002-002-002      (ANSI)
                    001-003-004

The following message should appear if you have appended point codes in step 7.

rlghncxa03w 07-02-19 20:03:21 GMT  35.6.0
LoopSet    Mode     Point Codes
==========================================================================
rtp1     discard    003-004-007       002-002-002      (ANSI)
                    001-003-004       007-007-007
                    003-003-003       005-005-005

The following message should appear if you have only changed the mode in step 7.

rlghncxa03w 07-02-19 20:09:00 GMT  35.6.0
LoopSet    Mode     Point Codes
==========================================================================
rtp1     notify     003-003-003       002-002-002      (ANSI)
                    001-001-001

Backup the new changes using the chg-db:action=backup:dest=fixed commend. These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first.
```
BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.
```
If a loopset was changed in step 7 and the force=yes was not used in step 7, and you wish to assign this loopset to the GTT or GTA entries that were removed or changed in steps 4 or 6, go to step 10.

If any of the following actions were performed in step 7, this procedure is finished. Do not perform step 10.
- A loopset was modified with the force=yes parameter in step 7.
- A loopset was modified in step 7, the force=yes was not used in step 7, and you do not wish to assign this loopset to the GTT or GTA entries that were removed or changed in steps 4 or 6.
Assign the loopset specified in step 7 to the GTT or GTA entries that were removed or changed in steps 4 or 6.
If the EGTT feature is not on, perform one of these procedures:
- Adding a Global Title Translation procedure if the GTT entry was removed from the database in step 6.
- Changing a Global Title Translation procedure if the GTT entry was changed in step 6.
If the EGTT is on, perform one of these procedures:
- Adding Global Title Address Information procedure if the GTA entry was removed from the database in step 4.
- Changing Global Title Address Information procedure if the GTA entry was changed in step 4.

Figure 2-176 Change the Attributes of a Loopset - Sheet 1 of 3

Figure 2-177 Change the Attributes of a Loopset - Sheet 2 of 3

Figure 2-178 Change the Attributes of a Loopset - Sheet 3 of 3