Interface to the exit

The application-description-validation exit is invoked in task mode, problem state, and key 8 and the job-step task is APF-authorized. The exit must restore this state before returning to its caller.

Control is passed to the exit using the BAL instruction. The exit must return to its caller using the address and addressing mode passed to it in general register 14.

When the exit is entered, register 1 contains the address of the parameter list. Each address in this list is used to locate the parameter value. These parameters are passed to the exit:

EQQUXPIF parameters

 REQUEST   DS   CL8   (Request type)
 RESOURC   DS   CL8   (Resource type)
 RECLEN    DS   F     (Record length)
 RECPTR    DS   A     (Record address)
 RETCO     DS   F     (Return code)
 ERRMSG    DS   CL80  (Error message string)

REQUEST: The type of database request (INSERT or REPLACE)
RESOURC: The type of resource to be validated (AD).
RECLEN: The length of the data base record to be validated (AD record, see DCLADR layout in the IBM Tivoli Workload Scheduler for z/OS Diagnosis Guide and Reference).
RECPTR: The address of the record area. It can only be validated.
RETCO: The return code of the exit. If its value is greater than 0 the application description update (INSERT AD or REPLACE AD) fails and a message containing the string ERRMSG is displayed.
ERRMSG: The message that explains the reason for the update failure. The message is displayed only if RETCO is greater than 0.