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:

Known Bugs:

When writing the P* listing, the batch SRCLIB program does not properly escape some characters, and programs reading the listing file will interpret the result as slewing (printer page control), deleting these and substituting random page ejects, etc. Again using the L command easily avoids the problem.

See Also:

expl srclib batch

expl l

Copyright © 1996, Thinkage Ltd.