WebSphere Application Server Version 6.1 Feature Pack for Web Services
             Operating Systems: z/OS

             Personalize the table of contents and search results
This topic applies only on the z/OS operating system.

Creating the customization jobs and files

Before you begin

You must select configuration data sets to use and complete the process of defining variables for this task. See Choosing configuration data sets and Setting the customization variables: Federated application server node for more information.

About this task

The Customization Dialog creates customization batch jobs and data files, based on the variable values you specified in the dialog. The batch jobs and data sets will be written to the config_hlq.CNTL and config_hlq.DATA configuration data sets that you created with the "Allocate target data sets" option.

Procedure

  1. Ensure that the configuration data sets are allocated and not in use.
    Note: Editing a member in config_hlq.CNTL or config_hlq.DATA will cause this task to fail.
  2. On the "Federate stand-alone application server Node" panel, type the appropriate number in the Option field to select "Generate customization jobs" and press Enter. You will have one of two results:
    • Result A: If all variables are defined correctly, you see the "Specify Job Cards" panel, which looks similar to this:
      ------------  WebSphere Application Server for z/OS Customization     --------
      Option  ===>                                                                  
                                                                                    
      Generate Customization Jobs                                                   
                                                                                    
       This portion of the Customization Dialog generates the jobs you must         
       run after you complete this Dialog process. You must complete the            
       customization process before you generate the jobs with this step.           
       If you have not done this, please return to that step.                       
                                                                                    
       Jobs and data files will get generated into data sets:                       
         'hlq.CNTL'                                                                 
         'hlq.DATA'                                                                 
       If you wish to generate customization jobs using other data sets, then       
       exit from this panel and select the "Allocate target data sets" option.      
                                                                                    
       All the jobs that will be tailored for you will need a job card.             
       Please enter a valid job card for your installation below. The               
       file tailoring process will update the jobname for you in all the            
       generated jobs, so you need not be concerned with that portion of            
       the job cards below. If continuations are needed, replace the                
       comment cards with continuations.                                            
                                                                                    
       Specify the job cards, then press Enter to continue.                         
                                                                                    
       //jobname  JOB (ACCTNO,ROOM),'userid',CLASS=A,REGION=0M                      
       //*                                                                          
       //*                                                                          
       //*                                                                          
      Note: Pay particular attention to the displayed target data sets. Make sure that they are the ones you intend to use.
    • Result B: If the variables are not defined correctly, you will see the "Verification" panel. Decide whether the warnings or errors are serious enough to warrant returning to the "Define variables" option.
      Note: If the return code is 8 or greater, return to the "Define variables" option and fix the uncovered problems. If you saved the variables previously, be sure to re-save them after making any updates.
  3. Fill in the job card information, according to your installation requirements. For each job, the dialog generates a jobname and the "JOB" keyword to match the member name of the PDS, but you specify the rest.
    Note: If you need to run these jobs on a particular system in the sysplex (for example, JES2 MAS or JES3 complex), you should specify the necessary Scheduling Environment (SCHENV), JES2 JOBPARM, or JES3 //*MAIN statement at this time.
    Example of a job card entry:
    //jobname JOB 1234,USER1,NOTIFY=????,MSGCLASS=O,REGION=0M
    //*             USER=SYSADM1,PASSWORD=SYSADM1
    /*JOBPARM SYSAFF=SYSB
    Note: This example is useful for jobs that require a user ID other than that of the logged-on TSO user. (This is typically a user ID with UID=0.) In that case, you can just put a comma at the end of the first line, put in the correct user ID on the second line, then uncomment that second line.
    You might want to use RACF SUBMIT authority to avoid having to keep passwords in your configuration data sets.
  4. Fix any errors. If there are errors anywhere, you will see the "Error" panel. Press PF3 to exit the error panel, then enter the correct panel to fix the errors. Then return to the "Generate Customization Jobs" option and pick up where you left off. If necessary, you can update the variables and rerun this option. The generation process will delete and re-tailor all the members.
    Note: Compress the configuration data sets before you rerun this option.

Results

You are done when all the jobs are generated. You can move ahead to viewing the generated jobs. See Following the generated customization instructions: Federated application server node for more information.
Task topic    

Terms of Use | Feedback

Last updated: Nov 25, 2008 2:35:59 AM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.wsfep.multiplatform.doc/info/ae/ae/tins_dialogsteps_createjobs5.html