Using the Customization Dialog

Why and when to perform this task

This article outlines the steps you should follow to configure your system using the Customization Dialog. Note that you should have already filled out the customization dialog worksheets. If you have not done this, go to Preparing to customize WebSphere Application Server for z/OS.

See the links at the bottom of this article for the corresponding instructions and help for each.

Steps for this task

  1. Start the Customization Dialog.
    Get the Dialog up and running so you can begin your customization. See Starting the Customization Dialog for instructions.
  2. Determine which task you wish to complete.
    After pressing "Enter" to get past the introduction screen(s), you will see the main Dialog panel which lists the tasks you can complete. Select the corresponding number for your desired task.

    Note: The remainder of the steps assume you have already chosen a task.

  3. Enter the customization variable information from the worksheets.

    Note: This step applies only to the "Configure security domain" task. Skip this step for all other install tasks.

    If you previously configured WebSphere Application Server for z/OS and saved the variables, you can load them and use them as a base and for defining your current configuration. See Loading customization variables for instructions.
  4. Load security domain customization variable information saved from "Configure security domain" task or previous configurations, if available.

    Note: Note: This step does not apply to the "Configure security domain" and "Configure integral JMS provider" tasks.

    In the tasks that require security domain variables, first run the "Configure security domain" task and then load the saved variables using this option in the other tasks. See Loading security domain variables for instructions.
  5. Allocate a new or existing target data set (.DATA/.CNTL).
    Designate a target data set to store your configuration information. See Allocating the target data sets for instructions.
  6. Define all variables for your particular customization.
    Using the worksheets that you completed, fill in a value for each variable. See Defining variables for instructions.

    Note: Ensure the accuracy of the variables and customized settings that you enter at this stage. Specification (spelling) errors and omissions are very difficult to diagnose and correct later on.

  7. Save your customization variable information to a data set.
    This option saves both your variables and target library settings in case you want or need to use them again. This way, they are available if you want to reconfigure or use the same values for another configuration or environment. This is also an important precautionary step in the case when you run into an error during the generate step; instead of having to re-enter all the information, you just reload it from the data set.

    It is recommended that you name the data set using the form *.SAVECFG. You should also make a backup copy of this data set.

    See Saving the customization variables for instructions.

  8. Save security domain customization variable information (applies to "Configure security domain" task only)
    This option saves both your security domain variables and target library settings for use in the other options. It is recommended that you name the data set using the form *.SDCFG. You should also make a backup copy of this data set.

    See Saving the security domain variables for instructions.

  9. Generate the customized jobs.
    This step creates the installation job streams you will run when stepping through the generated instructions. See Generating customization jobs for instructions.

    Note: At this point, you may want to save the variables to a data set again to catch any generation values you may have specified.

  10. Return to the related panel and correct any errors flagged by the Dialog and then regenerate the customized jobs.
    As the jobs and data members are created (or replaced), watch for errors. If there is an ENQ on the PDS, the Dialog will stop generating the tailored jobs for that data set and you will not have a complete set of generated jobs and data.
  11. Review the saved variables in the data set to which you saved them.

    Note: This step is optional.

    Sort the file on the columns that contain the variable values (typically columns 12-20) using the ISPF SORT command, then scan it for the following:

    Typos in the data set high-level qualifiers
    If there is a typo in one, it may stand out because the file will list it separately from the others.
    Typos in server names and user IDs
    If you use a column-specific naming convention, these will also stand out if there is a typo.
    Unique UIDs & GIDs
    It is important that these are all unique because the Dialog does not check for UIDs and GIDs that are already assigned in the RACF database.

  12. View, print and follow the generated instructions.
    These instructions step you through the process of running the jobs created by the Customization Dialog. This is the manual portion of actual customization. Note: For the "Configure security domain" task, you can wait to view the instructions until after you have customized the base Application Server node.

Results

After these steps are completed, you should have the desired configuration up and running smoothly. Follow the steps in this section again for whichever task you wish to perform, using the variables you saved from the first configuration as a basis for tailoring the variables for the others. (For example, you can use the same parameters and target CNTL, DATA, and SAVECFG data sets.)

What to do next

After you are finished with the Customization Dialog, continue your customization with the Using the administrative console. To access the console, in a Web browser, type http://your_fully_qualified_server_name:desired_console_port/admin, where your_fully_qualified_server_name is the fully qualified host name for the machine that contains the administrative server and desired_console_port is the port on which you want the Administrative Console to run (typically port 9080 or 9090). See the article Starting and stopping the administrative console for more information.

Related reference
Following the customized Security Domain Configuration instructions
Following the customized Application Server node instructions
Following the customized integral JMS provider instructions
Following the customized deployment manager node instructions
Following the customized Federate base Application Server node instructions
Following the customized Web services gateway instructions[5.0 only][Version 5.0.1][Version 5.0.2]
Following the customized v5.0 License Agreement Refresher instructions[5.0 only][Version 5.0.1][Version 5.0.2]



Searchable topic ID:   tinsruncust
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/tins_runcust.html

Library | Support | Terms of Use | Feedback