EXTRACT Examples

Example:

       $ MUPIP EXTRACT /NOLOG FL.GLO
       

This command instructs EXTRACT to create the global output file, FL.GLO, (which consists of all global variables in the database) without displaying statistics on a global-by-global basis. Because no label is specified, the first record in FL.GLO contains the text string "GT.M MUPIP EXTRACT."

Example:

       $ INIT MSA0: SPECIAL
       $ MOUNT/INIT=CONT/BLOCK=4104 MSA0: SPECIAL
       $ MUPIP EXTR/FO=BIN/SEL=("a2",M:Z)/LAB="SPSAVE" MSA0:SP.SVX
       

In this example, the first command initializes a magnetic tape with the label SPECIAL. The second command mounts the tape with OpenVMS automatic volume initialization and a block size of 4104. The magnetic tape block size of 4104 handles a database block of 4096 bytes. The MUPIP command instructs EXTRACT to create a BINARY output file, SP.SVX, with the label SPSAVE. Since the value of the /SELECT qualifier is enclosed in parentheses the file contains all globals in the database, except those inside the parentheses. In other words, the file contains all globals except ^a2, and those globals starting with the letters M through Z. EXTRACT displays statistics for each global.

Example:

       
            $ MUPIP EXTRACT/SELECT=DRG TT
       
       
         

This instructs EXTRACT to dump the global ^DRG to the device with the logical name TT (normally the login terminal).

The first record of a BINARY format data file contains the header label. The header label is 87 characters long. The following table illustrates the components of the header label.

BINARY Format Data File Header Label

 

CHARACTERS

EXPLANATION

1-26

Fixed-length ASCII text: "GDS BINARY EXTRACT LEVEL 2".

27-40

Date and time of extract in the $ZDATE() format:"YEARMMDD2460SS".

41-45

Decimal maximum block size of the union of each region from which data was extracted.

46-50

Decimal maximum record size of the union of each region from which data was extracted.

51-55

Decimal maximum key size of the union of each region from which data was extracted.

56-87

Space-padded label specified by the /LABEL qualifier.