When the ADSM server is started, the server sends an initialization request to the external media management program for each EXTERNAL library. The external program must process this request to ensure that the external program is present, functional, and ready to process ADSM requests. If the initialization request is successful, ADSM informs its operators that the external program reported its readiness for ADSM operations. Otherwise, ADSM reports a failure to its operators.
ADSM does not attempt any other type of operation with that library until an initialization request has succeeded. The ADSM server sends an initialization request first. If the initialization is successful, the request is sent. If the initialization is not successful, the request fails. The external media management program can detect whether the initialization request is being sent by itself or with another request by detecting end-of-file on the stdin stream. When end-of-file is detected, the external program must end by using the stdlib exit routine (not the return call).
When a valid response is sent by the external program, the external program must end by using the exit routine.
Format of the ADSM request:
INITIALIZE libraryname
where libraryname is the name of the EXTERNAL library as defined to ADSM.
Format of the external program response:
INITIALIZE libraryname COMPLETE, RESULT=resultcode
where: