The majority of client/server interaction between SMC/MVS and VM/Clients, and an ACSLS server with XAPI are transparent to the end user. Requests for volume information, mounts, and dismounts are generated automatically by the SMC/MVS and VM/Clients and are processed without operator intervention.
In addition to these automatic interactions, the ACSLS server with XAPI provides additional administrator, configuration, and operator commands that enable you to manage the XAPI component.
See Chapter 3, "XCMD XAPI Configuration and Administration Commands"for information about XCMD XAPI server configuration and administration commands.
See Chapter 4, "XCMD XAPI Server Operator Commands"for information about XCMD XAPI server operator commands
These commands are not part of the ACSLS base installation, but are available when the ACSLS XAPI component is optionally installed. Refer to the StorageTek Automated Cartridge System Library (ACSLS) Installation Guide for information about installing ACSLS and the ACSLS XAPI component.
To issue these commands, use the XCMD command facility, issued from the ACSLS cmd_proc. The general syntax of this command is:
XCMD command
Where command is one of the ACSLS XAPI component commands described in this publication.
Note:
You can also use the XCMD command facility to issue any XAPI user request supported by the ACSLS XAPI server. See Chapter 5, "XCMD Support for XAPI User Requests and HSC/VTCS Commands" for more information.The following conventions apply whenever you issue an XCMD command from the ACSLS cmd-proc:
XCMD does not use ACSLS command prompting.
When you enter keyword parameters with an associated value, the value must be preceded by a single blank character.
You can enter XCMD commands in uppercase or lowercase. The ACSLS XAPI component automatically translates all command input to upper case. For example, the subpool names "Testpool1", "testpool1", "TestPool1", and "TESTPOOL1" are all translated to the same subpool name "TESTPOOL1".
Note:
Normal ACSLS cmd_proc commands and parameters are usually specified in lowercase. Lowercase characters are not automatically translated to uppercase, except for vol_ids (volsers).You cannot precede an XCMD parameter value with an equal sign (=).
You cannot enclose XCMD values in parentheses. When multiple values are supported, you can use a comma to separate each value. For example, to query multiple volumes, enter XCMD QUERY VOLUME volser1,volser2 and not XCMD QUERY VOLUME(volser1,volser2).