gtpi1m1wSystem Installation Support Reference

RIAT

The Record ID Attribute Table (RIAT) contains information on every file type (both fixed and pool) in the database. For more information on this table, see Record ID Attribute Table.

User exit routine UCCRIT is invoked from the RITID macro call if the user exit option was specified for the ID during RIAT definition. This exit point, named RIT, cannot be activated dynamically. Exit point RIT is in copy segment CEFJ of CSECT CCFADC and copy segment CVF3 of CSECT CCVFAC.

The RIAT exit allows you to intercept all FIND/FILE macros after a RIAT entry has been found. This is a nondynamic exit point, but the exit may or may not be activated depending on the RIAT indicators for that ID.

General Conditions at Entry

The registers at entry to UCCRIT are:

R1
Address of the MIOB set up to service the request.

R2
Address of the RIAT entry, if found. If the MIOB was setup from the RIAT default entry R2 will be set to zero (0).

R9
Address of the ECB.

R11-R15
See User Exit Routines - Common Entry Conditions.

System Conditions at Entry

System state
Supervisor

System mask
Masked for I/O interrupts

Protect key
0

Address space
EVM.

Programming Considerations at Entry

  1. Filing critical user records.

    As many as six records per subsystem can be designated for filing during catastrophic error processing. CTIN generates a list of six doublewords for each subsystem that holds record addresses. These addresses are copied to disk as part of CPSF.

    The CINFC tag CMMZFA is used to access the list. The leftmost fullword contains the 31-bit main storage address of the record to be filed and the rightmost fullword contains the record file address in FARF format, as shown in the accompanying diagram.

    If fewer than six records are filed for any subsystem, X'FF' must appear in byte 4 of the doubleword following the last record entry for that subsystem.

  2. The contents of program registers R0-R7 have been saved in the ECB register save area.
  3. See User Exit Routines - Common Entry Conditions.
  4. See User Exit Routines - Common Programming Considerations for other considerations.
  5. See TPF System Generation for RIAT START call restrictions before you code this user exit and observe the following:

Programming Considerations on Return

See User Exit Routines - Common Return Conditions.

General Conditions on Return

See User Exit Routines - Common Return Conditions.