Type ASSEMBLE
Source Lines : 1,083
Fixes Applied : 1
Most Recent Version : Tuesday, December 12, 1978
Last Fix ID : [R08846DS]
Module
DMSNCP
Function
TO READ A 3705 CONTROL PROGRAM MODULE (EMULATOR PROGRAM OR
NETWORK CONTROL PROGRAM) IN OS LOAD MODULE FORMAT AND
WRITE A PAGE-FORMAT CORE IMAGE COPY ON VM/370 SYSTEM VOLUME.
Attributes
SERIALLY RE-USABLE, EXECUTES IN CMS USER AREA.
Operation
A GETMAIN IS ISSUED FOR MAXIMUM POSSIBLE CORE IMAGE
BUFFER, BUT ANYTHING OVER THREE PAGES IS ACCEPTED.
A BUFFER FOR INPUT LOAD MODULE RECORDS IS RESERVED AT
THE BEGINING OF THIS AREA, THEN THE NEXT EVEN PAGE BOUNDARY
IS COMPUTED - THIS IS THE ORIGIN OF THE 370X CONTROL
PROGRAM CORE IMAGE WHICH WILL BE GENERATED.
THE PARAMETER LIST IS THEN PROCESSED TO EXTRACT OPTION
VALUES AND IDENTIFICATION OF INPUT FILE. IF ANY
IRREGULARITIES IN THE COMMAND ARE FOUND, A MESSAGE
IS TYPED AND PROGRAM EXITS WITH AN APPROPRIATE
ERROR CODE. OTHERWISE, A FILEDEF WITH DDNAME 'DMSNCP1'
IS ISSUED FOR THE INPUT DATASET.
THE INPUT FILE IS THEN OPENED, AND A FIND PERFORMED FOR
THE REQUIRED INPUT MEMBER. RECORDS ARE READ,
CLASSIFIED ACCORDING TO TYPE (CESD, CONTROL OR TEXT)
AND PROCESSED. CESD RECORDS ARE USED TO RESOLVE
THE SYMBOLICALLY SPECIFIED ENTRY POINT
AND CHANNEL VECTOR TABLE. CONTROL RECORDS
GOVERN THE READING OF SUBSEQUENT TEXT RECORDS. TEXT
RECORDS ARE MOVED FROM THE INPUT BUFFER INTO THE
PROPER SPOT IN THE CORE IMAGE BEING CREATED.
AFTER THE LAST TEXT RECORD IS READ, THE INPUT FILE
IS CLOSED AND ANY REMAINING UNUSED
PORTION OF THE GOTTEN CORE IMAGE BUFFER IS RELEASED.
THE TYPE OF CONTROL PROGRAM CORE IMAGE IS DETERMINED,
AND THE SIZE OF THE REQUIRED COMMUNICATIONS CONTROLLER
PARAMETER LIST COMPUTED. THIS AMOUNT OF STORAGE (WITH
SUFFICIENT ADDITIONAL BYTES TO ALLOW ALIGNMENT ON A PAGE
BOUNDARY) IS GOTTEN.
FINALLY, THE CCPARM LIST IS FILLED IN BY EXAMINING THE
370X CONTROL PROGRAM CORE IMAGE, AND, IF IT IS A NETWORK
CONTROL PROGRAM, ATTRIBUTES REQUIRED FOR USE BY VM/370
ARE VERIFIED. IF INCORRECT, A WARNING MESSAGE IS TYPED
AND RETURN CODE ESTABLISHED, BUT PROCESSING CONTINUES.
A DIAGNOSE IS ISSUED TO INVOKE DMKSNC FOR COPYING
THE PARAMETER LIST AND CORE IMAGE ONTO A VM SYSTEM VOLUME
IN PAGE FORMAT.
FINALLY, EXIT PROCESSING FREES ANY GOTTEN STORAGE AREAS
AND RETURNS TO CALLING PROGRAM.
Calls to Other Routines
DMKSNC VIA DIAGNOSE.