Modifying Tools Customizer user settings

Before you can customize Db2® Automation Expert with Tools Customizer, you must review the settings that Tools Customizer uses. You might have to change the default values to suit your environment. In most cases, you can change the Tools Customizer values at any time. For example, after you have customized Db2 Automation Expert and are customizing a different product or solution pack, you might have to change the settings.

1. On the IBM Tools Customizer for z/OS main panel (CCQPHME), specify option 0, User settings for Tools Customizer.
   The Tools Customizer Settings panel (CCQPSET) is displayed, as shown in the following figure:

   CCQPSET             Tools Customizer Settings                14:03:51
   Command ===>                                                               
   Enter the settings for customizing a product or press End to save and exit.
                                                                              
   Commands: SAVE  OPTIONS                                                        
                                                                      
    Product Customization Settings                                                
                                                                                   
     *Customization library qualifier . . DB2TOOL.PRODUCT.CUST                 
        Volume serial  . . . .. . . . . .                                         
     *Use DB2 group attach  . . . . . . . YES (YES/NO)                            
                                                                                   
    Tools Customizer Library Settings                                             
                                                                                   
     *Metadata library . . . . . DB2TOOL.CCQ110.SCCQDENU                          
     *Discover output data set . DB2TOOL.CCQ110.DISCOVER                               
        Volume serial  . . . . .                                                  
     *Data store data set  . . . DB2TOOL.CCQ110.DATASTO1                          
        Volume serial  . . . . .                                                  
                                                                                   
    User Job Card Settings for Customization Jobs                                 
                                                                                   
    ===> //         JOB (ACCOUNT),'NAME',                                                                    
   

   Note: An asterisk next to a field indicates that the field is required.
2. Review the values for the following required fields. Use the default value or specify your own value.
   You must have appropriate READ and WRITE access to the data sets that are specified.

   Customization library qualifier

   The high-level qualifier that is used as the prefix for the customization library. The customization library is a data set in which the generated jobs to customize Db2 Automation Expert are stored. WRITE access to this qualifier is required.

   For each product to be customized, the first value that is specified for the qualifier is always used, even if you change it after you have generated the customization jobs. For example, if you customize a product and then specify a new qualifier for recustomization, although the new qualifier is saved and displayed, the original value is used.

   To maintain multiple instances of Tools Customizer, specify a unique customization library qualifier for each instance of Tools Customizer.

   Data set names that exceed 42 characters must be enclosed in single quotation marks (').

   Volume serial

   The volume name in which the customization library will reside. If you don't specify a volume name, it will be assigned by the system.

   Use DB2 group attach

   Determines the value that is used in the CONNECT statements in the generated customization jobs. Specify YES for data sharing environments, which causes the group attach name to be used. Specifying NO, in most cases, causes the SSID to be used in the Db2 CONNECT statement.

   Important: This field has no effect when you are customizing a product on a Db2 subsystem that is not a member of a data sharing group. In this case, the Db2 subsystem ID (SSID) is always used in the CONNECT statements in the generated customization jobs.

   When you are customizing a product on a Db2 subsystem that is a member of a data sharing group, how the Db2 subsystem is defined and the value of the Use DB2 group attach field determines the value that is used in the CONNECT statements in the generated jobs. The following table shows whether the SSID or the group attach name is used:

   Table 1. The effect of the value of the Use DB2 group attach field in a data sharing environment

   Db2 subsystem definition	Value of the Use DB2 group attach field	Value that is used in the CONNECT statements
   The Db2 subsystem is defined with an SSID.	Yes	Group attach name
   	No	SSID1
   The Db2 subsystem is not defined with an SSID.	Yes or No	Group attach name
   Note 1: If you generate jobs for multiple Db2 subsystems that are defined with an SSID and belong to the same data sharing group, the SSID of the first Db2 subsystem that is selected is used.

   For example, assume that on the Customizer Workplace panel, you generated jobs for the following Db2 subsystems:

   • DB2C, which is a stand-alone Db2 subsystem
   • DB2A, which is a Db2 subsystem that is a member of data sharing group DSG1
   • A Db2 subsystem that was not defined with an SSID that is a member of data sharing group DSGA

   The following figure shows how these Db2 entries might be listed on the Customizer Workplace panel:

   
   Associated DB2 Entries and Parameter Status                                    
     Line commands: G - Generate jobs  E - Edit  B - Browse  C - Copy  R - Remove 
     Cmd SSID GrpAttch Lvl Mode User ID Date       Status              Message    
         DB2C  --      121 NFM  SYSADM  2017/11/09 Ready to Customize             
         DB2A  DSG1    121 NFM  SYSADM  2017/11/09 Ready to Customize             
         --    DSGA    121 NFM  SYSADM  2017/11/09 Ready to Customize             
   ------------------------------ End of DB2 entries -----------------------------

   The following table shows which values are used in the CONNECT statements in the generated jobs, based on the value of the Use DB2 group attach field.

   Table 2. Value that is used in the CONNECT statements in the generated jobs

   SSID	GrpAttch	Value of the Use DB2 group attach field	Value that is used in the CONNECT statements
   DB2C	--	Yes	SSID
   		No	SSID
   DB2A	DSG1	Yes	Group attach name
   		No	SSID
   --	DSGA	Yes	Group attach name
   		No	Group attach name

   Tools Customizer metadata library

   The name of the data set that contains the metadata that is used to display the Db2 and LPAR parameters. The parameters that are displayed on the LPAR Parameters panel and the DB2 Parameters panel depend on the parameters that you define and the tasks and steps that you select on the Product Parameters panel for the product that you are customizing. For example, the Db2 parameters that are required, based on the selected tasks and steps, are displayed on the DB2 Parameters panel, and you can edit them. If they are not required, they are not displayed. Read access to this data set is required. Data set names that exceed 42 characters must be enclosed in single quotation marks (').

   Discover output data set

   The name of the data set in which the output from the Db2 Automation Expert Discover EXEC is stored. Each product has its own Discover EXEC. The Discover EXEC retrieves the product, LPAR, and Db2 parameters from a previously customized product. Write access to this data set is required. Data set names that exceed 42 characters must be enclosed in single quotation marks (').

   Volume serial

   The volume name in which the discover output data set will reside. If you don't specify a volume name, it will be assigned by the system.

   Data store data set

   The name of the data set where Tools Customizer stores information about product, LPAR, and Db2 parameter values. Information about which products are associated with which Db2 entries (Db2 subsystems, Db2 group attach names, and Db2 data sharing members) is also stored in this data set. Data set names that exceed 42 characters must be enclosed in single quotation marks ('). The specified data store data set can be used with only one invocation of Tools Customizer at a time. Data set names that exceed 42 characters must be enclosed in single quotation marks (').

   Volume serial

   The volume name in which the data store data set will reside. If you don't specify a volume name, it will be assigned by the system.

   User job card settings for customization jobs

   The job card information to be inserted into the generated jobs for customizing a product. The default value is the job statement information from the ISPF Batch Selection panel.

   The first line of the job card automatically begins with the following information:

   //          JOB

   where characters 3 - 10 are reserved by Tools Customizer for the job name and includes a blank space after JOB. This name cannot be edited. Information that you specify on the first line of the job card cannot exceed 57 characters. This character limit includes a continuation character. All other lines of the job card cannot exceed 72 characters.

3. Press End to save and exit.
   If the Discover output data set and the data store data set that you specified do not exist, Tools Customizer creates them.

   Important: If the ISPF sessions unexpectedly ends before you exit Tools Customizer, the fields on the Tools Customizer Settings panel (CCQPSET) will be repopulated with default values, and you will be required to review them or specify new values again.