Define a z/OS job from the Flow Editor

Procedure

  1. Click the application icon to put the Flow Editor into application placement mode and select z/OS job. The application icon appears in the workspace.
  2. Double-click on the application icon to define the job. The Application Definition- Edit Application display appears.
  3. On the General tab, fill out the following fields:

    1. In the Name field, specify a unique, meaningful name for the job in the flow.

    2. Optional: In the Description field, add any descriptive text that may be used for managing this job within the flow.

    3. In the z/OS host name field, specify the name of the mainframe host to run the job on.

    4. In the Login user ID and Password fields respectively, specify a valid user ID and password under which to log into the mainframe host to run the job.

    5. In the JCL file field, specify the full path to the JCL to run. This file will be sent to the mainframe host.

    6. In the Output file field, specify the full path to the output file to receive the z/OS® job output.

    7. Optional: In the Estimated run time (in minutes) field, you may specify the approximate number of minutes the job is expected to take to run. The default is 1 minute.

    8. Optional: In the Check interval (in minutes) field, you may specify the number of minutes to wait in between checking for the job output. The default is 1 minute.

    9. Optional: In the Time out (in minutes) field, you may specify the number of minutes to wait before assuming the job failed. The default is 0, or no timeout period.

  4. Optional: On the Execution Environment tab, you may fill out one or more of the following fields:

    1. If you want to submit your job to a particular queue, in the Submit to queue/partition field, specify the queue name. Ensure that the JCL is accessible from any host in the queue you specify.

    2. If you want to run the proxy LSF® job on a specific host, in the Run on host field, specify the name of the host. Ensure that the JCL is accessible from the host you specify.

  5. When you have completed filling in the fields, click OK. Draw any dependencies as required.

Results

The job output is in the following format:

  • The first column displays the job name.

  • The second column displays the job ID

  • The third column displays the status of the job, where valid status is OUTPUT. Additionally, the status displays the number of files spooled for output.

    If no output is returned from the job, the job is presumed to have failed.

Required fields

When defining a z/OS job, the user is required to enter the following fields:

  • z/OS host name—the name of the mainframe host to log into

  • login user ID—the user ID under which to log into the mainframe host

  • Password—the password used to validate the login user ID on the mainframe host

  • The full path to the JCL to submit

  • The full path to the output file to receive the z/OS job output

  • (a single spool file—any existing file will be overwritten)

    The JCL and output file names must be accessible to the LSF execution host