Version 8.2.5
 —  Utilities  —

FCBPRINT: Print/Dump File Control Block

graphics/util_adaick_fcbprint.png

Use the FCBPRINT function to print and dump the file control block (FCB) of a file.

This document covers the following topics:


Essential Parameter

FILE: File Number

The number of the file for which the FCB is to be printed/dumped. A file number is required the first time you execute ADAICK.

If FILE is omitted on subsequent executions, the last file accessed by ADAICK is used.

Top of page

Optional Parameters

NOOPEN: Prevent Open Resynchronization

When starting, ADAICK normally performs a utility open call to the nucleus to assure that no blocks of the affected file or files are still in the nucleus buffer pool. However, this also locks the file for other users. Specifying NOOPEN prevents ADAICK from issuing the open call.

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.

Top of page

Output Considerations

If the first unused RABN is equal to the last RABN plus 1, then it is very likely that the extent is full and there may be an additional extent. This is true of the first extent in the following example (highlighted in blue). In this case, the first unused RABN is 00002BFE, one more than the last RABN of the extent (00002BFD):

FI 00018 FCB +1A4           First NI RABN: 00002945
FI 00018 FCB +1A8            Last NI RABN: 00002BFD
FI 00018 FCB +1AC    First unused NI RABN: 00002BFE
FI 00018 FCB +1B0           First NI RABN: 00002EE3
FI 00018 FCB +1B4            Last NI RABN: 00002FCB
FI 00018 FCB +1B8    First unused NI RABN: 00002FBC

The first unused RABN does not necessarily lie in the next extent.

Top of page