Version 8.2.5
 —  Utilities  —

DSCHECK: Print/Dump Content of Data Storage Record

Use the DSCHECK function to print and dump the content of the Data Storage records in a file.

graphics/util_adaick_dscheck.png

If you are running Adabas 8 or later, primary and secondary ISNs are identified in the output from an ADAICK DSCHECK run, if spanned Data Storage records are in use.

This document covers the following topics:


Essential Parameter

FILE: File Number

The number of the file for which the record 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

ISN: ISN of Data Storage Record

The ISN of the Data Storage record to be printed. If ISN is omitted, the DSCHECK function prints the last ISN plus 1.

If the Data Storage record is a spanned record, be sure to specify the primary ISN of the spanned record, not a secondary ISN of the spanned record. ADAICK utility processing assumes all specified ISNs are primary ISNs; secondary ISNs will automatically be processed.

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

Sample Output

Here is a sample of the output produced from an ADAICK DSCHECK run for an Adabas 8 database that makes use of spanned records. Note that the primary and secondary spanned record ISNs are identified in the report.

Note:
Report output produced by the ADAICK DSCHECK utility function lists logically defined fields as asterisks (**).

000001D9 0004   0000  LEN      130D       AB IS THE LAST FIELD IN THE RECORD 
000001D9                                                                      
000001D9 000A   0006  ISN      00000001    Primary ISN=1        
000001D9 000E   000A  FLAGS    0081                             
000001D9 0010   000C  Next ISN 00000001                         
000001D9 0014   0010  Primary  00000001   
000001DA 0004   0000  LEN      1303        BA IS THE LAST FIELD IN THE RECORD 
000001DA                                                                      
000001DA 000A   0006  AC2 ISN  00000001    AC2 ISN=1       
000001DA 000E   000A  FLAGS    0041                        
000001DA 0010   000C  Next ISN 00000002                   
 000001DA 0014   0010  Primary  00000001                                                   

Top of page