Overview

Before you can perform these steps, you have to be authorized to create sb tasks in sb prod.

To receive authorization, contact the Stonebranch team and ask to be authorized.

• For Stonebranch to initiate batch jobs, you need at least three Stonebranch objects:

• A sb credentials object
• A sb cron trigger (or time trigger) to schedule when the batch jobs should be initiated
• A sb z/OS task to kick off the mainframe task

• You will also most likely need a sb workflow task.

Examples of logic that was in TM, but now needs to be programmed into a sb workflow:

• order of jobs, or submit multiple jobs at same time
• if hold or proceed if previous job abends

Create Credentials Object

Use your Logon ID and password.

Note: Every 45 days, when you change your logon ID password, you must immediately go to the sb prod interface and change the password here too. If you don't, any job using that sb credentials object will fail.

Create z/OS Tasks

Give the task a name with the following format:

It is helpful to include, in the name of the z/OS task, the name of the UEDIT JCL file that the task runs.

You may also want the task name to include the name of the Natural environment you are running. (Jobs in all mainframe environments are initiated from stonebranch prod. So you will want to be able to distinguish the sb tasks when you see the names in a list in the sb interface.)

Specify Credentials

• JCL location: CE.LIBRARY(FILENAME)
• Set "0" for the exit code success range.

Create SB Workflow

1. Create a new workflow, then click Edit workflow.
2. Use the binoculars icon to search for tasks you want to include. Drag the tasks from the Found Tasks window to the main workflow window.
3. Click once on the arrow icon, then drag from the first task you want to run to the second task you want to run. The default for an arrow is "success", i.e. the second job runs if the first is successful.
4. Click the little save icon, which looks like a floppy disk, to save changes to the workflow.

Create Cron Trigger

1. Give the cron trigger a name in the following format:

The name should include the Natural environment that is triggered.

2. Select System Default as the calendar.
3. In Tasks, choose the workflow you want to initiate.
4. Enter the minutes, hours, day of month, etc., when you want the task to run.
5. The minutes will be applied to every hour. So if you enter 15 for minutes, and 6 and 14 for hours, your job will run at 6:15 am and 2:15 pm.
6. Click Save or Update as appropriate.

7. To test it is working . .  .CONTINUE HERE. MAKE THE SYSTEM stop later in the process. Because T,Q,P all run here. it's possible you could make a typo when creating the prod one. 

~

BITS NOT NEED IN THIS DOCUMENTATION  

things you need to get set up and authorized for, to be able to set up this system

--authorized to "promote" sb objects between environments

--SB environments set up:

        --agent for each environemnt

       --agents organized into "promotion chains" (is that the term?)

        --agents in agent clusters

       --each agent you install on a server, you have to get firewall set up .

 --you want to organize your sb tasks into "promotion bundles", so you can promote a bunch at once.