START-JOBS Start FDDRL jobs

The START-JOBS statement starts the generated FDDRL jobs.

If FDDRL jobs have not been created explicitly for all the statements entered with CREATE-JOBS, the FDDRL jobs are created implicitly before they are started (see the description of "CREATE-JOBS Create FDDRL jobs"). If errors occur during this implicit job generation, all the jobs which have been created without error are started anyway.

Depending on the value of the PROCESS-JOBS parameter in the MODIFY-FDDRL-PARAMETERS statement, they are either executed under their own task (FDDRL main task) or under FDDRL subtasks. If the FDDRL jobs are executed under FDDRL subtasks, you must note the following:

• The FDDRL subtasks are started with the parameters that were set with via the MODIFY-FDDRL-PARAMETERS statement (TASK-LIMIT, RUN-PRIORITY).

• While the FDDRL subtasks are running, the status of the FDDRL jobs is periodically output. The output period depends on the value of the STATUS-OUTPUT-PERIOD parameter in the MODIFY-FDDRL-PARAMETERS statement.

• If volumes in the MAREN catalog are protected by passwords, the passwords must be added to the password list with the /ADD-PASSWORD command before the START-JOBS statement (see the “Utility Routines” manual [2]). The password list is copied into the FDDRL subtasks.

When the FDDRL jobs have terminated, an execution log is output (see "Results log of the FDDRL jobs"). Only after this log is output can you enter further FDDRL statements or END.

If at least 1 FDDRL job was terminated abnormally, message FBD1156 is output and in procedure mode the spin-off mechanism is activated. If additional FDDRL statements are to be executed in procedure mode, the START-JOBS statement must be followed by a STEP statement.

Until the START-JOBS statement you can enter statements for up to 5000 FDDRL jobs.

START-JOBS

Alias: STJ

OUTPUT = *SYSOUT / *SYSLST(...) / *NONE
	*SYSLST(...)
		|	SYSLST-NUMBER = *STD / <integer 1..99>
,STRUCTURE-OUTPUT = *SYSINF / <structured-name 1..20>(...) / *NONE
	<structured-name 1..20>(...)
		|	WRITE-MODE = *REPLACE / *EXTEND

OUTPUT =
Defines the output medium for the text output of reports and SHOW statements.

OUTPUT = *SYSOUT
Text output takes place to system file SYSOUT.

OUTPUT = *SYSLST(...)
Text output takes place to system file SYSLST.

SYSLST-NUMBER= *STD / <integer 1..99>
Defines whether the output is to take place to system file SYSLST or to a SYSLST file from the set SYSLST01 through SYSLST99. The default value is *STD, i.e. the output takes place to system file SYSLST.

OUTPUT = *NONE
No text output takes place.

STRUCTURE-OUTPUT =
Controls structured output of reports and SHOW statements to S variables.

STRUCTURE-OUTPUT = *SYSINF
Structured output is directed to the S variable stream SYSINF.

STRUCTURE-OUTPUT = <structured-name 1..20> (...)
Name of the S variable which is to be used for structured output.

WRITE-MODE =
Defines whether the output should replace or complement the current content of the S variable.

WRITE-MODE = *REPLACE
The current content of the S variable is replaced by the new output.

WRITE-MODE = *EXTEND
The new output extends the current content of the S variable.

STRUCTURE-OUTPUT = *NONE
No structured output takes place.