Overview of the FDDRL statements

The following FDDRL statements are available:

FDDRL statement	Alias	Meaning
COPY-DISK	CPD	Copy a disk to another disk
COPY-PUBSET	CPP	Copy all disks of a pubset to disks
CREATE-JOBS	CRJ	Create the FDDRL jobs from the specified FDDRL statements
DELETE-REQUESTS	DLR	Delete completed FDDRL requests from the request file
DUMP-DISK	DMD	Save a disk to MTC
DUMP-PUBSET	DMP	Save all disks of a pubset to MTC
END		Terminate the FDDRL utility routine
MODIFY-FDDRL-PARAMETERS	MFP	Define the execution parameters for the FDDRL run
RELOAD-DISK	RLD	Restore a disk from MTC created with DUMP-DISK or DUMP-PUBSET
RELOAD-PUBSET	RLP	Restore a complete pubset from MTC
SHOW-FDDRL-PARAMETERS	SFP	Display the current FDDRL parameters
SHOW-FDDRL-STATUS	SFS	Show running (foreign) FDDRL jobs
SHOW-FDDRL-TAPE-INFORMATION	SFT	Show the tape information of an FDDRL tape
SHOW-REQUESTS	SHR	Show running and completed FDDRL requests
START-JOBS	STJ	Start the FDDRL jobs

|n addition, the following SDF standard statements are available during an FDDRL run:

SDF statement	Meaning
EXECUTE-SYSTEM-CMD	Execute a command during the program run
HELP-MSG-INFORMATION	Output a system message to SYSOUT
HOLD-PROGRAM	Interrupt a program to enter commands
MODIFY-SDF-OPTIONS	Activate or deactivate the user syntax file and modify the SDF settings
REMARK	Comment on statement sequences
RESET-INPUT-DEFAULTS	Reset the task-specific default values
RESTORE-SDF-INPUT	Show the last input
SHOW-INPUT-DEFAULTS	Show the task-specific default values
SHOW-INPUT-HISTORY	Output stored inputs to SYSOUT
SHOW-SDF-OPTIONS	Display the SDF settings
SHOW-STMT	Display statement syntax description
STEP	Define a restart point
WRITE-TEXT	Output a specific text to SYSOUT

The SDF standard statements are not described in this manual (with the exception of END). For their description, see the manual “SDF Dialog Interface” [4].

The MODIFY-FDDRL-PARAMETERS statement defines the parameters for an FDDRL run. The current parameter values are accepted when the CREATE-JOBS statement is executed. If you enter more than one MODIFY-FDDRL-PARAMETERS statement and specify operands more than once, only the last operand before the START-JOBS statement is valid.

The statements for saving and restoring are used to define the FDDRL functions.

The CREATE-JOBS statement creates an FDDRL job for each function (in the case of pubsets for each disk) and for each disk set. When the START-JOBS statement is called, the FDDRL jobs are executed as specified in the PROCESS-JOBS operand of the MODIFY-FDDRL-PARAMETERS statement:

• PROCESS-JOBS=*BY-MAINTASK
  The FDDRL jobs are executed under their own task.

• PROCESS-JOBS=*BY-SUBTASKS
  The FDDRL jobs are executed under FDDRL subtasks.

Once the FDDRL jobs are completed, you can define and start additional functions or terminate the program with END.

With the exception of CREATE-JOBS, START-JOBS and END, you can specify the statements in any order.

Only one job can be defined for a disk or for a disk set:

• If you specify the VSN of a disk in more than one statement, only the last statement entered is processed. A message is issued to inform the user of this.

• If, however, a disk is addressed first via a statement for a pubset (e.g. DUMP-PUBSET) and then via a statement for a disk (e.g. DUMP-DISK), some of the values are taken over from the DISK statement for the FDDRL job of the pubset disk of the same name. These values concern the specification of the output device and are as follows:

  • with the COPY-PUBSET and COPY-DISK statements:
    OVERWRITE-DISK

  • with the DUMP-PUBSET and DUMP-DISK statements with specification of SAVE-ENTITY=*SINGLE-DISK:
    TAPE, TAPE-DEVICE-TYPE

If a statement is found to contain a syntax or semantic error, the spin-off mechanism is triggered. This mechanism, however, is only effective in procedure or batch mode.
The spin-off mechanism is also triggered after START-JOBS if only one of the FDDRL jobs was terminated abnormally or aborted. Erroneous executions of the FDDRL jobs (also under the FDDRL subtasks) are thus spread out into the FDDRL statement level and, if the STEP statement is missing, into the command level also.