INCLUDE INCLUDE Use the INCLUDE command to read one or more TEXT files (containing
relocatable object code) from disk and to load them into virtual
storage, establishing the proper linkages between the files. A LOAD command must have been previously issued for the INCLUDE command to
produce desirable results. For information on the CMS loader and the
handling of unresolved references, see the description of the LOAD command. The format of the INCLUDE command is: r -----, , INclude , fn... [(options ••• [) ]] 2E1i2.ll§: r , r , r , 10RIGIN {heXlOc}I , , , , , , , I , I I L- r ... 1!1!R , , NOMAP, L J r ... , ,NOLIBEI L J ,CLEAR , ',RESET {en*tr
y
}"
'1!OCL£lARI L .I L .I r , r ... r ITYPE I lIN! , , TRANS I L 1 r 1 I ,NOINV I ,N:J REP, I ,NOAUTO, L .I L J L J L J r 1
[START] ( SAME] '!H!R , ,NODUP, L J
fn .•. are the names of the files to be loaded into storage. Files
must have a filetype of TEXT and consist of relocatable object
code such as that produced by the :JS language processor. If a GLOBAL command has identified one or more TXTLIBs, fn may
indicate the name of a TITLIB member. If options were specified with a previous LJAD or INCLUDE command, these options (with the exception of CLEAR and ORIGIN) remain set if SAME is specified when INCLUDE is issued. Otherwise, the options assume their default settings. If conflicting options
are specifj,ed, the last one entered is in effect.
CLEAR clears the load area in storage to binary zeros before the
files are loaded. does not clear the load area before loading.
RESET {en;ry} resets the execution starting point previously set by a LOAD or INCLUDE command. If RESET entry is specified, the starting
execution address is reset to the specified location;
otherwise, the included loader input is searched for control
statements. The entry point is then selected according to the
priorities outlined in Usage Note 4 for the LJAD command. If
the included loader input does not contain control statements,
a default entry point is selected as follows:
If RESET * was
section loaded
point.
specified, the
by the INCLUDE first byte of the
command becomes the
first control
default entry
If the RESET option was omitted, the entry point
execution starting point previously set by a
command.
defaults to the LJAD or INCLUDE 106 eMS Command and Macro Reference
INCLUDE OR IGIN {hexloc} {TRANS 1 begins loading the program at the location specified by hexloc.
The variable, hexloc, is a hexadecimal number of up to six
characters. If this option is not specified, loading begins at
the next available storage location. INCLUDE does not overlay previously loaded files unless this option is specified and
the address given indicates a location within a previously loaded
object module. TRANS indicates that the file is loaded into the
transient area. adds information to the load map. NOMAP does not add any information to the load map. ""YPE displays the load map of the files at the terminal, as writing it on the A-disk. This option is valid only if
specified or implied.
well as
MAP is does not display the load map at the terminal. IN! writes invalid card images in the LOAD MAP file. NOINV does not write invalid card images in the LOAD MAP file. writes Replace (REP) statement images in the LOAD MAP file. See the explanation of the CMS LOAD command for a description of the R eolace (REP) sta temen t. NOREP suppresses the writing of Replace (REP) statements in the LOAD file.
searches your accessed virtual disks for TEXT file names to
resolve undefined references. suppresses automatic resolution of undefined references as TEXT file names.
allows TVTLIB 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. NOLlBE suppresses all loading of TITLlB members. START begins execution after loading is completed. SAME retains the same options (except ORIGIN and CLEAR) that were used by a previous INCLUDE or LOAD command. otherwise, the default
setting of unspecified options is assumed. If other options are
specified with SAME, they override specified options. NODU? (See Usage Note 1.)
displays warning messages at
duplicate CSECT is encountered CSECT is not loaded.
your virtual console when a
during processing. The duplicate
does not display warning messages at your virtual console when
duplicate CSECTs are encountered during processing. The du?licate CSECT is not loaded. Section 2. eMS Commands 107
Previous Page Next Page