User Exit Facility › User Exit Actions › Actions at RESTORE

Actions at RESTORE

After examining the passed record, the user exit instructs RESTORE to perform one of the following instructions:

Restore

Places a binary 4 in the flag field.

Returns to GVRESTOR

Delete (do not restore)

Places a binary 8 in the flag field.

Returns to GVRESTOR.

Modify

Moves the passed record to a work area within the exit.

Performs the necessary modifications.

Places a binary 12 in the flag field.

Calls the subroutine GVMODINS with the parameter list:

• The address of the fullword flag field.
• The address of a fullword containing the length of the modified record.
• The address of the modified record.

Returns to GVRESTOR.

Insert new

Inserts records prior to the record passed to the exit. Then the record previously passed to the exit is passed again until the exit indicates that the record is to be restored, deleted, or modified, or that end-of-file is desired. If the exit is passed, records may be inserted prior to signaling end-of-file.

Places a binary 16 in the flag field.

Calls the subroutine GVMODINS with a parameter list consisting of three fullword fields:

• The address of the fullword flag field.
• The address of a fullword containing the length of the new record.
• The address of the new record.

Returns to GVRESTOR.

Signal early EOF

Places X'FFFFFFFF (HIGH VALUES) in the flag field.

Returns to GVRESTOR.