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


Bypass verification exit (Eioption 22)

z/OS DFSMSdss Storage Administration
SC23-6868-01

This exit lets a user force DFSMSdss bypass serialization and security verification during data set copy, physical data set copy, dump, and restore processing for individual data sets. It also lets a user turn on a tolerate-migrated-volser indicator that forces DFSMSdss to restore a data set with a migrated volser. This exit is given control through the UIM at the start of data set copy, dump, and restore processing for each data set. DFSMSdss provides the UIM with the data set name through the EIREC22 structure within the exit identification block, ADREID0. EIREC22 is shown in Table 1. The data set name provided is the original name prior to rename processing, if any, for COPY or RESTORE. The UIM returns to DFSMSdss with a return code in the exit identification block. The valid return codes are:
0
Continue normal processing
16
Bypass one or more of the following:
  • If the Reset indicator (EI22RSET) is set on by the UIM for a VSAM data set during a logical data set dump, DFSMSdss resets the data-set-changed flag in the VTOC if the data set is successfully serialized and processed. DFSMSdss will not reset the data-set-changed flag for data sets dumped with RLS access and BWO data sets, even if EI22RSET is set on by the UIM.
  • If the DB2® Source Bypass indicator (EI22DB2) is set on by the UIM during a logical data set copy operation, and RENAMEU is specified for a DB2 VSAM linear data set, then DFSMSdss does not verify that the old component duplicates the DB2 naming convention when it derives the new component name. Alternatively, if the EI22DB2 bit is set on, DFSMSdss generates a DB2 component name for the target component—provided the new cluster name (specified in the RENAMEU parameter) matches the DB2 naming convention.
  • If the IMS™ indicator (EI22IMS) is set on, the caller is IMS.
  • If the Shared SYSDSN ENQ indicator (EI22SSYS) is set on by the UIM for a VSAM data set during logical data set dump, DFSMSdss attempts to obtain a shared SYSDSN enqueue. If EI22SSYS is not set on, then the type of SYSDSN enqueue (shared or exclusive) that DFSMSdss attempts to obtain depends upon whether or not the SHARE keyword was specified.
  • If the Mark-As-Recovery-Required indicator (EI22RRB) is set on by the UIM during logical restore, DFSMSdss marks the target data set as recovery required, provided that the target data set is SMS-managed.
  • If the Log Information Passed indicator (EI22LINF) is set on by the UIM during a logical restore, then DFSMSdss uses the log parameter (EI22LPRM), the log stream ID (EI22LSID) and the LOGREPLICATE indicator (EI22LREP) as the log information for the target data set, provided that the target data set is SMS-managed. If EI22LINF is not set, or the target data set is not SMS-managed, then the contents of EI22LPRM, EI22LSID and EI22LREP are ignored.
  • If the BWO_ALLOWED Passed indicator (EI22BWOP) is set on by the UIM during a logical restore, the DFSMSdss uses the BWO_ALLOWED field (EI22BWOA) for the target data set, provided the target data set is SMS-managed. If EI22BWOP is not set or the target data set is not SMS-managed, then the contents of EI22BWOA are ignored.
  • Serialization is bypassed if the UIM exit turns on the Bypass Serialization indicator, EI22BSER. Serialization is bypassed for the source data set for copy and dump processing, and for the target data set for copy and restore processing. DFSMSdss assumes that all necessary serialization has been performed by the invoker of DFSMSdss, but does not ensure that this is true. DFSMSdss performs normal serialization if the UIM exit does not turn on the bypass serialization indicator.

    DFSMSdss does not delete or uncatalog data sets that were bypassed for serialization even if the DELETE or UNCAT keywords are specified. If a preallocated data set is not large enough during a data set restore operation and the bypass serialization indicator is on, DFSMSdss does not scratch and reallocate that target data set and the restore operation fails.

  • RACF® verification and all other data set security checking is bypassed if the UIM exit turns on the Bypass RACF indicator, EI22BSEC. If EI22BSEC is set on, DFSMSdss checks to ensure that the application program is authorized to bypass RACF and security processing. The application program is authorized to bypass RACF and security processing if NOPASS was specified on the PPT statement of the SCHEDxx parmlib member. If the EI22BSEC indicator is on and NOPASS was specified, RACF verification and all other data set security processing including password checking is bypassed. DFSMSdss does not do any RACF authorization checks. DFSMSdss does not create any RACF profiles for the copied or restored target data set. DFSMSdss assumes that all necessary RACF authorization and security checking has already been performed by the invoker of DFSMSdss. For a copy or restore operation, RACF profiles are not created for the target data set.

    If the user turns on the bypass RACF indicator and PASS was specified on the PPT statement of the SCHEDxx parmlib member, DFSMSdss sets the error flag, EIXERR, on in the exit identification block and invokes the UIM again. If the user sets the bypass RACF indicator again, DFSMSdss issues error message ADR772W and processing continues as normal. DFSMSdss still allows serialization to be bypassed and tolerates migrated volume serial number processing if those indicators are set.

    DFSMSdss performs normal RACF and security processing if the UIM exit does not turn on the bypass RACF indicator.

  • If the Tolerate-Migrated-Volser indicator is set on by the UIM, DFSMSdss takes special action to support the restoration of a non-VSAM data set with a volume serial number of MIGRAT for a logical data set restore operation in an SMS-managed environment or when the CATALOG option has been specified. DFSMSdss ignores the EI22BMIG indicator for copy and dump operations and VSAM data sets.
    When DFSMSdss is restoring a non-VSAM data set and the Tolerate-Migrated-Volser indicator is set on, a catalog LOCATE is issued to determine the status of the data set being restored. Based on the result of that LOCATE, different actions are taken.
    No catalog entry is found:
    The data set being restored is not considered to be migrated. A normal DFSMSdss logical restore is performed. The Tolerate-Migrated-Volser indicator is ignored.
    A catalog entry is found but the VOLSER is not MIGRAT:
    The data set being restored is not considered to be migrated. Normal processing continues as though the indicator had not been set.
    A catalog entry is found and the VOLSER is MIGRAT:
    The data set is migrated and requires special processing. Instead of cataloging the data set after allocating it, DFSMSdss alters the existing MIGRAT volume serial number entry to the actual volume the data set was restored to. Once the catalog entry has been changed from MIGRAT to the new data set’s volume serial numbers, the restore continues as normal.
    Note: Because the migrated data set is not recalled during this restore, the user of this interface is responsible for deleting the migrated copy of the data set and updating the necessary control files.

    DFSMSdss performs normal non-VSAM data set cataloging if the UIM exit does not turn on the tolerate-migrated-volser indicator.

  • If the Extent Reduction bit (EI22EXTR) is set on by the UIM for a given data set and DFSMSdss is running in an SMS-managed environment, DFSMSdss tries to allocate the original volume where the data set was dumped.
  • If the Restore-To-Like-Device bit (EI22LIKE) is set on by the UIM for a given data set and DFSMSdss is running in an SMS-managed environment, DFSMSdss tries to allocate the target data set on a device whose unit is the same as that of the source data set. If DFSMSdss can not allocate the target data set on a device whose unit type matches that of the source, the data set is not processed.
  • Serialization by enqueuing on the major name of SYSDSN for a data set is bypassed if the UIM exit turns on the bypass SYSDSN indicator, EI22NSYS; other enqueues for a data set (for example, SYSVSAM) are not bypassed. The SYSDSN-level of enqueue serialization is bypassed for the source data set for DUMP and the target data set for RESTORE. DFSMSdss performs normal serialization if both EI22BSER and EI22NSYS are turned off.

    DFSMSdss does not delete or uncatalog data sets if EI22NSYS is set, even if the DELETE or UNCATALOG keywords are specified. If EI22NSYS is on and the preallocated data set is too small, the data set is not scratched and reallocated, and the RESTORE fails.

If the UIM has set the "set reconnect" flag on, DFSMSdss then sets the reconnect flag in the catalog on. DFSMSdss ignores the EI22SFSM flag for VSAM data sets.

If the UIM exit sets the return code to EIRC16 but fails to turn on any of the bypass verification indicators, DFSMSdss ignores all bypass options and performs normally. If the UIM exit sets the return code to EIRC16 for a VSAM data set and turns on the tolerate-migrated-volser indicator, DFSMSdss does not treat it as an error condition and ignores the tolerate-migrated-volser indicator.

If a list of storage groups is passed by the UIM (EI22SGP) then the list is used to allocate SMS managed data sets during logical data set copy and restore. Users must take care to ensure that the storage groups passed do not conflict with the storage groups that would be assigned based on the storage class of the data set. A user may pass a maximum of 15 storage groups in the list. If the target data set is not SMS-managed then the storage groups passed are ignored.

If an ACS environment is passed by the UIM (EI22ACSEN), it is used in place of the DFSMSdss default environments (ALLOC for logical data set copy or RECOVER for logical data set restore). The ACS environment passed in is used when calling the management class and storage class ACS routines unless BYPASSACS indicates that one or both of the ACS routines should not be called. It is also passed to SMS on the allocation request. If EI22ACSEN specifies SPMGCLTR and a list of storage groups was not passed, DFSMSdss continues to process the data set in the default environments (ALLOC for logical data set copy or RECOVER for logical data set restore).

An application may set EI22DSSRL to either EISRLDB2, EISRLZFS, EISRLCICS or EISRLEXIT during a logical data set copy. If DFSMSdss is unable to obtain access to the data set, the service specified by EI22DSSRL is used to close the data set so that DFSMSdss is able to obtain access to process the data set. After the data set is processed the corresponding service is used to reopen the data set.
Note: When EI22DSSRL is set to either EISRLDB2, EISRLZFS, EISRLCICS or EISRLEXIT then RLS processing is bypassed.
20
Disconnect exit
32
End function
36
End data set

Refer to EIRC36 in Data set verification (Eioption 21) for details on ending spheres.

Note: See the "Note for Eioptions 21, 22, and 23" at the end of the description for eioption 23.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014