Table of Contents

DMSLBT Abstract

Statistics

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

Synopsis

Module

     DMSLBT (TXTLIB)

Function

     TO  CREATE A  TEXT LIBRARY,  TO  ADD TEXT  FILES TO  AN
     EXISTING  TEXT LIBRARY,  TO DELETE  TEXT FILES  FROM AN
     EXISTING TEXT LIBRARY, TO CREATE A DISK FILE THAT LISTS
     THE CONTROL  SECTION AND  ENTRY POINT  NAMES IN  A TEXT
     LIBRARY, OR TO TYPE AT THE TERMINAL THE CONTROL SECTION
     AND ENTRY POINT NAMES IN A TEXT LIBRARY.

Attributes

      DISK RESIDENT, USER AREA ROUTINE

Operation

     THE OPERATION OF TXTLIB DEPENDS  ON WHETHER THE CALLING
     PROGRAM SPECIFIES GENERATE, ADD, MAP, OR DELETE.

     GENERATE:
     TXTLIB  CALLS THE ERASE  COMMAND PROGRAM TO  ERASE THE
     EXISTING TEXT  LIBRARY (IF ANY)  WITH THE SAME  NAME AS
     THE ONE  TO BE CREATED.   NEXT, TXTLIB  INITIALIZES THE
     INDEX AND SAVES IT FOR  SUBSEQUENT USE TO CALCULATE THE
     SIZE OF THE  FIRST CONTROL SECTION.  THEN  TXTLIB CALLS
     THE STATE  FUNCTION PROGRAM TO  DETERMINE IF  THE FIRST
     INPUT  TEXT FILE  SPECIFIED EXISTS.   IF  IT DOES  NOT,
     TXTLIB SIGNALS AN ERROR BY  MEANS OF A TERMINAL MESSAGE
     AND PROCESSES THE NEXT INPUT TEXT FILE.

     IF  THE  TEXT  FILE  EXISTS,  TXTLIB  CALLS  THE  RDBUF
     FUNCTION PROGRAM TO READ THE  FIRST RECORD IN THE FILE
      AND CHECKS THE FIRST COLUMN FOR A BLANK ( INDICATING
     THAT IT MAY BE AN OS LINKAGE EDITOR CONTROL CARD) AND
     IF IT IS NOT, THE RECORD IS PASSED ON TO BE WRITTEN OUT
     (THIS PROCESS IS FURTHER DESCRIBED LATER). IF THE FIRST
     COLUMN IS BLANK AND A LINKAGE EDITOR OPERATOR IS DETECTED,
     CONTROL IS PASSED TO THE APPROPRIATE PROCESSING
     ROUTINE, OTHERWISE THE CARD WILL BE WRITTEN TO THE TEXT DECK
     AND PROCESSED IN THE STANDARD FASHION.

     THE LINKAGE EDITOR OPERATORS THAT ARE PROCESSED CONSIST
     OF THREE: ENTRY, ALIAS AND NAME. THE FOLLOWING DESCRIBES
     THE EFFECT OF EACH OPERATOR.

    ENTRY - THE FIRST VALID ENTRY CARD ENCOUNTERED SETS THE ENTRY
            POINT NAME FIELD IN THE LDT CARD, WHICH IS TO
            BE PUT OUT WHEN THE TEXT DECK IS COMPLETED.

Calls to Other Routines

     NONE