Job Submit

The Job Submit element can be used to start a JCL job at the host and wait until it completes. This can be useful to setup or teardown a test scenario. The test Scenario will fail if the job fails.

Add Job Submit to the Test Scenario by dragging it from the tool palette. This opens the Edit the selected Job Submit element popup. Here are the fields available when setting up this element.

On the Job tab:

• Label - this is the label name you want assigned.
• Description - an optional description of the Test Element.
• JCL Location - supply one of these options:
• Job Definition ID - the Job ID references a Job Definition in the repository. Type in the Job Definition ID or drag and drop it from the repository.
• Variable substitution occurs inside the JC
• Dataset Name - this is the location of the JCL. This option will execute JCL located at the host. The JCL can be located in a dataset member like MY.DATASET.NAME(XADJOB01) or a JCL located in a sequential dataset like MY.DATASET.NAME.SEQJCL. The Job card definition must be included in the JCL.
• Dataset name variable substitution is for the name of the data set
• Specify JCL - this is the JCL to be sent to the host and executed. The JCL can be any JCL used for submitting jobs, but the Job card definition should be excluded as the Total Test Host server dynamically creates this.
• Variable substitution occurs inside the JC
  
  • Job name - an optional attribute used to specify the name of the job that is executed at the host. This is used for visually showing the job in editors as well as writing information in the execution log.
• On the Verify tab:
  • Stop execution when verification errors - check this box to stop execution of the test case when there is a mismatch of the expected return, system abend, and user abend codes.
    
    For each of the following verification fields, either write the expected value or write an expression to verify the values. Refer to the bottom half of the Verify tab for examples of return code or abend code values or expressions.
• Verify return code - specify the expected return code or return code expression.
• Verify system abend code - specify the expected system abend system abend expression.
• Verify user abend code - specify the expected user abend user abend expression.
• On the Xpediter tab:
  • Job name - will default be "hostuserid"+J if type Job Definition ID or Specify JCL is selected. Mandatory for job location in dataset or if job card is included in the JCL.
  • JCL Step - the step in the job where code coverage is going to be collected.
  • Main program - the main program where code coverage is going to be collected.
  • Program type - select Batch, Db2, or IMS.

• OK / Cancel - click on OK to save your element.