Retro1.org codex

TXTLIB                                                    CMS User Area command

Use the TXTLIB command to update CMS text libraries.  The format of the TXTLIB
command is:
+----------+------------------------------------------------------------------+
| TXTlib   | GEN libname fn1 [fn2...]         [(options...[)]]                |
|          | ADD libname fn1 [fn2...]         [(options...[)]]                |
|          | DEL libname member1 [member2...] [(options...[)]]                |
|          | MAP libname                      [(options...[)]]                |
|          | options:                                                         |
|          |    DISK     PRINT     TERM                                       |
+----------+------------------------------------------------------------------+
where:

GEN      creates a TXTLIB on your A-disk. If a TXTLIB with the same name
         already exists, it is replaced.

ADD      adds TEXT files to the end of an existing TXTLIB on a read/write disk.
         No checking is done for duplicate names, entry points, or CSECTs.

DEL      deletes members from a TXTLIB on a read/write disk and compresses the
         TXTLIB to remove unused space.  If more than one member exists with
         the same name, only the first entry is deleted.

MAP      lists the names (entry points) of TXTLIB members, their locations in
         the library, and the number of entries.

libname  specifies the filename of a file with a filetype of TXTLIB, which is
         to be created or listed or from which members are to be deleted or
         added.

fn1 [fn2...]
         specifies the name(s) of file(s) with filetype(s) of TEXT, that you
         want to add to a TXTLIB.

member1 [member2...]
         specifies the name(s) of TXTLIB member(s) that you want to delete.

Options:

DISK     writes a CMS file, named "libname MAP A5," that contains a list of
         TXTLIB members.  This is the default.

PRINT    spools a copy of the TXTLIB map to the virtual printer.

TERM     displays information about the TXTLIB on your terminal.


Usage notes:

1.  When a TEXT file is added to a library, its membername is taken from the
    first CSECT name or NAME statement in the TEXT file.  Deletions and LOAD
    and INCLUDE command references must be made on these names.

2.  Members must be deleted by their initial entry in the dictionary (that is,
    their "name" or the first ID name).  Any attempt to delete a specific alias
    or entry point within a member will result in a "NOT FOUND" message.

3.  If you want your TXTLIBs to be searched for missing subroutines during CMS
    loader processing; you must identify the TXTLIB on a GLOBAL command; for
    example:
       global txtlib newlib

4.  You may add OS linkage editor control statements NAME, ALIAS, ENTRY, and
    SETSSI to a TEXT file before adding it to a TXTLIB.  There must be a blank
    in column 1 and the ALIAS, NAME, and ENTRY statements must follow the END
    statement.  The ALIAS statement must precede the NAME statement.  The
    specified ENTRY point must be located within the CSECT.

5.  TXTLIB members are not fully link-edited, and may return erroneous entry
    points during dynamic loading.

6.  The total number of members in the TXTLIB file cannot exceed 1000.  When
    this number is reached, an error message is displayed.  The total number of
    entry points in a member cannot exceed 255.  When this number is reached,
    an error message is displayed and the next text file (if there is one) is
    processed.  The text library created includes all the text files entered up
    to (but not including) the one that caused the overflow.

7.  TERM or PRINT options will erase the old MAP file, if one exists.

8.  If you delete the last remaining member of a TXTLIB, the TXTLIB is erased.

9.  If the TXTLIB DEL command terminates abnormally, the temporary file
    'TXTLIB CMSUT1 A1' may remain on the disk.  This file must be either
    deleted or renamed prior to executing the next TXTLIB DEL command.  If the
    library TXTLIB file that was being updated prior to the abnormal
    termination still exists, delete the 'TXTLIB CMSUT1' file, otherwise rename
    the 'TXTLIB CMSUT1' file to the name of the library TXTLIB file that has
    been deleted.

Responses:

When the TXTLIB MAP command is issued with the TERM option, the contents of the
directory of the specified text library are displayed at the terminal.  The
number of entries in the text library (xxx) is also displayed.
   ENTRY INDEX
   name  location
     .     .
     .     .
     .     .
   xxx ENTRIES IN LIBRARY