Previous Topic: Define a z/OS-Data Set Trigger JobNext Topic: Define a z/OS-Regular Job

Working with Workload Objects › z/OS Jobs › Define a z/OS-Manual Job

Define a z/OS-Manual Job

You can define a z/OS-Manual job to create dependencies on z/OS jobs that are submitted outside the scheduling manager, such as a job that is submitted manually by a user. After the manually submitted job completes, the server releases the successors of the Manual job.

Note: To run these jobs, your system requires CA WA Agent for z/OS.

If more than one generation of the Application is active when a manually submitted job completes, the server posts the Manual job as complete in all active Applications.

To define a z/OS-Manual job

  1. Open the Application that you want to add the job to in the Define perspective.

    The Application appears in the workspace.

  2. Select the z/OS-Manual job from the z/OS group in the Palette view, and drag the job to the workspace.

    The z/OS-Manual icon appears on the Application workspace view.

  3. Right-click the z/OS-Manual icon, and select Edit from the pop-up menu.

    The Basic page of the z/OS-Manual dialog opens.

  4. Complete the following required fields:
    Name

    Defines the name of the job submitted outside CA Workload Automation DE.

    Agent name

    Specifies the name of the agent that monitors the manually submitted job.

    z/OS user ID

    Specifies the z/OS user ID that owns the job on z/OS.

  5. (Optional) Specify the following additional information:
    Authorization string

    Defines the authorization string the server uses to post the correct job. The server posts the Manual job complete when the manually submitted job runs under the corresponding user ID.

    Note: Contact your agent administrator to confirm whether the agent checks the authorization string. Depending on the scenario, the action to take differs as follows:

    • If authorization checking (AUTHSTR) is not set up for this agent, do not use this field.
    • If authorization checking (AUTHSTR) is set to RACUSER, enter the user ID that owns the job.
    • If authorization checking (AUTHSTR) is set to ACCOUNT1, ACCOUNT2, ACCOUNT3, or ACCOUNT4, enter the value found in the corresponding position of the job's JCL. For example, if AUTHSTR is set to check the ACCOUNT2 field, enter the value found in the second accounting position in the job's JCL.
    Search backward

    Defines the number of hours and minutes, in the format hhh:mm, that the agent does a backward search for a manually submitted job.

    Limits: 546 hours

    Example: 000:30

  6. Click OK.

    The z/OS-Manual job is defined.

Example: Post z/OS Manual Job Complete Based on the User ID

Suppose that you want to post a z/OS Manual job complete when the manually submitted job ABC runs under CYBER. The ZOS1 agent monitors job ABC.

To post z/OS Manual job complete based on the user ID

  1. Enter the following information in the Basic page:
  2. Click OK.