Types of access Schema DDL
88 U929-J-Z125-9-76
If you want to define a user-specific hash routine, you must observe the following reg ister
conventions:
Before and after running the routine, all UDS/SQL registers except Register 1 mus t
have the same content.
The hash routine is branched to by BALR 14,15; return to the UDS/SQL hash routine is
effected by BR 14.
The following information is provided by the UDS/SQL DBH:
Register 1: The address of a word containing the address of the key item
Register 2: The address of a byte containing the length of the key item.
Register 3: The address of a word containing the num ber of pages of the hash area
assigned to this key.
Register 13: Starting with the address (Register 13) + X’0C’, 13 words are available
to the user as a transaction-oriented save area for registers.
The UDS/SQL DBH expects the result of the hash routine in Register 1. It converts the
binary number encountered there into a relative page number as follows:
–Bit 2
31 in Register 1 is set to 0.
If the resulting value is less than the number of pages in the hash area (content of
Register 3), this value is used as the relative page number.
If the resulting value is greater, UDS/SQL performs the following division:
content (Register 1) / content (Register 3)
The quotient of this division is used as the relative page number.