3704/3705 Control Program Only a subset of the possible linkage editor control statements are
meaningful in C"S. .Since the CMS interface program cannot examine the
input data for the LKED command, all of the control statements are
allowed, even though several of them result in the creation of a load
module file which cannot be used under CMS. For both command options and control statements, see the publication sBĀ£ l!oader. !E"PORAR! The LKED ,command produces one tempora ry file:
fname SYSUTl This file is temporarily created for each link-edit steo: any existina
file with the same file identifier is erased at the beginning of the link edit. This file is placed on the read/write disk with the most
available space. Work space is automatically allocated as needed during
the link edit and returned to available status when the link edit is
complete. Insufficient space causes abnormal termination of the link
edit. PER!!!EN! The LKED command produces two permanent files:
fname LOADLIB
fname LKEDIT
The 'fname LOADLIB' file contains the load created by the
linkage editor. This file is in C"S simulated partitioned data set
format, as created by the CMS OS data management macros. The filename
of the input file becomes the filename of the LOADLIB file, unless the
LIBE option is specified. The filename of the input file also becomes
the member name of the output load module, unless either the NAME option
or a NAME control statement is used. One or more load modules may be
created during a single LKED command execution if the NAME linkage
editor control statement is used in the input file. When the NAME control statement is used, that name becomes the member name in the
LOADLIB file. The replace option of the NAME statement determines
whether existing members with the same name are replaced or retained.
The 'fname LKEDIT' file contains the printed output listing produced
according to the IREF, MAP, or LIST options. This file is created on
disk unless the PRINT or NOPRINT option is specified. The LOADLIB and
LKEDIT files are placed on (1) the disk from which the input file was
read, (2) the parent disk, or (3) the primary disk. Failure to obtain
sufficient space for these files results in abnormal termination of the
linkage editor. Step 9. Save the 3704/3705 Control Program Image on Disk
If you specified SAVE on the GEN3705 command, this step is executed for
you. If you did not specify SAVE on the GEN3105 command, you must issue
the SAVENCP command yourself. The VM/370 command privilege class A, B, or C is required to use
the SAVENCP command. 310 IBM VM/370 Planning and System Generation Guide
3704/3705 Control Program Use the CKS SAVENCP command to read a 3704/3705 control program load
module created by the LKED command, and to load it into virtual storage
in the CKS user area. Once the load is performed, SAVENCP scans the
control program image and extracts the control information required by CP. The control information is accumulated in one or more 4096-byte pages in the CKS user area. When all of the necessary control
information is extracted, SAVENCP builds the Communications Controllers Parameter List (CCPARK) and issues the DIAGNOSE X'50' instruction to
create the page-format copy of the control program on a CP-owned volume.
The format of the SAVENCP command is: , SAVENCP fname
fname [ (options.. [)]]
opt i.Q.B.§ : r , ,ENTRY symbol I IgnNIT I L .I L .I r , ,NAKE ncpnamel ,fname , L .I r , ILIBE librarynamet L .I is the filename of the LOADLIB file where the 3704/3705 control program load module resides; unless LIBE is specified,
in which case, it specifies the member name of the image
within the LOADLIB. This name is used as the ncpnaae for the DIAGNOSE instruction, unless the NAKE option is also
specified. ENTRY symbol
is the external symbol of the entry point in the 3704/3705 control program load module. (The standard entry for the
Emulation Program is CYAST1RT.) If the SAVE option of the GEN3705 command is specified, this symbol is set in the output EXEC file according to the Stage 2 input file. JAKE ncpname
is the ncpname to be used when the DIAGNOSE parameter list is
built. The ncpname specified must match an entry in the
system name table. These entries are created with the NAKENCP macro when VK/370 is generated.
LIBE libraryname CAJiliOD is the filename of a load module library file, filetype LOADLIB, which contains the control program image as member • fname' • must be specified if a Type 4 Channel Adapter is being used. VK/370 supports only one Type 4 Channel Adapter at a time,
although two may be present. Part 4. Generating the 3704/3705 Control Program 311
Previous Page Next Page