Qualifiers

-A[LL]

When used with -FILEHEADER, the -A[LL] qualifier displays additional information valuable to Fidelity technical support when troubleshooting GT.M problems.

-B[LOCK]=block-number

Specifies the starting block of the dump. The -BLOCK qualifier is incompatible with the -FILEHEADER qualifier.

For commands without an object qualifier, DSE uses the last block handled by a DSE operation. When no block has been accessed, (i.e., on the first block-oriented command), DSE uses block one (1).

Example:

        
        DSE> dump -block=2
        
                
Block 2 Size 1B Level 0 TN 2
Rec:1 Blk 2 Off 7 Size A Cmpc 0 Ptr 8 Key ^a
      7 : | A 0 0 61 0 0 8 0 0 0 
          | . . . a . . . . . .
Rec:2 Blk 2 Off 11 Size A Cmpc 0 Ptr B Key ^b
     11 : | A 0 0 62 0 0 B 0 0 0
          | . . . b . . . . . .
        

-C[OUNT]=count

Specifies the number of blocks, block headers, or records to DUMP. The -COUNT qualifier is incompatible with the -FILEHEADER qualifier.

-F[ILEHEADER]

Dumps file header information. The -FILEHEADER qualifier is incompatible with all other qualifiers except -ALL. A DSE dump of a database file header prints a 0x prefix for all fields printed in hexadecimal format.

        dse> f -r
        

Example:

        
        DSE> dump -fileheader
        
        
        
Access method                 BG     Global Buffers           1024
Reserved Bytes                 0     Block size (in bytes)    1024
Maximum record size          256     Starting VBN              558
Maximum key size              64     Total blocks               65
Null subscripts            FALSE     Free blocks                5C
Last Rec Backup                1     Number of local maps        1
Last Comp Backup               1     Lock space                 28
Last Inc Backup                1     Free space                180
In critical section     00000000     Timers pending              0
Cache freeze            00000000     Flush timer       00:00:01:00
Freeze image count      00000000     Flush trigger             512
Current transaction         1389     No. of writes/flush         7
Default Collation              1     Collation Version           1
Create in progress         FALSE     File is corrupt         FALSE
Reference count                1     Journaling               OPEN
Before imaging              TRUE     Journal Allocation        100
Journal Buffer Size          128     Journal Extension         100
Journal File:              MUMPS 
Clustered                  FALSE
Stale Timer          00:00:30.00     Quantum Interval  00:00:02.00
Response Interval    00:01:00.00     Tick Interval     00:00:00.10


        

Refer to the "Greystone Database Structure" chapter for a description of the file header fields.

-G[LO]

Dumps the specified record or blocks into the current output file in Global Output (GO) format. The -GLO qualifier is incompatible with the -HEADER and -FILEHEADER qualifiers.

-NO[CRIT]

Allows DSE DUMP to work even if another process is holding a critical section. Since results in this mode may be inconsistent, it should only be used if the critical section mechanism is not operating normally.

-[NO]H[EADER]

Specifies whether the dump of the specified blocks or records is restricted to, or excludes, headers. -HEADER displays only the header, -NOHEADER displays the block or record with the header suppressed. DUMP without the -[NO]HEADER qualifier dumps both the block/record and the header. The -HEADER qualifier is incompatible with the -GLO, and -FILEHEADER qualifiers.

By default, DUMP displays all information in a block or record.

-O[FFSET]=offset

Specifies the offset, in bytes, of the starting record for the dump. If the offset does not point to the beginning of a record, DSE rounds down to the last valid record start (e.g., DUMP -OFF=10 starts at -OFF=A if that was the last record). The -OFFSET qualifier is incompatible with the -RECORD and -FILEHEADER qualifiers.

-R[ECORD]=record_number

Specifies the record number of the starting record of the dump. The -RECORD qualifier is incompatible with the -OFFSET and -FILEHEADER qualifiers.

If you try to dump a record number that is larger than the last actual record in the block, a DSE error message provides the number of the last record in the block.