Using console operator commands

Automated Tape Allocation Manager (ATAM) offers operators several different console commands that can be used to perform a variety of functions, such as display the status of ATAM. The commands can also be used to dynamically alter the ATAM configuration.

All commands are intended to be modifiers of the MVS modify (F) command. The command format is as follows:

F ATHPROC,command

The following table describes this format:

Table 1. Format of operator commands
Item	Description
F	This is the letter used for the MVS "modify" command.
ATHPROC	This refers to the job name of the ATAM started task, which in this example is ATHPROC.
command	This refers to an ATAM operator command. All of the operator commands are described in this chapter. Most of the commands consist of a single letter, followed by command modifiers, if required.

For example, if an operator wanted to list (L) the status of tape devices known to ATAM, the operator would type the following command:

F ATHPROC,L

Please note that any dynamic changes made to the ATAM configuration with console operator commands are not saved between the stop and start cycle of the ATAM started task. If you wish to issue a series of commands for each ATAM started task cycle, you must save the commands in a Commands member. Commands contained in the ATAM Commands member are executed each time ATAM is started. For more information on how to use an ATAM Commands member, refer to Customizing the Commands member.

For the examples in this chapter, the following items are used:

Table 2. Terms used in examples
Term	Description
SYSA	Refers to the local system. All of the examples in this chapter show the commands being issued on SYSA.
RMT1, RMT2, and so on	Refers to remote systems that are running ATAM and have been defined in ATAM's configuration data set on SYSA.
ATHPROC	Refers to the job name for the ATAM started task.
xxxx xxxx-yyyy	Refers to a device or a range of devices.The device specification is an IBM-format UCB address. When you specify a range of tape units, such as `0130-013F`, ATAM looks at the low and high device addresses to ensure that these devices have already been discovered by ATAM. If not, the entire command is ignored. Note: Device addresses 0000 and FFFF are special values that will always be accepted. If you are unsure of the actual values on your system, specify a range that begins with 0000 or ends with FFFF.

The syntax for the commands includes symbols. The next table describes these symbols so you will understand how to read and type the commands.

Table 3. Symbols used in commands
Symbol	Description
Braces {}	Braces are used to indicate an entry that is required.
Brackets []	Brackets are used to indicate an entry that is optional. If there are multiple choices within the brackets, you can only choose one of the entries.
Vertical bar \|	Items that are separated by a vertical bar are alternative items. If multiple items are separated by vertical bars, you can only choose one of the items.
Asterisk *	An asterisk indicates all, such as all defined systems.