This statement enables you to display the tape information of an FDDRL tape.
This comprises information about the tape, the FDDRL run, the saved disk and its properties. This means that users can obtain information on the tape save and can mount the disks required for RELOAD-DISK (device type, format, capacity).
With DUMP-DISK detailed information is output explaining why the tape was rejected.
The statement is executed directly after the entry under the FDDRL main task.
If the specified tape is a continuation tape, the search for the meta information can take a long time. In this case you can if necessary cancel execution with K2/BREAK.
SHOW-FDDRL-TAPE-INFORMATION | Alias: SFT | ||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||
TAPE = <vsn 1..6>
Specifies the MTC (VSN) from which the tape information is to be read.
TAPE-DEVICE-TYPE = *BY-VOLUME-CATALOG / <device>
Defines the volume type of the tape from which the tape information is to be read.
TAPE-DEVICE-TYPE = *BY-VOLUME-CATALOG
This specification is only possible when MAREN is being used.
MAREN determines the volume type itself. When TAPE=*BY-OPERATOR is specified, this is the default volume type set for MAREN (MAREN parameter DEFAULT-DEVICE-TYPE).
TAPE-DEVICE-TYPE = <device>
Volume type of the MTC on the basis of which device management determines the type of device that will be required for tape processing. TAPE may not be specified.
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 tables below shows the fields output and their meaning:
1. Tape data
| Volume serial number (VSN) of the MTC |
| Tape sequence number of a tape set |
| Volume serial number of the first tape of a tape set |
| Creation date of the tape |
| Expiration date of the tape |
| User ID of the tape (with FDDRL, always TSOS) |
| Name of the tape file; provides information about its type (FDDRL, ARCHIVE, DMS) |
2. FDDRL Data
| FDDRL version of the save run |
| FDDRL tape format (compatible from the relevant FDDRL version) |
| Date and time of the FDDRL save (start time) |
| Catalog ID of the SF or SM pubset |
| VSN of the disk. Only supplied here in the case of single disk backup. |
| Time stamp of the pubset / single disk |
| SAVE-ENTITY (*SINGLE-DISK, *DISK-SET) |
| Name of the disk set of this tape |
| Number of disk sets generated (with DUMP-PUBSET) |
3. Disk properties
| VSN of the disk |
| Mnemonic device name (MN) of the disk |
| Device type of the disk |
| Disk format (KEY, NK2, NK4), |
| Allocation unit (A-U: 6, 8, 64). |
| Disk capacity (half-pages, last usable PHP number) or, in the case of old saves of CKD disks, the address of the alternative track area (format: CCHH and the indicator '*T'). |
| With disks of the type D3435, the capacity is output in the number of |
| Number of saved half-pages (2-KB units of the disk) |
If it is available, the tape data is output for every tape. The FDDRL data and disk properties are only output in the case of an FDDRL backup tape. In other cases the text 'NO FDDRL TAPE' is output.
Typical outputs
SAVE-ENTITY = *DISK-SET(...)
FDDRL TAPE INFORMATION FDDRL V21.0A00 2020-08-27 11:58:50 TAPE VSN = QA3093 VOL-SEQ = 0001 FIRST-VOL = QA3093 CRE-DATE = 2020-08-27 EXPIR-DATE = 2020-08-27 USER-ID = TSOS F-NAME = FDDRL.P.B10S.2020-08-27.063900-1 FDDRL = V21.0A TAPE-FORM = *V16-FORMAT SAVE-DATE = 2020-08-27 06:39:32 PUBSET = B10S DISK = DISK-DATE = 2020-08-19 10:01:18 SAVE-ENT = *DISK-SET DISK-SET = B10S-1 NUM-OF-DISK-SETS = 3 DISK UNIT DEV-TYPE FORM A-U NUM-OF-HPS NUM-OF-512B SAVED-HPS ------ ---- -------- ---- --- ---------- ---------- ---------- B10S.0 900E D3435 NK2 6 1966080 7864320 1345360 B10S.1 900F D3435 NK2 6 1966080 7864320 1330240 B10S.2 9068 D3435 NK2 6 1966080 7864320 1162880 B10S.3 9069 D3435 NK2 6 1966080 7864320 1171360 B10S.4 906A D3435 NK2 6 1966080 7864320 1119600 B10S.5 906B D3435 NK2 6 1966080 7864320 1123680
SAVE-ENTITY = *SINGLE-DISK
FDDRL TAPE INFORMATION FDDRL V21.0A00 2020-08-27 11:59:25 TAPE VSN = QA3096 VOL-SEQ = 0001 FIRST-VOL = QA3096 CRE-DATE = 2020-08-27 EXPIR-DATE = 2020-08-27 USER-ID = TSOS F-NAME = FDDRL.D.ABN4.0 FDDRL = V21.0A TAPE-FORM = *V15-FORMAT SAVE-DATE = 2020-08-27 10:26:53 PUBSET = DISK = ABN4.0 DISK-DATE = 2020-08-20 08:46:23 SAVE-ENT = *SINGLE-DISK DISK UNIT DEV-TYPE FORM A-U NUM-OF-HPS NUM-OF-512B SAVED-HPS ------ ---- -------- ---- --- ---------- ---------- ---------- ABN4.0 591E D3435 NK2 6 1843200 7372800 113840
Output to S variable
Output information | Name of the S variable | T | Contents |
Output identification | var(*list).ID | S | FBDSFT |
VSN of the MTC | var(*list).VOL | S | <c-string 1..6> |
Tape sequence number | var(*list).VOL-SEQ | S | <c-string 4> |
1st volume of a tape set | var(*list).FIRST-VOL | S | <c-string 1..6> |
Creation date | var(*list).CRE-DATE | S | <c-string 10> |
Expiration date | var(*list).EXPIR-DATE | S | <c-string 10> |
Length of the tape blocks | var(*list).BLOCK-LEN | S | <c-string 5..6> |
Owner of the MTC (TSOS) | var(*list).USER-ID | S | <c-string 1..8> |
Tape file name | var(*list).F-NAME | S | <c-string ..44> |
FDDRL tape format | var(*list).TAPE-FORM | S | *V17-FORMAT |
Save date | var(*list).SAVE-DATE | S | <yyyy-mm-dd> |
Save time | var(*list).SAVE-TIME | S | <hh:mm:ss> |
Catid of the pubset | var(*list).PUBSET | S | <c-string 1..4> |
Save scope | var(*list).SEL-BLOCKS | S | *USED-BLOCKS |
SAVE-ENTITY | var(*list).SAVE-ENTITY | S | *SINGLE-DISK |
Name of the disk set | var(*list).DISK-SET | S | <c-string 3..8> |
Number of disk sets | var(*list).NUM-OF-DISK-SETS | S | <c-string 1..1> |
Number of disks | var(*list).NUM-OF-DISKS | S | <c-string 1..4> |
VSN of the disk | var(*list).DISK(*list).DISK | S | <c-string 1..6> |
MN of the disk | var(*list).DISK(*list).UNIT | S | <c-string 2..4> |
Device type of the disk | var(*list).DISK(*list).DEV-TYPE | S | <c-string 1.8> |
Disk format | var(*list).DISK(*list).FORM | S | KEY |
Disk capacity in HPs | var(*list).DISK(*list).NUM-OF-HPS | S | <c-string 2..10> |
Disk capacity in number of | var(*list).DISK(*list).NUM-OF-512B | S | <c-string 2..10> |
Saved HPs of the disk | var(*list).DISK(*list).SAVED-HPS | S | <c-string 2..10> |
Time stamp of the disk (date) | var(*list).DISK(*list).DATE | S | <yyyy-mm-dd> |
Time stamp of the disk (time) | var(*list).DISK(*list).TIME | S | <hh:mm:ss> |