Reporting with USTBKPRT

Introduction#

USTBKPRT is a basic reporting utility that lists the contents, by backup version, of any UPSTREAM sequential disk or tape backup. Output is to a print and/or CSV formatted data set. The backup need not be currently recorded in the UPSTREAM repository. This may be useful for determining the contents of a vaulted backup created by USTVAULT, or a primary backup whose records have been removed or expired from the repository.

Executing USTBKPRT

USTBKPRT JCL Statements

USTBKPRT can only be executed as an z/OS batch job.

EXEC Statement

Must specify USTBKPRT. Optionally, may specify PARM=SUMMARY.

PARM=SUMMARY, lists the UPSTREAM backup control records and a summary of the backup, omitting the file detail.

STEPLIB DD Statement

Specifies the library that USTBKPRT resides (usually the UPSTREAM load library). This must be an APF authorized library.

SYSUDUMP DD Statement

Usually a SYSOUT data set. Recommended to diagnose error conditions that cause USTBKPRT to abend.

USTBKUP / SYSUT1 DD Statement

Either DD statement is acceptable. The UPSTREAM backup data set to be reported., USTBKPRT can only report on one backup at a time. If the backup is part of a multi-file tape data set, run multiple executions of USTBKPRT as necessary.

USTCSV DD Statement

Specifies the data set name of the optional CSV output file If it is directed to other than SYSOUT, file attributes are RECFM=VB, and any blocksize of 365 or larger is acceptable. The LOCATOR, TTTR/RB# and OFFSET are hex values and are prefixed with an “X”.

USTRPRT / SYSPRINT DD Statement

Either DD statement is acceptable. This is the USTBKPRT report file. This is a required DD statement and is usually a SYSOUT data set and has attributes of RECFM=VBA, and LRECL=136. If it is directed to other than SYSOUT, any block size of 140 or more is acceptable.

USTBKPRT Example#

The following example shows a report against backup data set: USTPROD.RED60A.COPYI1.G0001V00.

Here is an edited sample of a USTBKPRT report.