z/OS User Exits › z/OS Blockmode User Exits—IMS › TIRDATX—Date and Time Services Exit › Return Code

Return Code

Only some of the date and time services functions are available to this exit, these are indicated by the value of the DREQ field. Before returning this exit must restore registers 0-14 to their values on entry and update register 15 with the return code that controls how the date and time services functions continue processing.The return code varies depending on the request, as follows:

DREQ - Service Request DREQVAL

• 0—Use the system date/time as stored in DCMCB. The exit has not modified these values and accepts them as they are.
• 4—The exit has modified the date/time stored in the DCMCB and requests that the validation be re-executed for these values.

  Note: The exit will be called again after validation is complete.

• 8—The exit has modified the date/time stored in the DCMCB and does not require the values be re-validated. The modified values are returned to the requester.
• 12—The exit requests that the date/time service fail the request. This is returned to the service requester as if the date and/or time were invalid.

DREQ - Service Request DREQSD, DREQAS, DREQVTS, and DREQST

• 0—Use the system date/time as stored in DCMCB.
• 4—The exit requests the date, time, or timestamp value be recomputed. If the exit has modified any of these values, the modifications are discarded and the values computed from the system clock. For DREQAS, the DINC value represents the number of days to be added to the date. The exit is called again after the date and time have been recomputed.
• 8—The exit has modified the date/time stored in the DCMCB and does not require the date/time services recompute the associated values. The modified and unmodified values are returned to the service requester unchanged.
• 12—The exit requests that the date/time service fail the request. This is the same as if the clock was not set or was damaged.