ICF Files, TIMER

Use this record-level keyword to specify an interval of time for your program to wait before performing some specified function.

To set the timer, your program issues an output operation with the TIMER keyword in effect.

The format of the keyword is:

TIMER(HHMMSS | &field-name);

HHMMSS: The time interval is a 6-digit value where HH is the number of hours (00 through 99), MM is the number of minutes (00 through 59), and SS is the number of seconds (00 through 59).
&field-name: The time interval parameter is the name of a field that contains the timer value in the form HHMMSS described above. The specified field name must exist in the record format, and the field must be a zoned field with length 6, data type S, usage P, and zero decimal positions.

The following keywords cannot be specified with TIMER:

ALWWRT
CANCEL
CNLINVITE
CONFIRM
CTLDTA
DETACH
DFREVOKE
EOS

ENDGRP
EVOKE
FAIL
FMH
FMTNAME
FRCDTA
INVITE
NEGRSP

RCVCONFIRM
RCVCANCEL
RCVCTLDTA
RCVDETACH
RCVENDGRP
RCVFAIL
RCVFMH
RCVNEGRSP

RCVTRNRND
RECID
RQSWRT
SECURITY
SUBDEV
SYNLVL
VARBUFMGT
VARLEN

TIMER overrides the WAITRCD parameter on the Create ICF File (CRTICFF), Change ICF File (CHGICFF), and Override ICF File (OVRICFF) commands. The WAITRCD parameter value is ignored during the interval that the timer function is in effect.

Option indicators are not valid for this keyword.

Example

The following example shows how to specify the TIMER keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A          R RCD1                      TIMER(002512)
     A          R RCD2                      TIMER(&FIELD1);
     A            FIELD1         6S  P
     A
     A

On an output operation to RCD1, the timer will be set to 0 hours, 25 minutes, and 12 seconds. On an output operation to RCD2, the timer will be set to the value that has been set in FIELD1.

TIMER (Timer) keyword for ICF files

Example