LIBR - r4.3 - ELIPS Command Reference Guide
LIBR - r4.3 - ELIPS Command Reference Guide
Second Edition
This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to
as the “Documentation”) is for your informational purposes only and is subject to change or withdrawal by CA at any time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without
the prior written consent of CA. This Documentation is confidential and proprietary information of CA and may not be disclosed
by you or used for any purpose other than as may be permitted in (i) a separate agreement between you and CA governing
your use of the CA software to which the Documentation relates; or (ii) a separate confidentiality agreement between you and
CA.
Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation, you may
print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your
employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced
copy.
The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable
license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to
certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.
TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY
KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE,
DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST
INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE
POSSIBILITY OF SUCH LOSS OR DAMAGE.
The use of any software product referenced in the Documentation is governed by the applicable license agreement and such
license agreement is not modified in any way by the terms of this notice.
The manufacturer of this Documentation is CA.
Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions
set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or
their successors.
Copyright © 2003 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to
their respective companies.
Contact CA Technologies
Contact CA Support
For your convenience, CA Technologies provides one site where you can access the
information that you need for your Home Office, Small Business, and Enterprise CA
Technologies products. At http://ca.com/support, you can access the following
resources:
■ Online and telephone contact information for technical assistance and customer
services
■ Information about user communities and forums
■ Product and documentation downloads
■ CA Support policies and guidelines
■ Other helpful resources appropriate for your product
Contents 5
LONG Selection List .................................................................................................................................................... 40
SHORT/QUICK Selection List ....................................................................................................................................... 42
Index 121
Contents 7
Chapter 1: Introduction
This guide contains the information required to use the ELIPS interface between CA
Librarian and ISPF/PDF. ELIPS (Extended Librarian Interactive Productivity Services) is an
ISPF/PDF application that provides complete CA Librarian access and update capabilities
to the online user. ELIPS lets you edit, browse, rename, copy, print, view, or delete CA
Librarian members, as well as change member control and history information, easily
and immediately.
ELIPS immediately updates a member whenever the SAVE or END command is issued
and data has been changed, unless you are in VIEW (V) mode; then even if the data has
been changed, it does not update the member. In case of abnormal interruption, ELIPS
fully supports automatic EDIT recovery.
HELP Facility
ELIPS has a complete on-line tutorial which can be displayed by entering HELP on the
command line. Information on individual functions can be accessed by paging through
the on-line tutorial. To exit the HELP facility, enter END.
Chapter 1: Introduction 9
Library Naming Conventions
Specify any CA Librarian library name that adheres to these conventions in the
PROJECT/GROUP/TYPE fields of the ELIPS Main Entry Panel. If your CA Librarian library
name does not adhere to these conventions, you must specify it in the OTHER
LIBRARIAN DSNAME field of that panel.
Note: For more information on the exits, see the System Services Guide.
You must specify the name of the CA Librarian library that is the target of any ELIPS
function commands on the ELIPS entry panel. For this reason, you must come back to
the entry panel to change the name of the target CA Librarian library.
You can obtain a member selection list from this panel or specify the name of a CA
Librarian member as the target of ELIPS function commands.
The confirm delete setting, the display history setting, and the initial edit macro name
are specified only in the entry panel. To change them during an ELIPS session, you must
return to this panel.
To invoke an ELIPS functions, enter the first letter of the function on the command line.
Most of these functions require that you specify a member name. Available functions
are as follows:
A (ARCLIST)
Displays a line describing each level of an archived member.
B (BROWSE)
Displays the contents of an CA Librarian member.
C (COPY)
Makes a copy of a member and assigns to it the name provided in the NEWNAME
field.
D (DELETE)
Deletes the member from the CA Librarian library.
E (EDIT)
Invokes the ISPF editor for the member selected.
I (INFO)
Requests the display of a member's control and history information for examination
and update. You can also add history records using the INFO function.
J (JCLVAL)
Invokes the CA JCL validation product for the member.
JCLO (JCLOPTS)
Displays the options for the CA JCL validation product.
LI (LIST)
Displays a LONG or SHORT format selection list, depending on what was specified.
OPT (OPTIONS)
Displays CA Librarian library defaults, ELIPS installation options, and user options.
P (PRINT)
Prints a listing of the selected member to the SYSOUT class and DEST defined on the
ELIPS OPTIONS panel.
REC (RECOVER)
Queries the Edit Recovery Table for pending entries.
R (RENAME)
Renames the member to the name supplied in the NEWNAME field.
V (VIEW)
Invokes the ISPF editor for the member selected, but does not allow updates to the
member.
TY (TYPES)
Displays the member type/language table generated during ELIPS installation.
Member types, CA Librarian language code, and sequence field starting column and
length are all shown on a scrollable display.
UT (UTILITY)
Copies members to and from CA Librarian libraries and moves members from
sequential or partitioned data sets to CA Librarian libraries.
You can specify commands and parameters on this line. When parameters accompany a
command name, the command parameters override what is specified in the other fields
of the entry panel.
The data set name is taken from the OTHER LIBRARIAN DSNAME field, if this field is not
blank. Otherwise, the PROJECT/GROUP/TYPE fields are used for the data set name.
When you do not specify a command but supply a member name, the command
defaults to EDIT. Specifying a wildcard or a blank member name defaults to LIST. To
obtain a member selection list, enter only the CA Librarian library name. The LONG
member selection list is the default if the SELECTION LIST field is blank.
PROJECT and GROUP and TYPE
Specifies the three levels of qualification of an CA Librarian library name, when the
format of the CA Librarian library data set name is as follows:
project.group.type
You must fill in all three of these fields to specify an CA Librarian library.
MEMBER
Specifies the CA Librarian member to process (or a wildcard specification for a
selection list). You can use the MEMBER field when the data set name is specified in
the OTHER field and you supply any of the NEWNAME, PSWD, or ARC LVL fields.
Otherwise, you must specify the member name or wildcard name for a selection list
in the OTHER LIBRARIAN DSNAME field, enclosed in parentheses immediately after
the data set name.
When you specify the member name in the OTHER field, you can also specify
archive level selection by enclosing it in parentheses immediately following the
member name. You must still specify NEWNAME and PSWD in their respective
fields.
OTHER LIBRARIAN DSNAME ==> ELIPS.DEMO.DSN2(TESTMOD(-1))
If the COMMAND field is blank and the MEMBER field is either blank or a wildcard
specification, a member selection list is generated.
LRECL
Specifies the member record length to use when creating a new member with the
EDIT function on a wide record master file. Specify a value from 10 to 255.
NEWNAME
Specifies the name of the new member created by the COPY function or the new
name for a member being renamed. The new name must not contain spaces,
commas, parentheses, or slashes.
PSWD
Specifies the CA Librarian password for the existing member. If your site requires it,
you must enter the password to access a member. Otherwise, you can enter the
password as a check to be sure you are naming the correct member.
If a password is required for a member of an CA Librarian library that you specified
in the OTHER LIBRARIAN DSNAME field, you must specify that password in the
PSWD field.
When you supply an incorrect password, even if not required, ELIPS does not
process the member.
ARC LVL
Specifies the archive level of the member to process. Specify the archive level in
one of three ways:
■ Date and time. The syntax is as follows:
yymmddhhmmss
yy
Specifies the year.
mm
Specifies the month (default is 12).
dd
Specifies the day (default is 31).
hh
Specifies the hour (default is 24).
mm
Specifies the minute default is 59).
ss
Specifies the second (default is 59).
Note: If pairs of digits are omitted from the right, the default occurs.
■ Absolute level number. The syntax is as follows:
Lnnn
nnn
Specifies the level number, with 0 as the first version created.
ARC LVL ===> L3
-n
Specifies the number, with -0 as the current version.
ARC LVL ===> -1
SELECTION LIST
Specifies how you want to view the selection list. If you do not enter a function on
the command line and do not specify a member name, specify a wildcard.
L
Specifies a LONG format member selection list.
S
Specifies a SHORT format member selection list, showing member names only.
Q
Specifies a SHORT format member selection list, showing member names only.
PGMR
For the LONG member selection list, displays only members with the specified
programmer name in their control information.
You can specify the PGMR field as the name to find on the CA Librarian members or
use a wildcard. If the field is left blank or contains only an asterisk (*), then the
PGMR field is ignored when the selection list displays.
TYPE
For the LONG member selection list only, specifies the type of member to display
on the selection list (for example COBOL, ASM, or CLIST). A table (generated at
ELIPS installation) translates the type specified here into a CA-Librarian language
code.
You can only use those types that were specified during ELIPS installation. ELIPS
translates the member type into an CA Librarian language code for the search.
When you enter a member type that is not on the Type/Language Table, a panel
displays showing all of the acceptable member types. The user must then enter a
correct member type to proceed. You can enter an asterisk or blank field (meaning
all types) as anything can be valid in the TYPE field.
You can specify a one- to three- character CA Librarian language code in the TYPE
field by preceding the language code with a slash. For example, specifying /ASM
displays only those members with an CA Librarian language code of ASM.
CONFIRM DELETE
Specifies whether you want to be prompted with a CONFIRM DELETE screen
whenever a DELETE is to take place.
If you specify Y, a panel displays every time you request the DELETE function,
showing the pertinent control information for the member to delete. You can
cancel the DELETE at this point.
You can only specify the option to display a CONFIRM DELETE screen on the main
entry panel.
PRINT FUNCTION
Indicates whether the member listing report or only the member data prints. DATA
prints only FBA members (those with 1 in column one of record one) using the FBA
character controls.
DISPLAY HISTORY
Specifies whether the member's history records display automatically for BROWSE
and EDIT functions. EDIT also requires the EDIT profile to have NOTES ON. You can
set NOTES OFF and DISPLAY HISTORY Y to have the records displayed for BROWSE
only.
You can only specify the DISPLAY HISTORY option on the main entry panel.
INITIAL EDIT MACRO
Specifies the name of the optional initial macro to use when the PDF editor is
invoked for the ELIPS EDIT function. An initial macro is executed after data is read,
but before the data displays for edit.
Wildcard Specification
When you request a member selection list, you can specify the member name field and
the PGMR name field to select a subset of the members on the CA Librarian library.
You can use these two types together. For example, specifying a**c* selects members
that have an “a” as the first character, anything as the second character, anything as the
third character, “c” as the fourth character, and any number of unspecified characters
after that.
Note: The REFRESH command is not available from EDIT MOVE/COPY selection lists.
Edit Subcommands
The following are ELIPS edit subcommands:
■ HIST
■ INCALL
■ MENU
■ INC
■ INFO
■ NEWVERS
The ELIPS entry panel lets you enter the command with or without parameters. When
you specify a parameter, the command line overrides any parameter values that are
filled in on the panel. Otherwise, ELIPS takes the command parameter values from the
appropriate fields on the entry panel.
When you do not specify the command in the entry panel, the command defaults to
either:
■ EDIT when you specify a member name
■ LIST when the member name is a WILDCARD name or blank
The ELIPS selection lists let you enter the command in the command line or as a line
selection in the list. Since the line selection panel field is a one character field, you can
use only commands that have one character short formats as line selections.
The command syntax for ELIPS functions are as follows, for all commands except LIST:
command member PSWD(pswd) ARC(lvl) NEW(newname)
command
ELIPS function command.
member
Name of the member to act on.
pswd
Member's present password (where appropriate).
lvl
Archive level of the member to access.
newname
New name for RENAME and COPY commands.
Note: You can access members whose names contain lower case characters only as a
line in the body of a member selection list. Member names entered on the main panel
or on a selection list command line are converted to upper case before processing.
wildcard
The wildcard name the LIST is generated for. If the list is to include all members, use
* (asterisk) as the name.
lan
The three-character CA Librarian language code for the LIST command.
type
The member TYPE for the LIST command. You can specify the TYPE as /lan instead
of using the LANG keyword. If you specify both LANG and TYPE, then TYPE is used.
pgmr
The programmer name or wildcard programmer name for the LIST command.
The ARCLIST function command generates a selection list for an archived CA Librarian
member showing all available archive levels. The valid line selection commands for this
list are:
■ B (BROWSE)
■ C (COPY)
■ E (EDIT)
■ P (PRINT)
■ V (VIEW)
Any other ELIPS function command is allowed as a command line specification, except
for RENAME, DELETE, and INFO.
You can use the LOCATE command to position to the absolute level number, shown as
the first field in the display.
Shown is the archive selection list for member ARCMOD. The current level is selected
for BROWSE and the -2 archive level is copied to create member ARCMOD1. The ALT
command is also entered to change to an alternate display.
*************** ELIPS 4.1 ARCHIVE SELECT FUNCTION ALT 1 ******** MEMBER COPIED
Afterwards, the alternate display shows the two levels that were selected. RENAME,
DELETE and INFO are not valid as line selections because these are member level
functions. You cannot rename or delete a specific archive level, and cannot modify
control information for a previous level.
Pressing the END key or entering END on the command line returns you to the panel
where the ARCHIVE LEVEL selection list was invoked.
You can select an archive level of the member to copy, copying the selected level and all
available older levels to the new member.
Specify the COPY function by selecting C as an option on the main panel, or by entering
C as the select character on a LONG member selection list or ARCHIVE LEVEL selection
function and entering the name of the new member in the NEWNAME field.
memname
The name of the member to copy.
pswd
The members's password (your site might require a password).
level
The archive level, specified as an absolute or relative number, or a date and time.
newname
The name of the new member.
******************************************************************************
* ELIPS *
* CONFIRM DELETE *
* *
* MASTER: LIBR.ELIPSD1.MAST *
* MEMBER: TESTMOD *
* DESCRIPTION: SAMPLE ASSEMBLER PGM *
* PROGRAMMER: prgrmr2 *
* LAST UPDATED: 94/06/05 15:54:22 *
* ADDED DATE: 93/09/09 *
* LANGUAGE: ASM *
* *
* THIS LIBRARIAN MEMBER WILL BE DELETED IF THE ENTER KEY IS PRESSED, *
* AND KEPT IF THE END COMMAND IS ISSUED. *
* *
* PRESS ENTER OR END *
* *
******************************************************************************
Note: ARCLVL (archive level) is not allowed on a DELETE function selection since the
entire member is always deleted in all its levels. Similarly, you cannot delete only one of
the levels displayed on the Archive Level Selection List. You can specify DELETE with a D
on the main panel or on the selection list next to the member.
You can also specify DELETE on the command line of any selection list.
memname
The name of the member to delete.
pswd
The four-character member password (your site might require a password).
For further information on the ELIPS EDIT function and the commands and options
available with it, see the “Edit Function: Editing a Member” chapter in this guide.
COMMAND ===>
*********************ELIPS 4.3 CURRENT MEMBER INFORMATION**********************
* DSNAME: LIBR.ELIPSD1.MAST MEMBER: TESTMOD *
* LEVELS AVAILABLE: 012 DATE ADDED: 93/09/09 LAST UPDATED: 94/06/03 14:46 *
* PASSWORD ===> ZXQL LANGUAGE ===> ASM TYPE ===> ASM *
* ARCHIVE ===> Y STATUS ===> T MCD ===> *
* DESCRIPTION ===> SAMPLE ASSEMBLER PGM *
* PROGRAMMER ===> LIBDEM2 LOCKED ===N (Y/N) *
* ARCLR DATE ===> (yymmddhhmmss) *
* DELETE HIST? ===> (Y/N) *
* SEQ. OPT ===> R (R/N) *
* COLUMN ===> 73 LENGTH ===> 8 INCR ===> 0010 STARTNUM ===> 0010 *
* HISTORY DATA: *
* ===> *
* ===> *
* ===> *
* ===> *
* ===> *
* ENTER SAVE TO UPDATE THE MEMBER *
* ENTER END TO EXIT AND UPDATE IF CHANGED *
* ENTER CANCEL TO EXIT AND NOT UPDATE *
*******************************************************************************
DSNAME
The selected CA Librarian library. Not modifiable.
MEMBER
The selected member. Not modifiable.
LEVELS AVAILABLE
The number of archived levels for the member. This field is blank for a non-archived
member and is not modifiable.
DATE ADDED
The date the member was created. Not modifiable.
LAST UPDATED
The date and time that the member was last updated. Not modifiable.
PASSWORD
The current CA Librarian password for the member. If this field is changed, an INFO
update changes the password accordingly.
Passwords can be any four-character alphanumeric string. Special characters are
not permitted. CA Librarian assigns a password consisting of four random
alphabetic characters to each module that is added to the master file.
You cannot assign the following CA Librarian reserved words as passwords:
■ EXEC
■ LIST
■ NONE
■ NOPC
■ NOPR
■ PERM
■ TEMP
■ TEST
LANGUAGE
The current CA Librarian language code for the member.
TYPE
The corresponding TYPE (see TYPES command). If the LANG is not defined in the
TYPE table, the TYPE field is blank. You can specify either field. In case of conflict,
the LANG field overrides the TYPE specification.
ARCHIVE
The current CA Librarian archive status for the member (Y, N, or S). You can modify
this field to activate, deactivate, or suspend archiving for the member.
■ If you specify Y, the member becomes archived.
■ If you specify N, all levels, except the current level, are deleted and the
member becomes a non-archived member.
■ If you specify S, subsequent updates replace the level selected for updating,
delete more recently created levels (if any), and retain older levels (if any).
LOCKED
For wide record masters. Specify Y or N to lock or unlock the member.
DESCRIPTION
The current CA Librarian description for the member. This is a modifiable
30-character field and can be required as an ELIPS site option (see the section on
the OPTIONS command).
STARTNUM
The starting sequence number.
HISTORY DATA
The area for entering up to five CA Librarian HISTORY records that are added to the
member upon update.
The SAVE command entered on the INFO panel updates the member (if there were
changes) and then redisplays the INFO panel. END SAVEs then EXITs the function.
The CANCEL command EXITs the function without update. You can delete all the old
history records for the member by entering a Y next to DELETE HIST? If your site
requires a programmer name or description and the required field is blank, you must
enter the necessary information before the update is done.
A member Type Error Display appears if you enter a member type on the member
information update panel that is not found on the Type/Language Table. This error
display shows all of the acceptable member types. You must then enter a correct
member type to proceed. You can enter a language type, using the /lan format.
When you enter the LIST command from the LONG format list, the list only regenerates
if you specified a different wildcard name, PGMR, or TYPE.
When you enter the LIST command from the SHORT format list, the list regenerates if
you specified a different wildcard name. You cannot specify the PGMR and TYPE for the
short list.
When you enter the LIST command from the ARCHIVE selection list, the long or short
format list (whichever is currently set) regenerates. If you specify a wildcard name, it is
used.
COMMAND ===>
************************* ELIPS INSTALLATION OPTIONS **************************
* *
* REL: 4.3 mm/dd/yy *
* PASSWORD REQUIREMENT: READ: NO UPDATE: NO DELETE: NO *
* PROGRAMMER NAME REQUIREMENT: ADD: YES UPDATE: YES TSO ID) *
* DESCRIPTION REQUIREMENT: ADD: YES UPDATE: YES *
* HISTORY DATA REQUIREMENT: ADD/UPDATE: NO *
* CROSSCHECKING OPTION: TLICD: YES CCF: YES *
* TYPE DEFAULT: ASM *
* *
**************** LIBRARIAN LIBRARY INITIALIZATION OPTIONS *********************
* *
* DSNAME: LIBR.DEMO.ELIPS VOLUME: LIBRVL *
* ARCHIVING SUPPORTED: YES MAXIMUM LEVELS: 255 *
* PASSWORDS REQUIRED: NO SECURITY INVOKED: NO *
* VAR/NOVAR: VAR SEQUENCE DEFAULT: 73,8,0010,0010 ( RESEQ ) *
* *
***************************** ELIPS USER OPTIONS ******************************
* *
* SYSOUT CLASS ===> A (DEFAULT: A) SYSOUT DEST ===> *
* *
*******************************************************************************
The first line in the ELIPS INSTALLATION OPTIONS section shows the CA Librarian release
number and release date.
Note: You must specify an CA Librarian library data set name for this function in either
the PROJECT, LIBRARY, TYPE fields, or the OTHER MASTER DSNAME field.
PASSWORD REQUIREMENT
Indicates whether the CA Librarian password is required for READ, UPDATE or
DELETE functions. If the CA Librarian library requires passwords as an initialization
option, then passwords are required, regardless of the ELIPS installation option.
PROGRAMMER NAME REQUIREMENT
Indicates whether the programmer name is required for ADD or UPDATE. (TSO ID)
additionally indicates that ELIPS always uses the TSO user ID as the programmer
name, regardless of what is supplied.
DESCRIPTION REQUIREMENT
Indicates whether you must supply the CA Librarian description for ADD or UPDATE.
HISTORY DATA REQUIREMENT
Indicates whether you must supply CA Librarian history records for adds and
updates to members.
CROSSCHECKING OPTIONS
Indicate whether any are in effect. If CCF is YES, then access to LIB/CCF controlled
production CA Librarian libraries is restricted according to the rules the LIB/CCF
administrator specified. If TLICD is YES, then no member currently outstanding
through the LIBGET command can be updated using any ELIPS function.
TYPE
DEFAULT is the ELIPS TYPE (see the TYPES command) that is used when the CA
Librarian member to edit either does not have an CA Librarian LANG or the LANG is
not defined in the ELIPS TYPE table. The TYPE determines the edit PROFILE that is
used.
LIBRARIAN LIBRARY INITIALIZATION OPTIONS
Shown for the CA Librarian library that is currently specified on the ELIPS entry
panel.
DSNAME
Identifies the CA Librarian library.
VOLUME
The volume where that library resides.
ARCHIVING SUPPORTED
Indicates whether the library supports archiving. If YES, then MAXIMUM LEVELS is
the maximum number of archived levels that any one member can have. When a
member that has reached this maximum number is updated, the oldest level is
removed.
PASSWORDS REQUIRED
Indicates whether passwords are required to access members in this library using
any ELIPS function except INFO and LIST.
SECURITY INVOKED
Indicates whether CA Librarian library security is activated. NO indicates that no
security is activated. YES indicates that the AllFusion CA-Librarian management
code (MCD) is activated. EXT indicates that an external security system is activated.
VAR/NOVAR
Indicates whether automatic Source-Load audit trail variable substitution takes
place for batch CA Librarian and LIB/AM executions.
SEQUENCE DEFAULT
Shows the sequence number column, sequence field length, increment, starting
number, and RESEQ/NORESEQ option that is used when the language TYPE is
defined to use the library default. This is the sequence value that ELIPS generates,
based on the TYPE entry for the language in the ELIPS TYPES table, when no
sequence value is supplied.
The ELIPS USER OPTIONS section lets you modify the SYSOUT class and destination for
the PRINT function.
The default CLASS is A. There is no default value for destination (DEST). These options
remain in effect, once set, until changed again.
Note: An asterisk (*) is not a valid SYSOUT CLASS for the ELIPS PRINT function.
REPT prints the member's control information, history records, and data records.
DATA prints only the member's data records. When DATA is specified, if the first
character of the first record is the FBA top-of-page carriage control character (1), the
member is printed as format FBA. Otherwise, the data records are printed single spaced.
During ELIPS EDIT, when the edit profile specifies RECOVERY ON, the changes made to
the edit data between SAVES are automatically journaled by the editor in a recovery
backup data set.
Should the edit session end abnormally, then the edit session can be recovered upon
re-entering ELIPS.
When you enter ELIPS, the recovery table is automatically queried for pending entries. If
there is more than one pending entry (or the user deferred the recovery), then the
RECOVER command recovers the next entry, without having to exit ELIPS.
COMMAND ===>
*****************************************
*ELIPS EDIT FUNCTION: AUTOMATIC RECOVERY*
*****************************************
The following LIBRARIAN member was being edited by the ELIPS edit function
when the session was abnormally terminated:
LIBRARY: LIBR.BRANTON.TESTMAST
MEMBER: COBMOD
VERSION: 900424141752
STATUS: TEST
PASSWORD ===>
MCD ===>
Instructions:
Press ENTER key to continue editing the module, or
Enter END command to return to the ELIPS entry panel or selection list,
Enter DEFER command to defer recovery of the member, or
Enter CANCEL command to cancel recovery of member.
Enter TOP command to defer recovery of this member and redisplay
recoveries pending starting at the first one
The LIBRARY, MEMBER, VERSION and STATUS are non-modifiable fields that identify the
member at the current position in the recovery table. This is the edit session that is
recovered when you press ENTER. The PASSWORD field is for entering that information,
if required.
You can decide to recover the edit session, defer the recovery to a later time, or cancel
it altogether.
To rename a member from a LONG member selection list (or from a main panel), type R
in the function field next to a member, type the password (if necessary) in the password
field, and type the new name in the NEWNAME field.
You can rename any number of CA Librarian members on a LONG selection list at once.
In a SHORT or QUICK selection list, you must specify RENAME syntax on the command
line. Commands that need a NEWNAME specification, such as RENAME and COPY, must
be put entirely on the command line of the SHORT or QUICK member selection lists. You
cannot split a command between the list and the command line.
To rename a member from a selection list (using the command line), use the following
syntax:
RENAME memname [PSWD(pswd)] NEW(newname)
memname
Specifies the member to rename.
pswd
Specifies the password (if your site requires it).
newname
Specifies the new member name. Member names must not begin with an asterisk
(*) and must not contain spaces, slashes, parentheses, or commas. The product
converts lowercase letters to uppercase.
The following table is an alphabetical list of member types with their language codes,
the kind of data they ordinarily contain, and the location of CA Librarian sequence
numbers in their records. To be sure of the member types, language codes, and
sequence number defaults that your own site installed with ELIPS, you can issue the
TYpes command.
An asterisk in the sequence number field indicates that the location and length of the
sequence number for that member type defaults to the values assigned to the CA
Librarian library at initialization time.
Default
Member Land Code Contents of Data Set Sequence
Type Number Field
ASM ASM Assembler Statements 73 - 80
BASIC BAS BASIC Statements *
CLIST CMD TSO Commands *
CNTL JCL JCL and SYSIN for SUBMIT commands 73 - 80
COBOL COB ANS COBOL Statements 01 - 06
DATA DAT Uppercase Data 81 - 06
FORT FOR FORTRAN Statements 73 - 80
FORTGI FRG FORTRAN GI Statements 73 - 80
FORTH FRH FORTRAN H Statements 73 - 80
GIS GIS Generalized Information System (GIS) *
Routines
GOFORT GOF FORTRAN Code and Go Statments 73 - 80
MACRO MAC Macros 73 - 80
PL1 PL1 PL/1 Checkout or PL/1 Optimizing 73 - 80
Compiler Statements
RPG RPG Report Program Generator Statements 75 - 06
TEXT TXT Uppercase and Lowercase Text 81 - 06
VSBASIC VSB VSBASIC Statements *
Note: An asterisk in the sequence number field indicates that the location and length of
the sequence number for that member type defaults to the values assigned to the CA
Librarian library at initialization time.
For details on using the UTILITY Function, see the “ELIPS Utilities” chapter in this guide.
You can use VIEW mode to make changes to a member; then create a new member that
contains those changes. The member you accessed in VIEW mode is not updated when
you end the session.
The LIST is generated using the wildcard name, if supplied. Additionally, you can use the
PGMR and TYPE specification to further limit the LONG list on the ELIPS entry panel.
The selection lists let you enter a line selection or command line selection from the
ELIPS entry panel.
You can specify some functions by placing the first letter of the function name next to
the name of the member to process where it appears in the list. You can specify any
function on the command line if it follows syntax rules. Certain commands are for the
member selection list itself, to view the top or bottom of a list, to position the list to a
particular member, or to view an alternate version of the list as it might be installed at
your site.
These selection list commands, described in the following section, are as follows:
+1
(Default) selects the next alternate panel.
n
The absolute panel number. The number zero (0) represents the initial panel
for the selection list.
-n
.
Selects an alternate panel whose number is n less than that currently viewed
+n
Selects an alternate panel whose number is n greater than that currently
viewed or the maximum defined by your site, whichever is less.
T
The same as ALT 0 , that is, move to the top or initial selection list panel.
B
Moves to the last (highest number) selection list panel.
BOTTOM (BO)
Displays the last line of the list.
LOCATE (L)
In a LONG or SHORT format selection list, moves the display to the line containing
the member specified. If the name is not found, the line before the line where the
member would be shown if present displays as the first line. You only have to
specify the first part of a member name to position the display to the right
alphabetical location.
For an Archive Level selection list, position the display to the level specified.
LONG (LON)
The LONG command switches from the SHORT format selection list to the LONG
format selection list without returning to the ELIPS entry panel (or EDIT extended
MOVE/COPY panel).
REFRESH (REF)
Regenerates the selection list being viewed.
SHORT (SH)
The SHORT command switches from the LONG format selection list to the SHORT
format selection list without returning to the ELIPS entry panel (or EDIT extended
MOVE/COPY panel).
TOP (T)
Displays the first screenful of members in the list, for lists that take up more than
one screen.
To process a member on the LONG list, place the first character of the function you
want in front of the member name.
Shown is a line selection from the ELIPS LONG selection list. E (or S) selects member
CCFSCAN to edit. You can select multiple members at one time from the list and the
command line. The commands are processed first from the command line then the
selection list.
The ALT command changed the list to an alternate format and CCFSCAN is marked as
being EDITed and UPDATED. Member CC was selected to BROWSE and member
CCFSLATS was selected to PRINT. The ALT command is once again entered to change the
list to the second alternate format.
MEMBER PSWD VERSION DATE NEWNAME LEVEL RCDS SS LNG LVLS STAT
DESCRIPTION PROGRAMMER
------------------------------------------------------------------------------
CC 931121000000 *BROWSED 00002 N 73 8 DAT TEST
TEST DATA MEMBER BRADLEY
CCC 93032716160 00004 00B54 N 81 6 BAL 004 TEST
TEST PROGRAM BRADLEY
CCFSCAN 9301316102 *EDIT-U 00015 00001 N 81 6 BAL 016 TEST
SPECIAL LIBRSCAN PROGRAM BRADLEY
CCFSLATS 93041510418 *PRINTED 00002 00011 R 81 6 ASM 003 TEST
LIBRSCAN FMT SLATS/DO NOT MOD. BRADLEY
The last alternate display shows the three members that were accessed. The list
regenerates only when the END, LIST, SHORT or REFRESH commands are used.
You can select an archive level other than the current one by overtyping the date in the
UPDATED field with the date when the desired level was current. You can omit an even
number of characters from the right hand end of the new date specification. If you do,
CA Librarian assumes the highest possible values. See the Batch Command Reference
Guide for a complete discussion of specifying an archive level by date and time.
You can specify any command suitable for a selection list command line after
COMMAND. They can be the ELIPS functions described in the Command Syntax for ELIPS
Functions section in the “ELIPS Functions” chapter, the selection list commands
described in the Selection List Commands sections at the beginning of this chapter, or
the END command to return to the main panel.
A running total is kept for you of the number of members processed and updated in the
current session. The name of the CA Librarian library displayed on the selection list is
shown, as is the programmer name if one was specified, and any wildcard specification.
Then each member is listed, followed by a blank field for you to enter a password if your
site requires it for any processing.
If you need to find out the password, display the CONTROL INFORMATION screen by
specifying I in front of the member name.
The UPDATED field accesses a previous archive level of a listed member for any
appropriate function.
The SHORT format list lets you select any number of line selections and command line
selections at one time and processes them first from the command line, then the
selection list.
The list is regenerated only when END, LIST, LONG or REFRESH commands are used. A
selection from the SHORT list can access only the current level of each member. You can
make an archive level specification by entering the command on the command line. You
can specify any ELIPS function by entering the first letter of the function next to the
member name, except the COPY and RENAME functions, which require a NEWNAME
specification. You can enter these functions (and any of the others) on the command
line. See the section on command line syntax for details.
For access to back levels of a member, specify A next to the member name.
Note: Depending on site options chosen with respect to security and performance
considerations, the QUICK (Q) option for member selection list type might not be shown
on the main panel.
You can scroll the data in any direction (up, down, left or right) by a half or full page, or
by any number of lines (or columns) by means of the scroll commands.
You can use line commands directly on the affected lines to perform line-oriented
editing functions. For instance, you can enter D on a line to delete it or R to repeat it.
You can perform commands on several lines at the same time. Enter general primary
commands in the command field on line two of the display to edit operations.
For detailed instructions on the editor, enter HELP on the command line of the ELIPS
EDIT screen to view the tutorial.
During an EDIT session, you can copy or move data either out of or into the member you
are editing.
The ELIPS VIEW function is similar to the EDIT function for existing members. The
difference is that no updates take place for the member when you end the session. You
can use this functionality to make changes to the member; then create or replace a
member with the changes you made. The member you accessed in VIEW mode is not
updated with the changes.
■ INFO
■ NEWVERS
HIST Command
The ELIPS edit HIST command lets you display the HISTORY RECORDS for the member
currently edited.
The HISTORY RECORDS appear as NOTE lines at the top of the current display. These
lines are not part of the edit data. You can remove them using the RESET command.
level
Specifies is the archive level in date/time format (yymmddhhmmss) for which the
History Record display is to start. Specify a level only if you want to display the
history records for an archive level that is more recent than the level being edited.
INC Command
The ELIPS edit INC command lets you expand a specific CA Librarian -INC statement that
is contained in the edit data.
The included member’s records appear as NOTE lines. These lines are not part of the
edit data. You can remove them using the RESET command.
linenum
Required when the -INC statement is not the first line of the lines currently being
displayed or the cursor is not positioned to the line containing the -INC statement.
NEST
Expands nested -INC statements.
NESTL
Does not expand nested -INC statements. Additional NOTE lines identify the
position and member names of the nested -INC statements.
If you specify neither NEST nor NESTL, then nested -INC statements are not
expanded.
ARC(level)
The archive level date/time for included members in the format yymmddhhmmss.
INCALL Command
The ELIPS edit INCALL command lets you expand all CA Librarian -INC statements that
are contained in the edit data.
The included member’s records appear as NOTE lines. These lines are not part of the
edit data. You can remove them using the RESET command.
NEST
Expands nested -INC statements.
ARC(level)
Specifies the archive level date/time for included members in the form
yymmddhhmmss.
NESTL
Expands and identifies nested -INC statements.
Note:
■ If you do not specify NEST or NESTL, then nested -INC statements are not expanded.
■ If you do not specify the ARC option, the current level of included members display.
■ Included members must reside on the same library.
The ELIPS EDIT INFO command lets you display and modify the control information
for the member currently being edited. When the control information panel is
modified, the modifications are applied when the next update function is
performed (either through the END or SAVE command). See the section on the INFO
command for more details.
MENU Command
The ELIPS edit MENU command lets you END the EDIT function and return directly to
the ELIPS entry panel, skipping any selection lists.
NEWVERS Command
Specify ON or OFF. Valid only for archived members. The ELIPS edit NEWVERS command
allows the setting of the NEWVERS status.
The NEWVERS status indicates to ELIPS EDIT whether the SAVE command creates a new
version (archive level).
■ ON - Creates a new version for each SAVE issued during the edit session (provided
the SAVE detected changed data).
■ OFF - Creates only one version, regardless of how many SAVEs were issued during
the edit session. Use NEWVERS OFF when you want to SAVE data changes
frequently, but do not want to create multiple versions of the member during the
edit session.
The NEWVERS setting affects only the SAVE command, not the END command, and is
maintained from session to session until you change it.
Editor Commands
ELIPS also provides special features for the following editor commands.
■ COPY
■ CREATE
■ EDIT
■ END
■ JCLVAL
■ MOVE
■ PACK
■ REPLACE
■ SAVE
COPY Command
The ELIPS edit COPY command lets you copy a CA Librarian or PDS member, sequential
data set, or a subset thereof, into the edit data. Use the A (after) or B (before) line
commands or AFTER/BEFORE .label on the command line to specify where the data is
T
copied.
Important! Copying a large member into a smaller member can cause a B37 abend and
loss of the data changes made to the smaller member before the copy operation. To
prevent this loss of data, copy the larger member to a new member using ELIPS Utility.
Then copy the smaller member into the new member.
LINE NUMBERS (Blank for ALL lines or when “EXPAND INCLUDES” = YES)
FIRST LINE ===>
LAST LINE ===>
NUMBER TYPE ===> (R=RELATIVE, S=STD, C=COBOL, L=LIBRARIAN, D=DISPLAY
When the member name is not supplied, the extended copy panel displays. This panel
identifies another CA Librarian library, a partitioned data set member, or a sequential
data set. A CA Librarian library or PDS can be indicated in the PROJECT/GROUP/TYPE
fields.
MEMBER
The name of the member to copy. If you specify blank or a wildcard name, then a
selection list displays.
EXPAND INCLUDES
Can be specified as YES or NO. NO is the default. If you specify YES, any CA Librarian
-INC statements in the member being copied are expanded. When EXPAND
INCLUDES is YES, you cannot specify a FIRST and LAST line number.
DATA SET NAME
The data set name and member name can also be supplied in the OTHER field. Or,
the data set name can be supplied in the OTHER field and the member name in the
MEMBER field if any one of the PSWD, MCD or ARC LVL fields is supplied.
FIRST LINE and LAST LINE and NUMBER TYPE
When you want to copy a range of lines into the material you are editing, you can
specify a FIRST line number, a LAST line number, and a NUMBER TYPE. You cannot
use these fields when EXPAND INCLUDES is YES. The NUMBER TYPE can be
RELATIVE, STANDARD or COBOL for PDSs, CA Librarian sequence number field, or
DISPLAY.
When DISPLAY is selected as the NUMBER TYPE, the member where lines are copied
from displays. You can use the C line command or CC block copy line commands to
select a line or range of lines to copy.
Enter END after making the line selection to perform the copy. TOP, BOTTOM, CANCEL,
and FINDSEL commands are also supported. FINDSEL positions to the NEXT line selection
that you made.
For selection list generation, COPY also supports LONG, SHORT and QUICK lists. For
LONG selection lists, PROGRAMMER or wildcard PROGRAMMER name and TYPE is
supported.
CREATE Command
The ELIPS edit CREATE command lets you create a new CA Librarian member or
partitioned data set member from the edit data or subset thereof.
.strt
Starting label name.
.end
Ending label name. See EDIT LABELS and RANGES.
You can specify a partitioned data set or CA Librarian library either in the
PROJECT/GROUP/TYPE or OTHER field. If the member name is blank, the current
member name is used. When you specify EXPAND INCLUDES as YES, any CA Librarian
-INC statements are expanded from the CA Librarian library currently being edited as
the member is created. When you specify REPLACE SLAT VARS as YES, any CA Librarian
Source-Load Audit Trail variables contained in the data are replaced using the current
member information.
EDIT Command
When an EDIT command is active, you can invoke EDIT again as a subfunction.
EDIT [member]
member
Specifies is the name of the member to edit. This member must reside in the same
library that is used for the original EDIT session. When you do not specify a
member, the ELIPS entry panel displays letting you perform any ELIPS function.
When you specify a member, the EDIT panel displays. When EDIT is ended, the
previous edit panel redisplays.
END Command
The ELIPS edit END command ends the EDIT session.
■ If AUTOSAVE mode is ON, ELIPS SAVE is performed.
■ If AUTOSAVE mode is OFF with the PROMPT option, you are prompted to enter the
ELIPS SAVE or CANCEL command.
■ If AUTOSAVE mode is OFF with the NOPROMPT option, CANCEL is performed.
JCLVAL Command
Invokes the CA JCL validation product for a specified member.
MOVE Command
The ELIPS edit MOVE command moves a partitioned data set member or sequential data
set into the edit data. Move means that the data is copied and then the PDS member or
sequential data set is deleted.
Use the A (After) or B (Before) line commands to specify where to place the data in the
edit data or use AFTER/BEFORE .label on the command line.
To preserve the audit trail, MOVE is not supported from CA Librarian libraries.
The extended move panel displays allowing for the specification of the data set name. If
the data set is partitioned, a blank or WILDCARD member name displays a member
selection list. You can also specify the format for the list on the panel as L for long or S
for short.
REPLACE Command
The ELIPS edit REPLACE command lets you replace a CA Librarian member or partitioned
data set member or a sequential data set with all or part of the data from the current
edit session.
When you enter the REPLACE command without a member name, the extended replace
panel displays. You can specify a partitioned data set or CA Librarian library either in the
PROJECT/GROUP/TYPE or OTHER field. If the member name is blank, the current
member name is used. When you specify EXPAND INCLUDES as YES, any CA Librarian
-INC statements are expanded from the CA Librarian library currently being edited as
the member is replaced. When you specify REPLACE SLAT VARS as YES, any CA Librarian
Source-Load Audit Trail variables contained in the data are replaced with the current
member information.
SAVE Command
The ELIPS edit SAVE command immediately updates to the CA Librarian member that is
currently being edited, provided that changes were made to the data or control
information. The edit session remains active.
You can specify NOAUDIT as a parameter to the SAVE command, bypassing LIBAUDIT
Comparator processing and replacing all lines in the member with the lines in the edit
data, whether they were changed or not. Since the ten thousand record limit of the
Comparator was raised to one million records, you rarely need to specify the NOAUDIT
parameter.
ELIPS can display the CONTROL INFORMATION panel to prompt for any site required
data (PROGRAMMER, DESCRIPTION, HISTORY, and so on), unless you used the INFO
command to supply it before the SAVE.
SAVE observes the NEWVERS setting. When NEWVERS is ON, a new archive level is
created. When NEWVERS is OFF, a new archive level is created for the first SAVE, then
subsequent SAVEs replace that archive level. (Thus, only one archive level is produced
no matter how many SAVE commands are issued).
Note: Although you can enter the PACK command during ELIPS edit, the editor function
is disabled. CA Librarian automatically stores the data in the CA Librarian library in a
more efficient packed format.
A label is a character string that must begin with a period (.), followed by from one to
five alphabetic characters. No numeric or special characters are allowed. Labels starting
with .z are reserved for system use. Once assigned, the labels stay with the line, even if
the line is moved.
The label is assigned by typing the valid character string into the line command field of
the data line (the leftmost six columns of the edit data display).
000018 FILE-CONTROL.
.here SELECT CD-FILE ASSIGN TO SYS005-S-SYSIN.
000020 SELECT PRT-FILE ASSIGN TO SYS006-S-SYSPRINT.
.there DATA DIVISION.
000022 FILE SECTION.
You can assign labels only to data lines. You cannot assign them to special lines (=COLS>,
=MASK>, =TABS>, and so on).
Deleting Labels
You can remove a symbolic label from a data line by blanking out the label characters or
overtyping with a new label and pressing Enter. You can also unassign a label by deleting
the line containing that label or by using the RESET LABEL command.
Overtyping a label with a line command is acceptable and does not unassign the label.
The label reappears at the completion of the command and remains displayed in the
line command field.
You can move a label to another line by typing the same label on a new line. If you do
not take explicit action to unassign the label, the label remains assigned until you
terminate the edit.
System Labels
There are several special labels that the editor automatically assigns and maintains.
They all begin with the letter Z. Labels beginning with the letter Z are reserved for editor
use. You cannot assign them.
Unlike other labels, these system labels do not necessarily stay with the same line, but
instead represent logical positions on the display.
You can limit the range of lines certain edit commands process by entering a pair of
labels indicating the first and last lines to process, then naming those labels in the range
operand of the command. The specified command then processes whatever data is
contained in the designated (inclusive) range.
For example, the following command finds the first xxx in the range of lines from the
label .HERE to the end of the data.
COMMAND ===> find xxx .here .zl
The following command deletes all excluded lines in the range of lines from label .HERE
to label .THERE (inclusive).
COMMAND ===> del all x .here .there
The range operand consists of two labels separated by a blank or comma. A single label
is invalid. The labels can be any combination of system labels (.ZFIRST, .ZCSR, .ZLAST) or
user labels.
The label representing the smaller relative line number is used as the start of the range
and the label representing the larger relative line number is used as the end of the
range, regardless of the order you specified.
The range operand applies to the primary edit commands FIND, LOCATE, CREATE,
CHANGE, DELETE, REPLACE, EXCLUDE, SORT, RESET, and SUBMIT.
Control Information
You can enter the INFO command in the ELIPS edit function to display the CA Librarian
control information for the member being edited and to change the information that is
used when the member is updated. If PROGRAMMER, DESCRIPTION or HISTORY is
required, this screen displays when the member is updated and you are required to
enter the information.
Recovery
In case of abnormal termination of the EDIT session, recovery is the same as in ISPF.
When you resume the session, the recovery table is automatically queried for pending
entries. If RECOVERY is ON in your ISPF profile and you made changes to a member but
did not save the changes, ELIPS displays a screen offering a number of recovery options.
If there is more than one pending entry (or you deferred the recovery), you can use the
RECOVER command to recover the next entry without having to exit ELIPS. See the
section on the RECOVER function in the previous chapter for a description of this
function and also for an illustration of the ELIPS Recovery screen.
(The exception to this is if a specific archive level is specified. In that case, only that
archive level is copied.) Otherwise only the current level is copied. If the FROM file is a
CA Librarian library, the member control information is also copied. If a like-named
member already exists on the TO library, that member is updated. If such a member
does not exist, it is added.
The control information that is added or updated includes whatever is on the FROM
member, including programmer, description, language, and module type.
If the member is added to the TO file, the history records from the FROM member are
also copied. The date of the history records copied is the current date.
Note: The ELIPS Copy Utility does not function in the same way as the batch CA Librarian
Utility Copy; nor does it function the same way as the CA Librarian routine called
LIBRCOPY. The batch CA Librarian Utility Copy copies all archive levels of an archived
module, and completely replaces like-named modules existing on the destination
master file, unless specifically directed not to replace these modules. LIBRCOPY copies
only the current archive level of a module, and updates like-named existing modules on
the destination master file, instead of replacing them. For further information on batch
CA Librarian Utility Copy and the LIBRCOPY program, see the Systems Services Guide.
You can move members into a CA Librarian library from a PDS or sequential data set, but
MOVE is not allowed from a CA Librarian library. This restriction prevents the
un-intentional destruction of the CA Librarian audit trail.
SELECTION LIST:
FORMAT ===> (L/S/Q) PROGRAMMER ===>
MODULE TYPE ===> (OR /LAN)
If the FROM data set is partitioned or a CA Librarian library, enter a member name as
follows to:
■ Move or copy a single member, enter the member name.
■ Move or copy all members, enter * (asterisk).
■ Request a member selection list, leave member name blank or enter a wildcard
selection in the member name field.
To specify an ISPF library, enter the project, group, and type under the heading:
ISPF LIBRARY:
PROJECT ===>
GROUP ===>
TYPE ===>
MEMBER ===> (WC/Blank for member selection list)
Note: For convenience, you can enter any cataloged data set (LIBRARIAN, PDS or
sequential) with a three level name in this fashion.
You can also enter a member name. If you leave the member name blank, a member
selection list displays. You can make a wildcard member selection that results in a
subset of the member selection list.
You can enter any fully qualified data set name by enclosing it in apostrophes, for
example:
DATA SET NAME ===> 'sys1.maclib'
If you omit the apostrophes, your TSO prefix is left-appended to the data set name.
Whenever you enter a data set name in the Other field, it is used, even if you also enter
an ISPF library. You must specify the member name in the Other data set name field
unless either the PSWD, MCD or ARC LVL fields are filled in. In this case, you can use the
MEMBER field if the member name is not specified in the Other data set name.
A member name enclosed in parentheses can follow the data set name (in the
apostrophes, if they are present) for CA Librarian and partitioned data sets. If you enter
a CA Librarian or partitioned data set without a member name, a member selection list
displays. You can enter a member name of asterisk (*) to specify all members, for
example:
DATA SET NAME ===> 'sys1.maclib(_)'
You can also enter a wildcard selection as the member name that results in a subset of
the member selection list. Wildcard selection uses an asterisk (*) to mask characters in
the member name that are not checked for a match, for example:
DATA SET NAME ===> 'sys1.maclib(A_)'
This example would result in a member selection list of all member names having A as
the first character.
Note:
■ To access MSS (3850) virtual volumes that are not prestaged, you must have
MOUNT authority.
■ Non-CA Librarian multi-volume data sets are not supported.
■ Partitioned data sets with record format FBS or VBS are not supported.
■ Packing and unpacking of TSO data sets is not supported.
■ MOVE is only supported from a TSO data set.
■ REPLACE SLAT VARS is only supported to a TSO data set.
■ TSO data set to TSO data set MOVE/COPY is not supported. At least one of the files
must be a CA Librarian library.
If the FROM data set is a CA Librarian or PDS data set and the member name is left blank
or specified as a WILDCARD selection on the first panel, a member selection list displays
after the second move/copy panel is filled in.
You can scroll through the list using the scroll commands (UP and DOWN) or the LOCATE
command. You can select one or more members for processing by entering an S before
the name of each member. You can also rename members in the TO data set (if CA
Librarian or PDS) by entering a new name in the NEWNAME field on the long selection
list. If the CA Librarian password is required for the FROM library, you can enter it in the
PSWD field. If the CA Librarian password is required for the TO library, you can enter it
in the PSWD2 field. If you are selecting an archived level other than the current one
from the FROM CA Librarian library, you can overtype the UPDATED field to specify the
level as yymmddhhmmss, Ln, or -n.
Important! If you have unprocessed requests when END is entered, they are ignored.
Before proceeding, enter or verify the following options on the second move/copy
utility panel.
■ If the TO data set is partitioned or CA Librarian, then replace like-named members.
– Enter YES to allow the replacement or update of members in the data set,
depending on whether the Wide Record Conversion Utility Copy is being used.
See the section on the Wide Record Conversion Utility Copy for more details.
– Enter NO to prevent replacement of members in the data set.
■ If the TO data set is sequential, in “To” data set disposition:
– Enter OLD to overwrite existing data in the data set.
– Enter MOD to add to the end of the data set.
■ If the FROM data set is partitioned or sequential, in CA Librarian “number mode:”
– Enter OFF to use external numbers (81,6,10,10).
– Enter COB to use COBOL numbers (1,6,10,10).
– Enter STD to use standard numbers (73,8,10,10).
– Enter DEF to use the CA Librarian master file SEQ default.
■ If you choose COB or STD, use the existing numbers for ADDing a new member:
– Enter YES to use the existing sequence numbers.
– Enter NO to generate new sequence numbers.
Note: If you enter YES, be sure that the member has valid numbers in the field
referenced by the number mode. Otherwise, an error condition results.
Member Lists
If the FROM data set is a CA Librarian or PDS data set and the member name is left blank
or specified as a wildcard selection on the first panel, a member selection list displays
after the second move/copy panel is filled in.
You can scroll through the list using the scroll commands (UP and DOWN) or the LOCATE
command. You can select one or more members for processing by entering an S ahead
of the member names.
You can also rename members in the TO data set (if CA Librarian or PDS) by entering a
new name in the NEWNAME field of the long selection list.
■ If the CA Librarian password is required for the FROM library, you can enter it in the
PSWD field.
■ If the CA Librarian password is required for the TO library, you can enter it in the
PSWD2 field.
■ If an archived level other than current is selected from the FROM CA Librarian
library, you can overtype the UPDATED field to specify the level as
yymmddhhmmss, Ln, or -n.
Important! If you have unprocessed requests when END is entered, they are ignored.
The LOCATE command (which you can enter as LOC or L) scrolls to the member that you
specify. If the specified name is not in the list, the data is scrolled to the member name
that precedes the specified name (in alphabetic sequence).
The example that follows shows how to request a direct scroll to member FORA in the
selection list.
The example below shows how you could select members ADRIOT and BINARY02.
BINARY02 to BINARY03 are also renamed.
COMMAND ===>
NAME NEWNAME VV.MM CREATED LAST MODIFIED
s ADRIOT 01.03 02/11/01 02/10/02
BINARY01 01.06 02/11/01 02/11/03
s BINARY02 binary03 01.02 02/11/01 02/10/03
CALLLIB 01.03 02/11/01 02/09/02
COMMON1 01.20 02/11/01 02/11/02
■ The data to move or copy is not renumbered or modified in any way except that CA
Librarian -INCs can be expanded and SLAT (source load audit trail) variables can be
replaced per the panel 1 option.
■ ISPF library statistics that reflect the CA Librarian module control information are
created for the module when copying to a partitioned data set.
Note: ISPF services are invoked when the TO data set is a PDS, and results are
subject to limitations of these services.
■ When the FROM data set is CA Librarian, only the current archive level is copied
(except in the case in which the FROM data set is either BDAM or VSAM and the TO
data set is a wide record master file).
The characteristics of both data sets that participate in a move or copy operation must
be as follows:
■ Both data sets must exist and be cataloged. (The move/copy utility does not
automatically allocate space for a new TO data set.)
■ At least one data set must be an CA Librarian library, the other can be LIBRARIAN,
partitioned, or a DASD-resident sequential data set.
■ Non-CA Librarian data sets can be blocked or unblocked, but they must have a fixed
record format with a logical record length of 80 (with or without printer control
characters).
The Wide Record Conversion Utility Copy utilizes the same panels as the conventional
ELIPS Utility Copy, which can be selected by specifying one of the following options:
■ LU from the primary option menu
■ U from the CA Librarian selection menu
■ UT from the ELIPS entry panel
The functionality is transparent to the user. However, when either a BDAM or a VSAM
master file member is copied to a wide record master file, the results differ from those
of any other ELIPS Utility Copy scenario. These differences include the following:
■ Multiple archive levels are added or copied to the TO data set when the Wide
Record Conversion Utility is used. The exception to this is if a specific archive level is
specified. In that case, only that archive level is copied. Otherwise only the most
recent archive level is copied.
■ The added and last-updated dates and times are maintained across the copy when
the Wide Record Conversion Utility is used. Otherwise, the dates and times reflect
the date and time of the copy.
Once the FROM data set (the BDAM or VSAM master file) has been specified, you will be
prompted for the name of the TO data set (the wide record master file). Then you will
be prompted as to whether to replace like-named members:
■ Specifying NO does not attempt a copy if like-named members exist on the TO data
set. (This is the same for all ELIPS Utility Copy processing.)
■ Specifying YES causes the TO member to be updated with all archive levels of the
member in the FROM master file, if archiving is turned on for the TO master
file/member. (The exception to this is if a specific archive level is specified. In that
case, only that archive level is copied.) If archiving is turned off, the most recent
archive level in the TO master file is replaced by the most recent archive level in the
FROM master file.
Messages
The totals at time of interrupt/completion have the following meanings:
TOTAL MEMBERS MOVED/COPIED
The total processed prior to interrupt.
Note: Error messages identifying the member names are logged to the ISPF LOG data
set.
Invoking ELIPS
You can invoke ELIPS from a program or CLIST using ISPLINK or the ISPEXEC SELECT
service.
The PARM keyword and all ELIPS parameter keywords (EDREC, DSN, CMD, MACRO, MCD
and RETURN) are optional. If you omit the PARM keyword, the ELIPS main panel
displays.
Note: Unless the RETURN option is used, the return code only reflects the last function
performed.
The format of the SELECT service for invoking the utility follows:
■ REP or NOREP
■ IF SEQ, TO D/S DISPOSITION
■ OLD or MOD
■ IF FROM PDS/SEQ. LIBRARIAN NUMBER
■ OFF or COB or STD or DEF
The following is an example of invoking the utility from a CLIST through the ISPFEXEC
SELECT service:
8
A severe error occurred and the message ID exists in variable UTI@MSG (see the
next section).
UTIMAIN Variables
The message variable takes the form of UTI@MSG. The length is Length(8). This variable
contains the eight-byte ID of the utility message. You can find the short and long
associated message text in message library member UTI@0000. You can find this
variable in the function's profile pool.
The following variables are available during and after a copy all function. You can find
them in the function pool during an interrupt and in the profile pool when the mass
copy completes.
To maintain the ELIPS shared variable pool while invoking ELIPS from a CLIST, you can
front-end your CLIST with another CLIST that calls your CLIST. In doing so, the front-end
CLIST executes under the ISR APPLID. The called CLIST executes under the LIB@ APPLID,
which maintains the LIB@ variable pool. Similarly, a program can call another program
to maintain both variable pools.
For example, a front-end CLIST named CLIST1 can call CLIST2 as follows:
ISPEXEC CMD(CLIST2) APPL(LIB@) NEWPOOL
and CLIST2 can execute ELIPS and VGET variables from the LIB@ pool as follows:
ISPEXEC PGM(ELIPS)
ISPEXEC VGET(variable)
Once CLIST2 passes control back to CLIST1, CLIST1 has no access to the LIB@ shared
pool that CLIST2 and ELIPS used.
Note: On invocation of ELIPS, variable contents are updated in the ISPF function pool. If
a CLIST is invoked from within ELIPS edit which invokes ELIPS, the later invocation
overwrites the updates to the ISPF function pool variables which were made during the
prior invocation of ELIPS. Therefore, when the later ELIPS is exited, the prior ELIPS
retrieves invalid values from the ISPF function pool. This produces erroneous results.
Command Processors
The following table lists the command processors, their aliases, and their functions.
Note: Previous releases of the LIB/TSO interface included the LIBEDIT and LIBROWSE
functions. The ELIPS interface supersedes these functions. They are no longer provided
with the LIB/TSO interface.
A partitioned data set is divided into one or more members. A member name identifies
each member. They can be referenced separately. However, the block size and record
length must be the same for all members of a PDS. Any TSO data set, whether
partitioned or sequential, must be cataloged before you can use it for CA Librarian
processing.
Under the LIB/TSO system, the name of the CA Librarian master file consists of two
portions. The leftmost or high-order portion must have only one field, that of the
user-prefix qualifier or that of the site default name. The rightmost or low-order portion
can have one or more fields.
The fields of a typical master file name consist of one- to eight-alphanumeric or national
characters, beginning with an alphabetic or national character. The fields must be
separated by periods. The total length of the master file name must not exceed 44
characters, including periods.
Specify any master file name that adheres to these conventions through the SOURCE
option of the following commands:
■ LIBADD
■ LIBLIST
■ LIBDLM
■ LIBEXP
■ LIBGET
■ LIBINDEX
Important! If your master file name does not adhere to these conventions, then you
must specify it through the DSSOURCE option.
The fields must be separated by periods. The total length of the data set name must not
exceed 44 characters, including the periods. If all three fields are specified, the name is
referred to as a fully qualified data set name.
The user-prefix can be either the prefix the PROFILE command specified or the user ID.
Your site determines which. The user-prefix is the leftmost field of a fully qualified data
set name.
You must always specify the user-supplied name. However, depending on current
defaults and requirements, you can omit the user-prefix and descriptive-qualifiers when
referencing a TSO data set in a command, allowing LIB/ISPF-TSO to generate these
values. At times, you might have to specify a fully qualified name.
The descriptive-qualifier is the rightmost field of a fully qualified data set name. For
default name processing to work properly, the descriptive-qualifier of the TSO data set
must match the CA Librarian module type. This is either the TYPE option specified with
the command, the language code stored with the module as a result of the last LANG or
TYPE option specified, or the site module type default.
For partitioned data sets, the name of the member is enclosed in parentheses at the
end of the data set name. Member names can be up to eight characters long. The same
character restrictions that apply to sequential data set names apply to member names.
Member names are not counted in the 44 character length limit of the partitioned data
set name.
LIB/TSO Commands
LIB/TSO commands have the same syntax and data set naming conventions as other TSO
commands. A LIB/TSO command consists of a command name and possibly one or more
operands or options. The command performs the requested function. The operands
provide the specific information required to control command execution.
If required operands are not specified, the command prompts for them. Other options,
if not specified, default to preset values.
You can use commas or blanks as delimiters. The following sections use commas for
readability.
LIBADD
The LIBADD command adds a new module to a CA Librarian master file. The module
must exist as a cataloged sequential data set or as a member of a cataloged PDS.
{LIBADD}
{LIBA }
Required Operands
{module-name}
{pds-name(member)}
Options
module-name
Specifies the name to assign to the module you are adding to the master file. If you
specify a module name but do not use the TSODSN option to identify the data set to
add, the LIBADD command constructs the data set name for you, using the specified
module name as the user-supplied name and prefixing it with your user-prefix.
The descriptive-qualifier is derived from either the type option entry or the system
default. For example, if you enter LIBADD MYMOD,ASM, the resulting data set
name is user-prefix.MYMOD.ASM.
Note: You can let the command derive the name of the data set to add only if the
data set is a sequential data set whose name adheres to TSO naming conventions.
pds-name(member)
Use this operand when adding a member of a partitioned data set as a module.
Enter the user-supplied name of the PDS and the name of the member to add.
The LIBADD command constructs the full data set name by prefixing the
user-supplied name with your user-prefix and appending the specified type entry to
the name. If a type is not specified, the system default type is used. The member
name is used as the module name.
Note: You can only use this operand for partitioned data sets whose names adhere
to TSO naming conventions. When you are adding a member of a PDS whose name
deviates from TSO naming conventions (or when you want the module-name to be
different from the member name), you must use the module-name operand to
specify the name to apply to the module and identify the PDS and member through
the TSODSN option.
The following examples show typical applications for the LIBADD command.
Example 1
LIBADD COBMOD,ARC,PASSWORD(FLIP),COBOL
This command adds a module to the master file and assigns the name COBMOD to it.
The module exists as a sequential data set with the name user-prefix.COBMOD.COBOL.
The command activates the archiving facility for the module and assigns a password.
The specified type (COBOL) is translated into the equivalent three-character language
code (COB) and stored with the module.
Example 2
LIBADD COBMOD,COBOL,TSODSN(MODBB1.COBOL)
This example adds a module to the master file and assigns the name COBMOD to it. The
module exists as a sequential data set with the name user-prefix.MOD001.COBOL.
Example 3
LIBADD ASMCB1,TSODSN('E6B6.ASMAST1.ASM(ASMBB1)'),ARC,
DSSOURCE('E6B6.ASM.MASTER.FILE')
This command adds a module and assigns the name ASMC01 to it. The module exists as
a member, named ASM001, of a partitioned data set, named E606.ASMAST1.ASM.
LIBCTL
The LIBCTL command:
■ Lists all outstanding modules from previous LIBGET commands
■ Deletes an entry for an outstanding module from the TLICD and, optionally, the
associated data set or member, and
■ Lists all site defaults and requirements.
{LIBCTL}
{LIBC }
Options
[ GETVERS ]
[ ]
[ [DELETE ] [GENLIST ] [KEEPTSO ] [NOLIST] ]
[ [NODELETE] [NOGENLIST] [NOKEEPTSO] [LIST ] ]
[ ]
LIBDLM
The LIBDLM command deletes a module from a CA Librarian master file. If you issue a
LIBDLM command against an outstanding module, the module is deleted from the
master file, but the entry for the outstanding module remains on the TLICD and the data
set created as a result of the LIBGET remains untouched. Any subsequent attempt to
issue a LIBSAVE to return the data set as a module fails. To remove the TLICD entry for a
deleted outstanding module, you must issue an appropriate LIBCTL command.
{LIBDLM}
{LIBD }
Required
module-name
Options
[ GETVERS ]
[ ]
[ PASSWORD(password) ]
[ ]
[ [SOURCE(master-file-name) ] ]
[ [DSSOURCE{(dsn-of-master) }] ]
[ [ {('dsn-of-master')}] ]
[ ]
[ {TERMMSG} ]
[ {PERMMSG} ]
[ {TEMPMSG} ]
[ ]
module-name
Identifies the module to delete from a CA Librarian master file. You must specify a
module to delete. It must be the first operand entered.
LIBEXP
The LIBEXP command:
■ Returns a module to an CA Librarian master file that was retrieved through a LIBGET
command with the READONLY option specified.
■ Updates the control information of a module.
■ Updates a module without having to retrieve it from the master file through the
LIBGET command. If used in this way, you must create a data set containing an
updated version of the module and identify the data set in the LIBEXP command.
Note: Because the LIBEXP command bypasses the TLICD, potentially conflicting updates
are possible. To avoid this, management can choose to disable this command at your
site.
The LIBEXP command updates only one module at a time and assumes that the module
is on an CA Librarian master file.
{LIBEXP}
{LIBX }
Required Operands
{module-name }
{pds-name(member)}
Options
[ ]
[ VERS(mmdd[hhmm]) ]
module-name
Specifies the name of the module the LIBEXP command returns or updates.
If you specify the NOTSO option, LIBEXP assumes you are attempting to update the
module’s control information.
If you do not specify NOTSO, it assumes you are attempting to use the contents of a
data set or PDS member to update a module. If you specify a module name but do
not specify NOTSO and do not explicitly identify the data set to use to update the
module through the TSODSN option, the LIBEXP command constructs the name for
you. It does so by using the specified module name as the user-supplied name,
prefixing it with your user-prefix. The descriptive-qualifier is derived from the type
option entry, any language code stored with the module, or the system default. For
example, if you enter: user-prefix.MYMOD.ASM
Note: You can let the command derive the name of the data set to use to update
the module only if the data set is a sequential data set whose name adheres to TSO
naming conventions.
pds-name(member)
Use this operand if you are using a member of a partitioned data set to update a
module. Enter the user-supplied name of the PDS and the name of the member.
The LIBEXP command constructs the full data set name by prefixing the
user-supplied name with your user-prefix and appending the specified type entry to
the name. If you do not specify a type, the type stored with the module or the
system default type is used. The member name also identifies the module to
update.
Note: You can only use this operand for partitioned data sets whose names adhere
to TSO naming conventions. If you are using a member of a PDS whose name
deviates from TSO naming conventions or if the module-name is different from the
member name, you must use the module-name operand to specify the name of the
module and identify the PDS and member through the TSODSN option.
Example 1
LIBEXP FSRBB2,KEEPTSO,PASSWORD(FLAG)
In this example, the module FSR002 is updated using the contents of a TSO sequential
data set whose name adheres to TSO naming conventions and whose user supplied
name is also FSR002. The data set, user-prefix.FSR002.type, is retained after command
processing.
Example 2
LIBEXP USERMOD,ARC(-1),DESC('NEW USER MODULE'),HSTD,NOTSO,LIST
In this example, the current level of the archived module, USERMOD, is deleted and the
selected level is made the current level. All previous history records stored with the
module are deleted and a new description is provided. The LIST option writes a copy of
the module to the user-prefix.$$$$$$LX.LIST data set. Since this example is not updating
the data in the module, no TSO data set is referenced and the NOTSO option is
specified.
Example 3
LIBEXP USERMOD,TSODSN(MASTMOD)
The contents of the specified module, USERMOD, are replaced with the contents of the
data set user-prefix.MASTMOD identified through the TSODSN option. Since the data
set name is specified without enclosing quotes, the user-prefix is prefixed to the
specified name.
LIBGET
The LIBGET command copies a module from a CA Librarian master file into a data set or
PDS member. You can use an existing data set or member or allow the LIBGET command
to create one.
Modules retrieved from a master file through LIBGET are referred to as outstanding
modules. You must return outstanding modules to the master file through the LIBSAVE
command.
When a module is retrieved through LIBGET, an entry is made on The LIB/TSO Control
Directory (TLICD). The TLICD is a directory of all the modules that were copied from CA
Librarian master files into TSO data sets through the LIBGET command. When the
outstanding modules are returned through the LIBSAVE command to their respective CA
Librarian master files, their entries on the TLICD file are automatically deleted.
The number of module entries allowed per user on the TLICD file is determined at
installation. When the limit is reached, the user can either replace one entry by another,
without updating the module the entry references or free an entry by terminating the
LIBGET command and returning a module to the master file through the LIBSAVE
command.
When you specify the READONLY option, the module is copied into a TSO data set, but
no entry is made on the TLICD file.
{LIBGET}
{LIBG }
Required Operands
{module-name}
{pds-name(member)}
Options
[ GETVERS ]
[ ]
[ ARC[(date)] ARCINC[(date)] ]
[ [(Lx) ] [(Lx) ] ]
[ [(-y) ] [(-y) ] ]
[ ]
[ [INCLUDE{(RESEQ) } ] ]
[ [ {(NORESEQ)} ] ]
[ [NOINCLUDE ] ]
[ [INCASIS ] ]
[ ]
[ PASSWORD(password) ]
[ ]
[ READONLY ]
[ ]
[ [SOURCE(master-file-name) ] ]
[ [DSSOURCE{(dsn-of-master) }] ]
[ [ {('dsn-of-master')}] ]
[ ]
[ [TSODSN{(data-set-name) }] ]
[ [ {('data-set-name') }] ]
[ [ {(pds-name(member)) }] ]
[ [ {('pds-name(member)')}] ]
[ ]
[ TSOSIZE(nnnnnn) type ]
[ ]
[ VERS(mmdd[hhmm]) [VAR ] ]
[ [NOVAR] ]
module-name
Identifies the name of the module to retrieve from the CA Librarian master file.
If you do not identify the data set where the module is copied through the TSODSN
option, the LIBGET command constructs the name for you. It uses the specified
module name as the user-supplied name, prefixing it with your user-prefix.
The descriptive qualifier is derived from either the type entry specified on the
command, any language code stored with the module, or the system default. For
example:
LIBGET MYMOD ASM
Copies the module into a data set with the following name:
user-prefix.MYMOD.ASM
pds-name(member)
Identifies the module to retrieve from CA Librarian master file and copy to a TSO
partitioned data set member. If you enter the user-supplied name of the PDS and
the name of the member to use, the LIBGET command constructs the full data set
name by prefixing the user-supplied name with your user-prefix and appending the
specified type entry to the name.
If you do not specify a type, the language code stored with the module is converted
into the equivalent type and is used. If there is no language code or it is not
recognizable to /lib, the system default type is used. The member name is used as
the module name.
Note: You can only use this option for partitioned data sets whose names adhere to
TSO naming conventions. If you are using a member of a PDS whose name deviates
from TSO naming conventions (or if the module-name is different from the member
name), you must use the module-name operand to identify the module and you
must use the TSODSN option to identify the PDS and member name.
The following examples show some typical uses of the LIBGET command.
Example 1
LIBGET ASMMAST(PAROUTB1),INCLUDE(RESEQ),ASM
In this example, the contents of a module named PAROUT01 are retrieved and copied
into a member of a partitioned data set named user-prefix.ASMMAST.ASM. The
member name is the same as the module name. Any -INC statements in the module are
expanded and the included module is resequenced to make it consistent with the
including module. The type entry, ASM, constructs the data set name. ASM indicates to
the LIBGET command how to generate comment statements in correct language format
for the included modules. You can omit the type option if the language code is ASM or,
in the absence of a language code, the default type is ASM.
Example 2
LIBGET EJCLB11,PASSWORD(MSJK),READONLY,CNTL,INCLUDE(RESEQ)
TSODSN(JCLMAST(EFILE))
The module specified in this example, EJCL011, is copied into a member of a partitioned
data set named user-prefix.JCLMAST.CNTL. The member is named EFILE. You must use
the TSODSN option since the member name does not match the module name. Since
the READONLY option is specified, an entry is not made on the TLICD and you do not
have to return this module to the master file through a subsequent LIBSAVE. The type
option entry, CNTL, identifies this module as a JCL module. Any generated comments
identifying included modules are formatted accordingly.
Example 3
LIBGET RTASKAA,DSSOURCE('COB.MASTER'),TSODSN('RTASKAA.RPG')
This command retrieves a module name RTASKAA from a master file named
COB.MASTER and places it in a sequential data set named RTASKAA.RPG. The master file
is identified through the DSSOURCE option because it is not the site default master file.
The data set RTASKAA.RPG is identified through the TSODSN option because it does not
have a user-prefix qualifier. If the command specified only the module name, CA
Librarian would prefix the module name with the user-prefix of the individual who
issued the command. However, by identifying the data set through the TSODSN option
and enclosing the name in single quotes, you force CA Librarian to search for or
generate a data set of that exact name.
LIBINDEX
The LIBINDEX command lists an index of all the modules on a CA Librarian master file or
lists an index of all the modules associated with a particular programmer name on the
file. The LIBINDEX command has one required operand and a number of options, which
you can specify in any order.
Displayed information at the terminal has two formats: a long one and a short one.
The short form describes each module in a single line. The long form adds a second line
of description, depending on the required operand selected.
{LIBINDEX}
{LIBI }
Required Operands
{* }
{programmer-name}
Options
[ GETVERS ]
[ ]
[ ]
[[SHORT] [TERMMSG] ]
[[LONG ] [PERMMSG] ]
[[LONGT] [TEMPMSG] ]
[ ]
[[SOURCE(master-file-name) ] ]
[[DSSOURCE{(dsn-of-master) }] ]
[[ {('dsn-of-master')}] ]
*
(Asterisk) Indexes all the modules on a CA Librarian master file.
programmer-name
Specifies the name of the programmer whose modules are to be indexed. The name
can contain up to 15 characters and must correspond to the name supplied in the
PGMR field for the modules on the master file. You must specify * or
programmer-name.
LIBLIST
The LIBLIST command displays the contents of a selected module on the terminal
screen. The listing includes module control information and module records. You can
also display any history records associated with the module.
{LIBLIST}
{LIBL }
Required Operands
{module-name }
{pds-name(member)}
Options
[ GETVERS ]
[ ]
[ ARC[(date)] [ARCINDEX ] ]
[ [(Lx) ] [NOARCINDEX] ]
[ [(-y) ] ]
[ ]
module-name
Identifies the module on a CA Librarian master file to display.
LIBSAVE
The LIBSAVE command returns a module that was copied through the LIBGET command
to the CA Librarian master file. The LIBSAVE command updates only one module at a
time and assumes that the module is on an CA Librarian master file.
If you have more than one outstanding module when you issue the LIBSAVE, CA
Librarian prompts you for the name of the module to save.
{LIBSAVE}
{LIBS }
Options
[ GETVERS CLEARID ]
[ ]
[ NEWPSWD(password) HSTD ]
[ ]
[ ]
[ [ARC[(date)]] ]
[ [ [(Lx) ]] ]
[ [ [(-y) ]] ]
[ [NOARC ] ]
[ [ARCOFF ] ]
[ [ARCLR(date)] ]
[ ]
[ NOCHK NOAUDIT ]
[ ]
[ DESC('module-description') ]
[ ]
[ HIST('history-information') ]
[ ]
[ [KEEPTSO ] LANG(lan) ]
[ [NOKEEPTSO] ]
[ ]
[ [LIST ] ]
[ [NOLIST] ]
[ ]
[ PASSWORD(password) ]
[ ]
[ PGMR(programmer-name) ]
[ ]
[ [RESEQ ] [SEQ(s,l,i,v) ] ]
[ [NORESEQ] ]
[ ]
[ [RENAME(module-name)] ]
[ [COPY(module-name) ] ]
[ ]
[ [CHKINC ] ]
[ [NOCHKINC] ]
[ ]
[ [TERMMSG] ]
[ [PERMMSG] ]
[ [TEMPMSG] ]
[ TSOSIZE(nnnnnn) ]
[ ]
[ VERS(mmdd[hhmm]) ]
Example 1
LIBSAVE ARCLR(95B1),HSTD,HIST('NEW PROD MOD'),RESEQ,
NEWPSWD(FLIP),PASS(FLOP)
This example returns an outstanding module to the master file and clears all archiving
levels created before the one current on January 31, 1995. This command also deletes
all previous history records, adds a new one, and generates a new password.
Example 2
LIBSAVE COPY(COBBB2),DESC('COPY OF COBBB1')
Since the COPY option is specified, CA Librarian does not update the outstanding
module returned, but instead generates a copy with the specified name, in this case
COB002. Any changes made to the module are reflected in the copy and not in the
original. The description is stored with the new copy of the module only.
LIB/TSO Options
This section lists and describes the LIB/TSO options.
ARC
Command: LIBADD.
Specifying ARC without date or level number on a LIBADD command adds the
module to the master file as an archived module. Specifying ARC in this way on a
LIBEXP or LIBSAVE command creates the module as an archived module from that
execution forward.
If the master file was not initialized to accept archived modules, the add or update
is rejected. If you omit the ARC option from the LIBADD command, the module is
added as a standard (non-archived) CA Librarian module.
ARC[(date)|(Lx)|(-y)]
Commands:
■ LIBEXP
■ LIBGET
■ LIBLIST
■ LIBSAVE
ARC with a date, date and time, relative level number, or absolute level number
selects a specific level of a module for processing.
If you omit the ARC option from x and y and the module is archived, the most
recent level is selected for processing.
Updates (LIBSAVE, LIBEXP) with the ARC option used in this way applies to the
specified level. Any existing levels created after the specified level are deleted. The
updated level becomes the new current level.
ARC(date)
Selects a specific level by the date. The level that was current on the specified
date is updated. The format of the date is:
yymmddhhmmss
You can omit an even number of digits from the right. CA Librarian assumes the
highest possible values for omitted digits.
For example, if you specify ARC(95), CA Librarian selects the level that was
current at the end of the year on 12/31/95 at 23:59:59, and not at the
beginning of the year on 01/01/95 at 00:00:00.
ARC(Lx)
Specifies the absolute level, as reported on the module listing. You can specify
the absolute level up to five digits. The level number must be prefixed with the
letter L.
ARC(-y)
Specifies the relative level number. The level number can be specified up to
three digits. The relative level number must be prefixed with a minus sign (-).
Relative Archiving Level is as follows:
■ Current Level -0
■ One Level Older -1
■ Two Levels Older -2
■ n Levels Older -n
ARCOFF
Commands:LIBEXP
■ LIBSAVE
ARCOFF terminates archiving of a module and deletes all levels except the current
level. The module becomes a standard CA Librarian module. Once specified,
ARCOFF remains in effect until ARC is specified at another time.
NOARC
Commands:
■ LIBEXP
■ LIBSAVE
NOARC suspends the archiving of a module. When the module is updated while
NOARC is in effect, the level selected for updating is replaced, more recently
created levels (if any) are deleted, and older levels (if any) are maintained. Once
specified, NOARC remains in effect for the module until ARC or ARCOFF is specified.
ARCLR
Commands:
■ LIBEXP
■ LIBSAVE
ARCLR deletes every level of an archived module up to, but not including, the level
that was current on the date that you specify. Archiving continues for updates
made after an ARCLR operation. The full form of the date is:
yymmddhhmmss
You can omit an even number of digits from the right.CA Librarian assumes the
highest possible value for the omitted digits. For example, if you specify ARCLR(95),
all levels created before the level that was current on the last day of 1995 are
deleted.
ARCINC{(date)|(Lx)|(-y)}
Command: LIBGET.
Provides an archiving level selection for all included modules. If you specify this
option, every archived module included is expanded using the specified level. If you
do not specify this option, the most recent level of any included archived module is
selected. This option is ignored for any included module that has an archiving level
selection on the -INC statement.
ARCINC(date)
Specifies date (or date and time) when the level was current. The full form of
the date is:
yymmddhhmmss
You can omit an even number of digits from the right, but, if you do, CA
Librarian assumes the highest possible values for those digits.
For example, if you specify ARCINC(95), CA Librarian selects the level that was
current at the end of the year on 12/31/95 at 23:59:59, and not at the
beginning of the year on 01/01/95 at 00:00:00.
ARCINC(Lx)
Specifies the absolute level, as reported on the module listing. You can specify
the absolute level up to five digits. The level number must be prefixed with the
letter L.
ARCINC(-y)
Specifies the relative level number. You can specify the level number up to
three digits. The relative level number must be prefixed with a minus sign (-).
The Relative Archiving Level is as follows:
■ Current Level -B
■ One Level Older -1
■ Two Levels Older -2
■ ...
■ n Levels Older -n
[ARCINDEX|NOARCINDEX]
Command: LIBLIST
ARCINDEX gives an index of all archiving levels of the module. Information for each
level includes the absolute level number, the relative level number, language,
programmer name, and the date and time created.
[CHKINC|NOCHKINC]
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
If you specify CHKINC, the LIBADD, LIBEXP, or LIBSAVE command searches for any
comment statements identifying unexpanded -INC statements or included records.
These comment statements might exist if the data set was retrieved from a master
file through the LIBGET command or is a copy of another module that was originally
retrieved through LIBGET. Any located comments are replaced with the appropriate
-INC statement and any included records are deleted.
You can specify CHKINC, both to restore -INC statements and to prevent included
records and the comment statements from being added to the master file. If you
specify NOCHKINC, the search for comment statements is not initiated and any
comment statements and included records remain in the module. Also, comments
that identify unexpanded -INC statements are not converted back to the
appropriate -INC statement.
If there are no included records or unexpanded -INC statements in the data set,
specify NOCHKINC to save execution time.
This option is ignored when you specify NOTSO.
CLEARID
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
Clears columns 73 through 80 (sequence numbers) of data records added to the
master file to blanks. CLEARID does not affect records beginning with a slash (/).
This option can reduce the amount of space required to store a module.
[DELETE|NODELETE]
Command: LIBCTL.
Deletes the module entry on the TLICD file and the corresponding TSO data set or
PDS member. All outstanding modules are listed. You are prompted for any
information needed. You can delete only one entry per command execution.
A single outstanding module on the TLICD file is deleted without the prompting
message.
If a TLICD entry or the TSO data set is deleted, you cannot later update the module
the entry references through the LIBSAVE command.
DESC('module-description')
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
Provides a description of the module. The description can be 1 to 30 characters in
length and must be enclosed in single quotes. If a module description is required for
LIBADD but is not supplied, then LIBADD prompts for one. Quote marks are not
needed when replying to a prompting message.
DSSOURCE[(master-file-name|('dsn-of-master')(dsn-of-master)]
Commands:
■ LIBADD
■ LIBDLM
■ LIBEXP
■ LIBGET
■ LIBINDEX
■ LIBLIST
Identifies the master file the LIBLIST operation uses. If omitted, the site default
master file is used. DSSOURCE('dsn-of-master') specifies the full data set name of a
master file. If the data set name is not enclosed by single quotes, the name is
prefixed with your user-prefix.
[GENLIST|NOGENLIST]
Command: LIBCTL.
Lists all the installation defaults and requirements for LIB/TSO.
GETVERS
Commands:
■ LIBADD
■ LIBCTL
■ LIBDLM
■ LIBEXP
■ LIBGET
■ LIBINDEX
■ LIBLIST
■ LIBSAVE
GETVERS is a special option that you can specify with any command to display a
message indicating the CA Librarian release number of the version of that command
that is installed in your system. GETVERS can be the only optional option specified.
You can specify a dummy module-name as seen below. Any other options specified
are ignored.
LIBADD X,GETVERS
[INCLUDE|NOINCLUDE]
Command: LIBLIST.
INCLUDE expands all the -INC statements in the module. NOINCLUDE is the default.
When expanding an -INC statement, the -INC statement itself is replaced with the
included records. The sequence numbers of included records are listed as retrieved
from the included module.
INCLUDE[(RESEQ)|(NORESEQ)]
NOINCLUDE
INCASIS
Command: LIBGET.
These options control the expansion of -INC statements and the sequencing of the
records when a module is copied into a TSO data set. If not specified, the site
default, usually NOINCLUDE, is assumed.
A module stored on a master file can contain CA Librarian embedded -INC
statements that have the format:
-INC module-name[,options]
The module type determines the format of the comment statement (the comment
indicator and starting column). The type is derived from the type option specified
on the command, the language code stored with the module, or the site default, in
that order.
■ INCLUDE(RESEQ) reassigns, to records in the included modules, sequence
numbers consistent with those specified for the module obtained by the
LIBGET command. The sequence numbers of the module the LIBGET command
retrieved can be resequenced to prevent duplicate sequence numbers.
■ INCLUDE(NORESEQ) keeps the same sequence numbers that were assigned to
the included records in the module from which they came. As a result of
nonresequencing of included records, the records of the data set can be out of
sequence. Use the NONUM mode when editing this data set.
■ NOINCLUDE suppresses the expansion of the -INC statements in the CA
Librarian module when the LIBGET command retrieves it. Each -INC statement
is marked as unexpanded on the statement and is reformatted as a comment
statement.
If you specify INCASIS, the module is copied to the data set completely unchanged.
All -INC statements are copied exactly as they exist in the module without
expansion and without identifying comment records.
Note the following:
■ You can add -INC statements to a TSO data set using TSO editing facilities.
Because the mnemonic (-INC) must be placed in columns 1 through 4, you
should edit COBOL or any other data set types with sequence numbers in these
columns in NONUM mode to avoid conflict with the sequence number field.
■ Sequence numbers for the -INC statements must appear in columns 73 through
80 if the SEQCHK option is used.
■ Up to 64 levels of nesting of -INC statements is permitted.
■ Invalid -INC statements are not expanded, are marked as such when
reformatted as a comment statement, and error messages are written to the
terminal.
■ Do not make any changes to the CA Librarian generated comment statements
that mark -INC statements.
[INFO|NOINFO]
Command: LIBLIST.
Lists or does not list all module control information including module name,
number of records in the module, level number (if archived), password, language,
programmer-name, description, date module added to the master file, date and
time module last updated, sequence number option (s,l,i,v), status, date the
module last copied from another master file through the -OPT UTILITY, the number
of updates, and the COBOL syntax checker option (if specified).
[KEEPTSO|NOKEEPTSO]
Commands:
■ LIBADD
■ LIBCTL
■ LIBEXP
■ LIBSAVE
These options determine the disposition of the TSO data set after successful
completion of processing.
KEEPTSO retains the originating TSO data set or member. If you specify NOKEEPTSO
and the TSO data set is sequential, the data set is deleted and uncataloged. If the
TSO data set is a PDS member, the member is deleted. If the command (LIBADD,
LIBCTL) fails, the TSO data set or member is kept.
For LIBCTL, KEEPTSO prevents the TSO data set from being deleted when the
DELETE option is specified.
LANG(lan)
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
The value of lan is the one- to three-character language code identifying the
language or contents of the module. The specfied language code is stored with the
module (through a -LANG record). The entry can be one of the language codes or a
user-defined value.
Note: This option is only used to change the language code of the module. Refer to
the type option for other aspects of the CA Librarian language code.
[LIST|NOLIST]
Commands:
■ LIBADD
■ LIBCTL
■ LIBEXP
■ LIBSAVE
If you specify LIST and the module is successfully updated, batch CA Librarian writes
the module update listing to a data set called user-prefix.$$$$$$LS.LIST. You can
only save this information, which contains all updated records and control
information, by printing or renaming the data set because the updated records and
control information from the next execution overlay the current contents of
user-prefix.$$$$$$LS.LIST.
If you specify NOLIST, then the module listing is suppressed.
In certain instances, the SYNCHK option can invokee the LIST option even if you
specify NOLIST or it is the default.
If neither is specified, then LIST or NOLIST is selected according to the site default.
For LIBCTL, LIST (the default) lists all outstanding module information from previous
LIBGET command executions, including:
■ Module name.
■ Time the module was copied through the LIBGET command.
■ Master file name.
■ Data set name and the member name, if partitioned.
■ Absolute archiving level number if an archived module.
■ Date and time the module was last updated, if not an archived module, or the
date and time the selected archiving level was created.
[LIST[(s,e)]|NOLIST]
Command: LIBLIST.
LIST displays only the data records of the module. LIST(s,e) displays a range of
records, where:
■ s is the starting sequence number; it can be one to eight digits in length.
■ e is the ending sequence number; it can be one to eight digits.
■ NOLIST suppresses the displaying of data records and is the default.
NEWPSWD(password)
Commands:
■ LIBEXP
■ LIBSAVE
Specifies a new four-character, alphanumeric password. See the PASSWORD option
for a description of the restrictions on passwords.
NOAUDIT
Commands:
■ LIBEXP
■ LIBSAVE
Suppresses CA Librarian Auditing Facility (LIBAUDIT) processing. Specify this option
only if LIBAUDIT is installed and there are more than 10,000 records either in the
TSO data set or in the CA Librarian module you are updating.
Note: Take great care when using this option. NOAUDIT updates all the records of a
module, not just the changed records. This is important with archived modules
because NOAUDIT forces the archiving facility to retain an additional copy of every
record in the module, changed or not.
NOCHK
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
Suppresses COBOL syntax checking for the module being added. Specify this option
only if you specified the SYNCHK option but you do not want to have the syntax
checker process the module during the add. The values specified on the SYNCHK
option are retained and applied to subsequent updates of the module.
NOTSO
Command: LIBEXP.
Specify this option if you are updating only the control information of a module and
are not referencing a TSO data set.
Note: A new level is generated for archived modules even if only the module's
control information is updated.
PASSWORD(pswd)
Command: LIBADD.
When you add a module, you can use this option to assign a four-character,
alphanumeric password to the module. If you omit this option, the CA Librarian
generates a four-character password, all consonants, for the module.
If you specify this option, you can assign as a password any four-character
alphanumeric string (no special characters) except for the following CA Librarian
reserved words: BYPP, EXEC, FULL, LIST, NONE, NOPC, NOPR, PERM, TEMP, and
TEST.
Commands:
■ LIBDLM
■ LIBEXP
■ LIBGET
■ LIBSAVE
For these commands, use the PASSWORD option to specify the four-character,
alphanumeric password currently assigned to the module. The master file or your
site can require password. If it is required but not supplied, you are prompted for a
correct password.
To assign a new password to an existing module, see the NEWPSWD option.
PGMR(programmer-name)
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
Specifies the name of the programmer responsible for the module. The name can
be 1 to 15 characters long and must not contain blanks or commas. Your site can
require PGMR.
If PGMR is not specified but is required, LIBADD and LIBEXP prompt for a
programmer name. If it is not specified and not required, LIBADD uses the
user-prefix as the programmer name. LIBEXP defaults to your user-prefix as the
programmer name in that case, unless the module already has a PGMR field.
READONLY
Command: LIBGET.
When you specify this option, no entry is made on the TLICD file. The module is
simply retrieved and copied into a TSO data set.
{RENAME|COPY}(module-name)
Commands:
■ LIBEXP
■ LIBSAVE
RENAME renames the CA Librarian module when the module is returned to the
master file.
COPY creates a copy of the selected module and gives it the new module name.
Note: If you are updating the module while at the same time making a copy, the
changes are applied only to the copy; the original remains unchanged.
RENAME and COPY are mutually exclusive.
{RESEQ|NORESEQ}
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
These options specify a module's RESEQ/NORESEQ attribute. The specified value
has no effect on sequence numbers during LIBADD, although the RESEQ/NORESEQ
attribute specified for LIBADD is active during all updates to the module. For
information on sequence number formats, refer to the SEQ and SEQCHK options.
RESEQ renumbers the records of the module if any records are inserted or deleted.
The renumbering is based on the sequence number attributes established through
the SEQ or SEQCHK options.
If the module is not resequenced (NORESEQ), CA Librarian does not renumber the
module’s records. It assigns sequence numbers to the inserted data records,
beginning with one greater than the sequence number of the record after which
the new records are inserted, and incrementing by one. When necessary, the
sequence numbers of existing records are also incremented to prevent duplicate
sequence numbers.
Note: Standard modules can have their RESEQ/NORESEQ attribute changed.
Archived modules must keep the attribute specified for them when they were
added.
{SEQ(s,l,i,v)|SEQCHK(s,l,i,v)}
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
These options control the location, length, initial value, and increment of sequence
numbers assigned to the module.
SEQ assigns sequence numbers to the module records based on the specified
values.
SEQCHK does not assign sequence numbers to the data records, but rather verifies
that sequence numbers are present in the specified columns and are in ascending
numeric order. If an error is detected in the sequencing of the records, the module
is not processed and an error message is written on the CA Librarian update
message file.
The attributes specified through either option are used if the numbers are
resequenced in subsequent updates. SEQ and SEQCHK are mutually exclusive.
The variables for SEQ and SEQCHK are:
s
The column where the sequence number starts. Acceptable values for SEQ are
1 to 81 and for SEQCHK 1 to 80. If you specify 81, the sequence number
associated with each record is stored outside the record; all 80 bytes of the
record are then available for data. Since SEQCHK cannot scan for sequence
numbers outside of the record, you cannot specify 81 as the starting column
for SEQCHK.
l
The length of the sequence number field. Acceptable values are 1 to 9. If you
specify a starting column number of 81, you must specify a length of 6. If you
do not specify the starting column number 81, the sum of the starting column
and the length must not exceed 81.
i
The increment. Acceptable values are 1 through 9999.
v
The sequence number to assign to the first record of the module during
addition of the module or during sequenced updating. Acceptable values are 0
through 9999.
When you do not specify SEQ or SEQCHK, the master file's default sequence
parameters are used.
If you specify both SEQCHK and NORESEQ, the increment and starting values are
not used while the module is added, but are retained to control the generation of
sequence numbers during subsequent updates.
Note the following:
■ With LIBEXP, SEQCHK is ignored if the LIBAUDIT facility is in use.
■ If SEQ alters the length or location of the sequence number field, LIBAUDIT can
be rendered useless for determining which records of the module were
updated. Although LIBAUDIT ignores the value in the sequence number field, it
views a record with a sequence number field that is different in length or
location as updated, even if no other changes are made. If these values are
changed, LIBAUDIT views every record as updated.
[SHIFT|NOSHIFT]
Command: LIBLIST.
If the sequence number ends in column 80 on a data record, SHIFT displays the
sequence number in the leftmost position of a terminal line, and the rest of the
data record displays one space past the sequence number. When displaying the
sequence number, the first three leading zeros are suppressed. NOSHIFT displays
the data records as retrieved from the module. SHIFT is the default.
[SHORT|LONG|LONGT]
Command: LIBINDEX.
Determines the format used for indexing the modules on the master file. Both
SHORT and LONGT format can display at the terminal.
The SHORT format lists the module name, password, module description, date
added, date and time last updated, number of records, module source language,
and module status.
The LONG format, when selected with *, lists all information included in the short
format and the programmer name, the number of accesses, number of updates,
number of blocks, date last accessed, sequence number position and increment,
number of archived levels, and current archived level number.
The LONGT format, when selected with programmer-name, lists all information
included in the short format and Job Control Language procedures and sequence
number positions and increments.
Batch CA Librarian is invoked when you specify the LONG format. Supplying
programmer-name produces the Programmer Index listing. Supplying the *
produces the Management Index listing.
If you specify LONG, the information gathered is written into a permanent data set,
user-prefix.$$$$$$LI.INDEX. You can only save the information by printing or
renaming the data set because the information from the next execution overlays
the current contents of user-prefix.$$$$$$LI.INDEX.
If you specify LONGT, the information displays only on the terminal and is not
written to the permanent data set.
Note: If you specify the SHORT option of LIBINDEX or it is assumed, the TERMMSG
option is ignored and no Update Report is produced.
SOURCE(master-file-name)
Commands:
■ LIBADD
■ LIBDLM
■ LIBEXP
■ LIBGET
■ LIBINDEX
■ LIBLIST
Identifies the master file the LIBLIST operation uses. If omitted, the site default
master file is used.
SOURCE(master-file-name) specifies the low-order portion of the name of a master
file. The high-order portion or prefix assumes the site default.
SYNCHK(l,a)
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
CA Librarian verifies that the records of a module consist of syntactically valid
COBOL statements. The syntax checker scans each record of the module and
verifies that sentence structure, punctuation, and the use of reserved words
conform to COBOL rules. The validity of data or procedure references is not
checked.
The SYNCHK variables are:
l
Identifies the COBOL syntax level to apply. Specify one of the following:
■ CA for ANS COBOL
■ CD for COBOL D
■ CE for COBOL E
■ CF for COBOL F
■ CW for OS/VS2 COBOL (ANS COBOL 74)
a
Designates the action to take. Specify one of the following:
S
Suppresses writing of the module to the compilation file in the event of a
syntax error. The LIST option is automatically invoked for the module. The
module is still updated.
C
In the event of a syntax error, writing of the module to the compilation file is
not suppressed nor is the LIST option invoked. The module is still updated.
SE
Functions the same as S. In addition, it expands the COBOL COPY verb for disk
master files (for batch executions).
CE
Functions the same as C. In addition, it expands the COBOL COPY verb for disk
master files (for batch executions).
Note: The wide record format does not support SYNCHK(l,a).
SYNCHK(D,X)
Commands:
■ LIBEXP
■ LIBSAVE
Deactivates the syntax checker option for all future updates of the module. D is the
delete option. X is a dummy option. D and X are not variables and must be used as
illustrated.
[TERMMSG|PERMMSG|TEMPMSG]
Commands:
■ LIBADD
■ LIBDLM
■ LIBINDEX
■ LIBSAVE
Parameters:
TERMMSG
The CA Librarian Update Report is written to the terminal.
PERMMSG
CA Librarian writes the Report to a data set, named:
■ user-prefix.$$$$$$LA.MSGS for a LIBADD execution
■ user-prefix.$$$$$$Lx.MSGS for a LIBxxx execution
■ user-prefix.$$$$$$LA.MSGS for a LIBxxx execution
You can save this information only by printing or renaming the data set
because the Update Report from the next execution overlays it.
TEMPMSG
The Update Report is written to a temporary data set that is deleted at the end
of command processing. If you omit this option, your site default is assumed.
TSODSN{('data-set-name')|(data-set-name)|('pds-name(member)')|(pds-name(memb
er))}
Commands:
■ LIBADD
■ LIBEXP
■ LIBGET
For LIBADD and LIBEXP, identifies the data set used to update the master file. Use
this option if CA Librarian cannot determine the data set name from the
module-name option and other specified or defaulted information.
Note: With LIBXP, this option is ignored if you specify NOTSO.
For LIBGET, specifies the name of the data set where the retrieved module is
copied. You must identify the data set with the TSODSN option only if the LIBGET
command cannot determine the data set name from the module name option and
other supplied or default information.
Do not use this option if you specified the pds-name(member) option.
You can enter the data set or PDS name with or without single quotes. If you omit
the quotes, LIBGET prefixes the name with your user-prefix. You must specify all
other qualifiers whether you enter the name with or without your user prefix.
TSOSIZE(nnnnnn)
Commands:
■ LIBADD
■ LIBEXP
■ LIBSAVE
If you specified CHKINC and the LIBAUDIT facility is not active, CA Librarian must
allocate a temporary data set to hold the records of your module while restoring
included modules back to their original -INC statements. If the allocated data set is
not large enough to hold the module, LIBADD, LIBEXP, or LIBSAVE fails with a
B37-04 abend.
If such an abend occurs, reenter the command with TSOSIZE and the size (in
number of records) of the data set or member.
Note: TSOSIZE is ignored if you specify either NOTSO or NOCHKINC. Command:
LIBGET
You can use TSOSIZE if needed to specify the size, in number of records, of a new
sequential data set that the LIBGET command is to allocate to hold a retrieved
module. The size must be the sum of the records currently in the module plus all
records included as a result of expanded -INC statements.
If the default size is too small to hold the original module and all included records,
LIBGET fails with a D37 or B37 abend.
If such an abend occurs, delete the data set and reenter the LIBGET command,
specifying the estimated number of records in the data set with the TSOSIZE option.
Note: You cannot use TSOSIZE to specify the size of an existing data set. You cannot
use TSOSIZE when copying a module into a member of a partitioned data set.
type
Commands:
■ LIBADD
■ LIBEXP
■ LIBGET
Identifies the contents of the module. If you are allowing LIBADD or LIBEXP to
construct the name of the data set to add or use to update the module, the
specified type entry becomes the descriptive-qualifier of the constructed name. If
you omit this option, the site default (usually COBOL) is assumed.
Note: During CA Librarian installation, types are set as part of per site
customization. You can use the LIBCTL command to list the valid types allowed.
The valid entries for this option are:
■ ASM
■ BASIC
■ CLIST
■ CNTL
■ COBOL
■ DATA
■ FORT
■ FORTGI
■ FORTH
■ GIS
■ GOFORT
■ PL1
■ PLIF
■ RPG
■ TEXT
■ VSBASIC
Your site can change or add more at installation time.
The type also determines the format of any CA Librarian-generated comment
statements that can be inserted into the module. The specified type is converted
into a language code stored with the module (through a -LANG statement) unless
the LANG option is specified or the module already has a -LANG parameter
associated with it. If you specify the LANG option with a language code, that
language code is stored with the module.
In building a data set name, CA Librarian determines the module data type and thus
the descriptive-qualifier from:
■ The type specified on the LIBEXP command statement
■ The current language code stored with the module (unless the contents are
meaningless to CA Librarian)
■ The site default (usually COBOL)
[VAR|NOVAR]
Command: LIBGET
Invokes the Source-Load Audit Trail facility for the current execution if you also
specified the READONLY option. Without the READONLY option, VAR is ignored.
Entering NOVAR suppresses the processing of the facility for the current execution.
VERS(mmdd[hhmm])
Commands:
■ LIBEXP
■ LIBGET
■ LIBSAVE
With LIBGET, terminates processing of a module if the specified date (in mmdd
format) or date and time (in hhmm format) do not match that of the most recently
applied update. Processing proceeds normally if the specified date or date and time
matches that of the latest update.
LIB/TSO Messages
The LIB/TSO system messages, both prompting and diagnostic, are self-explanatory. You
can display the second and third message levels, designated by plus signs (+), by
entering question marks (?) at the terminal.
The TSO HELP command provides online information about the function and syntax of
all the commands. To request help, simply enter the HELP command followed by the
command name or alias. For example, the following command displays a description of
the function and use of the LIBADD command:
HELP LIBADD
You can suppress LIB/TSO LIBAUDIT processing for individual command executions by
specifying the NOAUDIT operand on the LIBSAVE or LIBEXP commands. NOAUDIT causes
LIB/TSO to issue a -REP ALL,NOAUDIT control statement.
Note:
■ The advantages of LIBAUDIT can be lost through careless handling of sequence
numbers. If you change the location of your sequence numbers, LIBAUDIT views the
records as updated, even if no other changes are made. This problem can be
especially acute if editing COBOL data sets. Take great care to ensure that sequence
numbers remain in the same location when modules are retrieved from or returned
to the master file. In addition, avoid using ISPF AUTONUM if LIBAUDIT is in effect.
■ Without LIBAUDIT, CA Librarian generates an entire copy of the module for every
archiving level and CA Librarian does not date stamp the changed records of
non-archived modules.
Index 121
command processors • 79 DSNAME field • 27, 30
Command Processors • 79 DSSOURCE (LIB/TSO option) • 96
command processors and CLISTs • 80
Command Processors and CLISTs • 80 E
command syntax • 21 E (EDIT) line selection command • 23
command syntax for ELIPS function commands • 21 E function command • 19
Command Syntax for ELIPS Functions • 21 edit • 43
command syntax for ELIPS LIST command • 21 EDIT • 50
commands (LIB/TSO) • 82 EDIT command • 9, 21
Commands and Subcommands • 19 EDIT Command • 50
commands available on the ELIPS main entry panel • EDIT edit command • 50
9 EDIT editor command with special ELIS features • 21
Contact CA Technologies • 3 edit function • 43
Control Information • 56 EDIT Function (E) • 26
COPY • 47 EDIT function command • 19, 26, 34
COPY command • 9 Edit Function-Editing a Member • 43
COPY Command • 47 EDIT Labels and Ranges • 54
COPY edit command • 47 edit subcommands • 20
COPY editor command with special ELIS features • Edit Subcommands • 20
21 edit symbolic labels and ranges • 54
COPY Function (C) • 25 Editor Commands • 46
COPY function command • 19, 25 editor commands (with special ELIPS features) • 21
copy utility • 59 Editor Commands with Special ELIPS Features • 21
CREATE • 49 editor-assigned • 55
CREATE Command • 49 EDREC parameter keyword • 72
CREATE edit command • 49 ELIPS Copy Utility • 59
CREATE editor command with special ELIS features • ELIPS Edit Commands • 43
21 ELIPS entry panel • 21
CROSSCHECKING OPTIONS field • 30 ELIPS Function Commands • 19
ELIPS Functions • 19
D ELIPS Move Utility • 60
D function command • 19 ELIPS Move/Copy Utility • 59
DAT land code • 34 ELIPS Parameter Keywords • 72
DATA member type • 34 ELIPS Return Codes • 73
DATA print option • 32 ELIPS selection list • 21
data set naming conventions (TSO) • 81 ELIPS User Exits • 10
DATE ADDED field • 27 END • 51
DELETE command • 9 END Command • 51
DELETE Function (D) • 26 END edit command • 51
DELETE function command • 19, 26 END editor command with special ELIS features • 21
Deleting Labels • 54 END ISPF command • 57
deleting symbolic labels • 54 entering data set information • 61
DESC (LIB/TSO option) • 96 entering library information • 61
described • 42, 59 Entering Library or Data Set Information • 61
DESCRIPTION field • 27 entry panel, ELIPS • 21
DESCRIPTION REQUIREMENT field • 30 Example 1 • 84, 88, 91, 96
Documentation Changes • 4 Example 2 • 84, 89, 92, 96
DSN parameter keyword • 72 Example 3 • 84, 89, 92
Index 123
LIBAUDIT processing • 118 MACRO parameter keyword • 72
LIBAUDIT Processing and LIB/TSO • 118 Main Entry Panel • 11
LIBCTL • 85 master file • 80
LIBCTL command • 79, 85 Master File Names, Module Names and TSO Data
LIBDLM • 85 Sets • 80
LIBDLM command • 79, 80, 85 MCD parameter keyword • 72, 74
LIBEXP • 86 MEMBER field • 27, 33
LIBEXP command • 79, 80, 86 member lists • 65
LIBGET • 89 Member Lists • 65
LIBGET command • 79, 80, 89 member syntax • 21
LIBINDEX • 92 memname syntax • 25
LIBINDEX command • 79, 80, 92 MENU • 46
LIBLIST • 93 MENU Command • 46
LIBLIST command • 79, 80, 93 MENU edit command • 46
LIBRARIAN LIBRARY INITIALIZATION OPTIONS field • MENU edit subcommand • 20
30 Messages • 69
LIBRARY field • 33 MOVE • 51
library naming conventions • 10 MOVE Command • 51
Library Naming Conventions • 10 MOVE edit command • 51
LIBSAVE • 94 MOVE editor command with special ELIS features •
LIBSAVE command • 79, 94 21
LIBTLICD command • 79 move utility • 60
LIBUTI command • 79 move utility function • 60
LIST • 37 move/copy • 62
LIST command • 21 move/copy member selection list • 62
LIST function • 37 MOVE/COPY Member Selection List • 62
LIST Function (LI) • 29 Move/Copy Utility panel • 60
List Function and Selection Lists • 37 Move/Copy Utility Panel • 60
LIST function command • 19, 29
LIST reserved word • 27 N
listing of • 43, 55 naming conventions, library • 10
LOCATE • 65 newname syntax • 21, 25
LOCATE (L) selection list command • 38 NEWPSWD(password) (LIB/TSO option) • 96
LOCATE command • 23, 65 NEWVERS • 46
LOCATE selection list command • 20, 37 NEWVERS Command • 46
LOCKED field • 27 NEWVERS edit command • 46
LON selection list command • 20, 37 NEWVERS edit subcommand • 20
LONG • 40 NOARC (LIB/TSO option) • 96
LONG (LON) selection list command • 38 NOAUDIT (LIB/TSO option) • 96
LONG format selection list • 40 NOCHK (LIB/TSO option) • 96
LONG Selection List • 40 NOINCLUDE (LIB/TSO option) • 96
LONG selection list command • 20, 37 NONE reserved word • 27
LONG selection list specification • 37 NOPC reserved word • 27
lvl syntax • 21 NOPR reserved • 27
NOQUERY parameter keyword • 72
M NOTE ISPF command • 57
MAC land code • 34 NOTSO (LIB/TSO option) • 96
MACRO member type • 34
Index 125
SHORT (SH) selection list command • 38 TOTALSQ UTIMAIN variable • 76
SHORT format selection list • 42 TSO data set naming conventions • 81
SHORT selection list command • 20, 37 TSO Data Set Naming Conventions • 81
SHORT selection list specification • 37 TSODSN
SHORT/QUICK • 42 ('data-set-name')|(data-set-name)|('pds-name(m
SHORT/QUICK format selection list • 42 ember)')|(pds-name(member)) (LIB/TSO option) •
SHORT/QUICK Selection List • 42 96
SOURCE(master-file-name) (LIB/TSO option) • 96 TSOSIZE(nnnnnn) (LIB/TSO option) • 96
special ELIPS features in editor commands • 21 TXT land code • 34
special features • 46 TY function command • 19
special features for edit commands • 46 TYPE field • 27, 30
Specifying Other CA Librarian, PDS, and Sequential type syntax • 21
Data Sets • 61 TYPES Function (TY) • 34
specifying sequential data sets • 61 TYPES function command • 19, 34
Specifying the TO Data Set • 64
specifying the TO library/data set information • 64 U
specifying wildcards • 17 use of asterisk in ELIPS LIST command syntax • 21
STARTNUM field • 27 used in LIST command syntax • 21
STATUS field • 33 user exits • 10
symbolic labels, editing • 54 using wildcards together • 17
SYNCHK(D,X) (LIB/TSO option) • 96 UT function command • 19
SYNCHK(l,a) (LIB/TSO option) • 96 UTILITY Function (UT) • 35
syntax for • 21 UTILITY function command • 19, 35
syntax rules • 82 UTIMAIN • 74, 75, 76
syntax rules for LIB/TSDO commands • 82 UTIMAIN Parameter Keywords • 74
System Labels • 55 UTIMAIN Return Codes • 75
system messages (LIB/TSO) • 117 UTIMAIN Variables • 76
T V
T selection list command • 20, 37 V (VIEW) line selection command • 23
TDSN parameter keyword • 74 V function command • 19
TEMP reserved word • 27 VAR parameter keyword • 74
TEST reserved word • 27 VAR/NOVAR field • 30
TEXT member type • 34 variables • 76
TOP (T) selection list command • 38 VERS(mmdd*hhmm+) (LIB/TSO option) • 96
TOP selection list command • 20, 37 VERSION field • 33
total members • 69 view • 43
total members messages • 69 VIEW command • 9
TOTAL UTIMAIN variable • 76 VIEW editor command with special ELIS features •
TOTALCT UTIMAIN variable • 76 21
TOTALENQ UTIMAIN variable • 76 view function • 43
TOTALEQ UTIMAIN variable • 76 VIEW Function (V) • 36
TOTALEXF UTIMAIN variable • 76 VIEW function command • 19, 36
TOTALNA UTIMAIN variable • 76 VOLUME field • 30
TOTALNL UTIMAIN variable • 76 VSB land code • 34
TOTALNR UTIMAIN variable • 76 VSBASIC member type • 34
TOTALNUM UTIMAIN variable • 76
TOTALPR UTIMAIN variable • 76
Index 127