SHOW-FDDRL-STATUS Show running (foreign) FDDRL jobs

The SHOW-FDDRL-STATUS statement monitors foreign FDDRL jobs. These are jobs which were started in batch mode or by other users.

SHOW-FDDRL-STATUS

Alias: SFS

JOB-IDENTIFICATION = *ALL / *TSN(...) / *JOB-NAME(...)
	*TSN(...)TSN=<alphanum-name 1..4>
	*JOB-NAME(...)
		|	JOB-NAME = <name 1..8> / *NONE)
,OUTPUT-PERIOD = 0 / <integer 0..3600 seconds>
,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

JOB-IDENTIFICATION =
Selects the FDDRL main task.

JOB-IDENTIFICATION = *ALL
Supplies information about the jobs of all FDDRL main tasks.

JOB-IDENTIFICATION = *TSN(TSN=<alphanum-name 1..4>)
Supplies information only about the jobs of the FDDRL main task with the specified TSN.

JOB-IDENTIFICATION = *JOB-NAME(...)
Selects the FDDRL main task according to the request name.

JOB-NAME=<name 1..8> / *NONE)
Supplies information only about the jobs of the FDDRL main tasks with the specified request name.

JOB-NAME=<name 1..8> / *NONE)
Supplies information only about the jobs of the FDDRL main tasks without a request name.

OUTPUT-PERIOD =
Specifies whether and at what time intervals the text output requested using the OUTPUT operand is to be repeated.

The output to S variable requested with the STRUCTURE-OUTPUT operand can only take place once.

OUTPUT-PERIOD = 0
The output is performed once only and not repeated.

OUTPUT-PERIOD = <integer>
The output is repeated periodically after the specified number of seconds.
You can abort the output with //HOLD-PROGRAM (K2) and /INFORM-PROGRAM. If no further FDDRL jobs are found, the output is automatically aborted.

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.

Output information

The SHOW-FDDRL-STATUS statement outputs the following information:

Field name	Meaning
REQ-NAME	Request name
TSN	TSN of the main task or subtask
STATEMENT	FDDRL statement
OBJECT-NAME	Catalog ID or VSN or MN of the (first) disk
DISK/-SET	VSN of the disk of the foreign disk or name of the disk set
FORM	Formatting of the output disk.
JOB-STA	Job status (INACTIVE, ACTIVE, TERM, FORM)
PROCESS-HPS	Number of disk blocks already processed (HP: physical half-page, 2KB)
%	Processing progress in percent
TERM-MSG	FDDRL termination message in the event of errors

Table 3: Outputs of the SHOW-FDDRL-STATUS statement

Typical output

/SHOW-FDDRL-STATUS

FDDRL JOB STATUS                  FDDRL V21.0A00      2020-06-24 09:23:38
 REQ-NAME    TSN STATEMENT           OBJECT-NAME
   DISK/-SET TSN FORM JOB-STA  PROCESS-HPS   % TERM-MSG
   -------- ---- ---- -------_ --------------- --------
 DMP-SBZ3   0N4Y DUMP-PUBSET         SBZ3

   SBZ3.0             ACTIVE       106800  10%
   SBZ3.1             ACTIVE       106800  10%
   SBZ3.2             ACTIVE       106800  10%
   SBZ3-1   0N46      ACTIVE       320400

Output to S variable:

Output information	Name of the S variable	T	Contents
Output identification	var(*list).ID	S	FBDSFS
Request name	var(*list).REQ-NAME	S	<c-string 5..10>
Alias of the statement	var(*list).STMT-NAME	S	CPD CPP DMD DMP RLD RLP CMD
Object type	var(*list).OBJECT-TYPE	S	PUBSET DISK UNIT
Object name: <catid> <vsn> / (<vsn>,...) <mn> / (<mn>,...)	var(*list).OBJECT-NAME	S	<string 1..12>
Number of disks	var(*list).NUM-OF-DISKS	S	1..n
Number of disk sets	var(*list).NUM-OF-DISK-SETS	S	0..9
is the task sequence number of the main task	var(*list).TSN	S	<c-string 4..4>
Termination message (FBDnnnn) in the event of errors	var(*list).TERM-MSG	S	<cstring 7..7> ’’
VSN of the disk	var(*list).DISK(*list).DISK	S	<VSN_1..6>
MN of the input disk	var(*list).DISK(*list).INPUT-UNIT	S	<c-string 2..4>
MN of the output disk	var(*list).DISK(*list).OUTPUT-UNIT	S	<c-string 2..4>
TSN of the processing task (main task / subtask)	var(*list).DISK(*list).TSN	S	<c-string 4..4>
Job status	var(*list).DISK(*list).JOB-STA	S	INACTIVE ACTIVE TERM FORM
Save scope	var(*list).DISK(*list).SEL-HPS	S	<c-string 0..10>
Number of processed HPs	var(*list).DISK(*list).PROCESS-HPS	S	<c-string 0..10>
Processing progress [%]	var(*list).DISK(*list).PROCESS-PERCENT	S	<integer 0..100>
Termination message in the event of errors	var(*list).DISK(*list).TERM-MSG	S	<c-string 7..7> ’’
Disk set name	var(*list).DISK-SET(*list).DISK-SET	S	<c-string 3..6>
TSN of the processing task (main task / subtask)	var(*list).DISK-SET(*list).TSN	S	<tsn>
Job status	var(*list).DISK-SET(*list).JOB-STA	S	INACTIVE ACTIVE TERM
Number of processed HPs	var(*list).DISK-SET(*list).PROCESS-HPS	S	<c-string 0..10>
Termination message in the event of errors	var(*list).DISK-SET(*list).TERM-MSG	S	<c-string 7..7> ’’
TSN of the task for monitoring the online save	var(*list).OLSC.TSN	S	<c-string 4..4> ’’
Remaining time for the online save	var(*list).OLSC.REMAINING-TIME	S	<0..7200 seconds> ’’
Termination message in the event of errors	var(*list).OLSC.TERM-MSG	S	<c-string 7..7> ’’