Configuring the Restore Device State Option

This procedure is used to configure the restore device state option using the chg-stpopts command with the rstrdev value for the on or off parameters of the chg-stpopts command. The system default value is off.

If the value of the restore device state option is off ( off=rstrdev ), the EAGLE does not retain the manually initiated state (for example, OOS-MT-DSBLD) for the signaling links, TCP/IP data links, cards, or the terminals after either the init-sys command is executed, or when a MASP role change occurs (the active MASP becomes the standby MASP and the standby MASP becomes the active MASP). After the init-sys command executes, the EAGLE attempts to bring all provisioned links, cards, and terminals on line, including those that were previously out of service. You will need to manually put each device back into its previous state after the EAGLE is back on line. If the init-sys command is being executed, it is advisable to print or electronically capture the output of the EAGLE’s rept-stat-slk, rept-stat-dlk, rept-stat-card, and rept-stat-trm commands for reference before issuing the init-sys command. During a MASP role change, current processing for the role change occurs and the state of the out-of-service devices may change. To restore a device to its previous state, issue the appropriate inhibit/deactivate command listed in Commands User's Guide in the Related Commands section for each of the above rept-stat commands.

If the value of the restore device state option is on ( on=rstrdev ), the state the signaling links, TCP/IP data links, cards, and terminals is not changed after the init-sys command is executed or a MASP role change occurs. No manual intervention is required to put the device back into its previous state after the EAGLE is back on line.

If the restore device state option is on and the database is being restored with the chg-db:action=restore command, the state of the cards, SS7 signaling links, TCP/IP data links, and terminals before the chg-db:action=restore and init-sys commands are performed will not be maintained after these commands are performed. The persistent device state table becomes obsolete and is disabled. UIM 1257 is generated.

rlghncxa03w 06-10-01 16:07:48 GMT  EAGLE5 36.0.0
1234.1257    SYSTEM       INFO  DB Restore has cleared and disabled PDS 

1. Display the existing values for the restore device state parameter by entering the rtrv-stpopts command.

   The value for the restore device state parameter is shown in the RSTRDEV field. This is an example of the possible output.

   rlghncxa03w 06-10-01 16:02:05 GMT  EAGLE5 36.0.0
   STP OPTIONS
   -----------------------
   RSTRDEV            off
   

   Note:

   The rtrv-stpopts command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-stpopts command, see the rtrv-stpopts command description in Commands User's Guide.
2. Change the restore device state parameter.

   To change the rstrdev parameter to on, enter this command.

   chg-stpopts:on=rstrdev

   To change the rstrdev parameter to off, enter this command.

   chg-stpopts:off=rstrdev

   When this command has successfully completed, this message should appear.

   rlghncxa03w 06-10-01 00:22:57 GMT  EAGLE5 36.0.0
   CHG-STPOPTS: MASP A - COMPLTD
   

3. Verify the changes using the rtrv-stpopts command.

   If the on=rstrdev parameter was specified in 2, this is an example of the possible output.

   rlghncxa03w 10-07-17 16:02:05 GMT  EAGLE5 42.0.0
   STP OPTIONS
   -----------------------
   RSTRDEV             on
   

   If the off=rstrdev parameter was specified in 2, this is an example of the possible output.

   rlghncxa03w 10-07-17 16:02:05 GMT  EAGLE5 42.0.0
   STP OPTIONS
   -----------------------
   RSTRDEV            off
   

   Note:

   The rtrv-stpopts command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-stpopts command, see the rtrv-stpopts command description in Commands User's Guide.
4. Backup the new changes using the chg-db:action=backup:dest=fixedcommand.

   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.
   

Figure 4-29 Configuring the Restore Device State Option