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

Purpose

This exit receives control for some but not all date and time services. Only services that acquire, or manipulate the date and time, where that date or time was acquired from the system, or where validation is involved, invoke this exit.

This exit is not invoked for the following conditions:

• Services involving conversion from one form to another does not invoke this exit.
• If some error condition exists. For example, if the clock is not set, the date and time services return the error directly to the requester and do not call this exit.
• For validation, if the value is not valid, the failure is returned to the requester and the exit is not called.
• If this exit changes a date or time and requests re-validation, and the value is in error, the error is returned to the requester and the exit is not called.

Note: If the date and time is modified by the exit, the exit must indicate this by returning the appropriate return code. Return codes that are invalid (not one of the listed values) will be ignored and the result is as if the exit returned zero (0). Therefore it is imperative that you not take advantage of any behavioral aspects not explicitly documented here or in the sample code since future releases could change the operation.