Type ASSEMBLE
Source Lines : 221
Fixes Applied : 1
Most Recent Version : Tuesday, December 12, 1978
Last Fix ID : [HRC310DS]

Module

       DMSGIO

Function

       CREATE THE DIAGNOSE AND CCW'S FOR AN I/O OPERATION TO
       A DISPLAY TERMINAL FROM A VIRTUAL MACHINE.

Attributes

       DISK RESIDENT

Operation

       DMSGIO FIRST DETERMINES IF IT HAS BEEN CALLED BY THE
       CMS EDITOR. IF IT HAS, THEN A WORK AREA EXISTS IN THE
       EDITOR EDCB CONTROL BLOCK FOR USE IN BUILDING THE CCW
       TO BE PASSED TO CP. IF DMSGIO HAS BEEN CALLED FROM
       AN APPLICATION PROGRAM, POSSIBLY VIA THE DISPW MACRO,
       THEN DMSGIO GETS FREE STORAGE FOR THE CCW.

       DMSGIO CREATES A DIAGNOSE INSTRUCTION OF THE FORMAT:

             ---------------------------------------
             | 83 | R1 | R2 |  0058             |
              ---------------------------------------

             WHERE:

             83      IS THE DIAGNOSE OPCADE
             R1      IS A REGISTER CONTAINING THE ADDRESS OF
                     THE CCW
             R2      IS A REGISTER CONTAINING A VIRTUAL
                     CONSOLE DEVICE ADDRESS
             0058    IS THE DIAGNOSE CODE IN HEXADECIMAL

       DMSGIO CREATES A CCW OF THE FORMAT:

             -----------------------------------------------
             | X'19' | DATA ADDR | FLGS | CTL | COUNT      |
             -----------------------------------------------

             WHERE:

             DATA ADDR   IS THE ADDRESS RECEIVED IN THE
                         PLIST OF THE INPUT BUFFER
             FLGS Z      ARE THE NORMAL CCW FLAG BITS
             CTL         IS THE LINE NUMBER POINTED TO BY
                         THE LINE ADDRESS IN THE PARAMETER
                         LIST.  THE HIGH ORDER BIT IS
                         INTERPRETED BY CP AS A REQUEST
                         TO ERASE THE ENTIRE OUTPUT DISPLAY
                         PRIOR TO DISPLAYING THE NEW DATA.
                         IF THE FLAG IN THE PARAMETER LIST
                         INDICATES A CANCEL FUNCTION, THIS
                         FIELD WILL CONTAIN X'FF' TO CAUSE
                         A SCREEN CANCEL OPERATION.
             COUNT       IS THE HALFWORD COUNT POINTED TO
                         BY THE COUNT ADDRESS IN THE
                         PARAMETER LIST

       USING THE INPUT PARAMETER LIST, THIS MODULE IS A
       BASIC INTERFACE FOR CMS OR APPLICATIONS PROGRAMS.
       USING A STANDARD CALLING SEQUENCE, CMS OR AN
       APLLICATION PROGRAM CAN WRITE TO THE DISPLAY
       TERMINAL.

Calls to Other Routines

       NONE