Using Optional Features › The CA Librarian Interface

The CA Librarian Interface

If your site is using CA Librarian as its source library manager, you need to install the CA Librarian Interface. This interface allows you to access members stored within the CA Librarian data sets.

CA Endevor SCM can add, update, or read from a CA Librarian data set. Whenever CA Endevor SCM adds or updates, it always adds or replaces the entire member, ignoring-but preserving- CA Librarian sequence numbers.

External and Internal Libraries

The CA Librarian data sets can be used as external libraries; for example, as development libraries, INCLUDE libraries, or target libraries.

It is not recommended that you use CA Librarian data sets as internal (base and delta) libraries, for performance and external usability issues. If you do use these data sets as CA Endevor SCM base and delta libraries, note that members written into the libraries are always stored with sequence numbers in columns 81-86, regardless of the type of language used. This is done to protect CA Endevor SCM information.

Set the CA Librarian Parameters in the Defaults Table

Redefine the CA Endevor SCM Defaults Table as follows, if necessary, to accommodate for the CA Librarian Interface:

• Specify the value LB in the LIBENV parameter (in the TYPE=MAIN macro).
• Update the LIBENVP parameter to specify that CA Librarian is installed at your site.
• Specify the name of the CA Librarian load module for your site in the LIBRPGM parameter. In the following example, the load module name is AFOLIBR, the default name delivered by CA Librarian .

  Col 1         Col 16                                     Col 72   
   
                CIDEFLTS TYPE=MAIN,                        X
                .  
                .
                .
                LIBENV=LB,                                 X 
                LIBENVP=Y,                                 X
                LIBPRGM=AFOLIBR,                           X
                .  
                .
                .
  

Note: For more information about editing the table, see The Defaults Table.

When to Customize for CA Librarian

Using CA Librarian may require some customization at your site. Because CA Endevor SCM automatically specifies columns 81-86 as the sequence columns for CA Librarian , and preserves all 80 columns of data (as applicable), it is not absolutely necessary to customize the interface at installation.

• If you do not require the Sequence Update facility (SEQUPD) of CA Librarian , you do not need to customize CA Endevor SCM to run the CA Endevor SCM CA Librarian Interface.
• If you need to control the sequence column numbers by type (if you are using the Sequence Update facility), you must customize your installation. Customization allows you to keep the CA Librarian members in external CA Librarian data sets, which may be updated by using imbedded sequence numbers.

For example, some sites have families of programs that are all updated by a common set of changes to a central copy of a particular type of program, such as a payroll program with several variants. The same set of changes can be applied to all programs by using the CA Librarian SEQUPD facility. In this example, customization would be required, as the client would need to retain control of the sequence number columns.

Considerations When Customizing for CA Librarian

If you decide to customize the CA Endevor SCM CA Librarian Interface for your site, you must consider the following:

• CA Endevor SCM must know the sequence columns for the element type being processed.
• CA Endevor SCM must preserve the original set of sequence numbers within the element, so subsequent sequence number updates will match correctly.
• CA Endevor SCM must always set the sequence columns when writing the element to an external CA Librarian data set, so CA Librarian will allow you to use these sequence columns for SEQUPD processing. This procedure informs CA Librarian that these specific columns are available, which in turn prevents automatic renumbering by CA Librarian.
• You must ensure that any element types customized for sequence number processing have valid, ascending numeric sequence numbers within the element.

How to Customize Your Site for CA Librarian

There are two steps involved in customizing your installation for the CA Endevor SCM CA Librarian Interface. These steps are described next:

1. Assemble and link-edit a language definition table to define the sequence columns by internal language for your installation.
2. Define distinct CA Endevor SCM types for those elements that will use SEQUPD processing.

Edit the C1LIBRSQ Table Member

You need to edit C1LIBRSQ to meet the requirements of your site.

After you complete the edits, use an SMP/E USERMOD to assemble and link-edit C1LIBRSQ or use the sample JCL BC1JTABL to assemble and link source module C1LIBRSQ outside of SMP/E. BC1JTABL is supplied in the installation library iprfx.iqual.CSIQJCL.

Edit these lines as follows:

• SYSLMOD DD-Replace iprfx.iqual.CSIQLOAD with the CSIQLOAD data set name you are using.
• C1LIBRSQ lines-Each C1LIBRSQ line defines the sequence number columns to be used for a particular internal language type. Enter the information required by your organization. Each line must specify a language (three characters in length, indicated by xxx), as well as two column numbers-a beginning column number (n1) and an ending column number (n2). You must enter one line per language. You can enter as many lines as necessary.
• The language types are matched against the PV/LB LANG field on the Type Definition panel.

The following list reflects the language codes CA Endevor SCM uses:

ASM (Assembler)

GOF

COB (COBOL)

JCL

DAT (Data)

PLF

FOR (FORTRAN)

PLI

FRG (FORTRAN G)

RPG

FRH (FORTRAN H)

TXT

GIS

VSB

The following examples illustrate acceptable C1LIBRSQ lines:

C1LIBRSQ LANG=COB,SEQCOLS=(1,6)

In this example, the language type is COBOL and the sequence number columns are 1 through 6.

C1LIBRSQ LANG=ASM,SEQCOLS=(73,80)

In this example, the language type is Assembler and the sequence number columns are 73 through 80.

Any languages not specified in the JCL are stored with sequence columns 81 through 86.

Note: If your site uses language codes other than those listed above, contact Technical Support at http://ca.com/support. An optional patch is available that allows you to modify the language codes in the JCL to accommodate the codes you are using.

Define CA Endevor SCM Types

You must determine which CA Endevor SCM types require the CA Librarian SEQUPD capability when you define element types for a system. These types require specific information to be entered on the Type Definition panel, as follows:

• The PV/LB LANG field must match one of the languages defined in the language definition table.
• The COMPARE FROM and COMPARE TO fields must include the sequence column fields defined for that language.
• Specify N for EXPAND INCLUDES, if the source output library is a CA Librarian data set. (Expanding INCLUDES makes the sequence numbers invalid.)

Note: If the language does not match or the sequence columns are not included within the compare columns (or both situations occur), CA Endevor SCM stores the sequence numbers in columns 81 through 86 when writing to external CA Librarian data sets.

Considerations When Defining Types

When defining types for the CA Endevor SCM CA Librarian Interface, keep in mind the following points.

For element types that are customized for the CA Endevor SCM CA Librarian Interface:

• Avoid EXPAND INCLUDES during add or retrieve processing where the target is a CA Librarian data set. Expanding INCLUDES makes the sequence numbers invalid.
• Ensure that members have valid sequence numbers in the sequence columns. If the numbers are invalid, CA Librarian rejects members during CA Endevor SCM retrieve processing.
• If a CA Endevor SCM member has invalid sequence numbers, retrieve that member into an IBM partitioned data set, adjust the sequence numbers, and add the member back into CA Endevor SCM.
• If using reverse formatted CA Librarian libraries, you should be aware of how -INC is handled. CA Endevor SCM will convert the '-' to a hex '02' and be added to the library; CA Endevor SCM does not want expansion to happen in the base library. Any CA Endevor SCM action will convert the hex '02' back to a '-'.

For element types that are not customized for CA Librarian:

• Set the CA Endevor SCM COMPARE columns to exclude CA Librarian sequence columns, to avoid sequence number edit rejections by CA Librarian.