5 XCMD Support for XAPI User Requests and HSC/VTCS Commands

In addition to the XAPI server configuration and administration commands described in Chapter 3, and the XAPI server operator commands described in Chapter 4, the XCMD interface also supports many XAPI user requests and compatible HSC/MVS text commands.

For example, to enter a QUERY_VOLUME request from the ACSLS user_proc using the XCMD command:

XCMD QUERY_VOLSER S00001

Supported XAPI Requests, Commands, and Parameters

The following table lists XAPI requests and corresponding HSC/MVS text commands that are supported by XCMD:

Table 5-1 XCMD Supported XAPI Requests and Corresponding HSC/MVS Commands

XAPI Request Corresponding HSC/MVS Text Command

DISMOUNT

DISMount

EJECT

EJect

MOUNT

Mount

MOVE

MOVe

QUERY_CAP

Display Cap

QUERY_DRIVES

Display DRives

QUERY_DRIVE_INFO

Display DRIVE_INFO

QUERY_LSM

Display Lsm

QUERY_SERVER

No corresponding HSC/MVS text command

QUERY_SCRATCH

Display SCRatch

QUERY_THRESHOLD

Display THReshold

QUERY_VOLSER or QUERY_VOLUME

Display Volser

QUERY_VOLUME_INFO

Display VOLume_info

SCRATCH

SCRAtch

UNSCRATCH

UNSCratch

VOLRPTFoot 1 

VOLRpt

Footnote 1 This VOLRPT is the HSC format VOLRPT command and report, NOT the ACSLS format volrpt.

Refer to the ELS Command, Control Statement, and Utility Reference for information about the HSC/MVS text commands listed above.

Though these requests and commands are supported, not all parameters are valid in ACSLS. Invalid parameters are as follows:

  • DISMOUNT (or DISMount command)

    Specification of the following results in a syntax error:

    • MVS device address format ccuu

    • hostid positional parameter

  • EJECT (or EJect command)

    Specification of the following parameters results in a syntax error:

    • WAITCAP

    • SEQ

    • RECTECH

  • MOUNT (or Mount command)

    Specification of the following results in a syntax error:

    • MVS device address format ccuu

    • hostid positional parameter

    • MGMTCLAS parameter is invalid

  • MOVE (or MOVe command)

    All parameters are supported.

  • QUERY_CAP (or Display Cap command)

    • All parameters are supported.

  • QUERY_DRIVES (or Display DRives command)

    Specification of the following parameters results in a syntax error:

    • ALL

    • IDLE

    • LIBRARY

    • DETAIL

    • IDENTITY

    • MEDIA

    • RECTECH

    • UNIT

    • BYDRIVE

    • BYLOC

    • SHOWLSLOT

  • QUERY_DRIVE_INFO (or Display DRIVE_INFO command)

    Specification of the following parameters results in a syntax error:

    • ALL

    • IDLE

    • LIBRARY

    • DETAIL

    • IDENTITY

    • MEDIA

    • RECTECH

    • VIRTUAL

    • DEVADDR

    • LSMLOC

  • QUERY_LSM (or Display Lsm command)

    All parameters are supported.

  • QUERY_SERVER (or Display SERVER command)

    All parameters are supported.

  • QUERY_SCRATCH (or Display SCRatch command)

    All parameters are supported.

  • QUERY_THRESHOLD (or Display THReshold command)

    All parameters are supported.

  • QUERY_VOLSER (or Display Volser command)

    All parameters are supported.

  • QUERY_VOLUME_INFO (or Display VOLume_info command)

    All parameters are supported.

  • SCRATCH (or SCRAtch command)

    All parameters are supported.

  • UNSCRATCH (or UNSCRatch command)

    All parameters are supported.

  • VOLRPT (or VOLRpt command)

    Specification of the following results in a syntax error:

    • MEDEQUAL

    • NONMEDEQ

    • VAULT

Issuing Commands to the ACSLS XAPI Server using the SMC or VM Client Route Command

With the exception of the EJECT or VOLRpt commands, you may issue any of the HSC/MVS commands listed in Table 5-1 from an SMC/MVS client or VM/client to the ACSLS XAPI server using the Route command.

Unlike XCMD commands entered from the ACSLS cmd_proc, the SMC/MVS or VM/Client Route command honors established SMC/HSC syntax conventions. Also, the XCMD token is omitted.

For example:

To issue an XAPI QUERY VOLUME request as an ACSLS cmd_proc XCMD command:

XCMD QUERY VOLUME VOLSER

Where VOLSER is the desired volume.

To issue the XAPI QUERY VOLUME request from an SMC/MVS client to the ACSLS XAPI server using the ROUTE command:

ROUTE ACSLS,QUERY VOLUME(volser)

Where volser is the desired volume.

Refer to the ELS Command, Control Statement, and Utility Reference for more information about the SMC ROUTE command.