Configuring Your Product › Configure Your Product Automatically (Auto Config)

Configure Your Product Automatically (Auto Config)

The automated configuration simplifies the configuration process. We recommend that you configure CA Chorus and disciplines at the same time.

Important! In your_chorus_hlq.CETJJCL and other data sets, you see seemingly duplicate members. For example, CHORJBOS and $HORJBOS. The first member is for manual configuration use. The second member is for automatic configuration use; however, with this method, you do not manually update any members that lead with the $ symbol. The ETJICUST batch job updates these members for you.

Important! If you install a discipline, you must deploy and configure it.

Follow these steps:

Important! Read the JCL comments as you complete this procedure. Most procedural and reference details reside in the jobs.

1. Review the following auto-config terms:

   ETJICUST

   A customization job that lets you propagate site-specific variables from one data set to all members of the library under your HLQ. You run this job twice in this procedure.

   • First Run: Creates your configuration data set, which contains all variables needed for your configuration. At this point, these variables have sample/default values. In subsequent steps, you will edit them to provide site-specific values.You only see variables for the disciplines that you are installing/configuring.
   • Second Run: In this run, your configuration data sets serves as the input to customize the members in the libraries with the HLQ provided in Output_ds_HLQ. These are new libraries that are created in this run of ETJICUST.

   Configuration Data Set (Configuration_ds)

   This data set includes directions and definitions regarding the values that you must enter for the CA Chorus and discipline configuration. You specify and create this data set during the first run of ETJICUST.

   Output_ds_HLQ

   Your configuration settings are applied to the CA Chorus and discipline configuration members in the new customized data sets as specified under the Output_ds_HLQ variable in the ETJICUST JCL member.

2. Review and edit ETJICUST in your_chorus_hlq.CETJJCL.
3. Submit ETJICUST in your_chorus_hlq.CETJJCL.

   Note: (New configurations only) For the configuration data set that you specify in the first run of this job, you cannot specify a data set that already exists.

   The expected return code is zero. Your configuration data set is created.

4. Edit the configuration data file that you specified for Configuration_ds as defined in ETJICUST. This data set includes directions and definitions regarding the values that you must enter for the CA Chorus and discipline configuration. Some values are optional, and some are mandatory.
5. Resubmit ETJICUST in your_chorus_hlq.CETJJCL.

   The expected return code is zero. If you see a different return code, review the output, make the appropriate change, and rerun the job.

   Your configuration settings are applied to the CA Chorus and discipline configuration members in the new customized data sets as specified under the Output_ds_HLQ variable in the ETJICUST JCL member. In the following topic, you submit the preconfigured jobs from these data sets.

   Important! You may determine that you have entered an incorrect value in the Configuration_ds file (for example, you see a customized job with incorrect information). For this scenario, update the information in the Configuration_ds file, and rerun ETJICUST. Doing so reconfigures the customization jobs and ensures that all values are updated correctly.

More information

Use ETJICUST to Point to Another Deployment