Configuring the CIA Repository › Implement the CIA Repository in DB2 › Implement User-Defined Fields in the CIA Repository

Implement User-Defined Fields in the CIA Repository

If your site has defined its own user fields on the ACID, you can include this information in the CIA repository.

Note: This implementation must occur after you have installed required software but before performing additional CIA implementation tasks. For information about how to define user fields to CA Top Secret by using the Field Descriptor Table (FDT), see the CA Top Secret User Guide.

The CIAUNLD job executes the unload utility, which reads information from the security database and creates an unload data set. The unload data set contains load data (in DB2 format) that populates the CIA repository. To include specific user-defined fields, you can specify USERFIELD input control statements in the SYSIN file of the CIAUNLD job (to generate UDFCHAR table records containing the fields).

Note: By default, the SYSIN file specifies to add all user-defined fields. If you do not want to include user-defined field data in the repository, specify the USERFIELD(*NONE*) input control statement in the CIAUNLD job.

Follow these steps:

1. Edit the CIAUNLD job in CAI.CAK0JCL0 by customizing the USERFIELD control statement to specify one of the following values:
   • *ALL* (to add all user-defined fields)
   • *NONE* (to omit user-defined fields)
   • field_name (to add a specific external user-defined field name to the repository)

     Note: You can specify multiple field names to add. If no CA Top Secret FDT entry matches the field name that is specified in the USERFIELD control statement, the unload utility terminates.

2. Submit the CIAUNLD job.

   Data customization is complete in the CIAUNLD job, and the product loads the user-defined fields into the repository.

Example: Add User-Defined Fields FIELD1, FIELD2, and FIELD3

The following unload utility SYSIN input control statements specify three user-defined character type fields (FIELD1, FIELD2, and FIELD3):

//SYSIN DD * 
USERFIELD(FIELD1) 
USERFIELD(FIELD2) 
USERFIELD(FIELD3) 
/* 

These USERFIELD control statements instruct the CIA unload utility to process FIELD1, FIELD2, and FIELD3 (when found) and generate UDFCHAR records in the UNLOAD data set.

Example: Do Not Implement User-Defined Fields

The following unload utility SYSIN input control statement specifies to omit user-defined fields:

//SYSIN DD * 
USERFIELD(*NONE*) 
/* 

Example: Implicitly Add All User-Defined Fields

The following unload utility SYSIN file implicitly specifies to add all user-defined fields (because no USERFIELD input control statements exist). This specification is the default specification.

//SYSIN DD * 
INPUT(DATASETS)
/* 

Example: Explicitly Add All User-Defined Fields

The following unload utility SYSIN input control statement explicitly specifies to add all user-defined fields:

//SYSIN DD * 
USERFIELD(*ALL*)
/*

More information:

USERFIELD—Add User-Defined Fields to the UNLOAD Data Set