Producing Customized Reports Using CA Earl › CA Earl Components Description › CTSEDATE Date Subroutine

CTSEDATE Date Subroutine

The manipulation of CA 1 internal dates is possible using the CTSEDATE date subroutine. This subroutine can be called from your CA Earl program.

CTSEDATE uses the CA 1 TMMDATE macro to provide the following functions:

• RETURN_DATE
• ADD_DAYS
• ADD_YEARS
• ADD_WORK
• NUM_DAYS
• TO_EXTERNAL
• SUB_DAYS
• SUB_YEARS
• FROM_EXTERNAL
• SET_FORMAT

Date Processing lists the date fields in the CA 1 CA Earl record that are available for manipulation. Coding examples and descriptions of the date functions begin on CTSEDATE Date Function Calls. The date constants and variable fields are contained in the EARLDEFS copy member.

CTSEDATE passes the return code issued by TMMDATE to CA Earl for verification. CA Earl places the return code in a field equal to the subroutine's name, CTSEDATE. In nonzero return code situations, CTSEDATE always appends an error message to the CTSEDATE function code. This message contains the TMMDATE return code and reason code, and text which explains the failure. The text is identical to that defined for the TMMDATE Anchor control block described in the Programming Guide.

CA Earl can test the return code and verify an error condition (see example on Example 5.) Return codes issued by the TMMDATE macro are described in the Systems Programming Guide. The only exception is return code 32, which indicates that CA Earl issued a nonexistent function call.