Configure a new UDB environment
How to create a UDB configuration and access a previous UDB configuration.
Before you configure your UDB environment or the Collector environment, you must first update your settings. For more information about modifying your settings see, Modify your settings.

To create a new UDB configuration, select option 5 from the configuration menu.
************** CICS Interdependency Analyzer for z/OS - V5R3M0 **************
Command ===>
Press ENTER to complete, PF3 to go back or PF1 for help.
Please select an option from the list below:
5 0. Settings
1. Configure new DB2
2. Configure existing DB2
3. Configure new CICS
4. Configure existing CICS
5. Configure new UDB
6. Configure existing UDB

************** CICS Interdependency Analyzer for z/OS - V5R3M0 **************
Command ===>
Press ENTER to complete, PF3 to go back or PF1 for help.
Please select an option from the list below:
Short or Full Configuration . . . S (S/F)
Please enter UDB configuration name and description:
UDB Configuration . . . . UDBCONF1
Description . . . . . . . UDB Configuration

To configure CICS® IA® for a UDB database, you need to complete these fields:
- SHORT OR FULL CONFIGURATION
- Set this option to S (Short), if you want to create a UDB configuration
by specifying a short list of required variables. All of the other
variables will be set to default values.
Set this option to F (Full), if you want to specify all of the required variables.
REQUIRED
- UDB CONFIGURATION
- The name of the new UDB configuration.
REQUIRED
- DESCRIPTION
- A short description of the UDB configuration.
OPTIONAL

Output UDB data sets
- OUTPUT DSN FOR UDB SCIUSAMP
- The output data set that contains the modified SCIUSAMP members
to configure UDB database.
REQUIRED
- OUTPUT DSN FOR UDB SCIUDAT1
- The output data set that contains the modified SCIUDAT1 members
to extract UDB CSV Files.
REQUIRED
- OUTPUT DSN FOR UDB SCIUDAT2
- The output data set that contains the modified SCIUDAT2 members
to extract UDB CSV Files.
REQUIRED
- OUTPUT DEVICE TYPE
The device type for the output data sets. Defaults to SYSDA.
REQUIRED for a Full configuration. For a Short configuration, this field is not displayed.

HLQ for IA output data sets
This field is displayed on the panel for Short configuration only. It is required and specifies the common values for the IA VSAM FILE QUALIFIER, IA GDG DATA SET QUALIFIER, IA LOG STREAM QUALIFIER and IA CSV FILE QUALIFIER variables. These variables are described later in this topic.

UDB Variables
- UDB DATABASE NAME
- This variable is the database name. This database name is used
when you connect to the database. This value is also required when
you connect with the CICS IA plug-in. The name is the database
location: for example, CICSIADB.
REQUIRED
- UDB TABLE QUALIFIER (SCHEMA)
- This variable is the qualifier, which is sometimes referred to as schema for the database
objects. This value is also required when you connect with the CICS
IA plug-in, for example: CICSIA53.
REQUIRED
- UDB CODESET
- Specifies the code set to use for data that is entered into this
database. The recommended value is 1252.
REQUIRED
- UDB TERRITORY
- Specifies the territory that is to be used for data that is entered
into this database. The recommended value is US.
REQUIRED
- UDB DATABASE SERVER DIRECTORY
- This variable is the directory on your server where the database
is located. The directory that you select must exist on your server,
for example: CICSIAUDB.
REQUIRED
CICS IA Variables
- IA PRODUCT QUALIFIER
The CICS IA data set qualifier. For a Short configuration, this field is not displayed.
- IA VSAM FILE QUALIFIER
- The qualifier prefix for the CICS IA VSAM data sets where the collected
data is stored. This variable is set to the same value that is used
in the CICS configuration.
REQUIRED for a Full configuration. For a Short configuration, this field is not displayed and is set to the value specified for "HLQ for IA output data sets".
- IA GDG DATA SET QUALIFIER
- The qualifier prefix for the GDG data set that is used by the
Command Flow option. This variable is set to the same value that
is used in the CICS configuration.
REQUIRED for a Full configuration. For a Short configuration, this field is not displayed and is set to the value specified for "HLQ for IA output data sets".
- IA LOG STREAM QUALIFIER
- The stream name qualifier for the CIUMTJNL log stream data sets
that are used by the Command Flow option. This variable is set to
the same value that is used in the CICS configuration.
REQUIRED for a Full configuration. For a Short configuration, this field is not displayed and is set to the value specified for "HLQ for IA output data sets".
- IA CSV FILE QUALIFIER
- The qualifier prefix for the CICS IA CSV output data sets.
REQUIRED for a Full configuration. For a Short configuration, this field is not displayed and is set to the value specified for "HLQ for IA output data sets".
- IA CSV FILE DATACLASS
- The data class that you use for the allocation of the CSV data
sets.
OPTIONAL. For a Short configuration, this field is not displayed.
- IA CSV FILE STORAGECLS
- The storage class that you use for the allocation of the CSV data
sets.
OPTIONAL. For a Short configuration, this field is not displayed.
- IA CSV FILE MNGMNTCLASS
- The management class that you use for the allocation of the CSV
data sets.
OPTIONAL. For a Short configuration, this field is not displayed.
- IA CSV FILE SPACE UNITS
- The space units that are used to express the data set allocation
size that is required.
REQUIRED for a Full configuration. For a Short configuration, this field is not displayed and defaults to CYLINDERS.
- IA CSV FILE PRIMARY QTY
- The primary allocation quantity for the CSV files, in cylinders,
tracks, KB, or megabytes as selected in the SPACE UNITS field.
REQUIRED for a Full configuration. For a Short configuration, this field is not displayed and defaults to 10.
- IA CSV FILE SECNDRY QTY
- The secondary allocation quantity for the CSV files, in cylinders,
tracks, KB, or megabytes as selected in the SPACE UNITS field.
REQUIRED for a Full configuration. For a Short configuration, this field is not displayed and defaults to 2.