z/OS V1R7.0-V1R12.0 MVS Device Validation Support
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Generic Update Routine

z/OS V1R7.0-V1R12.0 MVS Device Validation Support
SA22-7586-01

A UIM calls the generic update routine only when the name of a generic device type is based on certain specified features or parameters. It is used to overwrite the standard generic name that is associated with the device type.

The generic update routine can update the generic name only during parameter or feature checking. Also, the UIP must indicate that the generic update routine can update the generic name as a function of device features.

Note:
The IODV specifies device features and parameters. The UCA points to the IODV. Therefore, because the UIM passes the UCA to the generic update routine, that routine has access to device features and parameters.

To call the generic update routine within a UIM, use a BALR instruction in 31-bit addressing mode. Use standard register save area conventions. The UCAUGNP field in the UCA contains the address of the generic update routine.

Registers on Entry to the Generic Update Routine

Register 0
Undefined
Register 1
Pointer to a two-word parameter list
  • Word 1 - Address of the UCA
  • Word 2 - Address of an 8 byte field that contains the name of the generic device type
Register 2-12
Undefined
Register 13
Address of an 18-word save area
Register 14
Return address
Register 15
The generic update routine entry point address

Registers on Exit from the Generic Update Routine

Register 0-14
Restored
Register 15
Return code

Return Codes

RC 0
No errors detected, UIT updated with the new generic name
RC 8
Error detected, no UIT updated, message written

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014