Input Processing Output I GRl > 1 Process the command line. :> 10PTLIST 2 If filename not specified, find and :> 8 read dump spool file. CMS Dump File 3 Define files.
Reader spool File A. Set up the FILEDEF commands. :> CJ B. Check that the dump file exists.
C. Execute FI LEDEF commands.
D :> 4 Call the OS dump program. > 5 Return to CMS. DUMP •. ._-- Notes Module Label Ref Notes Module Label Ref
1 If the second parameter in the input DMKRND NCPDUMP DMKRND8501 UNABLE TO READ line starts with DUMP, the name of DUMP FROM READER
the CMS file is saved in the output TESTOPT FSCB. The appropriate options are
3
marked in the OPTLIST. If there are A. The name of the CMS dump file DMKRND
no options specified, FORMAT, no MNEMONIC, and no ERASE are
is put in the SVSUT2 and SVSIN FI LEDEFs and in the control STRTDUMP
assumed. If an invalid option is statement skeleton for the
specified, the following message is IPLDUMP processor.
generated
DMKRND863E INVALID PARA-
METER 'xxxxxxxx'
and control returns to CMS with a
return code of 24.
B. The STATE macro is issued to
check that the CMS dump file exists. If an error is retumed, the following message is generated
DMKRND861E FILE 'DUMPnn
2 If the name of a CMS dump file was DMKRND LOOKLOOP
NCPDUMP' NOT FOUND not specified, DMKRND assumes
the dump file is in the reader. The filename of the output file is set to
DUMPOO through DUMP09 and the STATE macro is issued until a dump file is found. If an available name is
The SVSIN record is created, using
the specified user options, any old SVSIN file is erased, and the new SVSIN file is written to the DUMPnn SVSIN file. If the record cannot
not found, the following message is
be written, the message
generated. DMKRND8701 UNABLE TO DMKRND851I TEN DUMP FILES ALREADV EXIST CREATE CONTROL FILE FOR IPLDUMP and control returns to CMS with a re- is issued and control returns to CMS. turn code of 22.
C. The following commands are issued LlNKDMP
The reader is spooled class E and the READNXT
to simulate an OS interface. spool file is read via a DIAGNOSE instruction. The records are deblocked DUMPWRT
and written to the CMS dump file.
The read/write loop continues until the real spool file DIAGNOSE instruc-
tion returns a nonzero return code.
When the end of file is reached, the FILEDEF SVSUT2 DISK DUMPnn
NCPDUMP Al (XTENT 513
NOCHANGE FI LEDEF SVSIN DISK DUMPnn SVSIN Al FILEDEF SVSPRINT PRINTER message
4 DMKRND loads register 1 with the DMKRND
'DUMPnn NCPDUMP' FILE address of a dummy parameter list CREATED and links to IFLDUMP. If the
is issued, the spool file is closed, and
processing continues. If the reader
return code from IFLDUMP is not
zero, it is passed to CMS. was empty or if a read error occurs, an
error message is issued.
5 If the return code from IFLDUMP DMKRND
is zero and ERASE has been requested, DMKRND8531 NO DUMP FILES EXIST the DUMPnn file is erased, and the following message is generated
'DUMPnn NCPDUMP' FILE ERASED Diagram 9-9. DMKRID--ICPDUMP Co.mand Processor 180 IBM VM/370 Service Routines progra. Logic
Program Organization
This section describes the following 3704/3705 co •• and processing aodules: DMKRND--NCPDUMP command processor DMSARN--ASM3705 com.and processor (for NCP/VS Release 2 and 3 Assembler) DMSARX--ASM3705 com.and processor (for
NCP/VS Release 4 Assembler) DMSGRN--GEN3705 command processor DMSLKD--LKED coama.nd processor DMSNCP--SAVENCP co •• and processor DMKRND The interface to the 05/360 3705 dump prograll. Runs in a CMS virtual machine R1: Address of parameter list
R13: Address of savearea
R14: Return address
R15: CSECT base register Q§gg§ RO-10: Work registers R1l: Address of FSCBDSECT R12: CSECT base register
R13: Address of savearea
R14: Linkage register
R15: Return code Call to Other Routines --IFLDUMP TO-format-and print the dump None
Data Areas -Tsca-- Exit Conditions --R12:--CSECT-base address
R13: Address of input savearea
R14: Return address
R15: Return code DoSIRN The interface between CMS and 3704/3705 Assembler (IFKlS"). !!ltrI goints the I!SARN To process the AS!3705 coamand. ISMBAND To handle any I/O activity
pertaining to the SYSUT2 file
during the asseably.
Attributes --tiskresident Conditions It Dl!SARN Rl: Address of the paraaeter list
R14: Return address
R15: Address of the entry point It AS!HAND R1: Address of the DECB R2: Address of the DCE RS: Address of the CPSECT Rll: Address of the FCESECT R14: Return address
R15: Address of the entry point RO-1 :
R3:
R4-5:
R6:
R7-9: RiO; R 12-13:
R14:
R 15:
Usage Work registers
Base register Work registers
Return address caller Work registers
constant S Work registers
Linkage register
Error code £g!!§ Other Routines IMSERSA To erase old files I!SS!NE To initialize storage IMSSTTA To locate the file pOinters IFKAS! To assemtle the
control program 3704/3705 !!ternal FREE!AIN To return free storage GETMAIN To ottain free storage NUCON The nucleus constant area !YPE To send aessages to
terminal ]g!g None
Exit Conditions the --contentS-of register 15 indicate results
of processing.
Chapter 9. The 3704/3705 Service programs 181
Previous Page Next Page