Tivoli Header

Administrator's Guide


Initialization Requests

When the 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 requests. If the initialization request is successful, TSM informs its operators that the external program reported its readiness for operations. Otherwise, TSM reports a failure to its operators.

TSM does not attempt any other type of operation with that library until an initialization request has succeeded. The 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 request:

INITIALIZE libraryname

where libraryname is the name of the EXTERNAL library as defined to TSM.

Format of the external program response:

INITIALIZE libraryname COMPLETE, RESULT=resultcode

where:

libraryname
Specifies the name of the EXTERNAL library as defined to TSM.

resultcode
One of the following:


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]