Configuring Your Product › Install ELIPS (Optional) › Assemble and Link the ELIPSGEN Macro

Assemble and Link the ELIPSGEN Macro

The ELIPSGEN macro must be assembled and link edited to complete the installation of ELIPS. The ELIPSGEN macro is the installation macro for ELIPS. It resides on the macro library (CAI.CALJMAC). Member LUELIGEN on the CALJJCL library contains a job stream to assemble and link edit the macro into your CA Librarian target library.

Note: You must assemble and link edit the ELIPSGEN macro outside of SMP/E.

See the following ELIPSGEN macro parameters for the installation options that ELIPS provides. You can tailor these for your own site's needs.

APANEL=(panelname[,panelname[...,panelname]]) | (LIBIAS00,LIBIAS01)

This option lets your site define the name of the MAIN and ALTERNATE panels to use for the ARCHIVE LEVEL selection list function.

The first panel defined is the default panel, the one shown when the user first enters the ALT function after entering ELIPS. It is also the ALT 0 screen.

panelname

The name of the panels to use for the ARCHIVE LEVEL selection list function. If a single screen is defined with no alternates, then the parentheses are not needed.

(LIBIAS00,LIBIAS01)

The default, specifies the panels that are provided on the installation tape.

ATYPn=(type,lang,seqcol,seqlen)

Defines the ELIPS Member Type-Language Code translation table.

n

The position in the type/language table where the entered information is placed. A table of default values is shown below. Any position can be changed. Positions 18 through 32 can be added.

type

The member type to enter in the type/language table. The type is used for such purposes as allowing the user to enter a member type for the LONG selection list and naming the edit profile to use.

lang

The 1- to 3-character CA Librarian language code to associate with the member type specified.

seqcol

The default starting column for sequence numbers for this type of member. It must be specified as two digits, in the form nn.

When you add a new member using the ELIPS EDIT function and you enter the language or type on the control information panel, the sequence number starting column is taken from the Type/Language Table starting column specification for the language or member type that you specify in this parameter. If the type is not found in the table, then the master file default is used.

Note: If a starting sequence of 00 is placed in this position, the master file default starting sequence column is used. (These are identified by asterisks in the table below.)

seqlen

The default sequence number length for this type of member. When you add a new member using the ELIPS EDIT function and enter a language or type as required on the control information panel, the sequence number length is changed if the language is found in the type/language table. Otherwise, the master file default is used.

If you place 0 in this position, then the master file default sequence number length is used. (These are identified by asterisks in the table below.)

Note: If an entry is duplicated in the table, it is found on a sequential basis. For example, the default shown in the following table for member type PL1 is language code PL1. For type PL1F, it is also PL1. Therefore, if a language code of PL1 is translated, it is always translated to the member type of PL1 since this appears first on the table; but if a member type of PL1F is entered, it is translated from the table to a language code of PL1.

The following table lists the defaults used in type/language translation.

CCFCHK=YES|NO

Cross-checking is done with LIB/CCF to see if the master file is a LIB/CCF-controlled production master file. If it is, only the BROWSE function is allowed on that master file.

YES

Cross checks with LIB/CCF each time a new master file is allocated and restricts access to a LIB/CCF-controlled production master file to BROWSE only.

Note: When CA Top Secret protects all master files in all chains, you do not need to use the ELIPSGEN option CCFCHK=YES. Using CCFCHK=YES adds considerable overhead (to read all the chains in the CCF system master file) to determine the chain access allowed to the master file being opened.

NO

(Default) Does not do this checking.

Note: If LIB/CCF-ISPF is not yet installed at your site, specify CCFCHK=NO. Failure to do so results in an S806 abend for LIB/CCF load module $CCFCOMI when attempting to access any master file through ELIPS.

CHECK=YES|NO

Specifies whether the LIB/TSO TLICD file checks for access to any update-type function in ELIPS (Edit, Update, Rename). This parameter is provided for sites that use the LIB/TSO interface. If you do not use LIB/TSO, allow this parameter to default to CHECK=NO.

YES

Specifies TLICD checking for each update-type access.

NO

The default. Does not do this checking.

DESC=NO|ADD|ADDSAVE

Specifies whether the DESCRIPTION field must be filled in before an add or an edit update can take place.

NO

The default. Indicates that the user can leave the description field blank.

ADD

Indicates that the user must enter a description for a member being added.

ADDSAVE

Indicates that the user must fill in the blank description field for ADDs, SAVEs, and INFO updates.

EXITnd=(C|L|O,name)

Defines the user exits for ELIPS.

nd

The exit node where the defined exec executes. At present, the only available nodes are FE (function entrance), GA (general allocation), CR (command route), and SE (sub-function entrance). See the System Services Guide for details on the exits.

C|L|O

Specifies the type of exit program used.

C

Command (CLIST or command processor) to execute using the ISPF SELECT CMD service.

L

Load module to execute using the ISPF SELECT PGM service.

O

Object code to link into the ELIPSGEN load module at installation.

name

Name of the CLIST, load module, or program to execute every time this exit node is reached.

HIST=YES|NO

Specifies whether HISTory records are required when updating a member.

YES

HISTory records are required on all updates. If HIST=YES is specified, then, before an update takes place, the CONTROL INFORMATION panel displays with a message indicating that HISTORY is required. If the INFO command is used during EDIT and history records are inserted, they are used and the panel does not redisplay.

NO

HISTory records are not required.

KANA=YES|NO

Specifies whether the HISTORY and DESCRIPTION fields entered on the information update panel are converted to uppercase.

NO

(Default) The HISTORY and DESCRIPTION fields are not converted to uppercase, allowing the use of Katakana in these fields.

YES

The HISTORY and DESCRIPTION fields are converted to uppercase.

Note: History cards are converted to upper case by the ISPF editor when displayed as NOTE lines by the ELIPS HIST command if CAPS(ON) is set in the edit profile. If these were entered using KATAKANA characters, they can be unreadable until the user sets CAPS(OFF).

LMCPAN=(panelname,[panelname[..,panelname]])|(ELIPUML0,ELIPUML1,ELIPUML2)

Defines the names of the ALTERNATE panels to use for EDIT COPY Selection lists.

panelname

Indicates the name of the panels to use for the LONG Member Selection list. If a single screen is defined with no alternates, then the parentheses are not needed.

LPANEL=(panelname,[panelname[...,panelname]])|(LIBLIBILS01,LIBILS02)

Defines the name of the MAIN and ALTERNATE panels to use for the LONG Member Selection list. See the section titled Customize Panels later in this chapter for restrictions on the contents of these panels.

The first panel defined is the default panel, and the one shown when the user first enters the LONG selection list after entering ELIPS. It is also the ALT 0 screen.

panelname

Indicates the name of the panels to use for the LONG Member Selection list. If a single screen is defined with no alternates, then the parentheses are not needed.

(LIBILS00,LIBILS01,LIBILS02)

(The default.) Specifies the panels that are provided on the installation tape.

LUDPAN=(panelname[,panelname])|(UTILPN10,UTILPN11)

Specifies the panels for the move/copy utility LONG PDS selection lists.

LUMPAN=(panelname[,panelname[...,panelname]])|(UTILPN00,UTILPN01,TILPN02)

Specifies the panels for the move/copy utility LONG master file selection.

MODE=EDIT|BROWSE

Specifies whether selected CA Librarian members can be updated (EDIT mode) or just read (BROWSE mode). If you omit this parameter, the default, EDIT mode, is assumed.

PGMR=NO|ADD|ADDSAVE|SYSUID

Specifies whether PROGRAMMER NAME is required for an update.

NO

Specifies that the user optionally fills in the PROGRAMMER NAME field. The TSO USERID is put into the PROGRAMMER NAME field automatically if the user does not enter a value.

ADD

(The default.) Specifies the PROGRAMMER NAME field must be filled in for an ADD.

ADDSAVE

The user is required to fill in the field for ADDs and SAVEs if it is blank.

SYSUID

ELIPS automatically uses the TSO ID as the PROGRAMMER NAME for all updates.

PRTBLK=blksize|3990

Specifies the transient file block size for the BROWSE function for printer members.

blksize

The block size to use when allocating the transient file when browsing a printer (133 byte) member. The block size must be a multiple of 133.

3990

The default value.

Note: For efficiency, do not change this when using UNIT=VIO, the recommended default.

PSWD=U|R|D|N

Lets the site require the member password for the ELIPS functions listed following:

• U—Requires a password for SAVE, EDIT, RENAME, and EDIT REPLACE.
• R—Requires a password for BROWSE, COPY, PRINT, and EDIT COPY.
• D—Requires a password for DELETE.
• N—(The default.) Requires no passwords.

Note the following:

• Master files initialized with the NOBYPP option require passwords for any type of member access (except for the INFO function), regardless of the PSWD keyword specification in this macro.
• CA Librarian passwords are not intended for use as a security mechanism as they appear in various batch CA Librarian listings and in many online displays. However, you can use them as a check to verify that a member name has been keyed correctly.
• To specify multiple values for the PSWD macro keyword, place the values in parethenthesis, separated by a comma. For example: PSWD=(U,R,D).

QALLOW=YES|NO

Specifies whether the SHORT member selection list is allowed to show PROD2 members, even when the MCD was not provided, to force the SHORT member list to use the quick path processing.

Quick path processing accesses member index information only. It is much quicker and more efficient than the normal path.

• YES—You can use quick path processing for all master files. Displays the names of all members, including those with a status of PROD2.
• NO—(The default.) You cannot use quick path processing for Software-Lock-protected master files without a management code.

Note the following:

• If you specify QALLOW=YES, you can modify the ELIPS Main Panel by removing the Q from the selection list choices (L/S/Q). See the section titled ELIPS Main Panel Customization in this chapter for instructions. The reason for doing this is that S and Q provide the same display when QALLOW=YES. However, although removed from the choices displayed on the panel, the Q option is still processed if entered.
• If you are using the access control facility interface, access to a master file or member is determined by the access rules for that master file or member. Therefore, specifying QALLOW=YES can still require that you provide an MCD for a SHORT member selection list. Consult the Security Administration Guide for details on the access control facility interface, MCD, and PROD2 status.

SOPGMN=name

The SYSOUT program name (for example: DSPRINT) that is allowed for the PRINT function, in addition to SYSOUT class and destination.

Note: In a CA Spool environment, if you want to allow the dynamic allocation of SYSOUT to a printer from CA Librarian:

1. Set SOPGMN to ESF (or to whatever your system uses to identify the subsystem ID for CA Spool).
2. Apply the special fix that references ESF found in the CALJJCL member LSrrLIST.

The CA Spool subsystem must be active.

Alternatively, you can create print files in JES and let CA Spool capture the JES SYSOUT files by way of the XFER or NJE interfaces. If you want to create the files in JES, then the SOPGMN is not required. See your CA Spool documentation for more information on these interfaces.

TLICD=dsname|LIBR.TLICD

The data set name of the TLICD file to use for CHECK= checking. If you specify CHECK=NO, this option is ignored.

• dsname—The data set name of the TLICD file.
• LIBR.TLICD—The default data set name of the TLICD file.

Note: This parameter is for sites that use the LIB/TSO interface. If your site does not use the LIB/TSO interface, allow the CHECK= parameter to default to CHECK=NO and the TLICD= parameter is ignored.

TSOBLK=blksize|4080

The transient file block size for members.

• blksize—The block size to use when allocating the transient file for EDIT and BROWSE of a non-printer (80 byte) member.
• 4080—The default value.

Note: For efficiency, do not change this block size when using UNIT=VIO (the recommended default).

TYPE=COBOL|type

The default member type to use as a low-level qualifier when allocating any necessary TSO files. Also use for requesting the correct edit profile when the CA Librarian language code for the member is not in the installation Type/Language Table.

UNIT=VIO|unitname

Specifies the UNIT name to use for the EDIT and BROWSE transient file.

• VIO—(The default.) The name of the virtual I/O unit name for your system.

  Note: Wide record master file users should be aware that the device, or the device being emulated when VIO, must support the LRECL of the largest members being placed in wide record master files.

• unitname—Can be any normal DASD device unit name, but failing to use VIO substantially degrades ELIPS EDIT and BROWSE performance.

ZEDBDSN=PREFIX|NOPREFIX

Specifies whether the high level qualifier of the RECOVERY DATASET DSN begins with the PREFIX or USERID.

• PREFIX—(The default.) The prefix begins the data set name (for example, prefix.userid.LIB 00NN.BACKUP).
• NOPREFIX—The user ID begins the data set name (for example, userid.LIB 00NN.BACKUP).

ZEDDISP=D|K

Specifies whether the RECOVERY DATASET is deleted or kept.

• D—(The default.) Deletes the data set.
• K—Keeps the data set.

Note: IBM has documented how to pre-allocate the recovery data sets. This keyword is supplied ONLY to allow you to change this table variable per their instructions.

ZEDNUM=8|nn

Specifies the number of entries in the EDIT RECOVERY TABLE. Specify any number from 1 through 99, inclusive. The default is 8.