Using the SELECTION_EXIT user exit

RUV provides a user exit for the following commands:

  • RECOVER BACKOUT
  • RECOVER FORWARD
  • PRINT ARCHIVE_IN (useful for getting a print of the journal)

The user exit is active during processing when you specify an exit program value for the SELECTION_EXIT(program) keyword; you must also provide the RPTOUT DD statement in the RUVZSM0 JCL.

The user exit is called for each record to be processed. For example, this exit can be useful to an auditing program that may want to examine whether a particular RUV-recorded VSAM record has been read, added, updated, or deleted.

RUV loads the link-edited user exit program you specify with the SELECTION_EXIT(program) keyword. It then uses standard operating system linkage conventions to call the program.

Warning

The parameter list passed to the user program will contain an address above the 16 MB line. This condition requires that you link the user exit program with AMODE(31) (access mode 31). The RMODE(24, 31, or ANY) (residency mode) may be whatever the user program requires.

A sample user exit program is found in the ZZUZSEL member of the RUV.CNTL library.

This section contains the following topics:

Related topic

Recovering-VSAM-data-sets


 

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