$TICALL FUNC=PUT

Timer Services Interface › $TICALL FUNC=PUT

$TICALL FUNC=PUT

Updates an existing timer definition.

&CONTROL SHRVARS=($TI)
-EXEC $TICALL FUNC=PUT
            [ CLASS=classname ]
            [ SUBCLASS=subclassname ]
              NAME=name
            [ SDATE=startdate ]
            [ EDATE=enddate ]
            [ STIME=starttime ]
            [ ETIME=endtime ]
            [ FREQ={ nnnn | HH.MM.SS } ]
            [ FTYPE={ MONTHS | DAYS | TIME } ]
            [ LIMIT= nnnn ]
            [ DAYLIST=(MON,TUE,…..) ]
            [ CATCHUP={ YES | NO } ]
            [ DELEXP={ YES | NO } ]
            [ STATUS={ ACTIVE | INACTIVE } ]
            [ SAVE={ YES | NO } ]
            [ ROUTE={ * | userid | MON | LOG | SYS } ]
            [ KEEP={ MON | LOG | SYS } ]
            [ COMMAND=command ]
            [ DESC=description ]

Updates an existing timer definition. If a same named definition does not exist, then the $TICALL FUNC=PUT will fail.

Operands:

FUNC=PUT: Updates an existing timer definition.

The description of all the other operands is the same as $TICALL FUNC=ADD, except that there are no defaults for the PUT function. If an operand is not specified, then that particular field will not be updated in the timer definition.

Return Codes:

&RETCODE = 0

$TICALL completed successfully. Data is returned in the following variables:

$TICATCHUP: CATCHUP
$TICLASS: CLASS
$TICDATE: Create date
$TICOMMAND: COMMAND
$TIDELEXP: DELEXP
$TIEDATE: EDATE
$TIETIME: ETIME
$TIFREQ: FREQ
$TIFTYPE: FTYPE
$TIKEEP: KEEP
$TILIMIT: LIMIT
$TINAME: NAME
$TIROUTE: ROUTE
$TISDATE: SDATE
$TISTATUS: STATUS
$TISTIME: STIME
$TISUBCLASS: SUBCLASS
$TIUSER: Modify user ID
$TIMDATE: Modified date
$TIMTIME: Modified time
$TIAUTH: User authority of $TIUSER

&RETCODE > 0

An error occurred. &SYSMSG is set with an error message.

Example: FUNC=PUT

&TOMORROW = &DATECONV DATE8 &DATE8 DATE8 +1
 &DESC = &STR 'Updating the start date and description'
&CALL PROC=$TICALL SHARE=($TI>) PARMS=(FUNC=PUT CLASS=USER +
 NAME=CMD1 SDATE=&TOMORROW DESC=&DESC)

Note: If the text entered in the Description and Command fields contains imbedded blanks, they must be enclosed in quotes.