Skip to Content

Unit user exit RVP

When you are dynamically allocating uncataloged input image copy, change accumulation, or log data sets, the Recovery utility determines the type of device to allocate using information recorded in the RECON data sets.

You can override the unit type using the DSUNIT keyword. You can also provide the Unit user exit routine to supply the unit type.

Related topics

User-exits

Keywords

There are no RVPSYSIN keywords associated with the Unit user exit.

Procedures

Provide a load module named RVP$UNIT.

The Recovery utility searches for the Unit user exit routine in the STEPLIB library concatenation. If found, it is called prior to the dynamic allocation of an image copy, change accumulation, or log data set, but only if the data set is uncataloged. When it receives control, register 1 points to a parameter block that contains information about the data set being allocated. Among this information is the unit type, which contains the value that the Recovery utility uses to allocate the data set. The user exit may examine the information supplied and may change the unit type prior to returning control to the Recovery utility.

The following restrictions apply:

  • RVP$UNIT must be reentrant. It may be called asynchronously by multiple recovery tasks.
  • RVP$UNIT must save all registers upon entry and restore them prior to returning. On return, register 15 must contain a return code. A return code of zero indicates normal completion of the user exit. A nonzero return code indicates an error; the Recovery utility abnormally terminates the associated recovery task.
  • RVP$UNIT must make no assumptions about the addressing mode used at run time. It may be called in either 24- or 31-bit mode and must return in the same mode. The parameter area passed to the exit routine resides in 24-bit storage.
  • The register save area provided in register 13 at entry is prechained. The word at offset 8 from register 13 already contains the address of the next save area available and may be loaded by the exit routine. In any case, RVP$UNIT must not modify the word at offset 8 from register 13 at entry.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Backup and Recovery for IMS 5.2