SRCLIB - edit text files into a card-image source library.

Syntax:

srclib [Update=]library [option]*

+Clear                      Commands=filename
Delete=name                 DUmp=filename
Extract=[name>]filename     Include=[name<]filename
List=name                   Replace=[name<]filename
+Table                      Update=Library
xx<filename                 xx>filename
+Zdebug

Options:

[Update=]library: gives the name of the program source library file to be updated. The file must be random, but it may be temporary or permanent. If it does not exist, SRCLIB will only create it if you specify +Clear.
+Clear: tells SRCL to clear (erase) the library. This is required when initializing a new library.
Commands=filename: gives a file of SRCLIB batch directives and text, conforming to the batch syntax described in "expl srclib batch". (Also see the "xx<filename" and "xx>filename" options.) The directives themselves MUST be uppercase.
xx<filename xx>filename: are used with the Commands= option. They associate file codes used by the directives with specific files. "xx" is the two-character file code. "xx<filename" specifies that file "filename" is to be accessed for reading, and associated with file code "xx". "xx>filename" is used to access a file for writing.
Delete=name[,name]*: deletes the specified elements from the source library.
DUmp=filename: dumps all source files into the named file. The resulting file contains SRCLIB directives intermixed with the source text. This lets you use the file as direct input to SRCLIB to recreate the source library or to append these members to another source library, using the Commands= option.
Extract=[name>]filename: extracts the program source named "name" and places it in "filename". If "name>" is not used to specify the element name, SRCLIB takes the element name from the file name. If "filename" is a pathname with slashes, SRCLIB only uses the file name part of the pathname as the "name". Trailing blanks up to column 80 are present in the "filename".
Include=[name<]filename: adds an element to the library. If "name<" is not used to specify the name of the element, SRCLIB takes the name from the given file name.
List=[program]*: lists the specified source program in BCD on the output "fc*p*" file. If no program names are given, SRCLIB lists all programs (in BCD).
Replace=[name<]filename: replaces an existing member of the library with a new version.
+Table: produces a list of the names of the source programs in the library on the output "fc*p*" file (fc*p* is written in BCD).

SRCLIB processes the above directives in exactly the order given, EXCEPT for the +Clear directive; +Clear is always picked out and processed FIRST.

Description:

SRCLIB (SouRCe LIBrary editor) is an editor for random source-library files. It lets you create and modify libraries of program source card-images. These libraries are used by the COBOL 74 COPY verb, and the PL/I and Fortran 77 INCLUDE directives.

The TSS SRCLIB command provides you with the full capabilities of the batch SRCLIB program, and is both faster and easier than submitting your own batch job. See "expl srclib batch" for further details on any of the above batch directives. The various explain files refer to the batch program directives, which have a slightly different syntax than those used by the TSS SRCLIB command; however, it is trivial to translate batch directives to TSS and vice versa.

Notes:

The +Clear option must be specified the first time a library is used, in order to initialize the library.
The message "impermissible perm write" means that the file was submitted to batch without write permission and that it was not changed in any way. This may happen if you do not use the Update= form and a directive such as APPEND, DELETE or MODIFY is used in the file specified by Commands=.
The batch SRCLIB program is sensistive to the case of element names, so the SRCLIB program converts all names to uppercase. If you wish to refer to an element with a lowercase name, you must use the Commands= option.
If using the Commands= file, you must type all SRCLIB directives in uppercase, and end the record with at least one blank.
The fc*p* listing file is BCD, and so ASCII programs may not list correctly in this file (for example, the output from the List= option). Also, you won't be able to tell if the program names from the +Table option are upper or lowercase. It will be faster and easier to look at a member of the library with the L command, since L gets the case of the element correct.
Input files are stored as card-images (80 characters). This tends to waste space. Lines are truncated on input (completely without warning or message) after 80 characters. When source files are extracted, trailing blanks are NOT stripped.

Known Bugs: