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. The following 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: Type of database request (INSERT or REPLACE)
RESOURC: Type of resource to be validated (AD).
RECLEN: Length of the database record to be validated (AD record, for details see ADR - application description
RECPTR: Address of the record area. It can only be validated.
RETCO: 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: Message that explains the reason for the update failure. The message is displayed only if RETCO is greater than 0.