SHOW-REQUESTS Show running and completed FDDRL requests

The SHOW-REQUESTS statement displays the FDDRL requests which are running and those which have already been completed.

When this statement is executed, old, completed FDDRL requests (by default older than 40 days) and the associated report files in PDF format are deleted automatically.

SHOW-REQUESTS

Kurzname: SHR

REQUEST-NAME = *ALL / <composed-name 5..10>
,REQUEST-DATE = *LAST-FDDRL-RUN / *ANY / *LAST-REQUEST-RUN / *TODAY / *YESTERDAY /
			<int -99999..0 days> / <date> / *INTERVAL(...)
	*INTERVAL(...)
		|		FROM = *EARLIEST-DATE / *TODAY / *YESTERDAY / <int -99999..0 days> / <date>(...)
		|			<date>(...)
		|				|	TIME = 00:00:00 / <time>
		|		,TO = *TODAY / *YESTERDAY / <integer -99999..0 days> / <date>(...)
		|			<date>(...)
		|				|	TIME = 23:59:59 / <time>
,STATE = *ANY / *ACCEPTED / *STARTED / *COMPLETED(...)
	*COMPLETED(...)
		|		SUB-STATE = *ANY / *COMPLETED-OK / *WITH-ERRORS
,SORT = *BY-DATE / *BY-NAME
,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

REQUEST-NAME =
Selects the requests according to their name.

REQUEST-NAME = *ALL
The request name is not a selection criterion.

REQUEST-NAME = <composed_name_5..10>
Information is output only for requests with the specified name.

REQUEST-DATE =
Selects the requests according to their start date.

REQUEST-DATE = *LAST-FDDRL-RUN
Information is output only for requests of the last FDDRL run (//START-JOBS).

REQUEST-DATE = *ANY
The start date is not a selection criterion.

REQUEST-DATE = *LAST-REQUEST-RUN
Information is output only for the most recent requests with the selected request name.

REQUEST-DATE = *TODAY
Information is output only for requests which were started on the current day.

REQUEST-DATE = *YESTERDAY
Information is output only for requests which were started on the previous day.

REQUEST-DATE = <int -99999..0 days >
Information is output only for requests whose start date lies the specified number of days in the past.

REQUEST-DATE = <date>
Information is output only for requests which were started on the specified date.

REQUEST-DATE = *INTERVAL(...)
Information is output only for requests whose start time lies in the specified period. Range specifications apply including the range limit values.

FROM =
Defines the lower limit of the period for the start time of the requests. Information is output only for requests which were started on the specified date or later.

FROM = *EARLIEST-DATE
Defines that the period for the start time of the requests has no lower limit.

FROM = *TODAY
Defines the date of the current date as the lower limit of the period for the start time of the requests.

FROM = *YESTERDAY
Defines the date of the previous day as the lower limit of the period for the start time of the requests.

FROM = <int -99999..0 days>
Defines the date which lies the specified number of days in the past as the lower limit of the period for the start time of the requests.

FROM = <date>(TIME = 00:00:00 / <time>)
Defines the specified date and, if required, the specified time as the lower limit of the period for the start time of the requests.

TO =
Defines the upper limit of the period for the request date of the requests. Information is output only for requests which were started on the specified date or earlier.

TO = *TODAY
Defines the date of the current date as the upper limit of the period for the start time of the requests.

TO = *YESTERDAY
Defines the date of the previous day as the upper limit of the period for the start time of the requests.

TO = <int -99999..0 days>
Defines the date which lies the specified number of days in the past as the upper limit of the period for the start time of the requests.

TO = <date>(TIME = 23:59:59 / <time>)
Defines the specified date and, if required, the specified time as the upper limit of the period for the start time of the requests.

STATE = *ANY / *ACCEPTED / *STARTED /
*COMPLETED (SUB-STATE= *ANY / *COMPLETED-OK / *WITH-ERRORS) Selects the requests according to their request state and sub-state.

SORT =
Specifies the sort criteria for the output.

SORT = *BY-DATE
The requests are sorted according to the start date in descending order (most recent requests first).

SORT = *BY-NAME
The requests are sorted according to the request name in ascending order.

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

REQ-NAME	Request name
REQ-DATE	Start date of the request
REQ-TIME	Start time of the request
TSN	TSN of the executing task (subtask or main task)
TERM-TIME	Termination time of the request
STA	Request status (ACCEPTED, STARTED, COMPLETED)
SUB-STA	Substatus of the request (WITH-ERROR / ’’)
REPORT-FILE	Name of the report file or *NONE
START-COUNT	Total number of accepted or started requests
COMPL-COUNT	Total number of completed requests
ERR-COUNT	Total number of requests completed with an error (SUB-STA=WITH-ERROR)

Typical output

FDDRL REQUESTS                    FDDRL V21.0A00      2020-08-27 10:48:16
 REQ-NAME   REQ-DATE   REQ-TIME TSN  TERM-TIME  STA     SUB-STA
            REPORT-FILE
 ---------- ------------------- ---- -------- --------- --------
 DMD-ABN4.0 2020-08-27 10:26:53 59N6 10:27:08 COMPLETED
            :B10S:$TSOS.S.FBD.59N6.2020-08-27.102653.DMD-ABN4.0
 RLP-B10S   2020-08-27 08:35:09 59MV 08:37:03 COMPLETED WITH-ERR
            :B10S:$TSOS.S.FBD.59MV.2020-08-27.083509.RLP-B10S
 RLD#WK906E 2020-08-26 14:00:54 59PF 14:01:40 COMPLETED
            :B10S:$TSOS.S.FBD.59PF.2020-08-26.140054.RLD#WK906E
 CPD-WK906C 2020-08-26 09:45:39 59MV 09:46:55 COMPLETED
            :B10S:$TSOS.S.FBD.59MV.2020-08-26.094539.CPD-WK906C
 START-COUNT: 0     COMPL-COUNT: 4     ERR-COUNT: 1

Output to S variable

Output information	Name of the S variable	T	Contents
Output identification	var(*list).ID	S	FBDSHR
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
Object type	var(*list).OBJECT-TYPE	S	PUBSET DISK UNIT
Object name	var(*list).OBJECT-NAME	S	<catid> <vsn> (<vsn>,...) <mn> (<mn>,...)
Start date	var(*list).REQ-DATE	S	<yyyy-mm-dd>
Start time	var(*list).REQ-TIME	S	<hh:mm:ss>
Termination date	var(*list).TERM-DATE	S	<yyyy-mm-dd>
Termination time	var(*list).TERM-TIME	S	<hh:mm:ss>
is the task sequence number of the main task	var(*list).TSN	S	<c-string 1..4>
Status	var(*list).STA	S	ACCEPTED STARTED COMPLETED
Substatus	var(*list).SUB-STA	S	WITH-ERRORS ’’
Name of the report file	var(*list).REPORT-FILE	S	<c-string_43..54> *NONE