Maintaining Active Job Conditions

Logical conditions (see the Concepts and Facilities documentation) 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 Input Conditions in the section Job Maintenance.

This document covers the following 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, press PF4 (ACond).

    An Active Conditions screen similar to the example below appears:

     16-09-25                ***** Entire Operations *****                16:06:18
     Owner NATQA5                  Active Conditions  
    -------------------------------------------------------------------------------
     Cmd Owner      Network    Condition            Date     Time    Run Status    
         NATQA5---- *--------- *------------------- -------- -----                 
      _  NATQA5     N1587ASY   NET-BEGIN            16-09-19 16:10   297 free      
      _  NATQA5     VKA-SYMBA  JOB1-OK              16-09-19 16:00   297 free      
      _  NATQA5     VKA-SYMBA  JOB1-OK              16-09-20 21:06   298 free      
      _  NATQA5     VKA-SYMBA  JOB2-OK              16-09-19 16:01   297 free      
      _  NATQA5     VKA-SYMBA  JOB2-OK              16-09-20 21:07   298 free      
      _  SYSDBA     SYSDBA     +ABC-COND            14-04-04 00:00   abs free      
      _  SYSDBA     SYSDBA     +COND-EXAMPLE        14-06-24 00:00   abs free      
      _  SYSDBA     SYSDBA     (C)+HEB-NUR-JCL-P    14-04-08 00:00   abs free      
      _  SYSDBA     SYSDBA     (C)+OGC-JCL-CHECK    15-08-03 00:00   abs in use    
      _  SYSDBA     SYSDBA     +XYZ-COND            14-04-04 00:00   abs free      
      _  SYSDBA     SYSDBA     +ZTEST               16-07-12 00:00   abs 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 fields and 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 Input 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    One-character line command input field.

For possible line commands, see Commands: Active Conditions.

Owner    Owner name for the condition.

For possible selection criteria, see Filtering Items in a Result List in Using Entire Operations.

Network    Network name.

For possible selection criteria, see Filtering Items in a Result List in Using Entire Operations.

Condition    Active condition name as defined on the master database.

For possible selection criteria, see Filtering Items in a Result List in Using Entire Operations.

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 or void.
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.
  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 Displaying Jobs Using 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 press PF5 (Save) to save the modification.

  3. Press 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. Press 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. Press PF5 (Save) to add the active condition.

  4. Press 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. Press 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 Filtering Items in a Result List in Using Entire Operations.

Network Network of the conditions.

For possible selection criteria, see Filtering Items in a Result List in Using Entire Operations.

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.

Viewing the Usage of Conditions Concatenated with an Active Job

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

Displaying Jobs Using an Active Condition

Start of instruction setTo list the job using an active condition

  • On the Active Conditions screen, type W in the line command input field next the 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:

     18-02-01                ***** Entire Operations *****                11:06:00 
     Owner SAGTEST                 Active Conditions                               
    -------------------------------------------------------------------------------
     Cmd Own +-------------------------------------------------------------------+ 
         SAG !                                                                   ! 
      _  SAG !                      Active Condition Usage                       ! 
      W  SYS !                                                                   ! 
      _  SYS !  Owner      SYSDBA           used by Owner     SAGTEST            ! 
      _  SYS !  Network    SYSDBA                   Network   SAGNET             ! 
      _  SYS !  Condition  +ABC-COND                Run       2                  ! 
      _  SYS !  Run        ABS                      Job       JOB-01             ! 
      _  SYS !  Status     3 destruct.              Begin     17-02-25 15:57:43  ! 
      _  SYS !  spec.Type                           End       17-02-25 15:58:08  ! 
             !                                                                   ! 
             !  ------PF1---------PF3------------------------------------------  ! 
             !        Help        End                                            ! 
             +-------------------------------------------------------------------+ 
                                                                                   
     ******************************* 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 window displays the job, which is using the active condition, or the job, which last used the condition.

    If several jobs use the condition simultaneously, only one job will be displayed. If the field End is blank, the condition is currently being used. Otherwise, it is not in use.

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 press 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 press PF3 to reopen the Calling Job Information window from this screen as shown in the following example:

     18-02-02                ***** Entire Operations *****                09:33:19 
     Active Jobs             Owner SAGTEST    Network SAGNET     Version           
     Selection AW________                                   Run from 347__ to 347__
    -------------------------------------------------------------------------------
     C   Job          Run Typ Loc    JobId  Node  Date  Time Message               
         *---------       ---                                                      
     _   DEMO-JOBK    347 JOB NAT             42 02-02 09:15 No JCL found for DEMO-
     _   DEMO +----------------------------------------------------------+ or DEMO-
     _ C JCLJ !                                                          ! l requir
     _   JCLJ !                  Calling Job Information                 ! ed      
     _   JCLJ !                                                          ! RU/B60-M
     _   JCL2 !                  Owner      Network       Run Job        ! $ not al
     _   JCL3 !  Subnetwork      SAGTEST    SAGNETSUB1     55 JOB-A      ! alid Use
     _   JOB- !  called by       SAGTEST    SAGNET        347 J2-SUB     !  failed,
     _   JOB- !                                                          !  failed,
     _   JOB- ! ----PF1----PF3--------------PF6------------------------- !  failed,
     _   JOB- !     Help   End              Calling Network              !  found  
     ******** +----------------------------------------------------------+ ********
     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

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.