Puts the global variable names and their corresponding data values into a GT.M database from a sequential file.
The format of the LOAD command is:
L[OAD] [ -BE[GIN]=integer] -BLOCK_DENSITY] -E[ND]=integer] -FI[LLFACTOR]=integer] -FO[RMAT]=GO|B[INARY]|Z[WR]] ] file-name
![[Caution]](images/caution.jpg) | |
Caution: From an application perspective, performing a MUPIP LOAD operation while an application is running may result in an inconsistent application state for the database. |
MUPIP LOAD uses the Global Directory to determine which database files to use.
LOAD supports user collation routines.
LOAD takes its input from the file defined by the file-name
LOAD may take its input from a UNIX file on any device that supports such files.
For information on loading with an M "percent utility," refer to the %GI section of the "M Utility Routines" chapter in GT.M Programmer's Guide. LOAD is typically faster, but the %GI utility can be customized.
Press <CTRL-C> to produce a status message from LOAD. Entering <CTRL-C> twice in quick succession stops LOAD. A LOAD that is manually stopped or stops because of an internal error is incomplete and may lack application level integrity, but will not adversely affect the database structure unless terminated with a kill -9.
![[Note]](images/note.jpg) | |
The MUPIP EXTRACT or MUPIP LOAD procedure for large databases are time consuming due to the volume of data that has to be converted from binary to ZWR format (on source) and vice versa (on target). One must also consider the fact that the extract file can be very large for a large database. Users must ensure adequate storage support the size of the extract file and the space occupied by the source and target databases. In order to reduce the total time and space it takes to transfer database content from one endian platform to another, it is efficient to convert the endian format in-place for a database and transfer the converted database. See MUPIP ENDIANCVT for more information on converting the endian format of a database file. |
The following sections describe the optional qualifiers of the MUPIP LOAD command.