Viewing and Maintaining a Job Network Diagram

Diagrams are provided for instances of a network master or an active network/job run. Diagrams can be used to view and edit a defined network or define a new network.

Note:
You can customize the diagram view by changing the Diagram settings in your user profile described in the Administration documentation.

Start of instruction setTo view a network diagram

  1. In the object workspace, select a Network Master instance or an Active Run instance.

  2. Open the context menu and choose the Diagram function.

    Depending on the node instance selected, a Diagram Network Master or Diagram Active Run window (see Examples of Diagrams) opens with a graphical view of the selected network.

    The symbols used to represent the network components are described in Explanations of Diagram Symbols.

    You can view and rearrange all network components as described in Maintenance Functions for Diagrams.

This document covers the following topics:


Explanations of Diagram Symbols

This section describes the symbols available in a diagram and indicates when a symbol only applies to an active job run.

The display of the symbols in the diagram graphic depends on whether the Use new design option is set (default) in the user profile (see the Diagram page described in Administration documentation). In general, the new design is characterized by gradient symbol colors and icons that identify specific reasons for an active job run that ended not ok.

The information provided with a diagram symbol can exceed the size available to display text. In addition, a complex network can contain very small symbols impossible to read without zooming because the size of the diagram is adjusted to the size of the network. Therefore, tooltips for annotations are provided for all symbols so you can always view the complete information in a readable form.

Symbol Description

graphics/diagram_job_standard.png

Job.

Common entries are:

graphics/diagram_job_suffix.png

Multiple suffix job (here: suffix symbol MULT-01 in the symbol table EXA-SYMBOL).

graphics/diagram_milestone_start.png

Milestone job that performs as the first network job.

In addition to the job special type, a milestone job has one or more (separated by slashes) of the following specifications:

 
User-defined milestone:
B Milestone job, network begin
E Milestone job, network end
I Milestone job, other
System milestone:

(used in active jobs only)

1 Milestone job, network begin
2 Milestone job, network end

graphics/diagram_milestone_any.png

Milestone job that performs in no particular job order.

graphics/diagram_milestone_end.png

Milestone job that performs as the last network job.

graphics/diagram_job_network.png

Job with type Subnetwork (NET), here named SUBNETJOB1.

graphics/diagram_condition.png

Condition.

Indicates the condition name (here: READ-DATA-OK) and the condition reference (here: RUN).

graphics/diagram_external_condition_new.png

External condition (new design) from another network.

Common entries are:

  • Condition name (here: INPUT-1-OK)

  • Condition reference (here: RUN)

  • Network owner (here: SAGTEST)

  • Network name (here: DOC-ND-M-1)

graphics/diagram_external_condition_old.png

External condition (old design).

graphics/diagram_resource.png

Resource (here named FTP-SERVER-1).

graphics/diagram_condition_reset.png

Reset condition.

graphics/diagram_condition.png

Set condition.

graphics/diagram_job_end.png

Successfully ended job.

graphics/diagram_job_waiting.png

Job waiting for execution.

(active run only)

graphics/diagram_job_running.png

Running job.

(active run only)

graphics/diagram_job_hold.png

Job in hold or suspended after changes to the job definition.

(active run only)

graphics/diagram_job_error.png

Job ended not ok.

(active run only)

graphics/diagram_clock_icon.png

Job ended not ok for one of the following reasons:
  • Job missed the latest start time and/or deadline defined in the Scheduling Parameters of the job.

  • Latest start time and/or deadline defined in the Network schedule does not allow job execution.

  • Job exceeded latest start time for one of the above reasons.

(shown in the new design and for the active job only)

graphics/diagram_x_icon.png

Job ended not ok because network activation was canceled by the user.

(shown in the new design and for the active job only)

graphics/diagram_exclamation_icon.png

Job ended not ok for any reason except graphics/diagram_clock_icon.png and graphics/diagram_x_icon.png explained above.

(shown in the new design and for the active job only)

The background colors used for the symbols denote the following:

Color Explanation
yellow The job waits for its execution. If the allowed execution time is exceeded, the job is considered as ended not ok and the symbol changes to red.

(active run only)

green The job is currently executing.

(active run only)

light green The active job is affected by
  • an explicit hold function

  • an active regenerated JCL

  • a file/member that is changed in the active job definition.

(active run only)

light yellow The job ended ok.
red The job ended not ok, for example, due to a JCL load error or an execution timeout.

(active run only)

light grey The condition is set.
dark grey The condition is not set.

Maintenance Functions for Diagrams

This section describes the functions available in a network diagram and indicates whether a function can only be used in a master network (master only) or an active run.

The following functions are available within the free space area of the diagram:

Function Description
Arrange Rearranges the objects of the diagram automatically.
Refresh Refreshes the presentation of the diagram. You can also use F5.
Auto Refresh You can:
  • start/stop automatic refresh

  • change the interval of automatic refresh

Note:
Changes to the refresh settings remain valid for the diagram in the active window only. For persistent changes, modify the Automatic Refresh settings in your user profile (see the Administration documentation).

Object Filter You may switch on/off:
  • Condition nodes

  • Resource nodes

Note:
Changes to the filter settings remain valid for the diagram in the active window only. For persistent changes, modify the Filter settings in your user profile (see the Administration documentation).

Tooltip You can customize the information displayed in tooltip:
  • For Job it is possible to switch the display on/off for Name, Type, Status (only in active run), Node, Symbol Table, Suffix symbol, Subnetwork, Job ID (only in active run).

  • For Condition it is possible to switch the display on/off for Name, Status (only in active run), Reference, Type, Suffix symbol, External network.

  • For Resource it is possible to switch tooltip on/off.

  • For Connector it is possible to switch the display on/off for source and target.

Note:
Changes to the tooltip settings remain valid for the diagram in the active window only. For persistent changes, modify the Diagram settings in your user profile (see the Administration documentation).

Find Opens a search dialog where you can enter a search string. You can also use CTRL+F.

See also To search for a string.

Find Next Finds the next occurrence of a search string entered in the search dialog. You can also use F3.

See also To search for a string.

Create Job Adds a new job to the network. A Create new Job Master (see Adding a Job Definition) or Create new Job Active (active run only; see Adding a New Job to the Active Network) window opens to add a new job to the network.
Create Condition

(master only)

Adds a new condition. Proceed as described in To add and link a condition.
Create Active Condition

(active run only)

Opens the Condition Active window to add a new active condition.
Paste

(master only)

Paste a job object in the current network. See Pasting Objects - Paste Data Function.
Browse Log Opens the Entire Operations log for the network or active run shown in the active diagram window or a symbol selected in the active diagram. The log only contains data relevant for this network or run.

See also the Browse Log function that can be performed on a selected node in the tree view of the object workspace.

Page Setup Opens a dialog where you can specify the page setup for printing the current diagram.
Printer Setup Opens a dialog where you can specify your printer settings.
Print Preview Opens a print preview where you can check if the diagram is laid out for printing according to your preferences.
Print Opens a dialog where you can send the diagram to a printer.
Zoom You have the following possibilities to zoom the diagram:
  • in: makes the diagram larger

  • out: makes the diagram smaller

  • selection: zooms in/out single or multiple diagram symbols selected in the diagram. You can select single or multiple elements with CTRL+LEFT MOUSE BUTTON or by dragging the left mouse button over a group of adjacent symbols.

  • complete: shows the complete diagram on the screen

  • original: shows the diagram in its original size

Show World View Opens a separate window with a minimized view of the complete diagram for easy navigation in complex diagrams. The green frame outlines the current viewport in the associated diagram. You can move the green frame to change the viewport in the diagram.
Show Legend View Opens a separate window with a minimized view of the symbols used in the diagram for a quick overview of the objects (for example, resources and conditions) used in the job network.
Export Graphic Opens a dialog where you can save the diagram on your hard disk.

The following functions are available for a job symbol selected in the diagram:

Function Description
Open Displays the currently selected job (box) and opens the Job Master or Job Active (active run only) window. Here, you can perform changes on the job.
Display Displays the currently selected job (box) in the Job Master or Job Active (active run only) window.
New Creates a new job (box) and opens the Create new Job Master (see Adding a Job Definition) or Create new Job Active (active run only; see Adding a New Job to the Active Network) window.
Delete

(master only)

Deletes the currently selected job (box). See Deleting Objects - Delete Function.
Copy data

(master only)

Copies the currently selected job (box). See Copying Objects - Copy Data Function.
Paste data

(master only)

Pastes the currently selected job (box). See Pasting Objects - Paste Data Function.
Usable Symbol Tables Lists all symbol tables that can be used by the job. See also Listing Usable Symbol Tables in the section Symbol Table and Symbol Maintenance.
Deactivate

(active run only)

You can cancel the planned activation of a job in a planned network run that is waiting for activation.
Hold

(active run only)

If the job has already been submitted to the operating system, it will be held in the operating system.
Release

(active run only)

Releases a job from hold status.
Cancel

(active run only)

The active job is cancelled.
Resubmit

(active run only)

After a job has terminated, you can modify and resubmit it while it is still in the active database. This function is useful after a job has failed.
Reactivate

(active run only)

Reactivates a job.
Browse Master JCL

(master only)

Browses the master JCL. See Displaying Master JCL.
Browse Active JCL

(active run only)

A window opens where, you can see the actual JCL submitted to the operating system for execution. It is produced from the Master JCL when the job or network is activated. The symbols are replaced with values from the active symbol table. If it is dynamic JCL, the generation is performed at this time. The active JCL is stored in the active Entire Operations database.
Edit Master JCL

(master only)

Edits the master JCL. See Editing Master JCL and Natural Sources.
Edit Active JCL

(active run only)

A window opens where you can view and edit the active JCL of the job.
Regenerate Active JCL

(active run only)

Regenerates the JCL while the job is in the active database.
Stop cyclic execution

(active run only)

Stops execution of currently running cyclic job.
Modify Latest Start

(active run only)

See Modifying the Latest Start Time for an Active Run in the section Active Job Networks.
Release edit lock

(active run only)

Removes a lock from active JCL: see Release edit lock in the section Active Job Networks.
Pregenerate Active JCL

(master only)

See Pregenerating Active JCL.
Remove pregenerated Active JCL

(master only)

See Removing Pregenerated JCL.
Edit pregenerated JCL

(master only)

See Editing Pregenerated JCL.
Browse SYSOUT

(active run only)

A dialog opens were you can view the SYSOUT of an active job. See Viewing Job SYSOUT.
Extended Log / JCL

(active run only)

A screen opens, where you can see the JCL which was submitted for this job.
Extended Log / SYSOUT

(active run only)

A screen opens, where you can see the SYSOUT of the job.
SYSOUT Messages

(active run only)

A screen opens, where you can see the SYSOUT messages of the job (z/OS only).
Activate Job

(master only)

Opens the Activation dialog where you can activate the currently selected job (box).
Open Subnetwork

(active run only)

Opens the subnetwork Network Master dialog for a subnetwork (Job with type Subnetwork).
Subnetwork diagram Opens the Network diagram for a subnetwork (Job with type Subnetwork).
Zoom Subnetwork Opens a list of jobs for a subnetwork (Job with type Subnetwork).
Waiting for

(active run only)

See Displaying Prerequisites for Active Jobs: Waiting for in the section Active Job Networks.
List Active Jobs See Listing Active Jobs.
Browse Log Opens the log for the currently selected job (box). See Displaying Logged Information - Browse Log Function.
Export

(master only)

See Exporting Objects in the Import/Export Functions documentation.
Add to Workplan Adds an object to the workplan. See also Add to Workplan.

Connecting Lines

The following functions are available for the relationships (connecting lines) within the diagram:

Function Description
Set Input Condition

(active run only)

Sets the input condition.
Reset Input Condition

(active run only)

Resets the input condition.
Delete

(master only)

Deletes the currently selected relationships between the objects.
Open Network

(master only)

Opens the corresponding network maintenance dialog (see Modifying a Network Definition) for an external input condition.
Network Diagram

(master only)

Opens the corresponding network diagram and to position diagram view to the proper condition for an external input condition.
Open Input Condition

(master only)

Opens the Condition dialog. Here, you can perform changes on the currently selected input condition.
Open Output Condition

(master only)

Opens the Condition dialog. Here, you can perform changes on the currently selected output condition.

Editing and Navigating in the Network Diagram

This section provides instructions for using the diagram editor functions to maintain objects for a network and find a particular object in the diagram.

Start of instruction setTo add and link a condition

  1. From the context menu in the Diagram Network Master window, choose Create Condition.

    A square symbol appears indicating the position where the new condition will be placed in the diagram.

  2. In the free space of the diagram, left-click on the position where you want to place the new diagram symbol.

    A Create Condition dialog appears.

  3. Enter a valid condition name and choose OK.

    The new condition is added to the diagram as a temporary (TMP) object, without any logical job links as shown in the tooltip information for the condition symbol.

  4. Drag the selected condition and drop it onto the job to which you want to link the new condition as a logical input condition.

    An Add new Input Condition window similar to the example below opens:

    graphics/add_inputcondition.png

  5. Enter the required definitions. The fields and options in the window are described in Fields and Selection Options: Input Condition in the section Job Maintenance.

  6. When you are finished, choose OK.

    The new condition is linked to the job as indicated by the connecting line between the job and the condition symbol and the tooltip information for the symbols.

Start of instruction set To create an output condition

  1. Select a job.

  2. Drag the job and drop it onto a condition.

  3. Select a branch (All Checks ok or Any Check not ok) to which the condition should be assigned.

Start of instruction set To link two jobs

  1. Select a job.

  2. Drag the job and drop it onto a job.

  3. Select a branch (All checks ok or Any check not ok) to which the condition should be assigned.

Start of instruction setTo search for a string

  1. Call the search dialog by pressing CTRL+F or by choosing the Find function from the context menu:

    graphics/search_diagram.png

  2. Fill in your search criteria. You can specify the search string, object type where the string is searched as well as the attribute of the object where to be searched. An asterisk ("*") is not interpreted as a wild card.

  3. Choose OK.

Examples of Diagrams

Example of a Diagram Network Master (New Design)

graphics/diagram.png

Example of a Diagram Active Run (New Design)

graphics/diagram_activerun.png