CP-AMS can present the actions associated with a matched message or default condition to the operator without actually performing the actions. This capability allows the database creator to test and debug a SMART AMS or CP-AMS database without fear of adverse system effects. Test mode can be applied to an entire CP-AMS run-time system using the DBUG option of the OM keyin, or it can be applied to a single pattern in the database by specifying the TEST parameter in a BADB TYPE command. If you use the OM DBUG option, all actions (including AMS default actions) are displayed in debug format.
The debug or test representation of the actions consists of a series of LG console commands. The first LG command is either an $AMS-MTCH$ or $AMS-DFLT$ message. An $AMS-MTCH$ message indicates the associated actions are the result of a matched pattern in the AMS database. An $AMS-DFLT$ message indicates that the associated actions are default actions because of the system operation mode and mode options.
A match/default message is followed by an $AMS-MSG$ message, which contains the text of the message that caused the actions. This $AMS-MSG$ message is preceded by an $AMS-INFO message if it contains non-ASCII characters. The information message explains that blanks were substituted for non-ASCII characters.
Non-ASCII characters cannot be sent to the host by an LG command.
The message text message is followed by a list of action messages. These messages represent the actions that would have occurred for the current system operation mode. These messages are preceded by $AMS-ERR$ messages if CP-AMS detects an error while generating the action.
Action text messages have the format:
LG $AMSaction-id$ n$ action
where:
action-id
is a 4-character (maximum) abbreviation of the action type. Values shorter than four characters are padded on the right with spaces. The following table lists the abbreviations used.
| Action-id | Meaning |
|---|---|
| ACTV | Activate a database |
| ALRM | Alarm |
| ANS | Answer an outstanding read-and-reply message |
| CMD | Command |
| CREA | Create a member of a variable group |
| DACT | Deactivate the active database |
| DEST | Destroy a member of a variable group |
| DISP | Display supplemental text |
| ELIF | ELSEIF conditional logic action |
| ELSE | ELSE conditional logic action |
| ENDI | ENDIF conditional logic action |
| EXE | Execute keyins from an OS 2200 Console View macro |
| HILT | Highlight message and supplemental text |
| HOLD | Hold message and supplemental text |
| IF | IF conditional logic action |
| RELS | Release held messages |
| RSET | Reset the value of a variable or member of a variable group to its default value |
| RSPN | Respond to a read-and-reply message |
| SET | Set the value of a variable or member of a variable group |
| SPRS | Suppress the matched message |
| TCMD | Transparent command |
| TEXE | Transparently execute keyins from an OS 2200 Console View macro |
n
is an integer such as 1, 2, or 3 that represents the level of nesting in a nested conditional construction.
action
is the text associated with the action (if any).