The command used to start ATMCOMM is also used to select the ATMCOMM options that affect the functions ATMCOMM performs. The options specified on the command line will specify the types of messages ATMCOMM intercepts, whether to keep a log file of commands and messages, whether a trace file is started, or whether to display the message type and origin.
Your selections can be changed while ATMCOMM is running using the ATMCOMM commands. The command format for both the PROFILE EXEC file and the CMS command line is as follows:
ATMCOMM args
The value args represents the ATMCOMM options. You can specify any of the following options on this statement. Multiple options are separated from each other by a space. The capital letters indicate the allowable abbreviation for each option.
The following information provides an explanation of each option:
This option turns the ATMCOMM logging feature on or off. While the LOG option is active, the logging feature creates a CMS file in which every captured command and message is logged, along with a time stamp and additional message information. For more information on this option, see the appendix "ATMCOMM Console Log Operations."
Default: NOLOG.
This turns the ATMCOMM trace feature on or off. When TRACE is active, you can receive ATMCOMM debugging information. This option is similar to the logging feature, but it maintains a disk file in a special binary internal format.
Default: NOTRACE.
This controls whether each message displayed through ATMCOMM should have the message type and origin displayed in the first two tokens of the line. If you enable this option, 18 extra characters are displayed at the start of each line.
Default: NOPREFIX.
Note: The status of LOG, TRACE, and PREFIX remains unchanged when you stop and restart ATMCOMM. However, if the ATMCOMM nucleus extension is reloaded, the status defaults to NOLOG, NOTRACE, and NOPREFIX.
The remaining options, MESSAGE, WARNING, CPCONIO, EMSG, and IMSG specify which types of console messages ATMCOMM should capture. If none of these is specified, ATMCOMM captures only SCIF and SMSG traffic. These options do not remain set if the ATMCOMM STOP command is issued. You must reenter the message types each time you restart ATMCOMM. Each message type option causes ATMCOMM to issue a CP SET command for the corresponding message type. For example, if you include message type CPCONIO, ATMCOMM issues a SET CPCONIO IUCV command when it starts processing.
When you stop ATMCOMM in an orderly way (by issuing ATMCOMM STOP), each of the message types reverts to the setting in effect when ATMCOMM was initially started. However, if you perform an IPL on CMS while ATMCOMM is running, the settings made by ATMCOMM remain in effect.
The settings for message types that you omit from the startup command line remain as set at ATMCOMM startup. For example, if you enter SET EMSG OFF before starting ATMCOMM, EMSG remains off when ATMCOMM is running, unless you specify EMSG as a startup parameter, in which case it is set to IUCV. This method allows you to set certain message types to IUCV before starting ATMCOMM, or to set them as a part of initiating ATMCOMM.
Once ATMCOMM is running, you can use the CP SET command to change the setting for any message type. You also can use the ATMCOMM program commands, LOG, TRACE, or PREFIX (or NOLOG, NOTRACE, and NOPREFIX) to control each of these functions.
The command ATMCOMM NOLOG, for example, turns off the ATMCOMM logging feature. Message types MESSAGE, WARNING, CPCONIO, EMSG, and IMSG are only valid during startup, however, and cannot be used as internal commands when ATMCOMM is running.
For most sites, all message types should be enabled for ATMCOMM. To do this, enter the following statement on the last line of the operator PROFILE EXEC file:
ATMCOMM MESSAGE WARNING CPCONIO EMSG IMSG
To enable all of the message types and turn on the ATMCOMM logging feature, enter the following statement on the last line of the operator PROFILE EXEC file:
ATMCOMM MESSAGE WARNING CPCONIO EMSG IMSG LOG
|
Copyright © 2014 CA.
All rights reserved.
|
|