Administrator's Guide

Volume Release Request

When the ADSM server returns a volume to scratch status, the server starts the external media management program, issues a request to initialize, then issues a request to release a volume.

The external program must send a response to the release request. No matter what response is received from the external program, ADSM returns the volume to scratch. For this reason, ADSM and the external program can have conflicting information on which volumes are scratch. If an error occurs, the external program should log the failure so that the external library inventory can be synchronized later with ADSM. The synchronization can be a manual operation.

Format of the ADSM request:

RELEASE libraryname volname

where:

libraryname

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

volname

Specifies the name of the volume to be returned to scratch (released).

Format of the external program response:

RELEASE libraryname volname COMPLETE, RESULT=resultcode

where:

libraryname

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

volname

Specifies the name of the volume returned to scratch (released).

resultcode

One of the following:

• SUCCESS
• VOLUME_UNKNOWN
• VOLUME_UNAVAILABLE
• INTERNAL_ERROR