Using Optional Features › The CCID Definition Data Set

The CCID Definition Data Set

If you want to use CCID validation, you must build a CCID definition data set. Before you can build the data set, though, you need to specify a CCID validation data set name in the Defaults Table, using the CIPODSN parameter.

Note: For more information about the CIPODSN parameter, see The TYPE=MAIN Macro.

How to Install the CCID Definition Data Set

The following are the three steps involved in installing the CCID definition data set:

1. Allocate the data set.
2. Initialize the data set.
3. Add the data set name to the CA Endevor SCM Defaults Table.

Allocate the Data Set

Allocate the CCID validation data set using the standard ISPF data set utilities-option 3.2 from the ISPF/PDF Primary Option Menu. The data set must have the following attributes:

LRECL=

80

RECFM=

FB

DSORG=

PS

BLKSIZE=

Any multiple of 80

The data set name you use must be the same as that specified for the CIPODSN parameter in the Defaults Table. The data set name can be any valid name that conforms to your site's naming conventions.

How to Install the ++CONTROL Password Interface

The three steps involved in installing the ++CONTROL password interface include the following:

1. Edit member C1PTCNTL.
2. Assemble and link C1PTCNTL.
3. Copy the output into the CA Endevor SCM authorized library.

Edit C1PTCNTL

To install the ++CONTROL password interface, you need to provide the CA Panvalet library data set name and password for each library that is password-protected. Use member C1PTLCNTL, which is supplied in the installation iprfx.iqual.CSIQSRC library, to do this. C1PTLCNTL contains the instructions you need to define each library and password. Make sure that you provide values that are proper for your site for all the PANPRFX, PANQUAL, and PANLIB qualifiers within this module.

Assemble and Link-Edit C1PTCNTL

Use sample JCL BC1JTABL to assemble and link-edit C1PTCNTL to your iprfx.iqual.CSIQAUTU outside of SMP/E or use an SMP/E USERMOD to accomplish this. BC1JTABL is provided in the installation library iprfx.iqual.CSIQJCL.

Initialize the Data Set

You can initialize the CCID validation data set by copying a template that is delivered as part of CA Endevor SCM. Because CA Endevor SCM requires information to be placed in certain columns, it is recommended that you copy member SAMPCIPO into the data set allocated in Step 1. By using this member as a template, you can ensure that the fields in the data set are positioned in the correct columns.

Use the standard ISPF copy utility-option 3.3 on the ISPF/PDF Primary Option Menu-to copy SAMPCIPO from the sample JCL library (iprfx.iqual.CSIQJCL, created during Step 2 of the base installation process) into the data set.

Use the ISPF edit service to tailor the data set to meet the requirements of your site.

Add the Data Set Name to the Defaults Table

After you have allocated and initialized the CCID validation data set, you need to add the data set name to the Defaults Table. To do this, add the valid data set name to the CIPODSN parameter, as follows:

Col 1     Col 16                                             Col 72   
 
          CIDEFLTS TYPE=MAIN,                                X
          .  
          .
          .
          CIPODSN=,           CCID VALIDATION DATASET NAME   X
          .  
          .
          .

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

Do not update the CIPODSN parameter in the Defaults Table before allocating the CCID validation data set. If CIPODSN contains a non-null entry, CA Endevor SCM assumes that the entry is a data set name and looks for that data set during initialization. If CA Endevor SCM cannot find the data set, it generates an error message. Therefore, before using CA Endevor SCM, be sure that the CCID validation data set is allocated and defined appropriately.