Administrator's Guide

Volume Query Request

The format of the Volume Query Request is:

QUERY libraryname volume

where:

libraryname

Specifies the name of the EXTERNAL library as defined to ADSM.

volume

Specifies the volume name to be queried.

Format of the external program response:

QUERY libraryname volume COMPLETE, STATUS=statusValue, RESULT=resultCode

where:

libraryname

Specifies the name of the EXTERNAL library as defined to ADSM.

volume

Specifies the volume name queried.

resultCode

One of the following:

• SUCCESS
• LIBRARY_ERROR
• VOLUME_UNKNOWN
• VOLUME_UNAVAILABLE
• CANCELLED
• TIMED_OUT
• INTERNAL_ERROR

If resultCode is not SUCCESS, the exit must return statusValue set to UNDEFINED. If resultCode is SUCCESS, STATUS must be one of the following values:

• IN_LIBRARY
• NOT_IN_LIBRARY

IN_LIBRARY means that the volume is currently in the library and available to be mounted.

NOT_IN_LIBRARY means that the volume is not currently in the library.