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:

Related Topics:


Listing Active Conditions

Start of instruction set 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 similar to 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.

Start of instruction set 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

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 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:

Date
Time

 
Date / Time Date and time when this condition was set. The date and time serve as search criteria for Entire Operations 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 particular 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).

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.

Start of instruction set 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 if for a job before submission.

Start of instruction set To add an active condition

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

    A Condition Addition window similar to 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.

Start of instruction set 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.

Start of instruction set 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

Start of instruction setTo 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 similar to 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.

Start of instruction setTo 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 similar to 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.

Start of instruction set To view active jobs calling a subnetwork

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

    A Calling Job Information window similar to 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.