Previous Topic: TLMDATE ADD_WORK Macro—Add Work Days to a DateNext Topic: TLMDATE ANCHOR Macro—Define Anchor Control Block

TLMDATE Macro - Common Date Processing Routines › Coding the TLMDATE Macros › TLMDATE ADD_YEARS Macro—Add Years to a Date

TLMDATE ADD_YEARS Macro—Add Years to a Date

Use the ADD_YEARS form of the TLMDATE macro to add a number of years to a date. This function adds YEARS to TODATE and places the resulting date into RESULT.

This function uses registers 0, 1, 14 and 15. These registers cannot be used to pass information to the macro.

This macro has the following format:

label TLMDATE ADD_YEARS

,TODATE=internal1
,YEARS=years
,RESULT=internal2
,ANCHOR=anchor
,PARM=plist
[,NORMAL=branch]
[,ERROR=branch]
[,FAIL=branch]
TODATE

Specifies the CA TLMS internal date to be added to. This field cannot contain a CA TLMS keyword.

Type: RX-type label, (Rn), internal packed (4 bytes)

YEARS=years

Specifies the number of years to be added to TODATE.

Type: RX-type label, (Rn), packed (4 bytes)

RESULT

Specifies the field to receive the resulting CA TLMS internal date.

Type: RX-type label, internal packed (4 bytes)

ANCHOR=anchor

Points to the label specified by the ANCHOR form of the TLMDATE macro.

Type: RX-type label or (Rn)

PARM=plist

Points to the label specified by the PARM form of the TLMDATE macro.

Type: RX-type label or (Rn)

NORMAL=branch

(Optional). Specifies the instruction to receive control on return from the CTSDATE module when no errors occurred. If not defined, the next instruction after the macro is executed.

Type: RX-type label

ERROR=branch

(Optional) Specifies the instruction to receive control on return from the CTSDATE module when a date or range error occurred. If not defined, the next instruction after the macro is executed.

Type: RX-type label

FAIL=branch

(Optional) Specifies the instruction to receive control on return from the CTSDATE module when a critical error has occurred. If not defined, the next instruction after the macro is executed.

Type: RX-type label

Example: TLMDATE ADD_YEARS Macro

                                                                  Pos. 72
                                                                  |
TLMDATE  ADD_YEARS,YEARS=NUMYEARS,TODATE=DATE,                    X
      RESULT=DATEPYR,ANCHOR=R1ANCR,PARM=R1PARMS,                  X
      NORMAL=ADDOKAY