Invoking the date conversion routine

When a program invokes the date conversion routine, the program must pass two parameters to it:

Three-byte date: a three-byte field containing a packed-decimal date (format yydddF)
Four-byte date: a four-byte field

Note: This routine runs in the caller's mode, state, and key. Recovery is handled by the calling program.

Format of returned converted date

The routine returns a four-byte packed-decimal date whose format is either 00yydddF (for 1971-1999) or 01yydddF (for 2000-2070).

If ddd is 000 in the three-byte yydddF date field passed to the routine, the routine returns 00 for cc (indicating a year 19yy), regardless of what yy is.

Return code

The return code from this routine follows RACF® conventions with a return code of 00 (X'00') indicating successful date conversion. This code is sent to register 15.

The return code is as follows:

Note to Reader

The return code is shown in hexadecimal.

Return Code: Meaning
00: The date conversion function completed successfully.