CIC-START

Start a task on a local or remote system at a specified time.
Restriction: This topic applies only when the AppMaster Builder AddPack has been installed, and applies only to Windows platforms.

Target:

CICS

Syntax:

CIC-START TRANSID(name)
... [INTERVAL(hhmmss)|TIME(hhmmss)] [CICSoptions]
... [ERROR(errorpara)]

General Rule:

  1. SERVICE-RELOAD is an OS/VS COBOL statement; do not use with COBOL II, because the compiler treats this call as a CONTINUE statement.

Parameters:

CICSoptions

Valid CICS option. See your CICS reference manual for more information.

ERROR (errorpara)

User-defined error routine to perform when an abnormal condition occurs.

INTERVAL (hhmmss)

Time interval between issuing and executing the call. Hhmmss can be replaced by zero, a decimal constant, or a COBOL data name defined as PIC S9(07) COMP-3.

TIME (hhmmss)

Expiration time for the START function. Hhmmss can be replaced by a decimal constant or a COBOL data name defined as PIC S9(07) COMP-3.

TRANSID (name)

Transaction code identifying the program where control returns; can be a literal (maximum 4 characters) or COBOL data name (minimum 5 characters).

Example:

Start a specific task (not associated with a terminal) in one hour.
CIC-START TRANSID('TRNL') INTERVAL(10000)
... ERROR(ERROR-PARA)
Initiate task TRN2 associated with terminal STA3; begin the task at 5:30 P.M.
CIC-START TRANSID('TRN2') TIME(173000)
... TERMID('STA3') ERROR(ERROR-PARA)