Type ASSEMBLE
Source Lines : 474
Fixes Applied : 0
Most Recent Version : Tuesday, December 12, 1978
Last Fix ID : [Unmodified]

Module

       DMSFET  ( FETCH )

Function

       PROVIDE THE FACILITY TO BRING INTO STORAGE A
       SPECIFIED PHASE FROM THE SYSTEM/PRIVATE CORE
       IMAGE LIBRARY OR FROM A CMS 'DOSLIB' LIBRARY.
       ALSO, TO START EXECUTION OF THE PHASE, IF THE
       START OPTION WAS SPECIFIED. IF 'START' WAS NOT
       SPECIFIED, TO INFORM THE USER WHERE THE PHASE
       ENTRY POINT IS.

Attributes

       NUCLEUS RESIDENT MODULE
       REENTRANT

Operation

       1. SET UP NECESSARY ADDRESSABILITIES AND SAVE
          THE RETURN REGISTER. INITIALIZE THE DOSFLAGS
          FIELD, AND VERIFY IF IN CMS/DOS ENVIRONMENT.

       2. CHECK THE COMMAND LINE FOR VALID ARGUMENTS
          AND OPTIONS. ENSURE THAT A PHASE  NAME WAS
          SPECIFIED. SET INTERNAL FLAG IF THE 'START'
          OPTION WAS SPECIFIED. IF THE 'COMP' OPTION
          WAS SPECIFIED, SET FLAG 'DOSCOMP' IN FLAG
          BYTE 'DOSFLAGS' (DOSFLAGS IS IN NUCON).
          IF THE 'ORIGIN' OPTION WAS SPECIFIED, THEN
          CONVERT THE ADDRESS IN THE COMMAND LINE TO
          A BINARY VALUE. IF THE 'INSTAL' OPTION WAS
          SPECIFIED, SET FLAG 'VSMINSTL' IN THE FLAG
          BYTE 'DOSFLAGS'. (DOSFLAGS IS IN NUCON).

       3. INITIALIZE THE CMS'S ( USER AREA ) STORAGE
          POINTERS. COMPUTE THE SIZE OF THE VIRTUAL
          MACHINE AND ACQUIRE ALL STORAGE ( LESS SIX
          PAGES FOR SYSTEM USE ). INITIALIZE LOCATION
          'PPEND' IN 'BGCOM' TO POINT TO THE END OF THE
          USER'S VIRTUAL PARTITION. ALSO INITIALIZE THE
          THE DATE FIELD IN 'BGCOM'.

       4. ISSUE FILEDEF FOR THE 'DOSLIB' LIBRARIES, AND
          ISSUE AN SVC 4 TO LET DMSFCH LOAD, AND IF NE-
          CESSARY RELOCATE THE REQUESTED PHASE. ONCE THE
          PHASE HAS BEEN LOADED, DMSFCH RETURNS THE ENTRY
          POINT OF THE PHASE IN REGISTER 1.

       5. A LOADER TABLE ENTRY ( NUMBER 3 ) IS SETUP TO
          POINT AT THE PHASE JUST LOADED, SO DMSLDR CAN
          NOW WHERE THE PHASE IS IN CORE. IF THE 'START'
          WAS SPECIFIED, A PLIST IS BUILT TO CALL 'START'
          (DMSLDR) AND BEGIN EXECUTING THE PHASE.

       6. IF 'START' WAS NOT SPECIFIED, AN INFORMATION
          MESSAGE IS ISSUED TO INFORM THE USER WHERE THE
          ENTRY POINT OF THE PHASE IS. HE MAY SETUP ADDR.
          STOPS OR BREAKPOINTS AND HE CAN START EXECUTING
          THE PHASE BY ISSUING THE CMS 'START' COMMAND.

       7. WHEN ALL PROCESSING HAS BEEN DONE, A RETURN TO
          CALLER IS MADE PASSING BACK IN REGISTER 15 THE
          RETURN CODE OF THE COMMAND. IF THE PHASE WAS
          EXECUTED BY SPECIFYING THE 'START' OPTION, THE
          RETURN CODE MAY BE THAT OF THE PHASE JUST RUN.

Calls to Other Routines

       DMSSMN, DMSFCH, DMSFLD, DMSDOS
       DMSFRE, DMSLDR, DMSERR