LOAD LOAD Use the LOAD command to read one or more eMS or OS TEXT files
(containing relocatable object code) from disk and to load them into
virtual storage, establishing the proper linkages between the files.
The format of the LOAD command is: r- I LOAD fn .•• [(options ••• [) ]] I I I I I I 1 , I I , I L- r .. I INOMAPI L J
r , ,CLEAR I L .J r .. ITYPE I I.R0TYPE, L .J
r , , INOLIBEI L .J [START] r .. r , IORIGIN {heXIOC}, : RESET I TRANS I L .J L .J r .. II!!! , INOINVI L J r .. I I NODUPI L J r .. I INOREPI L .J r .. I!QI2 , INOAUTOI L J
fn .•. specifies the names of the files to be loaded into storage. The
files must have a filetype of TEXT and consist of relocatable
object code such as that produced by the OS language processors.
If a GLOBAL TXTLIB command has been issued, fn may indicate the
name of a TXTLIB member. QEiiQll§: If conflicting options are specified, the last one entered
is in effect. Options may be overridden or added when you use the INCLUDE command to load additional TEXT files.
CLEAR clears the load area in storage before the object files are
loaded. Whole page frames are released; the remainder of
storage that is not on a page boundary is set to binary
zeros. does not clear the load area before loading. RESET ORIGIN sets the starting location for the programs currently loaded.
The operand, entry, must be an external name (for example, CSECT or ENTRY) in the loaded programs. If RESET is not
specified, the default entry point is used. (See Usage Note
4.) RESET * is treated as a null entry and does not alter
the selection of starting location. !Qig: The RESET option should not be used when loading TEXT files created by any of the following as/vs language
processors under CMS: OS Code and Go FORTRAN, as FORTRAN IV (Gl), OS FORTRAN IV (H) Extended, OS/VS COBOL Compiler and
Library, as Full American National Standard COBOL Version 4
Compiler and Library. {
heXIOC } TRANS loads the program beginning at the location specified by
hexloc; this location must be in the CMS nucleus transient
area or in the user area. The location, hexloc, is a 120 IBM VM/370 CMS Command and Macro Reference

LOAD hexadecimal number of up to six characters. If TRANS is
specified, the file is loaded into the CMS nucleus transient
area. If ORIGIN is not specified, loading begins at the
first available storage location in the user program area. Any program loaded into the transient area must have a
starting address of X'EOOO'. See the discussion of the GENMOD command for information on loading programs in the
transient area. writes a load map on your A-disk, named LaAD MAP AS. NOMAP does not create the LOAD MAP file. TYPE displays the load map at your terminal, as well as writing it
on the This option is valid only if the MAP option
is in effect. does not display the load map at the terminal. !H! includes invalid card images in the load map. NOINV does not include invalid card images in the load map. includes Replace (REP) statements in the load map. NOREP does not include the Replace (REP) statements in the load
map.
searches your accessed virtual disks for TEIT file names to
resolve undefined references. NO AUTO suppresses automatic resolution of undefined references as 'I'EXT file names. allows TITLIB members to be loaded and searches library
directories for external references not resolved in the
loaded text. Text libraries to be searched must have been
previously defined by a GLOBAL command. NOLIBE suppresses all loading of TITLIB members. START executes the program being loajed when loading is completed. LOAD does not normally begin execution of the loaded files.
To begin execution immediately upon successful completion of
loading, specify START. Execution begins at the default
entry point. (See Usage Note 4.) QqR displays warning messages at your terminal when a duplicate CSECT is encountered during processing. The duplicate CSECT is not loaded. (See Usage Note 3.) NODUP does not display warning messages at your terminal
duplicate CSECTs are encountered during processing.
duplicate CSECT is not loaded.
when
The
1. You must have a read/write eMS A-disk accessed when you issue the LOAD command; the loader creates a temporary workfile named DMSLDR SYSUTl and writes it on the A-disk.
section 2. CMS Commands 121