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.