Chapter 9. The 3704/3705 Service Pr"ograms
Introduction
There are four CMS commands and tvo CP coamands specifically for generating and
manipulating the 3704/3705 contrel program. The CMS coa.ands are needed to generate and
save a copy of the 3704/3705 control program. The CP commands allow you to
operate and aanipulate the 3704/3705 in a manner siailar to the way other CP commands
let you operate your other virtual machine
devices.
The C8S comaands that help you generate
a 3704/3705 centrol program are: AS83705, GEN3705, LKED, and SAVENCP. The AS83705 coamand is an interface between C8S and the NCP/VS Release 2 and 3 Assembler (IFKAS8) or the NCP/VS Release 4 Assembler (CWAXOO). It accepts source statement files as input,
cbecks that the input file exists and that
the options specified are valid, calls IFKAS8 or CWAXOO to perfora the assembly,
and produces an object deck and program
listing as output. The AS83705 command produces the stage 1 output for the 3704/3705 control program generation - process.
The GEN3705 command accepts the file
produced in stage 1, creates a unique
asseab1er file for each job step in the
input file, creates several unique files
containing the linkage editor statements
necessary to build the load aodule file,
and builds an EXEC aacro file of the CMS coamands necessary to assemble and load the 3704/3705 control program. If SAVE was
specified on the command line, it saves a
copy of the control program in page-format
on a CP-owned volume. The LKED command is an interface between CMS and the as/'s 1 linkage editor. The GEN3705 co •• and processor embeds the LKED
co.mands in the EXEC macro file it
produces. The LKED co.mand processor
interprets the C8S comaand lines, defines
the necessary files, and links to the OS/VS linkage editor. Two permanent files are
produced: the 'filename LOADLIB' file,
which contains the load aodu1es, and the
'filename 1KEDIT' file, which contains the
printed output.
The SAVENCP co •• and builds the parameter
list (CCPARM) and calls D!KSNC via Diagnose
instruction X'50' to write a core image
copy of the 3704/3705 control program to a CP-owned system volume. This copy of the
control program is loaded each time the 3704/3705 is loaded.
The CP commands that help yeu te centro1
the operation of the 3704/3705 are NCPDUMP and NETWORK. The NCPDU!F command processor performs several different tasks. It: Erases a specific CP or eMS 3704/3105 dump file. Formats the 3704/3705 dUllp. Prints the 3704/3705 duap file. Issigns an identifier to the 3704/3705 dump file. Creates the CMS 3704/3705 dUmp file.
The NETWORK command precessor provides
the support for the 3704/3705 that several CP commands (ENABLE, DISIELE, QUERY, DISPLAY, VARY, BALT, TRICE, and SHUTDOWN) provide for other devices. In addition,
the NETWORK command has options that load a na.ed 3704/3705 contrel Frogram into 3704/3705 storage and duap the contents of
that storage.
These co.mands are discussed in detail
in other putlications. For lore information about the A583105, GEN3105, LKID, and SA'ENCP comaands and a complete
description of the generation process, see
the VML11.Q Planning and system GeM.!atiSl! Guide. For more informaticn about the NCPDUMP and NETWORK COli lands, see the !J!L170 Operator'§ §uide. The ZAP service program, which allows
you to update and dump existing 3704/3705 load libraries, is described in "Chapter 10. The ZAP Service Program
n
and in the !J!L170 Quide. Chapter 9. The 3704/3705 Service Programs 169
Method of Operation
This section describes the CftS modules that
provide the co •• ands to generate the 3704/3705 control progra.s. Diagrams describe the functions perforaed by each of
the co.mand processors. Figure 9-1 shows
the relationships between these diagra.s. Diagram 9-1 describes the SAVENCP co •• and, which saves an image of the 3704/3705 control program so that it can
later be loaded. Diagra. 9-2 shows how CCPARft is built.
Diagrams 9-3, 9-4, and 9-5 describe the GEN3705 com.and, which generates a series
of commands to assemble, link edit, and
load the 3704/3705 control program. Diagram 9-1 Diagram 9-3 Diagram 9-6 DMSNCP - DMSGRN - DMSARN - SAVENCP Overview of the ASM3705 Command GEN3705 Command Processor Command Processor Processor I Diagram 9-2 Diagram 9-4 Diagram 9-5 DMSNCP - DMSGRN - DMSGRN - Building the Generati ng the Generating the CCPARM List 3705 Assembler Link Edit Files Files tiagrams 9-6 ASft3705 co.mand, between e!s and eIIKAS! or CWAXOO). and 9-7 describe the
which is an interface
the ICP/VS Assembler Diagram 9-8 describes the LKED co •• and,
which is an interface bEtween CftS and the as/VS1 Linkage Editor.
Diagra. 9-9 describes com.and, which prints a 37C4/3705 storage.
Diagram 9-7 Diagram 9-8 DMSARX - DMSLKD - ASM3705 LKED Command Command Processor
Processor RCPDU!!F of the
Diagram 9-9
DMKRND - NCPDUMP Command Processor
Figure 9-1. Key to the 3704/3705 Service programs Bethod of Operation Diagrams 170 IBM VM/370 Service Routines Program Logic
Previous Page Next Page