Version 8.2.4
 —  Utilities  —

ADAPRI Syntax and Examples

graphics/util_adapri.png

This document describes the syntax and parameter of the ADAPRI utility.


Essential Parameters

FROMRABN/ TORABN: Range of Blocks to Be Printed

The beginning and ending numbers of the RABNs to be printed. Both values must be specified; there are no defaults.

Printing begins with the block number specified with the FROMRABN parameter and ends with the block number specified with the TORABN parameter. Each block in the range is printed in hexadecimal format.

Top of page

Optional Parameters

BATCH: Output Format

Controls the line length of the printed output. If BATCH is not specified, the default line size is 80 characters. If BATCH is specified, the output line size is 120 characters.

DEVICE: Device Type

The device type that contains the data set to be printed. This parameter is required if the device type is different from the standard device type assigned by the ADARUN DEVICE parameter.

NOUSERABEND: Termination without Abend

When a parameter error or a functional error occurs while this utility function is running, the utility ordinarily prints an error message and terminates with user abend 34 (with a dump) or user abend 35 (without a dump). If NOUSERABEND is specified, the utility will not abend after printing the error message. Instead, the message "utility TERMINATED DUE TO ERROR CONDITION" is displayed and the utility terminates with condition code 20.

Note:
When NOUSERABEND is specified, we recommend that it be specified as the first parameter of the utility function (before all other parameters). This is necessary to ensure that its parameter error processing occurs properly.

NUMBER: Command/ Protection Log Data Set Number

The number of the multiple (two through eight) command log (CLOG) or protection log (PLOG) data set from which the blocks are to be printed. NUMBER can only be specified when CLOGPRI or PLOGPRI is specified. When NUMBER=2 is specified, DD/CLOGR2 blocks are printed; if the CLOGPRI or PLOGPRI function is specified without NUMBER, the blocks are taken from DD/CLOGR1 (the default).

Top of page

Examples

Example 1:

ADAPRI ASSOPRI FROMRABN=1,TORABN=2

Blocks 1 and 2 of the Associator (which contain the general control blocks) is printed.

Example 2:

ADAPRI DATAPRI FROMRABN=8000,TORABN=8120

Blocks 8000 to 8120, inclusively, of Data Storage are printed.

Example 3:

ADAPRI WORKPRI FROMRABN=1,TORABN=100,BATCH

Blocks 1 to 100 of the Adabas Work are to be printed. The output line size to be used is 120.

Example 4:

ADAPRI CLOGPRI FROMRABN=1,TORABN=80,BATCH,NUMBER=2

Blocks 1 to 100 of the command log data set DD/CLOGR2 are printed in 120-character-wide format.

Example 5:

ADAPRI DSIMPRI FROMRABN=1,TORABN=1

Block 1 only of the DSIM data set is printed. The DSIM data set is only used if Adabas Delta Save Facility Facility is installed.

Example 6:

ADAPRI ASSOPRI FROMRABN=X'19D619',TORABN=X'19D619'

Block 1693209 of the Associator is printed. Note the use of hexadecimal values in the FROMRABN and TORABN parameters.

Top of page