You can use the following options for the OM keyin when switching operating modes:
AAMS
In attended mode, AAMS turns on CP-AMS database pattern matching. Pattern matching is always on in casual and unattended modes.
OMKEY has two SOLAR installation modes that affect the AAMS option:
SOMKEYAMSON
With this installation mode, the AAMS option is on by default when you enter the OM,A keyin. You need not enter the keyin OM,A ON/AAMS to enable CP-AMS database matching in attended mode. However, to disable CP-AMS database pattern matching in attended mode, you must enter the keyin OM,A OFF/AAMS on each mode change to attended mode.
SOMKEYAMSOFF
With this installation mode, the AAMS option is off by default when you enter the OM,A keyin. To enable database pattern matching in attended mode, you must enter the keyin OM,A ON/AAMS on each mode change to attended mode.
For more information about the SOLAR installation modes, see the software Products Installation Guide.
DBUG
Causes CP-AMS to run in Test mode, where all matches in the CP-AMS database and actions generated by CP-AMS are recorded in the system log file using LG (log file entry) keyins. CP-AMS does not execute actions in Test mode.
TRME
In unattended mode, aborts any nonprivileged run that issues a read-and-reply message that does not match a pattern in the CP-AMS database. CP-AMS sends an E keyin to terminate the run and produces a blank response to the outstanding message. CP-AMS also sends an LG keyin to indicate why it is terminating the run. This LG keyin records the reason for termination in the run's print file.
This option eliminates runs hanging due to unanswered messages when no operator is present. If CP-AMS matches the message in the active database, the console message is considered answered even if CP-AMS does not execute any actions. This also occurs if the matching pattern is in Test mode. CP-AMS is in Test mode if it matches a test pattern (one with TEST specified in the BADB TYPE command or if you have specified the DBUG option on the OM keyin. CP-AMS maintains a list of currently unanswered read-and-reply messages, so that if the TRME option is enabled later, CP-AMS aborts runs associated with the messages in this list.
Refer to F.8 for additional information about the TRME option with a CP-AMS database.
UALM
In casual or unattended modes, sounds an alarm for runs that terminate abnormally. The alarm is issued only if the abnormal termination message does not match any pattern in the active CP-AMS database. The run's read-only abnormal termination message has one of the following forms:
run-id ERROR FIN
run-id FAC ERROR FIN
run-id ABORT FIN
If CP-AMS matches the termination message in the active database, the console message is considered answered even if CP-AMS does not execute any actions. CP‑AMS also matches this message when the Exec appends the time that the run ended to the message. This option is most useful for production systems with very stable jobs.
Only the primary read-only termination message sounds an alarm.
These options are not valid in all operating modes. The following table shows the relationships between the various operating modes and the OM keyin options:
Option | Attended | Casual | Unattended |
AAMS | Allowed | Implicit | Implicit |
DBUG (applies to all the options turned on for a particular mode) | Allowed | Allowed | Allowed |
TRME | Not allowed | Not allowed | Allowed |
UALM | Not allowed | Allowed | Allowed |
Examples of OM Keyins
In the following example, the keyin changes the operating mode to casual. CP-AMS pattern matching is on and CP-AMS executes any actions defined with casual mode.
OM,C
In the next example, assume that the current operating mode is casual. The first keyin changes the operating mode to attended. CP-AMS pattern matching remains on and CP-AMS executes actions defined with attended mode. The second keyin leaves the operating mode as attended and turns CP-AMS pattern matching off. The third keyin changes the operating mode to unattended mode and turns pattern matching on.
OM,A OM,A OFF/AAMS OM,U
In the following example, the keyin changes the operating mode to casual and turns Test mode on (since the DBUG option is specified). CP-AMS pattern matching is on and CP‑AMS logs, rather than executes, actions defined with casual mode.
OM,C ON/DBUG
The following OM keyin changes the operating mode to unattended, turns Test mode off, and turns the UALM option on. CP-AMS pattern matching is on and CP-AMS executes actions defined with unattended mode. Additionally, CP-AMS sounds an alarm when a run terminates abnormally.
OM,U OFF/DBUG,ON/UALM
In the next example, the keyin changes the operating mode to unattended and turns on the TRME and UALM options. CP-AMS pattern matching is on and CP-AMS executes actions defined with unattended mode, sounds an alarm when a run terminates abnormally, and aborts non-privileged runs that issue a read-and-reply message.
OM,U ON/TRME/UALM
In the following example, assume that the operating mode is casual. This OM keyin turns on the TRME, UALM, and DBUG options. These options take effect only when the next operating mode change to unattended is performed. Since no mode change occurred, CP-AMS pattern matching is on and CP-AMS executes actions defined with casual mode.
OM ON/TRME/UALM/DBUG
In the next example, the OM keyin causes the OMKEY background run to send the message, "TERMINATE CMR NOW", to the console. CP-AMS can match this message and execute automatic actions.
OM,M TERMINATE CMR NOW