Configuring Command Classes

This procedure is used to assign different names to the 32 configurable command classes, and to assign commands to these configurable command classes.

The EAGLE still has the non-configurable command classes: Basic, Database Administration, Debug, Link Maintenance, Program Update, Security Administration, System Maintenance.

The Command Class Management feature allows commands from any of these non-configurable command classes to placed into another command class, which can be assigned to a user or terminal. This gives greater control over the commands that users can use, and to the commands that can be executed from a given terminal. For example, a user needs to use only these commands: rtrv-card, rtrv-ls, rtrv-slk, rtrv-dstn, rtrv-rte, rtrv-user, rtrv-secu-user, rept-stat-db, rept-stat-card, rept-stat-slk, rept-stat-ls, rtrv-gpl, rept-stat-gpl, rept-stat-rte, rept-meas.

To give this user access to these commands without the Command Class Management feature would require the user to be assigned to these command classes: Database, Security Administration, System Maintenance, Program Update, and Link Maintenance. In addition to giving access to the commands this user needs, this user has access to all the commands in these command classes. This would also allow the user to add, change, or remove database entities (cards, signaling links, routes, etc.), to inhibit signaling links, enable features with either the chg-feat or enable-ctrl-feat command that you may not want turned on.

The Command Class Management feature allows these commands to be placed in their own command class which can be assigned to the user. Once the new command class is configured with these commands, the commands will be in their original command classes as well as the new configured command class. The user can be restricted to executing the commands in the new configured command class.

Commands can also be removed from configurable command classes.

When the Command Class Management controlled feature is enabled and activated, these command classes are created with the names U01, U02, U03, ... U32. The names of these command classes, and the descriptions of these command classes can be changed with the chg-cmdclass command. The chg-cmdclass command uses these parameters.

:class – The current class name, shown in the rtrv-cmdclass command output.

:nclass – The new command class name consisting of 1 alphabetic character and 2 alpha-numeric characters.

:descr – The description of the new command class consisting of 1 alphabetic character and up to 31 alpha-numeric characters, enclosed in double quotes.

Commands can be assigned to these configurable command classes using the chg-cmd command. The chg-cmd command uses these parameters.

:cmd – The command being added or removed from the configurable command class.

:class1 - :class8 – The name of the configurable command class that command is being added to or removed from with either yes (to add the command) or no (to remove the command) separated by a dash. For example, to add a command to configurable class db1, the class1=db1-yes parameter would be specified.

Up to eight configurable command classes can be specified with the chg-cmd command. To assign the command to more than eight configurable command classes, the repeat chg-cmd command until the desired number of configurable command classes, up to 32, have been specified.

To configure command classes, the Command Class Management feature must be enabled and turned on. Enter the rtrv-ctrl-feat command to verify whether or not the Command Class Management feature is enabled. If the Command Class Management feature is not enabled or turned on, perform Activating Controlled Featuresto enable andturn on the Command Class Management feature.

Verify that the Command Class Management feature is enabled and turned on, by entering the rtrv-ctrl-feat command.
This is an example of the possible output.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
The following features have been permanently enabled:
Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  off     ----
```
Note:
The rtrv-ctrl-feat command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-ctrl-feat command, see the rtrv-ctrl-feat command description in Commands User's Guide.

If the Command Class Management feature is enabled and turned on (status = on),.

If the Command Class Management feature is not enabled or turned on, perform Activating Controlled Features to enable and turn on the Command Class Management feature. After the Command Class Management feature is turned on, continue the procedure with 2.

Caution:
If the Command Class Management feature is temporarily enabled, the configurable command classes can be assigned and used only for the amount of time shown in the Trial Period Left column in the rtrv-ctrl-feat output.

Display the descriptions of the configurable command classes in the database by entering the rtrv-cmd command.

This is an example of the possible output.

rlghncxa03w 09-05-01 21:15:37 GMT EAGLE5 41.0.0
CMD                 CLASS
alw-slk             link, u11
ent-user            sa
unhb-slk            link
rtrv-attr-seculog   sa, u31
inh-slk             link, abc
rtrv-meas-sched     link, abc, def
act-lbp             link
act-dlk             link
act-slk             link
rtrv-seculog        sa, abc, def, ghi
act-lpo             link
blk-slk             link, abc, u23, u31
dact-lbp            link
canc-dlk            link
inh-card            sys
canc-lpo            link, u01, u02, u03, u04, u05, u06, u07, u08, u09, u10,
                    u11, u12, u13
canc-slk            link
ublk-slk            link, u01, u02, u03, u04, u05, u06, u07, u08, u09, u10,
                    u11, u12, u13, u14, u15, u16, u17, u18, u19, u20, u21,
                    u22, u23, u24, u25, u26, u27, u28, u29, u30, u31, u32
inh-trm             sys, krb
rept-meas           link
.
.
.
chg-meas            link
tst-dlk             link, krb
tst-slk             link

If the desired configurable command class descriptions are in the database, and the commands are in the desired command classes, no further action is necessary. This procedure is finished.

Note:

If the name of a configurable command class is not being changed, continue the procedure with 6.

Display the configurable command class descriptions by entering the rtrv-cmdclass command.

This is an example of the possible output.

rlghncxa03w 09-03-01 21:15:37 GMT EAGLE5 40.1.0
CLASS               DESCR
link                link maintenance commands
sa                  security administration commands
sys                 system maintenance commands
db                  database administration commands
dbg                 debug commands
pu                  program update commands
u01                 configurable command class 1 
krb                 my command class description
u03                 configurable command class 3 
dab                 your command class description
u05                 configurable command class 5 
.
.
.
u32                 configurable command class 32

Change the configurable command class name or description by entering the chg-cmdclass command.
For this example, enter these commands.

chg-cmdclass:class=u01:nclass=db1:descr="retrieve database commands"

chg-cmdclass:class=dab:nclass=s15

chg-cmdclass:class=u03:descr="user commands 3"

Note:
The command classes link, sa, sys, db, dbg, and pu cannot be changed.

When these commands have successfully completed, this message should appear.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CHG-CMDCLASS: MASP A - COMPLTD
```
Verify the changes by entering the rtrv-cmdclass command, specifying the command class name, or new command class name if the command class name was changed, used in 4 .
For this example, enter these commands.

rtrv-cmdclass:class=db1

This is an example of the possible output.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CLASS               DESCR
db1                 retrieve database commands
```
rtrv-cmdclass:class=s15

This is an example of the possible output.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CLASS               DESCR
s15                 your command class description
```
rtrv-cmdclass:class=u03

This is an example of the possible output.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CLASS               DESCR
u03                 user commands 3
```
Add or remove a command from the desired command classes by entering the chg-cmd command.
For this example, enter these commands.

chg-cmd:cmd=rtrv-card:class1=db1-yes

chg-cmd:cmd=tst-dlk:class1=krb-no

When these commands have successfully completed, this message should appear.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CHG-CMD: MASP A - COMPLTD
```
Up to eight configurable command classes can be specified with the chg-cmd command. If you wish to assign the command to more than eight configurable command classes, but no more than 32 configurable command classes, repeat this step until the desired configurable command class assignments have been made.
Verify the changes by entering the rtrv-cmd command specifying the cmd parameter value used in step 6.
For this example, enter these commands.

rtrv-cmd:cmd=rtrv-card

This is an example of the possible output.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CMD                 CLASS
rtrv-card           db, db1
```
rtrv-cmd:cmd=tst-dlk

This is an example of the possible output.
```
rlghncxa03w 06-10-01 21:15:37 GMT EAGLE5 36.0.0
CMD                 CLASS
tst-dlk             link
```

Back up the new changes using the chg-db:action=backup:dest=fixed command.

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-12 Configuring Command Classes

Sheet 1 of 2

Sheet 2 of 2