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:
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.