In Test mode, CP-AMS generates a series of unsolicited LG (log file entry) keyins for each message that matches a pattern in the CP-AMS database, including system default actions.
Note: Display enhancement and automation actions are logged but not executed during this mode. However, conditional logic actions and actions performed on user-defined variables and variable groups are logged and executed during Test mode. As a result, the values of variables change.
LG $AMS-DFLT$
Produced when CP-AMS does not find the message in the active database. CP-AMS generates a default action.
LG $AMS-MTCH$GROUP = 'group-id', NBR = pattern-number
Produced when CP-AMS matches a pattern match in the active CP-AMS database to a console message. This keyin includes the group-id and number of the matched pattern. Although it is displayed in uppercase, the group-id is stored exactly as entered in the CP-AMS database. It is not case sensitive.
LG $AMS-MSG $msgtext
This keyin includes the original console message text. The system logs only the portion of the message text CP-AMS used to perform the match. The message response number and any run-id attached by the Exec are stripped off.
LG $AMS-action-id$ n$ action
This keyin is generated for each of the actions CP-AMS would execute, including automation actions, display enhancement actions, actions performed on variables and variable groups, and actions performed with conditional logic.
The variable portions of this keyin are:
action-id
is an abbreviation (of up to four characters) of the action type. The following abbreviations are 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 a variable to its default value |
| RSPN | Respond to a read-and-reply message |
| SET | Set the value of a variable |
| SPRS | Suppress the message |
| TCMD | Transparent command |
| TEXE | 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 logic action. This part of the message is present only when the message results from actions executed from within an IF-ELSEIF-ELSE-ENDIF construction (see 4.24).
action
is the text associated with the action (if there is any).
LG $AMS-INFO$ BLANKS SUBSTITUTED FOR NON-ASCII CHARACTERS
CP-AMS generates this keyin prior to LG keyins with a message or action that contains non-ASCII characters.
LG $AMS-MBR$ member-name
where member-name is the name of a member of a variable group (see 3.4) that was set, reset, created, or destroyed.
LG $AMS-WAIT$ time units
where time is the number of seconds or minutes that the execution of the action would be delayed and units is either MINUTES or SECONDS.
LG $AMS-RSLT$ result
where result is the result of the expression of an IF, ELSEIF, or SET command.
Example
The following LG keyins illustrate what could be generated as a result of one console message:
LG $AMS-MTCH$GROUP='GROUP1', NBR=24 LG $AMS-MSG $CMS ERROR FIN LG $AMS-CMD $RC CMS LG $AMS-ALRM$13 LG $AMS-HOLD$ LG $AMS-HILT$ YELLOW
You can use a data reduction program on these console entries in the system log file. Because an $AMS-DFLT$ or $AMS-MTCH$ message precedes each set of actions, you can determine the cause and effect of messages and actions.
Note: The console message echoed in the log message and any associated action text may be truncated because of the limitation on the number of characters that an LG keyin can contain. Therefore, an LG keyin may not completely reflect the actual actions CP-AMS performs when not in Test mode.