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.

Example:

        
        
            
        DSE> DUMP /FILEHEADER
        
        

            
Access method                 BG     Global Buffers           1024
Reserved Bytes                 0     Block size (in bytes)    8192
Maximum record size          510     Starting VBN               49
Maximum key size             128     Total blocks       0x00000386
Null subscripts            FALSE     Free blocks        0x00000032
Last Record Backup    0x00000001     Extension Count           100
Last Database Bckup   0x00000001     Number of local maps        2
Last Bytestream Bckup 0x00000001     Lock space         0x00000028
In critical section   0x00000000     Timers pending              0
Cache freeze id       0x00000000     Flush timer       00:00:01.00
Freeze match          0x00000000     Flush trigger             960
Current transaction   0x000A9689     No. of writes/flush         7
Create in progress         FALSE     Modified cache blocks       0
Reference count                1     Journaling         DISALLOWED
KILLs in progress              0
Replication State         CLOSED     Region Seqno              0x1
Resync Seqno                 0x1     Resync transaction 0x00000001

        
         

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. Once you choose the /GLO format, you must exit DSE and reenter to choose the /ZWR format.

/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 /ZWR, /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.

/ZWR

Dumps the specified record or blocks into the current output file in ZWRITE (ZWR) format. The /ZWR qualifier is incompatible with the /HEADER and /FILEHEADER qualifiers. Once you choose the /ZWR format, you must exit DSE and reenter to choose the /GLO format.