Type ASSEMBLE
Source Lines : 2,912
Fixes Applied : 9
Most Recent Version : Tuesday, December 12, 1978
Last Fix ID : [HRC015DS]

Module

       DMSUPD (UPDATE COMMAND)

Function

       CMS 'UPDATE' COMMAND -- UPDATE SOURCE FILES ACCORDING
       TO SPECIFICATIONS IN UPDATE FILES.  MULTIPLE UPDATES
       MAY BE MADE, ACCORDING TO SPECIFICATIONS IN CONTROL
       FILES WHICH DESIGNATE THE UPDATE FILES.

Attributes

       DISK RESIDENT, NON-RE-ENTRANT, NON-REUSABLE

Operation

       IF A SINGLE UPDATE IS TO BE PERFORMED, THEN THE INPUT
       SOURCE FILE AND THE UPDATE FILE ARE OPENED.  AS THE
       CONTROL CARDS ARE READ FROM THE UPDATE FILE, INSERTIONS
       AND DELETIONS ARE MADE TO THE SOURCE FILE, WITH THE
       UPDATED VERSION WRITTEN ONTO DISK AS $FNAME.

       IF MULTIPLE UPDATES ARE TO BE PERFORMED, THEN THE CONTROL
       FILE IS OPENED, AND USED AS A GUIDE TO THE VARIOUS
       UPDATE FILES.  UPDATE FILE CONTROL CARDS MAY REFER
       TO UPDATE FILES, OR TO 'AUX' FILES CONTAINING
       DESIGNATIONS OF UPDATE FILEIDS.  (THE EXACT FORMATS OF
       THESE FILES IS DESCRIBED IN DETAIL IN THE COMMAND
       LANGUAGE USER'S GUIDE.)  IF NO UPDATE FILES ARE FOUND
       AT ALL, A RETURN CODE OF 40 IS GENERATED (THIS CODE IS
       GENERATED IN ONLY THIS WAY).
        WHEN MULTIPLE UPDATES ARE BEING PERFORMED, THE INPUT
        SOURCE FILE IS READ INTO STORAGE AND THE UPDATES ARE
        THEN PERFORMED IN STORAGE.  ALL UPDATES ARE DONE
        IN STORAGE BEFORE THE OUTPUT FILE IS CREATED
        ON DISK.

       AS A FINAL STEP, IF THE 'REP' OPTION WAS SPECIFIED, THEN
       THE $FNAME FILE IS RENAMED TO FNAME.

Calls to Other Routines

       ADTLKP    LOOK UP ACTIVE DISK TABLE
       ADTLKW    LOOK UP READ/WRITE ACTIVE DISK TABLE
       FSREAD    READ RECORDS FROM INPUT FILES
       FSWRITE   WRITE RECORDS TO OUTPUT FILES
       FSCLOSE   CLOSE INPUT AND OUTPUT FILES
       FSERASE   ERASE OLD COPIES OF OUTPUT FILES
       PRINTL    PRINT THE LOG FILE
       LINEDIT   TYPE MESSAGES AND FORM LINES
       DMSERR    TYPE ERROR MESSAGES
       FSSTATE   DETERMINE EXISTENCE OF INPUT FILES
       ATTN      STACK LINES (WITH 'STK' OPTION)
       RENAME    RENAME WORK FILES