Command Syntax for ELIPS Functions

You can specify ELIPS function commands from the ELIPS entry panel, LONG, SHORT or ARCHIVE selection lists.
cl
You can specify ELIPS function commands from the ELIPS entry panel, LONG, SHORT or ARCHIVE selection lists.
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.
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.
The command syntax for the ELIPS LIST command is as follows:
LIST wildcard LANG(lan) TYPE(type) PGMR(pgmr)
  • 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.
ARCLIST Function (A)
The ARCLIST function displays an ARCHIVE LEVEL selection list for the member for which it is specified.
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)
You can also use S for EDIT.
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.
*************** ELIPS 4.1 ARCHIVE SELECT FUNCTION PANEL O ******** ROW 1 OF 7 COMMAND ===> ALT SCROLL ===> PAGE ******************************************** 0 MEMBERS ACCESSED, 0 UPDATED ** * LIBR.ELIPSD1.MAST --- MEMBER(ARCMOD) STATUS(T)---------------------------* ***************************************************************************** LEVEL PSWD VERSION DATE NEWNAME LANG DESCRIPTION RCDS b 00006 900915114239 COB MODULE TO BE CALLED 00006 00005 900911100029 COB MODULE TO BE CALLED 00005 c 00004 900910143217 ARCMOD1 COB MODULE TO BE CALLED 00005 00003 900910143040 COB MODULE TO BE CALLED 00005 00002 900910142916 COB MODULE TO BE CALLED 00005 00001 900910142837 COB MODULE TO BE CALLED 00005 00000 900910142512 COB MODULE TO BE CALLED 00005 ************************** END OF SELECTION LIST ****************************
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 COMMAND ===> SCROLL ===> PAGE ********************************************* 0 MEMBERS ACCESSED, 0 UPDATED ** * LIBR.ELIPSD1.MAST --- MEMBER(ARCMOD) STATUS(T)----------------------------* ****************************************************************************** LEVEL PSWD VERSION DATE NEWNAME PROGRAMMER SS SEQ RCDS 00006 900915114239 *BROWSED O0 MODULE TO BE CALLED 00006 00005 900911100729 O0 MODULE TO BE CALLED 00005 00006 900915114239 *COPIED O0 MODULE TO BE CALLED 00005 00003 900910143040 O0 MODULE TO BE CALLED 00005 00002 900910142916 O0 MODULE TO BE CALLED 00005 00001 900910142837 COB MODULE TO BE CALLED 00005 00000 900910142512 COB MODULE TO BE CALLED 00005 ************************** END OF SELECTION LIST *****************************
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.
BROWSE Function (B)
The ELIPS BROWSE function lets you display the selected member in read-only mode, using the ISPF BROWSE service. You can browse all members in a
CA Librarian
library, including printer members.
COPY Function (C)
The ELIPS COPY function lets you copy all levels of a member to a new member in the same
CA Librarian
library.
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.
You can also specify
COPY
on the command line.
This function has the following format:
C memname [PSWD(pswd)] [ARC(level)] NEW(newname)
  • 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.
DELETE Function (D)
The ELIPS DELETE function lets you delete a member from a
CA Librarian
library. A CONFIRM DELETE panel displays unless you chose, by an option on the main panel, not to confirm the delete.
****************************************************************************** * 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 * * * ******************************************************************************
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.
This function has the following format:
D memname [PSWD(pswd)]
  • memname
    The name of the member to delete.
  • pswd
    The four-character member password (your site might require a password).
EDIT Function (E)
The EDIT function lets you edit a
CA Librarian
member, using the ISPF editor. The additional capabilities of this function are:
  • Creation of a new member.
  • Immediate update on SAVE or END, if data was changed.
  • The ability to display the contents of included members on the screen.
  • History record display.
  • Control information change on update.
  • The NEWVERS command to specify the version integrity option.
For further information on the ELIPS EDIT function and the commands and options available with it, see the “Edit Function: Editing a Member” section.
INFO Function (I)
The ELIPS INFO function displays the current control information for an
CA Librarian
member and lets you modify it. Updating an archived member creates a new archive level. Normal
CA Librarian
validity rules apply to the information supplied in the INFO panel and the ELIPS installation requirements are observed for updates (see the section on the OPTIONS command).
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.
LIST Function (LI)
The LIST command, when entered from the ELIPS entry panel, displays a LONG or SHORT format selection list.
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.
OPTIONS Function (OPT)
This function displays both the initialization options for the specified
CA Librarian
library, the current site options for ELIPS, and the user's SYSOUT options for the ELIPS PRINT command.
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 OPTIONS function panel consists of three sections:
  • ELIPS site options
  • CA Librarian
    library initialization options
  • ELIPS user options
The first line in the ELIPS INSTALLATION OPTIONS section shows the
CA Librarian
release number and release date.
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.
An asterisk (*) is not a valid SYSOUT CLASS for the ELIPS PRINT function.
PRINT Function (P)
The ELIPS PRINT function prints a listing of the selected member by dynamically allocating SYSOUT based on the SYSOUT CLASS and DEST defined on the ELIPS OPTIONS panel. The print listing's job name is the same as the TSO user ID and is routed to the JES spool and printed when the user ID logs off.
You can specify REPT or DATA on the ELIPS entry panel.
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.
Note the following:
  • The DATA and REPT options are not applicable to printer members, which are printed as is. If the first character of the first record is the FBA top-of-page carriage control character (1), then the member is printed as format FBA. Otherwise the member is printed as format FBM.
  • You can install ELIPS to optionally support a SYSOUT program that can affect the disposition of the PRINT listing.
  • The JES2 TSUCLASS OUTPUT initialization statement must specify YES for the ELIPS PRINT function to allocate SYSOUT.
RECOVER Function (REC)
The ELIPS RECOVER command queries the edit recovery table for pending entries.
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.
RENAME Function (R) -- Change a Library Member Name
Use the ELIPS RENAME function to change the name of a member on the
CA Librarian
library.
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.
SELECT Function (S)
Specifying SELECT invokes the EDIT function. It is the same as EDIT.
TYPES Function (TY)
The TYPES function displays the Type/Language Table that was generated during ELIPS installation. The allowable member types, the corresponding
CA Librarian
language codes, and the sequence field starting column and length are all shown on a scrollable display.
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.
Member Type
Land Code
Contents of Data Set
Default Sequence 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 Compiler Statements
73 - 80
RPG
RPG
Report Program Generator Statements
75 - 06
TEXT
TXT
Uppercase and Lowercase Text
81 - 06
VSBASIC
VSB
VSBASIC Statements
*
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.
UTILITY Function (UT)
The move/copy utility moves data from a partitioned or sequential data set to a
CA Librarian
library, or copies data from an
CA Librarian
library to another or to a partitioned or sequential data set.
You can select the move/copy utility by either:
  • Selecting option L.U from the primary option menu,
  • Selecting option U from the
    CA Librarian
    selection menu, or
  • Selecting option UT from the ELIPS entry panel.
For details on using the UTILITY Function, see the “ELIPS Utilities” section.
VIEW Function (V)
The VIEW function works just like an edit session except that no updates take place.
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.