Administrator's Guide
When the ADSM server requires a volume mount, the server starts the
external media management program, issues a request to initialize, then issues
a request to mount a volume. The external program is responsible for
verifying that this request is coming from ADSM and not from an unauthorized
system.
The volume mounted by the external media management program must be a tape
with a standard IBM label that matches the external volume label. When
the external program completes the mount request, the program must send a
response. If the mount was successful, the external program must remain
active. If the mount failed, the external program must end immediately
by using the stdlib exit routine.
Format of the ADSM request:
MOUNTlibraryname volname accessmode devicetypes timelimit userid
volumenumber 'location'
where:
- libraryname
- Specifies the name of the EXTERNAL library as defined to ADSM.
- volname
- Specifies the actual volume name if the request is for an existing
volume. If a scratch mount is requested, the volname is set to
SCRTCH.
- accessmode
- Specifies the access mode required for the volume. Possible values
are READONLY and READWRITE.
- devicetypes
- Specifies a list of possible device types and formats that can be used to
satisfy the request for the volume. The most preferred device type and
format is first in the list. Items are separated by commas, with no
intervening spaces. Possible values are:
- 3480
- 3480XF
- 3490E
- 3570
- 3590
- 4MM_DDS1
- 4MM_DDS1C
- 4MM_DDS2
- 4MM_DDS2C
- 8MM_8200
- 8MM_8205
- 8MM_8500
- 8MM_8500C
- 8MM_AIT
- 8MM_AITC
- DLT_2000
- DLT_4000
- DLT_7000
- DTF
- GENERIC_TAPE
- OPT_RW_650MB
- OPT_RW_1300MB
- OPT_RW_2600MB
- OPT_WORM_650MB
- OPT_WORM_1300MB
- OPT_WORM12_5600MB
- OPT_WORM12_12000MB
- OPT_WORM14_14800MB
- QIC_IBM1000
- QIC_525
- timelimit
- Specifies the maximum number of minutes that the server waits for the
volume to be mounted. If the mount request is not completed within this
time, the external manager responds with the result code TIMED_OUT.
- userid
- Specifies the user ID of the process that needs access to the
drive.
- volumenumber
- For non-optical media, the volumenumber is 1. For optical
media, the volumenumber is 1 for side A, 2 for side B.
-
'location'
- Specifies the value of the location field from the ADSM inventory, for
example, 'Room 617 Floor 2'. One blank character is inserted
between the volume number and the left single quotation mark in the location
information. If there is no location information associated with a
volume, nothing is passed to the exit. If there is no volume
information, the single quotation marks are not passed. Also, if volume
information is passed, then probably the volume has been ejected from the
library and needs to be returned to the library before the mount operation can
proceed. The location information should be posted by the agent so that
the operator can obtain the volume and return it to the library.
Format of the external program response:
MOUNT libraryname volname COMPLETE ON specialfile, RESULT=resultcode
where:
- libraryname
- Specifies the name of the EXTERNAL library as defined to ADSM.
- volname
- Specifies the name of the volume mounted for the request.
- specialfile
- The fully qualified path name of the device special file for the drive in
which the volume was mounted. If the mount request fails, the value
should be set to /dev/null.
The external program must ensure that the special file is closed before the
response is returned to the ADSM server.
- resultcode
- One of the following:
- SUCCESS
- DRIVE_ERROR
- LIBRARY_ERROR
- VOLUME_UNKNOWN
- VOLUME_UNAVAILABLE
- CANCELLED
- TIMED_OUT
- INTERNAL_ERROR
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]