z/VM: CP Commands and Utilities Reference - z/VM - IBM

HCPLDR
Operands
HCPLDR with the TAPE or PUNCH option to generate CP, the loader does not
link-edit object modules and does not pass control to HCPGEN to write the
system on the system residence device.
Issue the HCPLDR command under CMS.
Attention: You should use the VMFBLD EXEC to build nuclei. If you use the
HCPLDR command, it does not load any serviced text decks contained in the
nucleus. The HCPLDR command does not support loading text decks by PTF
number.
loadlist
is the file name of the load list EXEC file. It contains the names of the object
files in the order in which they are to be loaded. The load list may look like this.
&CONTROL OFF
&1 &2 &3 HCPLDR LOADER
&1 &2 &3 fn [ft]
&1
.
&2 &3 fn [ft]
.
fn and ft are the file name and file type of an object file. The ft is optional. If ft is
omitted, HCPLDR searches the control file or an explicit list of file types to
determine the file type.
HCPLDR LOADER must always be the first file. HCPLDR loads each object
module in order from the top of the load list to the bottom.
You can place most loader control statements in the load list EXEC file. You
cannot place VERIFY, REPLACE, or INCLUDE CONTROL SECTION
statements in the EXEC file. A loader control statement begins with a 12-2-9
punch (X'02'). Whenever HCPLDR encounters X'02' in the first column of a
record, it interprets that record as a control statement. For more information see
Appendix D in the z/VM: CP Commands and Utilities Reference.
ctlfile
is the file name of the control file.
HCPLDR uses the update level identifiers in the control file to determine the file
type for those object modules listed in the load list without file types. The
command skips the MACS record in the control file and searches for update
level identifiers from the top of the control file down. If HCPLDR finds an update
level identifier other than TEXT, the command appends the identifier to TXT to
create a file type, then searches for the file (fn TXTxxxxx). If HCPLDR cannot
find an object file that has the first update level identifier, the command finds the
next identifier and continues the search. As a last resort, when HCPLDR cannot
find the object file according to update level identifiers, the command searches
for fn TEXT. For example, if the control file is:
TEXT MACS HCPGPI HCPPSI HCPOM1 HCPOM2 DMSGPI DMSOM OSMACRO
SPEC AUX1111
IBM1 AUXVM
HCPLDR follows this search order:
fn TXTSPEC
fn TXTIBM1
fn TEXT (last resort)
1834 z/VM: CP Commands and Utilities Reference