Maintaining Active Job Networks

#### Search Results

Search

# Maintaining Active Job Networks

- Listing Active Job Networks

- Deactivating Active Job Networks

- Repeating Active Job Networks

- Displaying Operating System Information on Active Tasks

- Listing Next Network Activations

- Viewing the Execution History of an Active Network

## Listing Active Job Networks

To list all active job networks of an owner

- Select the Active Job Networks option from the Main Menu.

  An Active Job Networks screen like the example below appears:

       12.03.18                ***** Entire Operations *****                11:28:47
       Owner EXAMPLE                 Active Job Networks
       Selection OR________
      -------------------------------------------------------------------------------
       Cmd Runs Owner      Network    Node  Description
                *--------- *--------- *----
       _ P   *  EXAMPLE    B60-FLOW   N0031 Job Flow, BS2000
       _     *  EXAMPLE    E01-CONTI  N0148 Completion-Codes, Job Duration
       _ P   *  EXAMPLE    E60-FLOW   N0146 Job Flow, MVS
       _ P   *  EXAMPLE    Z60-FLOW   N0146 Job Flow, MVS

       ******************************* Bottom of Data *******************************
        A Active Jobs N Deactivate Network P Description R Repeat
        S Act.Jobs Schedule T Accounting X History
       Command => ____________________________________________________________

      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help        End                     Up    Down  ATask All   NxtAc Menu

This section covers the following topics:

- Listing a Selected Range of Networks

- Columns: Active Job Networks

- Line Commands: Active Job Networks

- Special PF Keys: Active Job Networks

### Listing a Selected Range of Networks

You can specify the range of networks to be listed by entering filter criteria in the Selection field on the Active Job Networks screen and pressing ENTER. For more information, see Selecting a Range of Networks to be Listed in the section Network Maintenance.

### Columns: Active Job Networks

The following table explains the column headings for the data listed on the Active Job Networks screen:

Field | Description
--- | ---
Cmd | One-character line command input field. For possible input values, see Line Commands: Active Job Networks. Note The letter `L` (loop) appears between the Cmd and Runs columns if a loop was found during a loop test for the corresponding network. For further information, see the description of the field Loop.
Runs | Depending on your choice as described in Selecting a Range of Networks to be Listed and the Number of Active Runs Display Mode : The current number of active runs of this network. If there are more than 999 runs `>999` is shown. or An asterisk (`*`) which in this column indicates that one or more active job runs exist for the network.
Owner | Owner name for the network. For possible selection criteria, see Specifying Filter Criteria.
Network | Network name. For possible selection criteria, see Specifying Filter Criteria.
Node | Execution node specified for the network as the default for its jobs. For possible range specifications, see Specifying Filter Criteria.
Description | Short description of network as defined in the job network definition on the master database.

### Line Commands: Active Job Networks

The following line commands are available on the Active Job Networks screen:

Line Command | Description
--- | ---
`A` | List active jobs for the selected network. See Listing All Active Jobs for a Single Active Network.
`N` | Deactivate the selected network. See Deactivating an Active Job Network.
`P` | Display text description of selected network (browse mode only). See Viewing Long Descriptions of Active Jobs.
`R` | Repeat active network. See Repeating Active Job Networks.
`S` | Active jobs schedule. See Viewing and Modifying the Active Jobs Schedule.
`T` | Display job network accounting data. See Viewing Job/Network Accounting Information.
`X` | Display network execution history. See Viewing the Execution History of an Active Network.

### Special PF Keys: Active Job Networks

The following special PF keys are available on the Active Job Networks screen:

PF Key | Name | Function
--- | --- | ---
PF7 | Up | Scroll list backwards.
PF8 | Down | Scroll list forwards.
PF9 | ATask | List active tasks specific to the operating system. See Displaying Operating System Information on Active Tasks.
PF10 | All | List all active jobs on the All Active Jobs screen. See Listing All Active Jobs for All Networks.
PF11 | NxtSt | Next scheduled network activations. See Listing Next Network Activations and Displaying Next Network Starts (System-Wide) in the section Schedule Maintenance.

## Deactivating Active Job Networks

There are several ways of preventing or interrupting the execution of an active job network. These are described in the following section.

- Deactivation User Rights (Profile Settings)

- Deactivating Active Runs for a Network

- Deactivating all Networks

- Deactivation of planned Networks (Activation Cancelling)

- Stopping a Running Network

### Deactivation User Rights (Profile Settings)

Deactivation requires active job deletion user rights and either network master deletion rights or network activation rights. See User Definitions and Profile Settings in the Administration documentation.

### Deactivating Active Runs for a Network

If you wish to prevent Entire Operations from submitting active jobs for a network, you can deactivate a network before the first job run is performed.

To deactivate run numbers for active jobs in a selected network

1. On the Active Job Networks screen, type `N` (Deactivate Network) in the Cmd column next to the selected network, and press ENTER.

   A selection window opens with a list of job run numbers for the selected network together with the activation date:

        12.03.18                **** +-----------------------------------------------+
        Owner EXAMPLE                |                                               |
        Selection OR________         |  Owner EXAMPLE       Network B60-FLOW         |
       ----------------------------- |                                               |
        Cmd Runs Owner      Network  |  Please mark the run numbers, for which       |
                 *--------- *------- |  active jobs are to be deactivated.           |
        N P   *  EXAMPLE    B60-FLOW |  Then continue with 'Enter'.                  |
        _     *  EXAMPLE    E01-CONT |                                               |
        _ P   *  EXAMPLE    E60-FLOW |  Cmd   Run  Start Time                        |
        _ P   *  EXAMPLE    Z60-FLOW |   _   2715  05.03.18 07:30                    |
                                     |   _   2716  06.03.18 07:30                    |
                                     |   _   2717  07.03.18 07:30                    |
                                     |   _   2718  08.03.18 07:30                    |
                                     |   _   2719  12.03.18 07:30                    |
                                     |   _   2720  13.03.18 07:30 planned            |
                                     |   _   2721  14.03.18 07:30 planned            |
                                     |                                               |
        **************************** |                                               |
         A Active Jobs N Deactivate  |                                               |
         S Act.Jobs Schedule T Accou |                                               |
        Command => _________________ |                                               |
                                     |  PF3 End  PF7 Up  PF8 Down  PF9 Deact all     |
                                     |  PF9: Deactivate all visible runs.            |
                                     +-----------------------------------------------+

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        End                     Up    Down  ATask All   NxtAc Menu

2. In the Cmd column, type any character next to the job run number(s) you want to deactivate, and press ENTER.

   Or:
   Choose PF9 (Deact all) to deactivate all job run numbers listed in the window.

   If the active runs do not fit on one screen, it might be necessary to repeat this function several times.

   Note
   Be careful with PF9, because no confirmation is requested.

3. Choose PF3 (End) to close the window.

> Command Processing

>   - The message `in Progress` in the selection window indicates that the command has been accepted.

>     The message `planned` in the selection window indicates that the active job network is not completely activated. No active jobs exist in this state.

>   - Deactivation is performed by the Entire Operations Monitor in the background. A slight delay can occur during this operation.

>     If the Monitor is not active, you can deactivate a job using the Deactivation in Foreground option of Special Functions of the System Services Menu.

### Deactivating all Networks

The system administrator can stop the Entire Operations Monitor to halt the execution of all job networks. Jobs currently being executed continue until normal termination, unless they are explicitly cancelled from the operating system.

### Deactivation of planned Networks (Activation Cancelling)

If you try to deactivate a planned network activation, you will be prompted for confirmation:

    +----------------------------------------------+

    !                                              !
    !  Please confirm                              !
    !  the Deactivation of NET01-517 (4737)        !
    !  by entering NET01-517                       !
    !          ==> ______________________________  !
    !  PF3 End                                     !
    +----------------------------------------------+

You must confirm the deactivation by entering the network name here.

Note
Confirmation of deactivation of planned activations can be switched off globally by the setting the Confirm activation cancelling option on the Default Setting (3) screen of the Entire Operations defaults described in the Administration documentation.

### Stopping a Running Network

To interrupt a running network, add an input condition, e.g. `WAIT-HERE`, for the job before which the network is to stop running, and ensure that it will not be set. For more information, see Adding an Active Condition.

To restart the network at the point of interruption, you can manually set the input condition, or remove it from the active job definition (see Displaying and Modifying an Active Job Definition).

## Repeating Active Job Networks

Authorized users can repeat single or multiple active job network runs.

Only active jobs which were already executed will be repeated.

Active output conditions of these jobs will be reset prior to repetition.

To repeat or activate an active job network

1. On the Active Job Networks screen, type the line command `R` next to the network run you want to repeat or manually activate.

   A run number window like the example below opens:

        12.03.18                **** +-----------------------------------------------+
        Owner EXAMPLE                |                                               |
        Selection OR________         |  Owner EXAMPLE       Network B60-FLOW         |
       ----------------------------- |                                               |
        Cmd Runs Owner      Network  |  Please mark the network runs                 |
                 *--------- *------- |  to be repeated                               |
        R P   *  EXAMPLE    B60-FLOW |                                               |
        _     *  EXAMPLE    E01-CONT |                                               |
        _ P   *  EXAMPLE    E60-FLOW |  Cmd   Run  Start Time                        |
        _ P   *  EXAMPLE    Z60-FLOW |   _   2715  05.03.18 13:14                    |
                                     |   _   2716  06.03.18 13:14                    |
                                     |   _   2717  07.03.18 13:14                    |
                                     |   _   2718  08.03.18 13:14                    |
                                     |   _   2719  12.03.18 13:14                    |
                                     |                                               |
                                     |                                               |
                                     |                                               |
        **************************** |                                               |
         A Active Jobs N Deactivate  |                                               |
         S Act.Jobs Schedule T Accou |                                               |
        Command => _________________ |                                               |
                                     |  PF3 End  PF7 Up  PF8 Down                    |
                                     |                                               |
                                     +-----------------------------------------------+

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        End                     Up    Down  ATask All   NxtSt Menu

2. Select one or more network runs to be repeated with any character, and press ENTER.

   For each run to be repeated, a confirmation window like the example below opens:

       +--------------------------------------------------------------+
       |                                                              |
       |  Owner EXAMPLE    Network B60-FLOW   Run 2138                |
       |                                                              |
       |  Adapt job time frames for the repetition ==> N (Y/N)        |
       |                                                              |
       |  PF3  End                                                    |
       +--------------------------------------------------------------+

3. Adapt job time frames for the repetition. If `Y` (yes) is entered here, the active job's time frames will be adapted as follows:

   Formula | Example
   --- | ---
   time delay = current time - old earliest start | 13:00 - 9:00 = 4 hours
   new earliest start = current time | 13:00
   new latest start = old latest start + time delay | 17:00 + 4 hours = 21:00
   new deadline = old deadline + time delay | 18:00 + 4 hours = 22:00

## Displaying Operating System Information on Active Tasks

This section covers the following topics:

- Listing All Active Tasks

- Columns: All Active Tasks

- Listing Active Tasks according to Node

- Listing Active Tasks according to Type

### Listing All Active Tasks

To display operating system information on active tasks

1. Choose PF9 (ATask) on the Active Job Networks screen.

   An All Active Tasks screen like the example below appears:

        16-10-14                ***** Entire Operations *****                16:47:35
                                       All Active Tasks
        Node ==> 55522  MVS/ESA                                      Type ==> JOB_____
        ------------------------------------------------------------------------------
         DP ID Type   JobId Name     Step     Proc     Status   Disp Region   CPU
        236 30 JOB    24962 XGSLDDIE NATRPC                     YES  3040     0.18
        236 52 JOB    23836 PQATIMER PQAMIT   N                 YES  3520     4.00
        238 10 JOB    62099 SYSPOOL  NAT                        YES  2188     0.01
        255 11 JOB    23765 SNRPC531 EOR##531          SWAP-OUT NO   1372     2.27
        230 11 JOB    23766 SNRPC543 EOR##543                   YES  1308     0.08
        230 12 JOB    36186 ESI      EOR##543                   YES  1516     0.32
        255 12 JOB    59842 ETSWCPEF LYCANSRV          SWAP-OUT NO   1496     3.22

        ******************************* Bottom of Data *******************************
        Command => ____________________________________________________________

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        End                           Down

   This screen displays information on all active tasks running on the operating system, including jobs not defined to Entire Operations (z/OS only).

### Columns: All Active Tasks

The following table explains the column headings for the data listed on the All Active Tasks screen:

Column | Description
--- | ---
DP | Dispatching priority assigned by operating system.
ID | JES2 batch initiator identifier (for `JOB` type tasks only).
Type | Type of job. Corresponds to the value entered in the Type field (see Listing Active Tasks according to Type).
JobId | Identifier of job as assigned by the operating system or by the job entry subsystem.
Name | z/OS: Name of job as assigned in the JOB statement of the JCL.
Step | Name of job step currently being executed.
Proc | Name of procedure currently being executed.
Status | Status of address space. Possible values:
`V=R` | Running in real memory.
`TERM` | Address space is terminating.
`NON-SWAP` | Address space cannot be swapped.
`SWAP-OUT` | Address space is swapped out.
(blank) | Address space is swapped in.
Disp | Dispatch ability of address space:
`YES` | Address space is dispatchable.
`NO` | Address space is not dispatchable.
Region | Amount of real storage used by address space (in KB).
CPU | Amount of CPU consumed by address space (to one-hundredth of a second).

Operating system information is offered as a view only and cannot be modified.

### Listing Active Tasks according to Node

To select an Entire System Server node for which the tasks are to be listed

1. Enter a node number in the Node input field of the All Active Tasks screen.

   Or:
   Enter an asterisk (`*`) and press ENTER to open a selection window for nodes and mark a listed node with any character.

2. Press ENTER.

3. The All Active Tasks screen lists tasks for the selected node only.

### Listing Active Tasks according to Type

To list active tasks according to type

1. In the Type input field of the All Active Tasks screen, enter one of the following values (shortest possible input underlined):

   Type | Description
   --- | ---
   (blank) | Show all types.
   `*` | Show all types.
   `INI` | JES2 initiator.
   `JOB` | Batch jobs (default).
   `STC` | Started tasks.
   `TSU` | TSO users.

   The operating system information which appears immediately after the node number cannot be modified.

2. Press ENTER.

   The All Active Tasks screen now lists tasks of the selected type only.

## Listing Next Network Activations

To list all next scheduled and manual network activations

- Choose PF11 (NxtSt) on the Active Job Networks screen.

  The Next scheduled Network Starts screen appears.

  For further information, see Displaying Next Network Starts (System-wide) in the section Schedule Maintenance.

## Viewing the Execution History of an Active Network

To display execution history for a selected network

- On the Active Job Networks screen, type `X` in the line command input field next to the required network, and press ENTER.

  A History screen appears for the selected network.

  For further instructions and information, see Displaying the Network Execution History in the section Schedule Maintenance.

### On this page

- Listing Active Job Networks
- Deactivating Active Job Networks
- Repeating Active Job Networks
- Displaying Operating System Information on Active Tasks
- Listing Next Network Activations
- Viewing the Execution History of an Active Network