z/OS DFSMSdss Storage Administration
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Function startup (Eioption 00)

z/OS DFSMSdss Storage Administration
SC23-6868-01

This exit point is called during DFSMSdss initialization and again during function initialization (such as a dump or restore operation). The EIRECPTR points to the EIREC00 data area. The EIREC00 data area contains a field, EI00SBPL, which the application may use to return a subpool number that is to be shared between all DFSMSdss tasks. EI00SBPL is only valid when EITSKID is zero.

The application can set EI00NOLK to request that DFSMSdss bypass ADRLOCK ENQUEUE or DEQUEUE processing during full-volume and tracks RESTORE operations. The application must be able to resolve any deadlock conditions that result from the request to bypass ADRLOCK ENQUEUE or DEQUEUE processing.

The application can also set EI00SENQ to request that VTOC serialization be held only for the duration of VTOC access. This flag is only valid for full volume dump operations and when EITSKID is nonzero. This flag provides a function similar to that provided by the Enqueue Installation Exit Routine (seez/OS DFSMS Installation Exits). The VTOC serialization is released after VTOC access is complete if either the EI00SENQ flag is set or the Enqueue Installation Exit Routine requests it.

The application can also set EI00NENQ to request that DFSMSdss not reserve on VTOC of the source volume. This flag is only valid for physical COPY and DUMP operations during function startup (for example, when EITSKID is nonzero).

The application can also set EI00BSEC flag to request that RACF® verification and all other data set security checking is bypassed. This flag is only valid for full/tracks COPY, full/tracks DUMP, and full/tracks RESTORE operations during function startup (that is, when EITSKID is nonzero).

DFSMSdss provides the source VOLSER to the UIM. This field is only valid for full/tracks COPY, full/tracks DUMP, and full/tracks RESTORE during function startup (that is, when EITSKID is nonzero). For RESTORE, this field contains the volume serial number of the input volume where the dump data set resides.

The valid return codes for function startup are:
0
Continue normal processing
16
Record modified
20
Inhibit all UIM calls—Not valid when EITSKID is zero and either UFSYSIN or UFSYSPR was set in the installation options exit, or EITSKID is nonzero and either UFNOIN or UFNOOUT was set in the installation options exit.
32
End processing. This return code is only valid for a full dump and a full restore operation.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014