Backups certain globals or to extract data from the database for use by another system. The MUPIP EXTRACT command copies globals from the current database to a sequential output file in one of three formats-GO, BINARY, or ZWR. The format of the EXTRACT command is:
EXTR[ACT] [
[-FO[RMAT]=GO|B[INARY]|Z[WR]
[-FR[EEZE]]
[-LA[BEL]=text]
[-[NO]L[OG]]
[-S[ELECT]=global-name-list]
[-OCHSET=character-set]
] file- nameBy default, MUPIP EXTRACT uses -FORMAT=ZWR.
MUPIP EXTRACT uses the Global Directory to determine which database files to use.
MUPIP EXTRACT supports user collation routines. When used without the -FREEZE qualifier, EXTRACT may operate concurrently with normal GT.M database access.
To ensure that MUPIP EXTRACT reflects a consistent application state, suspend the database updates to all regions involved in the extract, typically with the FREEZE qualifier, or Backup the database with the ONLINE qualifier and extract files from the backup.
EXTRACT places its output in the file defined by the file- name. EXTRACT may output to a UNIX file on any device that supports such files, including magnetic tapes.
![[Note]](images/note.jpg) | |
Magnetic tapes may have a smaller maximum file size than disks. |
For information on extracting globals with the %GO utility, refer to "M Utility Routines" chapter of the GT.M Programmer's Guide. MUPIP EXTRACT is typically faster, but %GO can be customized.
The following sections describe the qualifiers of MUPIP EXTRACT command.