...
Step 1 | Open the z/OS task. |
---|
Step 2 | In the Parameters field, click the + icon. |
---|
Step 3 | Add a parameter in the following format: - Name is the name of a variable preceded with
@ . For example: *@DATE1 . - Value is the value you want to set to the variable. For example:
20110601 .
|
---|
Step 4 | When the JCL is submitted for execution, the parameter *@DATE1 (shown in the following example) will be substituted with the value 20110601 in the JCL or in any in-stream data. The example also shows the *@DATE1 parameter being used in an in-stream data and in a JCL IF statement: Panel |
---|
Html bobswift |
---|
<pre>
//INPUT DD *
@DATE1
/*
</pre> |
|
Panel |
---|
Html bobswift |
---|
<pre>
//AIF IF @DATE1 > 20110101 THEN
</pre> |
|
If a Universal Controller parameter must be concatenated with a non-space character, end the parameter name with a period (.). The example below uses the *@DATE1 parameter concatenated with a non-space character in an in-stream data set: |
---|
...
Html bobswift |
---|
<pre>
//INPUT DD *
DATE@DATE1.ACT9898
/*
</pre> |
|
|
Anchor |
---|
| Skipping Steps during Initial Run |
---|
| Skipping Steps during Initial Run |
---|
|
Skipping Steps during Initial Run
...
Step 1 | On the Activity Monitor, click the Details icon next to the Instance Name of the task you want to re-run. The z/OS Task Instance Details displays. |
---|
Step 2 | Click the Restartable Job Steps tab to display a list of all job steps in the task.
Check the Restartable column to see from which steps you can start the re-run (Yes or No). If applicable, the Failed column indicates at which step(s) the task failed. |
---|
Step 3 | Assuming any failures were caused by error(s) in the JCL, examine the JCL and make your corrections. The Controller uses a background process to determine whether changes have been made to the JCL. Any changes trigger a confirmation process. |
---|
Step 4 | Click the Details icon next to the Step Number of any step to see detail information about that step.
|
---|
Step 5 | From the Restartable Job Steps list, select the steps that you want included in the re-run: <Shift> Action menu (You also can right-click a step and select Select to End for Re-run to include that selected step and all following steps in the re-run.) If you want to de-select a job step in the group for inclusion in the re-run, right-click the step and, in the Action menu, click Deselect for Re-run. |
---|
Step 6 | Click the z/OS Task Instance tab to redisplay the z/OS Task Instance Details. |
---|
Step 7 | Click the Re-run button to re-run the task for the selected job steps. |
---|
Step 8 | If you have made changes to the JCL, the task instance goes into a status of Confirmation Required on the Activity Monitor. To confirm the changes: - From the Activity Monitor, open the task instance.
- Click the Confirm JCL Changes tab to display a list of all changes that were made to the JCL.
- Click the Confirm button at the top of the list.
- Click the z/OS Task Instance tab. Verify that the JCL Changes Confirmed field is checked and then click the Re-run button.
Note |
---|
| If a z/OS task instance transitions into the Confirmation Required status, and the Controller determines that the number of steps did not change, it preserves the step re-run selection. However, if the Controller detects a change in the number of steps, all steps will be de-selected. |
|
---|
Step 9 | After the re-run is complete, the Failed column in the Restartable Job Steps list should show No for each step. Note |
---|
| If you repeat the above process on the same task instance, the previous list of JCL changes, if any, is replaced with the most recent list of changes. |
|
---|
...
The following table describes each column on the z/OS Restartable Job Steps list.
Column Name | Description |
---|
Step Number | Number assigned to this step by the Controller. |
Anchor |
---|
Restartable | Restartable | Restartable Html bobswift |
---|
<ol>
<li> Click the first step that you want included in the re-run.
<li> Press and hold the |
<Shift> Html bobswift |
---|
key.
<li> Click the last step that you want included in the re-run.
<li> Right-click any step in the selected group to display an |
Action menu Html bobswift |
---|
.
<li> Click <b>Select for Re-run</b>.
</ol> |
(You also can right-click a step and select Select to End for Re-run to include that selected step and all following steps in the re-run.) If you want to de-select a job step in the group for inclusion in the re-run, right-click the step and, in the Action menu, click Deselect for Re-run. |
Step 6 | Click the z/OS Task Instance tab to redisplay the z/OS Task Instance Details. |
---|
Step 7 | Click the Re-run button to re-run the task for the selected job steps. |
---|
Step 8 | If you have made changes to the JCL, the task instance goes into a status of Confirmation Required on the Activity Monitor. To confirm the changes: - From the Activity Monitor, open the task instance.
- Click the Confirm JCL Changes tab to display a list of all changes that were made to the JCL.
- Click the Confirm button at the top of the list.
- Click the z/OS Task Instance tab. Verify that the JCL Changes Confirmed field is checked and then click the Re-run button.
Note |
---|
| If a z/OS task instance transitions into the Confirmation Required status, and the Controller determines that the number of steps did not change, it preserves the step re-run selection. However, if the Controller detects a change in the number of steps, all steps will be de-selected. |
|
---|
Step 9 | After the re-run is complete, the Failed column in the Restartable Job Steps list should show No for each step. Note |
---|
| If you repeat the above process on the same task instance, the previous list of JCL changes, if any, is replaced with the most recent list of changes. |
|
---|
Anchor |
---|
| Restartable Job Steps List Column Descriptions |
---|
| Restartable Job Steps List Column Descriptions |
---|
|
Restartable Job Steps List Column DescriptionsThe following table describes each column on the z/OS Restartable Job Steps list.
Column Name | Description |
---|
Step Number | Number assigned to this step by the Controller. |
| If the JCL job fails, the Controller determines the latest step that you can restart from. Yes indicates that you can restart from this step. |
Anchor |
---|
| Selected for Re-run |
---|
| Selected for Re-run |
---|
|
Selected for Re-run | Indicates (Yes or No) whether or not this step has been selected for re-run (the Selected for Re-run field is enabled in the Restartable Job Steps Details). |
| Specifies which other step(s), if any, must be completed successfully before you can run this step. |
Step | Name of the JCL step (extracted from the JCL). |
Procedure | Procedure step name from within the JCL step. |
Program | Name of the program being executed by the step. |
Step Code | Extracted from the JCL. Exit code for this step of the program. |
Failed | Indicates (Yes or No) whether or not this step failed. |
Updated By | Name of the user that last updated this step. |
Updated | Date and time that this step was last updated. |
...
For example, the JCL shown below contains CA7 Scheduled Overrides statements #JI and #JEND. This JCL will set CLASS =A if the SCHID is between 1 thru 39, and set CLASS=B if the SCHID is between 40 thru 79. The user can set the SCHID by entering it into the Schedule ID field. The Agent scans for #JI and #JEND, and generates the appropriate JCL, as shown in the following example.
Panel |
---|
Html bobswift |
---|
<pre>
//SCHID JOB (IMS,001),JIM,MSGCLASS=X,MSGLEVEL=(1,1),NOTIFY=&SYSUID,
#JI,ID=1-39
// CLASS=A
#JEND
#JI,ID=40-79
// CLASS=B
#JEND
//S1 EXEC PGM=IGWSPZAP
//SYSLIB DD DSN=OPS01.JS01.LOAD,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DUMPT WMSSETRC WMSSETRC
/*
//
</pre> |
|
Anchor |
---|
| Non-Restartable Job Steps |
---|
| Non-Restartable Job Steps |
---|
|
Non-Restartable Job Steps
...