FDRABRP Archive Report

PRINT ARCHIVE statement

The report generated by the PRINT ARCHIVE statement contains information stored by ABR for data sets that have been archived, including: data set name, DASD volume ID and type, date archived, data set attributes, backup file number and volume serial numbers and when the backup expires.

PRINT ARCHIVE statement syntax

PRINT

ARCHIVE


,ADATE=yyddd|yyyyddd


,COPY=1|2


,DELETE=NO|YES


,DSG=dsg|(dsg,…,dsg)


,DSN=dsn|(dsn,…,dsn)


,EXPIRE=NO|YES


,FORMAT=CRT|PRT


,HEX


,LINECNT=58|nn


,RECALL=NO|YES


,REORG%=nn


,RESTORED=NO|YES


,SDATE=yyddd|yyyyddd


,SDAYS=nnnn


,SELTERR=NO|YES


,SORT=NO|YES


,SUM=NO|YES


,VOL=vol|(vol,…,vol)


,VOLG=volg|(volg,…,volg)


,XDAYS=10|nnn

PRINT ARCHIVE can also be used with an FDRAPPL Application Control File, to report on data sets that have been backed up with FDRAPPL.

Important

If you specify a data set name with the DSN operand and this data set was archived multiple times, ABR only displays the most current copy. If you want to see all of the times the data set was archived, specify DSG= the full data set name.

VSAM

VSAM files are reported by the cluster name followed by its individual components. Selection criteria for VSAM files are only by cluster name.

PRINT ARCHIVE statement operands

ADATE=

Only data sets archived on the specified date are selected, specified as a Julian date (year plus day number), which is in the form “yyyyddd” (for example, 1997123) or “yyddd” (for example, 97123). If the 2-digit year format is used, year numbers less than 70 are assumed to be in the 21st century, for example, 20123=2020123. For readability, a period may be inserted between the year and day (for example, 1997.123).

COPY=

Specifies which backup copy number (1 or 2) to process for tests such as SDAYS and EXPIRE=.

Default: Both copies are tested.

DELETE=
NO

Selects only the archived data sets that have not been marked for deletion.

YES

Selects only the archived data sets that have been marked for deletion by the DELETE statement of FDRARCH, (see FDRARCH-DELETE-Statement) and are subject to removal from the Archive Control File.

Default: The delete flag is not tested.

DSN=

Only data sets or clusters with a name matching one of the names given are selected (1 to 44 characters).

Important

FDRABRP does not support data set name masking (patterns). For similar reports using masking, FDREPORT-Generalized-Report-Writer.

DSG=

Only data sets or clusters beginning with one of the prefixes given are selected (1 to 44 characters).

There is a special form of the DSG operand. Leading periods “”) after DSG= indicate that the group name starts after one or more index levels. Each period indicates that one index level is to be bypassed.

Example: DSG=..TST selects any data set with a third index level starting with “TST”.

Important

DSN and DSG operands may be repeated and/or intermixed. A total of up to 200 strings may be specified.

EXPIRE=
NO

Selects only the archived data sets that have not expired.

YES

Selects ONLY the archived data sets that have expired (data sets that are subject to removal from the Archive Control File because they are past their expiration date). Expiration dates recorded as 99.000, 99.365, or 99.366 are interpreted as “never expire”.

Default: No expiration date check is made.

FORMAT=
CRT

Produces a 79-character line formatted for a TSO terminal.

PRT

Produces a 121-character line formatted for a printer.

Default: CRT if executing under TSO; PRT otherwise.

HEX

Specifies that the Archive Control File is to be printed in a dump format (character/hexadecimal). Individual fields are NOT identified.

Default: The report is produced in character format, with the data identified by field within the records.

LINECNT=

nn

Specifies the maximum number of lines each report page can contain, from 10 to 99, inclusive.

Default: 58.

RECALL=
NO

Selects only the archived data sets that have not been marked for auto-recall.

YES

Selects only the archived data sets that were archived by FDRABR with the RECALL=YES option for auto-recall are selected.

Default: The recall flag is not tested.

REORG%=

Specifies a minimum percent of free space required in the Archive Control File. If the free space is less than the nn%, message FDR428 is issued, listing the actual percent of free space.

Default: 10.

RESTORED=
NO

Selects only the archived data sets that have not been restored.

YES

Selects only the archived data sets that have been restored by FDRABR.

Default: The restored flag is not tested.

SDATE=

Only the data set sets was archived on or after the specified date are selected, specified as a Julian date (year plus day number) that is in the form “yyyyddd” (for example, 1997123) or “yyddd” (for example, 97123). If the 2-digit year format is used, year numbers less than 70 are assumed to be in the 21st century, for example, 20123=2020.123. For readability, a period may be inserted between the year and day (for example, 1997.123). This option reduces the execution time of the print program if many data sets have been archived.

Default: The entire Archive Control File is searched.

SDAYS=

Specifies a value in days used to calculate a prior Julian date (today's date minus the SDAYS= value). This date is used as described above by SDATE operand. This option can reduce the execution time of the print program if many data sets have been archived.

SELTERR=
NO

Specifies that a condition code of 12 is not set if there are no archived data sets that match the selection criteria on this PRINT command.

YES

Specifies that a condition code of 12 is set if there are no archived data sets that match the selection criteria on this PRINT command.

Default: YES.

SORT=
NO

Results in the report being printed in archive date sequence (most current to least current).

YES

Results in the archive report being printed in data set name sequence. See Section 53.2 “FDRABRP JCL Requirements” for possible JCL modifications required for sorting.

Default: YES; except when the input device or the output device is a TSO terminal, which causes NO to become the default.

SUM=
NO

Results in the summary report being bypassed.

YES

Results in the printing of the summary report after the detail listing.

Default: YES.

VOL=
VOLG=

Only data sets that were archived from the specified volume serial “VOL=” or volume serial prefix “VOLG=” are selected. Multiple values are specified in parentheses separated by commas.

Important

VOL and VOLG operands may be repeated and/or intermixed. A total of up to 100 strings may be specified.

XDAYS=

Specifies a value in days used to calculate a future expiration date (today's date plus the XDAYS= value). This date is used when calculating the number of expired entries printed in the summary report. This value is also used if you select expired entries by coding EXPIRE=YES operand.

Default: 10.

inset_2.jpgThe FDRABRP program has been functionally stabilized, but is still available; however, this report can be produced with FDREPORT and enhanced with all the features available in FDREPORT and the flexibility to modify the reports as desired. This is the JCL and control statements to produce the equivalent FDREPORT for FDRABRP “PRINT ARCHIVE” report.

//FDREPORT EXEC PGM=FDREPORT,REGION=0M //SYSPRINT DD SYSOUT=* //ABRMAP DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //SYSIN DD * SORT FIELD=DSN PRINT DATATYPE=ARCHIVE,RPTYPE=ARCHIVE /*

This FDREPORT example can be found in the JCL library installed with FDR. The member name is EX5303A.

Sample reports for FDRABRP

ABR Archive Report

CARD IMAGE - * PRINT ARCHIVE,SDAYS=90
FDR400 AUTOMATIC BACKUP/RECOVERY REPORT - FDRABRP VER 5.4/91P -INNOVATION DATA PROCESSING DATE: 2008.323 PAGE - 1

FDRABR ARCHIVE REPORT --- DSNAME SEQUENCE

ARCHIVE CONTROL FILE IS -- FDRABR.ARCHIVE AND IS LOCATED ON DASD VOLUME -- SCR083

*-DSK VOL-* *--DATE OF--* D/S REC BLOCK LBP BK **---DSN TAPE INFO---**
**---DATA SET NAME---** SERIAL S TY ARCHIVE EXPDT ORG FM SIZE LRECL ALLOC R/TRK* TY CN SUFFIX FN VOL-SERIAL(S)
ICF1.C540266.ARC.PS SCR082 1 0E 08.263 08.262 PS FB 3120 80 2C 0 0E 1 B108263A 0 SCR089
09.262 81 2 B208263A 1 001440
IDP.C540697.TEST1 SCR087 1 0E 08.234 08.235 ** U 0 0 1T 0 0E 1 B108234B 0 SCR088
08.235 81 2 B208234B 1 CCR094
IDP.C540697.TEST1 SCR087 1 0E 08.234 08.235 ** U 0 0 1T 0 0E 1 B108234A 0 SCR088
08.235 81 2 B208234A 1 CCR086
IDP.C540697.TEST2 SCR087 1 0E 08.234 08.235 ** U 0 0 1T 0 81 1 B108234C 1 CCR095
IDP.C540697.TEST2 SCR087 1 0E 08.234 08.235 ** U 0 0 1T 0 81 1 B108234B 1 CCR090
PLOUS.GDGS3.DATA1 SMS811 2 0E 08.294 08.304 PS FB 80 80 1T 0 0F 1 B108294A 0 DV20FF
PLOUS.GDGS3.DATA1 SMS812 3 0E 08.294 08.304 PS FB 80 80 1T 0 0F 1 B108294A 0 DV20FF
...
TSTSMS.C540968.PS.VOL2 SMS407 2 0F 08.315 09.314 PS F 23476 23476 4T 3 0E 1 B108315F 0 SCR086
TSTSMS.C540968.PS.VOL2 SMS407 2 0F 08.315 09.314 PS F 23476 23476 4T 3 0E 1 B108315E 0 SCR086
TSTSMS.C540968.PS.VOL2 SMS407 2 0F 08.315 09.314 PS F 23476 23476 4T 3 0E 1 B108315D 0 SCR086
TSTSMS.C540968.PS.VOL2 SMS407 2 0F 08.315 09.314 PS F 23476 23476 4T 3 0E 1 B108315C 0 SCR086

**---VOL TY FIELD SHOWS DEVICE TYPE OF DATA SET ARCHIVED--*
08--2314 09--3330 0D--3330-11 0A--3340 0B--3350 06--2305-01 07--2305-02 0E--3380 0C--3375
0E--3380-E 0E--3380-K 85--F6421 0E--3380-1 0E--3380-2 0F--3390 0F--3390-2 0F--3390-F 0E--3380-E4
0E--3380-3 0F--3390-3 0F--3390-9 0F--3390-27 0F--3390-54 04--9345-1 04--9345-2 0E--3380-K4 0F--3390-E2
0E--3380-K5 0F--3995-53

**---BK TY FIELD SHOWS DEVICE TYPE OF ARCHIVE BACKUP--*
0E--3380 0F--3390 81--3490

***** INFORMATION FOR FIELD LABELED *DSN SUFFIX* ***CLUSTER – DEFINES A VSAM ICF GASE CLUSTER
THE TAPE DSNAME IS CONSTRUCTED AS FOLLOWS: THE FIRST FOLLOWED BY ITS ASSOCIATED COMPONENTS
THE FIRST INDEX IS ’FDRABR.’
THE SECOND IS THE DISK SERIAL NUMBER PRECEDED BY A ’V’
THE THIRD IS FOUND UNDER DSN-SUFFIX
EXAMPLE FOR DATASET NAME TSTSMS.C540968.PS.VOL2
(FDRABR.VSMS407.B108315C)

***** INFORMATION FOR FIELD LABELED R/TRK* **-----ALLOC TYPE------**
WHEN THE DATA IS FOLLOWED BY AN ASTERISK(*), C – CYLINDER ALLOCATION
THIS INDICATES THE FIELD VALUE IS THE RELATIVE TRACK T – TRACK ALLOCATION
ADDRESS OF THE BEGINNING OF THE DATASET. A – ABSOLUTE TRACK ALLOCATION
WHEN THE ASTERISK IS NOT PRESENT, THE VALUE IS THE
NUMBER OF USED TRACKS (LAST BLOCK POINTER).

This report provides the ABR user a list of all data sets that have been archived from DASD storage. The report also furnishes the user a list of tape volumes that contain the data sets that have been archived from DASD storage devices.

Sample archive report under TSO

*** ARCHIVE CONTROL FILE IS -- FDRABR.ARCHIVE
*** LOCATED ON DASD VOLUME -- SCR083


DSN-TST.EMPLOYEE.LIST DVOL-BM23C6 3390 VSEQ---1
ARCHIVE DATE-2008.326 BK/TY(1)-3590-1 BK/TY(2)-*N/A EXT--1 NO/CYL------3
DSORG-PS RECFM-FB BLKSIZE---9040 LRECL----80 LBP------0
TDSN(1)-FDRABR.VBM23C6.B108326A EXPDT-2009.325 FIL----1 VOL-003342


DSN-TST.PAYROLL.MASTER DVOL-BM23C6 3390 VSEQ---1
ARCHIVE DATE-2008.326 BK/TY(1)-3590-1 BK/TY(2)-*N/A EXT--1 NO/CYL------3
DSORG-PO RECFM-FB BLKSIZE---9040 LRECL----80 LBP------1
TDSN(1)-FDRABR.VBM23C6.B108326A EXPDT-2009.325 FIL----1 VOL-003342

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*