Maintaining Active Job Conditions

#### Search Results

Search

# Maintaining Active Job Conditions

Logical conditions are defined on the master database when linking jobs within a job network. When a job network is activated and running, Entire Operations sets logical conditions automatically (active conditions) according to the occurrence of system events. Alternatively, you can set active conditions manually. You can display and maintain active conditions.

An active condition reflects the current value of the condition for a given job network activation. It can have the value true (the condition exists) or false (the condition does not exist). The run number assigned to the job network at activation is automatically passed to the active conditions defined for the jobs in the network. An active condition is uniquely identified by owner, network, run number and condition name.

Notes:

1. You can define new input conditions for an active job, or delete or modify existing conditions. Any changes to active conditions for active jobs are valid for the current job run only.
2. You can maintain active input conditions in the same way as described for master input conditions in Defining and Managing Job Conditions in the section Job Maintenance.

This document covers the following topics:

- Listing Active Conditions

- Viewing an Active Condition and Changing Its Status

- Adding an Active Condition

- Deleting Single or Multiple Active Conditions

- Displaying Conditions for an Active Job

- Viewing Job Usage of an Active Condition

- Viewing Calling Jobs of Subnetworks

#### Related Topics:

- Logical Conditions - Concepts and Facilities documentation

## Listing Active Conditions

To list all active conditions used by all active networks

- On the Active Jobs, All Active Jobs or Input Conditions Maintenance screen, choose PF4 (ACond).

  An Active Conditions screen like the example below appears:

       10.10.18                ***** Entire Operations *****                12:25:11
       Owner EXAMPLE                 Active Conditions
      -------------------------------------------------------------------------------
       Cmd Owner      Network    Condition            Date     Time    Run Status
           EXAMPLE--- *--------- *------------------- -------- ----- -----
        _  EXAMPLE    B60-FLOW   E60-JOB1-I           08.10.18 23:00  2886 free
        _  EXAMPLE    B60-FLOW   E60-JOB1-O           10.10.18 12:18  2890 free
        _  EXAMPLE    B60-FLOW   E60-J019-O           10.10.18 12:18  2890 free
        _  EXAMPLE    E60-FLOW   E60-JOB1-O           03.10.18 23:00  5401 free
        _  EXAMPLE    Z60-FLOW   E60-JOB1-O           03.10.18 23:00  1256 free

       ******************************* Bottom of Data *******************************
       D Delete   M Modify   W Where Used
       Command => ____________________________________________________________

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

  This screen displays a list of all active conditions belonging to the selected owner and networks. The columns are explained in Columns and Fields: Active Conditions.

To list input conditions used by an active job run

1. On the Active Jobs or All Active Jobs screen, type `I` in the line command input field next to the required job, and press ENTER.

2. Press ENTER.

   An Input Condition Maintenance screen with a list of input conditions for the selected job appears.

   This screen corresponds to the Input Condition Maintenance screen of the Job Maintenance function on the master database described in Defining and Managing Job Conditions in the section Job Maintenance.

This section covers the following topics:

- Columns and Fields: Active Conditions

- Line Commands: Active Conditions

### Columns and Fields: Active Conditions

The following table explains the columns of the Active Conditions screen. The names of the columns correspond to the names of the fields available when adding or viewing an active condition in the Condition Addition/Modification window, unless indicated otherwise in the Field column of the following table.

Column | Field | Description
--- | --- | ---
Cmd | n/a | One-character line command input field. For possible line commands, see Line Commands: Active Conditions.
Owner | n/a | Owner name for the condition. For possible selection criteria, see Specifying Filter Criteria.
Network | Network | Network name. For possible selection criteria, see Specifying Filter Criteria.
Condition | Condition | Active condition name as defined on the master database. For possible selection criteria, see Specifying Filter Criteria. Note If the condition name has the prefix `(C)`, the active condition is being used for JCL checking only. When adding or modifying a condition: Pay attention to the restrictions for condition names described in the section Job Maintenance. For global active conditions, the same applies as described in Global Conditions (Job Maintenance).
Date Time | Date / Time | Date and time when the condition was set or modified. The date and time serve as search criteria for active conditions, if no run number is specified. You can enter a start date and time for the list of active conditions. See also Date and Time Formats.
Run | Run Number | Run number of the job which sets this condition, or the value `abs` (absolute) or `void`. `void` is displayed if a run number is not relevant for a job run. For information on `abs`, see `ABS` in Possible References for Input Conditions. You can enter a run number to list the conditions for this run only.
Status | Status | Status of the condition. Possible values:
`0` | Free. Can be used by any job.
`1` | In use. Can be used by jobs which do not require exclusive usage.
`2` | Exclusive. Currently in use by a job; not usable by other jobs.
`3` | Destructive. Currently in use by a job; not usable by other jobs. The condition will be deleted after job termination.
n/a (shown in Condition column) | Special Type | Usage of the condition. Possible input values for input fields:
(blank) | Condition is not used for checking JCL.
`C` | Condition is only used for checking JCL. If this option is selected, the name of the condition in the Condition column is prefixed with `(C)`.

### Line Commands: Active Conditions

The following line commands are available on the Active Conditions screen:

Line Command | Function
--- | ---
`D` | Delete the condition. See Deleting Single or Multiple Active Conditions.
`M` | View the condition and modify its status. See Viewing an Active Condition and Changing Its Status.
`W` | Display the job that uses the active condition. See Viewing Job Usage of an Active Condition.

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

PF Key | Name | Function
--- | --- | ---
PF6 | Delete | Delete single or multiple active conditions. See Deleting Single or Multiple Active Conditions.
PF7 | Up | Scroll up in the list of active conditions.
PF8 | Down | Scroll down in the list of active conditions.

## Viewing an Active Condition and Changing Its Status

You can view an active condition and modify its status to change the use made of it by future runs of the job for which it is defined.

To view a condition active and change its status

1. On the Active Conditions screen, type `M` in the line command input field next to the required condition, and press ENTER.

   A Condition Modification window opens.

   The fields in the window have the same meaning as the corresponding columns on the Active Conditions screen. They are explained in Columns and Fields: Active Conditions.

2. If required, you can change the status of the condition, and choose PF5 (Save) to save the modification.

3. Choose PF3 (End) to close the Condition Modification window and return to the Active Conditions screen.

## Adding an Active Condition

You can add an active condition to change the job flow by defining it for a job before submission.

To add an active condition

1. Choose PF2 (Add) on the Active Conditions screen.

   A Condition Addition window like the example below opens:

       05.02.16                ***** Entire Operations *****                16:22:43
        Owner TESTBED                 Active Conditions
       -------------------------------------------------------------------------------
        Cmd Owner      Network    Condition            Date     Time    Run Status
            TESTBED--- *--------- *------------------- -------- -----
         _  TESTBED    NET +---------------------------------------------+  free
         _  TESTBED    NET |                                             |  free
         _  TESTBED    NET |         Condition Addition                  |  free
         _  TESTBED    NET |                                             |  free
         _  TESTBED    NET |           Owner ==> TESTBED                 |  free
         _  TESTBED    NET |         Network ==> __________              |  free
         _  TESTBED    NET |       Condition ==> ____________________    |  free
         _  TESTBED    NET |     Date / Time ==> __________ ________     |  free
         _  TESTBED    NET |      Run Number ==> _____                   |  free
         _  TESTBED    NET |    Special Type ==> _                       |  free
         _  TESTBED    NET |                                             |  free
         _  TESTBED    NET |          Status ==> _                       |  free
         _  TESTBED    NET |                                             |  free
        ****************** |  Enter-PF1---PF2---PF3------PF5---------    | ***********
        D Delete   M Modif |        Help  Add   End      Save            |
        Command => _______ +---------------------------------------------+ ____

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

   The input fields have the same meaning as the corresponding columns on the Active Conditions screen. They are explained in Columns and Fields: Active Conditions.

2. Enter values for the input fields.

3. Choose PF5 (Save) to add the active condition.

4. Choose PF3 (End) to close the Condition Addition window and return to the Active Conditions screen.

## Deleting Single or Multiple Active Conditions

You can delete single or multiple active conditions.

Note
Check carefully the side effects before you delete multiple active conditions.

To delete a single active condition

1. On the Active Conditions screen, type `D` in the line command input field next to the required condition, and press ENTER.

   A confirmation window opens.

2. Enter `Y` and press ENTER to delete the condition and return to the Active Conditions screen.

To delete multiple active conditions

1. Choose PF6 (Delete) on the Active Conditions screen.

   An Active Condition Deletion window opens:

        27.10.08               ***** Entire Operations *****                    15:58:37
         Owner SN                      Active Conditions
        -------------------------------------------------------------------------------
         Cmd Owner      Network    Condition            Date     Time  Run   Status
             SN*------- *--------- *------------------- -------- -----
          _  SN         BS2-EX-2   JOB-1-OK             27.06.07 16:20  1108 free
          _  SN         BS2-EX-2   JOB-1-OK             27.06.07 16:21  1109 free
          _  SN         BS2-EX-2   JOB-1-OK             27.06.07 16:21  1110 free
          _  SN   +------------------------------------------+ 7 00:07  1111 free
          _  SN   !                                          ! 7 16:22  1108 free
          _  SN   !        Active Condition Deletion         ! 7 16:22  1109 free
          _  SN   !                                          ! 7 16:22  1110 free
          _  SN   !    Owner      ==> __________             ! 7 00:08  1111 free
          _  SN   !    Run from   ==> _____________          ! 7 16:23  1110 free
          _  SN   !        to     ==> _____________          ! 7 00:08  1111 free
          _  SN   !    Confirm?   ==> Y                      ! 7 08:12  1400 free
         ******** !                                          ! ************************
         D Delete !                                          !
         Command  !    Enter-PF1---PF3--------------------   ! _________________
        Enter-PF1 !          Help  End                       ! F9---PF10--PF11--PF12---
              Hel +------------------------------------------+                  Menu

   This screen displays a list of all active conditions belonging to an owner.

   You can use several selection criteria for the active conditions to be deleted: see Fields: Active Condition Deletion.

2. Enter the required selection criteria for the active conditions to be deleted and press ENTER.

### Fields: Active Condition Deletion

The following table explains the fields available on the Active Condition Deletion window:

Field | Description
--- | ---
Owner | Owner of the conditions. For possible selection criteria, see Specifying Filter Criteria.
Network | Network of the conditions. For possible selection criteria, see Specifying Filter Criteria.
Condition | Condition(s).
Run from | Start of run number interval to be deleted.
Run to | End of run number interval to be deleted.
Confirm | `Y` Prompt for each deletion. `N` Perform deletions without prompting.

## Displaying Conditions for an Active Job

To display condition usage of an active job

- In the Prerequisites window, enter the line command `W` (see Line Commands: Prerequisites for an Active Job) next to the required condition.

  A Condition window like the example below opens:

       17-04-14 +----------------------------------------------------------+ 1:36:41
                !                                                          !
       Owner EX !  Owner   EXAMPLE         Condition E60-J013-O            !
                !  Network E60-FLOW                                        ! 17-04-14
      --------- !                                                          ! --------
       C Condit !         Output Condition of                              ! Exit
       W E60-J0 !         Owner      Network        Run Job                !
                !         EXAMPLE    E60-FLOW        10 JOB-013            !
                !         EXAMPLE    E60-FLOW        10 JOB-014            !
                !         EXAMPLE    E60-FLOW        61 JOB-013            !
                !         EXAMPLE    E60-FLOW        61 JOB-014            !
                !                                                          !
                !                                                          !
                !         Input Condition for                              !
                !         Owner      Network        Run Job                !
                !         EXAMPLE    E60-FLOW        10 JOB-014            !
       ******** !                                                          ! ********
       D Delete !                                                          !
                !                                                          !
                !                                                          !
       Command  !  ------PF3---------------------PF7---PF8---------------  ! _
                !        End                     Up    Down                !
                +----------------------------------------------------------+

      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Add   End   ACond Save        Up    Down                    Menu

  The left column of the window displays the jobs which can generate the condition. The right column of the window displays the jobs which use this condition as an input condition.

## Viewing Job Usage of an Active Condition

This function is used to display the job that uses or last used an active condition.

To view the job that uses or last used an active condition

- On the Active Conditions screen, type `W` in the line command input field next to the required active condition, and press ENTER.

  Or:
  In the Prerequisites window, type `W` in the line command input field next to a condition for which a job is waiting and press ENTER.

  An Active Condition Usage window like the example below opens:

      +-------------------------------------------------------------------+
      |                                                                   |
      |                      Active Condition Usage                       |
      |                                                                   |
      |                                      used by                      |
      |  Owner        EXAMPLE                Owner     EXAMPLE            |
      |  Network      E60-FLOW               Network   E60-FLOW           |
      |  Condition    E60-JOB1-O             Run       5646               |
      |  Run          5646                   Job       J07                |
      |  Status       0 free                 Begin     28.08.19 13:15:40  |
      |  Special Type                        End       28.08.19 13:32:29  |
      |                                                                   |
      |  ------PF1---------PF3------------------------------------------  |
      |        Help        End                                            |
      +-------------------------------------------------------------------+

This window displays the job that currently uses the active condition, or the job that used the condition most recently. If the field End is empty, the condition is currently in use. If a date and time is entered, it indicates when the job stopped using the condition.

The Begin field shows the date and time since when the job started using the condition.

If several jobs use the condition simultaneously, only one job is displayed.

For explanations of other fields contained in the window, see Columns and Fields: Active Conditions.

## Viewing Calling Jobs of Subnetworks

This function can be used only for active jobs which are part of an active subnetwork.

To view active jobs calling a subnetwork

1. On the Active Jobs or All Active Jobs screen, type `Y` next to a job that belongs to a subnetwork.

   A Calling Job Information window like the example below opens:

        18-02-01                ***** Entire Operations *****                17:03:25
        Active Jobs             Owner SAGTEST    Network SAGNETSUB1 Version
        Selection AW________                                   Run from 54___ to 54___
       -------------------------------------------------------------------------------
        C   Job          Run Typ Loc    JobId  Node  Date  Time Message
            *---------       ---
        Y   JOB-A         54 JOB                    02-01 17:03 ==> Y-Cmd executed <==
        _   JOB- +----------------------------------------------------------+ ME not f
        _   SUBN !                                                          !  RUN not
                 !                  Calling Job Information                 !
                 !                                                          !
                 !                  Owner      Network       Run Job        !
                 !  Subnetwork      SAGTEST    SAGNETSUB1     54 JOB-A      !
                 !  called by       SAGTEST    SAGNET        346 J2-SUB     !
                 !                                                          !
                 ! ----PF1----PF3--------------PF6------------------------- !
                 !     Help   End              Calling Network              !
        ******** +----------------------------------------------------------+ ********
        A Sc.P B Brw C Can D Dea E Edit G Gen.JCL H Hold I InCond J JCL K A.Res L Res.
        M Mod. O EOJ P Prose R Resub. S SYSOUT T Stop U Rel. V RA W Wf Y SubC Z Subnet
        Command => ____________________________________________________________

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help  Add   End   ACond Save  ResUs Up    Down  ATask Left  Right Menu

   (If the selected job has no calling job or does not belong to a subnetwork, the message `No calling Job` occurs instead.)

   In the example above, the job `JOB-A` of the subnetwork `SAGNETSUB1` is called by the `J2-SUB` job of the `SAGNET` network.

2. You can choose PF6 (Calling Network) to open the Active Jobs screen of the calling network (here: `SAGNET`) and close the Calling Job Information window.

3. You can choose PF3 to reopen the Calling Job Information window from this screen.

### Special PF Key

PF Key | Name | Function
--- | --- | ---
PF6 | Calling Network | Opens the Active Jobs screen of the calling network with a list of all its active jobs.

### On this page

- Maintaining Active Job Conditions
- Listing Active Conditions
- Viewing an Active Condition and Changing Its Status
- Adding an Active Condition
- Deleting Single or Multiple Active Conditions
- Displaying Conditions for an Active Job
- Viewing Job Usage of an Active Condition
- Viewing Calling Jobs of Subnetworks