BST08OCP: Copying/Checking/Repairing/Restoring archive files

Overview

BST08OCP is an archive utility that can be used for the following tasks:

  • Checking archive data, for example, checking the contents of archive datasets (CHECK command)
  • Creating copies of archive datasets (COPY command)
  • Updating the appropriate database tables according to the contents of the archive datasets (REPAIR command)
  • Reloading data from archive datasets (RESTORE command)

The product STC must be active when BST08OCP is running.

Function support is product-dependent

BST08OCP supports different functions for different Beta Systems products. For more detailed information on supported functions, see the documentation of your product.

The following examples are taken from _beta doc|z plus.

License check

No license is necessary for the CHECK function. For all the other functions, the program verifies that the required license is present before it executes the specified function.

Sample JCL

+-------------------------------------------------------------------------+
|jobcard |
|//BST08OCP EXEC PGM=BST01RFF,REGION=0M,PARM=('S=97', |
|// 'PGM=BST08OCP', |
|// 'B01LST=nn', |
|// 'B97LST=nn', |
|// 'SIGNON=YES') |
|//* |
|//STEPLIB DD DISP=SHR, |
|// DSN=BETA.APFLOAD <=== BETA APF LIBRARY |
|// DD DISP=SHR, |
|// DSN=BSA.LOAD <=== BSA LOAD LIBRARY |
|// DD DISP=SHR, |
|// DSN=BETA97.LOAD <=== PRODUCT LOAD LIBRARY |
|//* |
|//SFFPARM DD DISP=SHR, |
|// DSN=BETA.PARMLIB <=== LST PARAMETER |
|//* |
|//B97DEF DD DISP=SHR, |
|// DSN=BETA97.DB.DEF |
|//* |
|//IRMPRINT DD SYSOUT=* |
|//IRMPROT DD SYSOUT=* |
|//IRMLOG DD SYSOUT=* |
|//IRMDEL DD SYSOUT=* |
|//IRMIN DD * |
| CHECK DSNAME(BETA97.TAPE365.VTS.E04251.C002) ORDER(1) |
|/* |
+-------------------------------------------------------------------------+

Return codes

0

The program terminated normally.

4

The program terminated with warnings, which can be caused by, for example:

  • No data found to process

8

Inconsistencies were found in the archive data.

16

This return code can occur due to several reasons, for example:

  • An invalid keyword was coded.
  • A required DD statement was not coded.
  • The program was unable to find a matching record for the dataset specified. (The dataset may have already expired or its name may have been misspelled.)

DD statements

The sample JCL and the following table use DD cards with prefix IRM, which is the prefix used by _beta doc|z plus. Instead of the product prefix, you can also use the prefixes BSS or BST, i.e. BSTPRINT/BSSPRINT, BSTPROT/BSSPROT, etc.

DD name

Description

IRMPRINT

Logs the start, the command executed, and the result

IRMPROT

Result of the analysis, for example, contents of the archive datasets analyzed

This DD statement is required when using the CHECK command. It is optional for all other commands. Don't code this DD statement if you don't need this information.

IRMLOG

Used by the program to log the input statements coded in DD IRMIN and to output messages

IRMERR

Contains lists where errors have been found (these lists are also logged in IRMPROT)

IRMDEL

List of archive datasets that can be deleted; you can use DD IRMDEL as input for IDCAMS to delete these datasets

IRMIN

Input statements

This is where you code the commands that are to be processed by BST08OCP.