Maintaining Active Jobs

#### Search Results

Search

# Maintaining Active Jobs

This document covers the following topics:

- Listing Active Jobs

- Listing Jobs of an Active Subnetwork

- Adding a New Job to the Active Network

- Viewing and Modifying the Active Jobs Schedule

- Cancelling, Holding and Releasing Active Jobs

- Resubmitting Active Jobs

- Deactivating a Job in an Active Network

- Reactivating an Active Job

- Displaying and Modifying an Active Job Definition

- Modifying EOJ Checking and Actions

- Viewing Long Descriptions of Active Jobs

- Displaying Prerequisites for Active Jobs

- Viewing and Modifying Resources Used by Active Jobs

- Modifying Scheduling Parameters

- Browsing Active Job SYSOUT

#### Related Topics:

- Activating a Single Job Manually

## Listing Active Jobs

You can access active runs of a network to list and maintain active jobs.

> User Restrictions for Active Jobs Lists

>   Users can be restricted to view jobs on the Active Jobs or All Active Jobs screen.

>   If the user is of type `A` (Administrator) or if the user has access to the owner SYSDBA, then all active jobs are displayed. In all other cases, the following active jobs are displayed:

>   - From networks of the current owner,

>   - From networks of owners to which the user has access,

>   - From networks to which the user has access.

>   See also Granting Definition: Authorizing Other Users or Owners to Access a Network in the section Network Maintenance.

This section covers the following topics:

- Listing All Active Jobs for All Networks Active

- Listing All Active Jobs for a Single Active Network

- Listing Active Jobs by Process Status

- Listing Active Jobs According to Run Numbers

### Listing All Active Jobs for All Networks Active

To list all active jobs for all active networks

- Choose PF10 (All) on the Active Job Networks screen.

  An All Active Jobs screen like the example below appears:

       18-03-05                ***** Entire Operations *****                19:20:07
                                      All Active Jobs
       Selection AW________                                   Submit User ID ________
      -------------------------------------------------------------------------------
       C Owner      Network    Job          Run    JobId  Time Message
         *--------- *--------- *---------
       _ EXAMPLE    MAIN1      JOB-05         5          19:15 E60-JOB4-O - 5 - RUN n
       _ EXAMPLE    MAIN1      JOB-06         5          19:15 MAC Exit SYSEORU/B60-M
       _ EXAMPLE    SAGNET     NAT           35          19:16 ACTIVECONDITION2 - 35
       _ INCIDENT   I1042163   I1042163J1   149          23:30 Start Time 03-06 16:00
       _ INCIDENT   I1042163   -            150          17:06 Activation Network 03-
       _ INCIDENT   I1042163   -            151          00:00 Activation Network 03-
       _ INCIDENT   I5033788BA -           3305          17:06 Activation Network 03-
       _ INCIDENT   I5033788BA -           3306          17:06 Activation Network 03-
       _ INCIDENT   I5033788BA -           3307          17:06 Activation Network 03-
       _ INCIDENT   I5033788BA -           3308          17:06 Activation Network 03-
       _ INCIDENT   I5033788BA -           3309          17:06 Activation Network 03-
       *********************************** m o r e **********************************
       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

  The screen lists all jobs currently active in your Entire Operations environment for the selected owner(s) depending on your view authorizations (see also User Restrictions for Active Jobs Lists). Additionally, network runs are listed where activations are planned and in the process, but not yet completed.

  A hyphen (`-`) instead of a job name in the Job column indicates that the network has been activated but not yet started. The hyphen (`-`) is replaced by the job name when the network starts to execute the job.

  Note
  By contrast, the Active Jobs screen lists all active jobs for a single network selected from the Active Job Networks screen.

#### Sort Order

The sort order for this screen can be defined individually for each user in the user definition: see Sort Orders in Lists described in the Administration documentation.

This section covers the following topics:

- Input Fields: Filtering Jobs on the All Networks Active Screen
- Columns: All Active Jobs
- Commands: All Active Jobs

#### Input Fields: Filtering Jobs on the All Networks Active Screen

You can limit the number of jobs listed on the All Active Jobs screen by entering selection criteria in the following input fields:

> Owner, Network and Job

>   For valid input values, see Specifying Filter Criteria in the section Using Entire Operations.

> Submit User ID

>   Enter a user ID in the Submit User ID field and press ENTER to list only those active jobs with the specified submit user ID.

>   The user ID is case-sensitive.

> Selection by Job Status

>   You can enter a job status in the Selection field to select jobs according to their status: see Listing Active Jobs by Process Status.

#### Columns: All Active Jobs

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

Column | Description
--- | ---
C | One-character line command input field. For possible values, see the line commands in the section Commands: Active Jobs.
Owner | Network owner. For possible selection criteria, see Specifying Filter Criteria.
Network | Network to which the job belongs. For possible selection criteria, see Specifying Filter Criteria.
Job | Job name as defined to Entire Operations. For possible selection criteria, see Specifying Filter Criteria.
Run | Job run number automatically assigned at activation time. The job run number uniquely identifies an active copy of a job together with the job name.
Job Id | Job identifier as assigned by the operating system or by the job entry subsystem.
Time | Last action or check time for the job.
Message | Last message issued for the job by Entire Operations. Choose PF11 (Right) or PF10 (Left) to display the full message text. For a list of possible messages and their meaning, see Messages in Active Jobs Lists in the Messages and Codes documentation.

#### Commands: All Active Jobs

> Line Commands

>   For a description of the available line commands, see the line commands in the section Commands: Active Jobs.

>   Note
>   Most of these line commands refer to a specific job and may therefore not be used in lines referring to network runs. For these lines, only the commands `D` and `A` are allowed.

> Special PF Keys

>   For a description of available PF keys, see the special PF keys in the section Commands: Active Jobs.

### Listing All Active Jobs for a Single Active Network

You can access an active network to list and maintain active jobs.

To list all active jobs running in an active network

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

  An Active Jobs screen like the example below appears:

       18-03-05                ***** Entire Operations *****                19:29:01
       Active Jobs             Owner EXAMPLE    Network MAIN1      Version
       Selection AW________                                   Run from 5____ to 5____
      -------------------------------------------------------------------------------
       C   Job          Run Typ Loc    JobId  Node  Date  Time Message
           *---------       ---
       _ D JOB-01         5 JOB NAT             42 03-05 19:15 Dummy Job (Definition)
       _ D JOB-1-TEST     5 JOB NAT             42       19:15 Reference ABS+ Format
       _   JOB-012        5 JOB MAC             31       19:15 MAC Exit SYSEORU/B60-M
       _   JOB-013        5 JOB MAC             31       19:15 MAC Exit SYSEORU/B60-M
       _   JOB-014        5 JOB MAC             31       19:15 MAC Exit SYSEORU/B60-M
       _   JOB-015        5 DUM                 31       19:15 E60-J014-O - 5 - RUN n
       _   JOB-019        5 JOB MAC             31       19:15 MAC Exit SYSEORU/B60-M
       _   JOB-02         5 JOB MAC             31       19:15 MAC Exit SYSEORU/B60-M
       _   JOB-03         5 NAT NAT             31       19:15 NAT Module SYSEORU/B60
       _   JOB-04         5 JOB MAC             31       19:15 MAC Exit SYSEORU/B60-M
       _   JOB-05         5 DUM                 31       19:15 E60-JOB4-O - 5 - RUN n
       *********************************** m o r e **********************************
       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

  This screen lists all active jobs in the network depending on your view authorizations (see also User Restrictions for Active Jobs Lists).

  The jobs are sorted in the expected execution order of the network, derived from the logical dependencies. Jobs with the same execution order are sorted alphabetically.

  The fields and columns available on the screen are explained in Input Fields: Active Jobs and Columns: Active Jobs.

  You can use line commands and PF keys on this screen to modify active jobs: see Commands: Active Jobs.

  Modifications of active jobs are effective for a specific run of a job only and do not affect any definitions made on the master database. This also applies to changes made to active job JCL, input conditions and End-of-Job checking and actions.

This section covers the following topics:

- Input Fields: Active Jobs
- Columns: Active Jobs
- Commands: Active Jobs

#### Input Fields: Active Jobs

The input fields on the Active Jobs screen are described in the following table:

Input Field | Description
--- | ---
Selection | You can restrict the list to jobs with special status values. For further information, see Listing Active Jobs by Process Status.
Run from | Enter a run number or enter an asterisk (`*`) to select a run number from a list. Default: the latest active run (in chronological order). The latest active run is set depending on the Last Run Display option set for the user in the Network Maintenance function (see the Administration documentation).
Run to | Enter a run number or enter an asterisk (`*`) to select a run number from a list. If the entered or selected Run to is lower than Run from, it will be set to the value of Run from. Default: the latest active run (in chronological order). Maximum run number: 99999. The latest active run is set depending on the Last Run Display option set for the user in the Network Maintenance function (see the Administration documentation).

#### Columns: Active Jobs

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

Column | Description
--- | ---
C | One-character line command input field. For possible values, see the line commands in the section Commands: Active Jobs.
(no heading) | The column without heading between C and Job indicates the current job type or status, and whether a job description exists. Possible indicators:
`D` | This is a temporary dummy job. For more information, see Displaying and Modifying an Active Job Definition.
`R` | This is a recovery job. For more information, see Defining Recovery Actions in the section Defining and Managing End-of-Job (EOJ) Checking and Actions.
`K` | This is a job for which a request for deactivation is pending in the Monitor task queue after a user initiated the deactivation of the job or job network.
`P` | This is a job for which a long description exists.
Job | Job name as defined to Entire Operations. For possible selection criteria, see Specifying Filter Criteria.
Run | Job run number automatically assigned at activation time. The job run number uniquely identifies an active copy of a job together with the job name.
Typ | Job type as defined to Entire Operations.
JobId | Job identifier as assigned by the operating system or by the job entry subsystem.
Node | Execution node of the machine designated for the job.
Date | Last action or check date for the job. See also Date and Time Formats.
Time | Last action or check time for the job. See also Date and Time Formats.
Message | Last message issued for the job by Entire Operations. Choose PF11 (Right) or PF10 (Left) to display the full message text. For a list of possible messages and their meaning, see Messages in Active Jobs Lists in the Messages and Codes documentation.

#### Commands: Active Jobs

Use the following line commands to perform the described functions on the active jobs listed on the Active Jobs or All Active Jobs screen:

Line Command | Description
--- | ---
`A` | For active networks: Modify scheduling parameters for the active job. For planned network runs: Modify planned network start time.
`B` | Browse the active JCL for the selected active job. See Browsing Active JCL.
`C` | Cancel the active job from the operating system. See Cancelling an Active Job.
`D` | For active networks: Deactivate the selected job from the active database, including any definitions made at job level (conditions, End-of-Job handling etc.). For planned network runs: Cancel the planned job activation.
`E` | Edit the activate JCL for the selected active job. See Editing Active JCL.
`F` | Release edit lock (for administrators only). See Release Edit Lock.
`G` | (Re)generate the dynamic JCL for this activation. See Regenerating Active JCL.
`H` | Set active job in hold status. See Holding an Active Job.
`I` | Modify the defined input conditions for the active job. See Listing Active Conditions.
`J` | Define JCL for the active job. See Defining JCL for an Active Job.
`K` | View the resources allocated for the active job. See Viewing and Modifying Resources Used by Active Jobs.
`L` | Maintain resources for the active job. See Viewing and Modifying Resources Used by Active Jobs.
`M` | Modify definition for the active job. See Displaying and Modifying an Active Job Definition.
`O` | Modify End-of-Job checking and actions for the active job. See Defining and Managing End-of-Job (EOJ) Checking and Actions.
`P` | Text description of the job. See Viewing Long Descriptions of Active Jobs.
`R` | Resubmit active job. See Resubmitting an Active Job.
`S` | Browse job SYSOUT. See Browsing Active Job SYSOUT.
`T` | Stop cyclic job (special type `C` only). This sets the reserved condition `P-STOPCYC-jobname` to terminate the cyclic execution.
`U` | Release active job from hold status. See Releasing an Active Job.
`V` | Reactivation of an active job. See Reactivating an Active Job.
`W` | (Waiting for prerequisites) For active jobs: Display all pending prerequisites for the active job. For active networks awaiting symbol prompting: Invoke symbol prompting (see also Symbol Prompting during Network or Job Activation).
`Y` | Show the calling job (if this active job is part of an active subnetwork). See Viewing Calling Jobs of Subnetworks.
`Z` | List jobs in a subnetwork (for jobs of the type `NET` only). See Listing Jobs of an Active Subnetwork.

Use the following special PF keys to perform the described functions on the active jobs listed on the Active Jobs or All Active Jobs screen:

PF Key | Name | Function
--- | --- | ---
PF2 | Add | Active Jobs screen: Add an active job definition. All Active Jobs screen: Select an active node from a window and add an active job definition.
PF4 | ACond | Maintain active conditions.
PF9 | ATask | Display operating system information on active tasks.
PF12 | Menu | Return to Entire Operations Main Menu.

The following section describes in more detail the functions you can perform on active jobs using line commands and PF keys (explanations are not necessarily given in the same order as the list of associated line commands above).

### Listing Active Jobs by Process Status

You can list active jobs according to their processing status by entering one or more of the following values in the Selection field on the Active Jobs or All Active Jobs screen and pressing ENTER:

Value | Description
--- | ---
`A` | All active jobs (default).
`E` | All active jobs waiting for at least one event.
`H` | All jobs in hold.
`I` | All jobs in the scheduling system input queue.
`N` | All jobs with `job not ok` terminating status.
`O` | All jobs with `job ok` terminating status.
`S` | All submitted jobs.
`T` | All terminated jobs.
`W` | Planned network runs waiting for activation.
`X` | All jobs in execution.

The default setting is `AW` (all active jobs and the planned network runs waiting for activation).

Alternatively, you can enter a question mark (`?`) in the Selection field and press ENTER to open the following selection window:

     18-03-05                ***** Entire Operations *****                19:36:52
                                    All Active Jobs
     Selection ?________                                    Submit User ID ________
    ---------- +--------------------------------+ ---------------------------------
     C Owner   !                                ! obId  Time Message
       *------ !      Status Preselection       !
     _ EXAMPLE !                                !      19:15 MAC Exit SYSEORU/B60-M
     _ EXAMPLE !  W   Waiting for Activation    !      19:28 MAC Exit SYSEORU/B60-M
     _ EXAMPLE !  A   All active Jobs           !      19:15 Dummy Job (Definition)
     _ EXAMPLE !  E   Waiting for an event      !      19:15 Reference ABS+ Format
     _ EXAMPLE !  H   Jobs in Hold              !      19:15 MAC Exit SYSEORU/B60-M
     _ EXAMPLE !  S   Submitted                 !      19:15 MAC Exit SYSEORU/B60-M
     _ EXAMPLE !  I   In Spool Input Queue      !      19:15 MAC Exit SYSEORU/B60-M
     _ EXAMPLE !  X   Executing                 !      19:15 E60-J014-O - 5 - RUN n
     _ EXAMPLE !  T   Terminated                !      19:15 MAC Exit SYSEORU/B60-M
     _ EXAMPLE !  O   Ended ok                  !      19:15 MAC Exit SYSEORU/B60-M
     _ EXAMPLE !  N   Ended not ok              !      19:15 NAT Module SYSEORU/B60
     ********* !  *   All Jobs                  ! *********************************
     A Sc.P B  !                                ! old I InCond J JCL K A.Res L Res.
     M Mod. O  !     Select ==>  *_________     !  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

Enter one or more values in the Select ==> field and press ENTER to list the active jobs with the selected status.

### Listing Active Jobs According to Run Numbers

By default, only jobs of the last run are displayed on the Active Jobs screen.

To list specific job runs

- Enter the required start and end numbers in the Run from/to input fields of the Active Jobs screen, and press ENTER.

  For example, if you enter `7` in the Run from field, all jobs with run number equal to or greater than `7` are listed. If you enter `4` in the Run from field and `7` in the to field, all jobs with run numbers `4`, `5`, `6` and `7` are listed.

  This setting is kept until you modify it or until you display the Active Jobs screen for another network.

## Listing Jobs of an Active Subnetwork

This function is only applicable to jobs of type subnetwork (NET).

If an active job has the type `NET`, and if the subnetwork is defined properly, you can invoke the active job list of the defined subnetwork directly.

To list jobs of an active subnetwork

- On an Active Jobs or All Active Jobs screen, type `Z` (Subnet) in the line command input field next to a job of the type `NET`, as shown in the following example:

       12.08.22                ***** Entire Operations *****                10:07:55
       Active Jobs             Owner REQUEST    Network P241499A   Version
       Selection AW________                                   Run from 3____ to 3____
      -------------------------------------------------------------------------------
       C   Job          Run Typ Loc    JobId  Node  Date  Time Message
           *---------       ---
       _   JOB1           3 JOB NAT   504657   148 12.08 10:03 Submitted: JobId 50465
       Z   UNTER          3 NET                148       10:07 ==> Z-Cmd executed <==
       _   DUMMY          3 DUM                148       10:03 UNTER-OK - 3 - RUN not

       ******************************* Bottom of Data *******************************
       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

  Press ENTER.

  The job or the jobs of the subnetwork defined for the selected `NET` job are now listed on the screen, as shown in the following example:

       12.08.22                ***** Entire Operations *****                10:08:20
       Active Jobs             Owner REQUEST    Network P241499B   Version
       Selection AW________                                   Run from 5____ to 5____
      -------------------------------------------------------------------------------
       C   Job          Run Typ Loc    JobId  Node  Date  Time Message
           *---------       ---
       _   JOB2           5 JOB NAT            148 12.08 10:04 NET-BEGIN - 5 - RUN no

       ******************************* Bottom of Data *******************************
       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

  For further information, refer to the following sections:

  - Input Fields: Active Jobs

  - Columns: Active Jobs

  - Commands: Active Jobs

  If you leave the subnetwork job list by pressing PF3, you return to the active jobs list of the calling network.

####

## Adding a New Job to the Active Network

To add a job to the active database for the current run of an active job network

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

   A Job Definition (active) window opens, as shown in the following example:

        +-------------------------------------------------------------------------+
        !                                                                         !
        !                        Job Definition (active)                          !
        !                                                                         !
        !  Job Name       ==> .TEMP.____      Activated          18.08.22 13:18   !
        !  Run            ==> 3949            Modified  XHTRI    18.08.22 13:18   !
        !  Description    ==> __________________________________________________  !
        !  Job Type       ==> ___                         Network ==> B60-FLOW    !
        !  Execution Node ==>   121 BS2000                Version ==> (unnamed)   !
        !                                                                         !
        !  Special Type   ==> ________               Symbol Table ==> EXA-SYMBOL  !
        !  Dummy Flags    ==>                Symbol Table Version ==> SV98______  !
        !  Milestones     ==> ________                                            !
        !  Restartable    ==> _                                                   !
        !  Escape Characters:             Activation ==> § Submit ==> "           !
        !                                                                         !
        !  End-of-Job Action Errors set 'not ok' Conditions ==> N                 !
        !                                                                         !
        ! Enter-PF1---PF2--PF3--PF4---PF5---PF6---PF7---PF8--PF9--PF10----PF12--  !
        !       Help  Add  End  Edit  Save  Spec  Symb  Net  JCL  Browse  Menu    !
        +-------------------------------------------------------------------------+

2. Enter the values of the new job definition for the current network run.

   The input fields in the Job Definition (active) window mostly have the same meaning as in the maintenance window of a job master definition; see Fields: Job Definition (Master) in the section Job Maintenance. However, the Job Definition (active) window contains additional fields which are protected.

   The additional fields and special PF keys available in the Job Definition (active) window are described in Displaying and Modifying an Active Job Definition.

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

4. Choose PF3 (End) to close the Job Definition (active) window.

   The new active job is now listed on the Active Jobs screen.

Notes:

1. JCL is automatically loaded after the job has been added.
2. A job is not automatically activated after being added to an active network. The job is first put into hold status and additional definitions can be added, for example, active time frames. To activate the job, you must enter the line command `U` (Release) on the Active Jobs or All Active Jobs screen.

Adding a job to an active job network involves temporarily changing the network structure and job flow. This is achieved with minimum effort as indicated in the following example.

This section covers the following topics:

- Example

- Achieving a Sequential Flow

### Example

You may wish to add a job to a network for one specific run.

This example illustrates the addition of a job to a network consisting of 3 sequential jobs. The new job (Job 4) is to be inserted between Job 1 and Job 2:

### Achieving a Sequential Flow

To achieve a sequential job flow

1. Add the new active job using the Job Definition (active) window;

2. Define Cond-1 as input condition for Job 4;

3. Define Cond-4 as output condition in End-of-Job handling for Job 4;

4. Change the input condition defined for Job 2 (Cond-1) to Cond-4.

   Job 4 is executed for the current run of the job network only.

   If you wish this change to be permanent, use this procedure on the master database.

## Viewing and Modifying the Active Jobs Schedule

To list an active jobs schedule

- On the Active Job Networks screen, type `S` (Act.Jobs Schedule) in the line command input field next to the required network, and press ENTER.

  An Active Jobs Schedule screen like the example below appears:

       17-02-24                ***** Entire Operations *****                16:13:39
       Owner  EXAMPLE            Active Jobs Schedule              Network E01-CONTI
       Selection *                                            Run from 2____ to 2____
      -------------------------------------------------------------------------------
       C   Job          Run Type Latest Start Deadline     Message
           *--------- ----- ---- ------------ -----------  --------------------------
       _   E01-J01        2 JOB  02-25 16:10  02-26 16:10  Ended ok
       _   E01-J02        2 JOB  02-25 16:10  02-26 16:10  Ended not ok - STEP02 C001
       _   E01-J05        2 JOB  02-25 16:10  02-26 16:10  JobId 57487 executing (sub

       ******************************* Bottom of Data *******************************
       A Sched.P  M Modify Latest Start

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

  This screen lists all active jobs in the network.

  You can use line commands and PF keys to modify single and multiple jobs.

  Modifications of jobs on the Active Jobs Schedule screen are effective for a specific run of a job only and do not affect any definitions made on the master database. This also applies to changes made to active job JCL, input conditions and End-of-Job checking and actions.

This section covers the following topics:

- Columns: Active Jobs Schedule

- Commands: Active Jobs Schedule

- Modify Latest Start Time

### Columns: Active Jobs Schedule

The following table explains the columns for the data listed on the Active Jobs Schedule screen:

Column | Description
--- | ---
C | One-character line command input field. For possible values, see the line commands in Commands: Active Jobs Schedule.
(no heading) | There is another column without a heading between C and Job. Possible values:
`D` | This is a dummy job. For more information, see Job Types in the section Job Maintenance.
`R` | This is a recovery job. For more information, see Defining Recovery Actions in the section Defining and Managing End-of-Job (EOJ) Checking and Actions.
Job | Job name as defined to Entire Operations. For possible selection criteria, see Specifying Filter Criteria.
Run | Job run number automatically assigned at activation time. The job run number uniquely identifies an active copy of a job together with the job name.
Type | Job type as defined to Entire Operations.
Latest Start | Latest start time of the job.
Deadline | Deadline time of the job.
Message | Last message issued for the job by Entire Operations. Choose PF10 (Left) or PF11 (Right) to display the full message text. For a list of possible messages and their meaning, see Messages in Active Jobs Lists in the Messages and Codes documentation.

### Commands: Active Jobs Schedule

The following line commands are available on the Active Jobs Schedule screen:

Line Command | Description
--- | ---
`A` | Active scheduling parameters. See also Modifying Scheduling Parameters.
`M` | Modify latest start time.

The following special PF key is available on the Active Jobs Schedule screen:

PF Key | Name | Function
--- | --- | ---
PF9 | ChLat | Change latest start (for all jobs).

### Modify Latest Start Time

The latest start time may be changed for an active job that is not started or is already terminated.

You can use either of the following methods to modify the latest start time:

- Set: Enter the date and time of the new latest start;

- Add: Enter the days, hours and minutes to be added to the latest start time of the active job.

The deadline value can change during this modification to guarantee that the following rule is met: latest start time + estimated elapsed time <= Deadline.

All actions are logged in the Entire Operations log file.

To modify the latest start time for active jobs

1. On the Active Jobs Schedule screen, enter the line command `M` next to the job(s) for which you want to change the start time.

   Or:
   On the Active Jobs Schedule screen, choose PF9 (ChLat) to change the start times of all jobs scheduled for the network run.

2.      29.10.08               ***** Entire Operations *****                 14:09:30
        Owner  SN                 Active Jobs Schedule              Network A-2
        Selection * +------------------------------------+     Run from 457__ to 457__
       ------------ !                                    ! ---------------------------
        C   Job     !      Modify Latest Start Time      !  Message
            *------ !          22.06    22:59:00         !  --------------------------
        _   HUGO-1  !           for  HUGO-2              !  JobId 43825 - Symbol Repla
        M D HUGO-2  !                                    !  WORKDAY - 0 - DAT not foun
        _ D HUGO-3  !        Date     Time               !  WORKDAY - 0 - DAT not foun
        _           !   Set  29.10.08 00:00:00           !
        _           !                                    !
        _           !   or                               !
        _           !                                    !
        _           !   Add  ___ days __ hr __ min       !
        _           !                                    !
        _           !                                    !
        _           ! ---PF1---PF3---------------------  !
        _           !    Help  End                       !
        _           +------------------------------------+
        ******************************* Bottom of Data *******************************
        A Sched.P  M Modify Latest Start

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

## Cancelling, Holding and Releasing Active Jobs

- Operating System Jobs Handling

- Cancelling an Active Job

- Holding an Active Job

- Releasing an Active Job

### Operating System Jobs Handling

Operating system jobs in the Entire Operations active database can be handled directly from the Active Jobs or All Active Jobs screen.

When Entire Operations submits jobs to the operating system, they are assigned a job number which appears, for example, on the Active Jobs or All Active Jobs screen. In z/OS systems, JES operator commands are issued.

Note
In BS2000, console commands are issued.

### Cancelling an Active Job

You can cancel the planned activation of a job in a planned network run that is waiting for activation. The job is then not executed within the active network.

To cancel an active job from the operating system

1. Enter `C` (Canc) in the line command input field of the appropriate job on the Active Jobs or All Active Jobs screen.

2. Press ENTER.

3. A window opens in which you can confirm the cancelation request:

        18-03-06                ***** Entire Operations *****                08:48:38
        Active Jobs             Owner EXAMPLE    Network E01-CONTI  Version
        Selection AW________                                   Run from 11___ to 11___
       -------------------------------------------------------------------------------
        C   Job          Run Typ Loc    JobId  Node  Date  Time Message
            *---------       ---
        _   E01-J01       11 JOB NAT   108563   148 03-05 19:47 Ended ok
        _   E01-J02       11 JOB NAT   108564   148       19:47 Ended not ok - STEP02
        C   E01-J03       11 JOB NAT   108565   148       08:48 ==> R-Cmd executed <==
        _   E01- +-------------------------------------------------------------+ EP03
        _   E01- !                                                             !
        _   E01- !  Please confirm                                             ! EP06
                 !  the Cancelling of E01-J03                                  !
                 !  by entering 'Y' ===> _                                     !
                 !                                                             !
                 !  PF3 End                                                    !
                 +-------------------------------------------------------------+
        ******************************* Bottom of Data *******************************
        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

4. Enter the name of the job to be cancelled and press `ENTER`.

   The specified job is cancelled.

   For a job listed when `W` (Waiting for Activation) is entered in the Selection field, the planned activation of the job in a planned network run is cancelled.

Notes:

1. A cancelled job cannot be released for further processing.

2. For BS2000 jobs, you can only use the cancel command if the following conditions are fulfilled:

   - The BS2000 user ID in effect can issue a cancel command for the Entire System Server node(s) in use. If required, specify the following in the Entire System Server parameter file and restart Entire System Server:

         SYSTEM-COMMAND-USER=TSOS,user-id[,...]

     For example:

         SYSTEM-COMMAND-USER=TSOS,SAG1,SAG2,SAG3

   - The active and passive Entire System Server console servers are available (see the Entire System Server User's Guide).

3. UNIX jobs are cancelled by the SIGTERM signal.

### Holding an Active Job

You can stop an active job and place it in hold status.

To stop a job and place it in hold status

1. Enter `H` in the line command input field of the appropriate job on the Active Jobs or All Active Jobs screen.

2. Press ENTER.

   The message `==> H-Cmd executed <==` appears in the Message column for the job.

3. Press ENTER again.

   The message `Job set to Hold` appears in the Message column for the job.

Notes:

1. If the job has already been submitted to the operating system, it will be held in the operating system.
2. Operating system hold does not work for Windows jobs.
3. For UNIX jobs, the whole process group belonging to the job ID will be held.

### Releasing an Active Job

You can release a job from hold status.

To release a job from hold status and allow it to continue

1. Enter `U` in the line command input field of the appropriate job on the Active Jobs or All Active Jobs screen.

2. Press ENTER.

   The message `==> U-Cmd executed <==` appears in the Message column for the job.

3. Press ENTER again.

   The message `Job released from Hold` appears in the Message column.

Notes:

1. If the command is used for a job of the type `NET` (subnetwork): during a release, no new activation of the subnetwork will be performed.
2. The release from hold command is available for networks in the status `to be activated` too.

## Resubmitting Active Jobs

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.

For example, if a JCL error has occurred, you can modify the active JCL (see Editing Active JCL) and resubmit the job. The resubmitted job uses the old input conditions for submission, but can set different output conditions, depending on the End-of-Job analysis.

Any output conditions set by the job's first run can be reset by the second run if this feature is defined in the job's original End-of-Job handling.

To resubmit an active job

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

   The following window opens:

        21.03.18                ***** Entire Operations *****                17:27:01
        Active Jobs             Owner EXAMPLE    Network B60-FLOW   Version
        Selection AW________                                   Run from 2734_ to 2734_
       -------------------------------------------------------------------------------
        C   Job          Run Typ Loc    JobId  Node  Date  Time Message
            *---------       ---
        R   JOB-01      2734 JOB MAC     3914 N0031 21.03 13:14 Ended ok
        _   JOB-012     2734 JOB MAC     3917 N0031       13:15 Ended ok
        _   JOB-013    +--------------------------------------------+ ok
        _   JOB-014    |                                            | ok
        _   JOB-015    |       Resubmission of Job JOB-01           | Job terminated
        _   JOB-019    |                                            | ok
        _   JOB-02     |  Please select:                            | ok
        _   JOB-03     |  reload from master JCL  .......... ==> _  |  ended normally
        _   JOB-04     |  with submission symbol replacement ==> _  | ok
        _   JOB-05     |  reuse submitted JCL unchanged .... ==> _  | Job terminated
        _   JOB-06     |                                            | ok
        ************** |  PF1 Help   PF3 End                        | ****************
        A Sc.P B Brw C +--------------------------------------------+ L 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

2. Select either option with any character and press ENTER to confirm the resubmission.

3. The window closes and the resubmission time with the message `Job is resubmitted` appears in the message field of the Active Jobs or All Active Jobs screen.

   The fields provided in the window are explained in Options for Resubmission.

This section covers the following topics:

- Options for Resubmission

- Resubmitting an Active Job of NET type (Subnetwork)

- No Reloading after Editing

- Job Resubmission under BS2000

### Options for Resubmission

You have one of the following options to resubmit a job:

reload from master JCL | Reload the JCL from the master JCL definition and resubmit the job.
with submission symbol replacement | Reload the active JCL with symbol replacement (default) and resubmit the job. Symbols and symbol function values are updated depending on the setting of the Entire Operations default Submit symbol/function recalculation at resubmit on the Default Setting (3) screen described in the Administration
reuse submitted JCL unchanged | Reload the active JCL from the previous job submission and resubmit the job exactly as before. Symbol replacement is not repeated. Note Any modifications of the active JCL will be overwritten.

Note
Jobs of the types `NAT` (Natural Program) or `STC` (Started Task) are always resubmitted with keep active JCL; a different option selected for resubmission is ignored.

### Resubmitting an Active Job of NET type (Subnetwork)

If the line command `R` (resubmit) is used for jobs with `NET` type (subnetwork), the subnetwork will be repeated with the same subnetwork run number. However, this is only allowed if the subnetwork has not started yet.

### No Reloading after Editing

In case of a resubmission of the active job, the pregenerated JCL is not reloaded if the active JCL of the job has been edited in the meantime.

### Job Resubmission under BS2000

The SYSOUT file copy attempts are limited if the SYSOUT file is locked. The limit is 10 times the task (Monitor) wait time. If the task wait time is smaller than 30 seconds, the limit is 10 * 30 = 300 seconds.

If the SYSOUT file is still locked when the limit is reached, the active job will be set to a permanent error status, with the message text `10 SYSOUT Renaming Attempts failed`.

For each unsuccessful attempt, the message text will be set to `SYSOUT File Renaming - File in use`. In addition, the event will be logged with the SYSOUT file name.

## Deactivating a Job in an Active Network

To prevent the execution of a certain job in an active network for the current run

1. On the Active Jobs or All Active Jobs screen, type `D` in the line command input field of the selected job, and press ENTER.

   A window opens in which you must confirm deactivation by typing `Y` in the appropriate field:

        18-03-06                ***** Entire Operations *****                09:03:23
        Active Jobs             Owner EXAMPLE    Network E01-CONTI  Version
        Selection AW________                                   Run from 11___ to 11___
       -------------------------------------------------------------------------------
        C   Job          Run Typ Loc    JobId  Node  Date  Time Message
            *---------       ---
        _   E01-J01       11 JOB NAT   108563   148 03-05 19:47 Ended ok
        _   E01-J02       11 JOB NAT   108564   148       19:47 Ended not ok - STEP02
        D   E01-J03       11 JOB NAT   208456   148 03-06 08:48 Ended not ok - STEP03
        _   E01- +-------------------------------------------------------------+ EP03
        _   E01- !                                                             !
        _   E01- !  Please confirm                                             ! EP06
                 !  the Deactivation of E01-J03                                !
                 !  by entering 'Y' ===> _                                     !
                 !                                                             !
                 !  PF3 End                                                    !
                 +-------------------------------------------------------------+
        ******************************* Bottom of Data *******************************
        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

2. Press ENTER to deactivate the job.

Deactivation is performed by the Entire Operations Monitor in the background. Deactivating a job from the active network involves deleting it from the active job network and restructuring the active network to ensure uninterrupted job flow. The following example illustrates job deactivation by bypassing a job in an active network consisting of three sequential jobs.

This section covers the following topics:

- Example: Deactivation of a Job

- Ensuring Uninterrupted Job Flow

### Example: Deactivation of a Job

The network in the following figure is to run without Job 2:

### Ensuring Uninterrupted Job Flow

To ensure uninterrupted job flow

1. To prevent Job 2 from running, it is sufficient to delete its input condition Cond-1. If you deactivate Job 2 from the Active Jobs or All Active Jobs screen, the input condition is automatically deleted.;

2. Replace the input condition for Job 3 (Cond-2) by the input condition Cond-1.

   The current run of the job network skips Job 2.

   If you wish to deactivate a job that is currently running (interrupt its execution), you must cancel it from the operating system before deactivation (see Cancelling an Active Job).

## Reactivating an Active Job

This function is used to deactivate an active job and then reactivate it completely.

This function can be used to restore an inconsistent active job (for example, if a symbol was missing during the original activation).

To reactivate an active job

1. On the Active Jobs or All Active Jobs screen, type `V` in the line command input field of the selected job, and press ENTER.

   A confirmation window prompts you to confirm the reactivation of the selected job.

2. Type `Y` and press ENTER to reactivate the job and close the window.

Reactivation is performed in the background by the Entire Operations Monitor, whereby:

- The active job is deactivated and activated again.

  After deactivation, the job may temporarily disappear from the active jobs list.

- All input and output definitions are recreated.

- The active JCL is newly generated.

- A prerequisite check is performed after reactivation.

## Displaying and Modifying an Active Job Definition

To view and modify the definition of an existing job in an active job network

1. On the Active Jobs or All Active Jobs screen, type the line command `M` next to a job listed, and press ENTER.

   A Job Definition (active) window like example below opens:

       21.08.22                ***** Entire Operations *****                14:41:48
       Active Jobs             Owner EXAMPLE    Network B60-FLOW   Version
        +-------------------------------------------------------------------------+
        !                                                                         !
        !                        Job Definition (active)                          !
        !                                                                         !
        !  Job Name       ==> JOB-01____      Activated          18.08.22 22:00   !
        !  Run            ==> 3950            Modified  SN       08.01.20 14:44   !
        !  Description    ==> Where it all starts_______________________________  !
        !  Job Type       ==> JOB                         Network ==> B60-FLOW    !
        !  Execution Node ==>   121 BS2000                Version ==> (unnamed)   !
        !                                                                         !
        !  Special Type   ==> ________               Symbol Table ==> EXA-SYMBOL  !
        !  Dummy Flags    ==>                Symbol Table Version ==> SV98______  !
        !  Milestones     ==> 1_______                                            !
        !  Restartable    ==> _                                                   !
        !  Escape Characters:             Activation ==> § Submit ==> $           !
        !                                                                         !
        !  End-of-Job Action Errors set 'not ok' Conditions ==> N                 !
        !                                                                         !
        ! Enter-PF1---PF2--PF3--PF4---PF5---PF6---PF7---PF8--PF9--PF10----PF12--  !
        !       Help  Add  End  Edit  Save  Spec  Symb  Net  JCL  Browse  Menu    !
        +-------------------------------------------------------------------------+

   The window displays all current values of the job. You can modify any job parameter.

2. Choose PF4 (Edit) to edit any JCL or Natural program according to the job type.

3. Choose PF5 (Save) to save all changes.

4. Choose PF3 (End) to close the window and return to the Active Jobs screen.

   These changes only affect the current run of the job.

The following applies when you modify a job definition in an active job network definition:

- The current user ID is stored as the last modifying user of the job for all definition and JCL modifications. This user ID is taken as the submit security user ID. If the Monitor does not use its own user ID, see Monitor Defaults - Submit Security User Type in the Administration documentation.

- It may be necessary to release the active job after the modification with the line command `R` (resubmit). This causes a new check of all prerequisites.

This section covers the following topics:

- Fields: Job Definition (Active)

- Special Job Type D - Execution as a Dummy

- Special PF Keys: Job Definition (Active)

### Fields: Job Definition (Active)

The input fields in the Job Definition (active) window mostly have the same meaning as in the maintenance window of a job master definition; see Fields: Job Definition (Master) in the section Job Maintenance. However, the Job Definition (active) window contains the following additional fields which are protected:

Field | Description
--- | ---
Dummy Flags | Indicates why a job executed as a temporary dummy. Possible flags/entries:
`C` | Dummy due to condition.
`D` | Dummy due to definition.
`E` | Empty JCL (no JCL statement generated on purpose).
`J` | JCL check.
`K` | Job is deactivated.
`M` | Dummy due to multiple suffixes.
`R` | Dummy due to recovery.
`S` | Dummy due to schedule dependency.
`T` | Dummy due to repetition.
Note A job that executes as a temporary dummy can have an impact on the execution of End-of-Job actions defined for the job.
Activated | Activation date and time of the network.
Modified | User ID and timestamp of the last modification.
Run | Run number of the current job run.

### Special Job Type D - Execution as a Dummy

In the Job Definition (active) window, it is possible to modify the field Special Type from empty to `D` (execute as dummy), and vice versa.

- If `D` is removed, an automatic reloading of the JCL is performed. In case of active jobs of the type `NET`, the subnetwork is activated.

- If `D` is set, the job is executed as a dummy job. In this case, it does not play any role, whether already active JCL or an active subnetwork were loaded.

See also: Job Execution as a Dummy Job.

### Special PF Keys: Job Definition (Active)

PF Key | Name | Function
--- | --- | ---
PF2 | Add | Add an active job to the active network. See Adding a New Job to the Active Network.
PF4 | Edit | Edit JCL or a Natural program according to the job type.
PF6 | Spec | Define special parameters for operating system dependent job definitions.
PF7 | Symb | Open the Usable Symbol Tables window and select a symbol table for browsing or modification. See Listing Usable Symbol Tables.
PF8 | Net | Subnetwork definition (for jobs of type `NET` only). See Defining a Subnetwork.
PF9 | JCL | JCL definition This action is required for all job types with JCL. See Define the JCL for a job.
PF10 | Browse | Browse JCL or Natural program source code for the job.

## Modifying EOJ Checking and Actions

To modify the End-of-Job checking and actions for the current run of a specific job

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

  An End-of-Job Checking + Actions screen like the example shown in the section Defining and Managing End-of-Job (EOJ) Checking and Actions appears showing the current definitions. You can modify event and action definitions in the same way as described in this section.

Note
Any modifications made to End-of-Job handling parameters of an active job are valid for the current job run only.

## Viewing Long Descriptions of Active Jobs

To view the long text description of an active job

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

  An editor screen like the example shown in the section Job Maintenance appears.

The screen contains text, provided a long description exists for the job master. The text is displayed in Editor format and you can use Editor commands and PF keys to browse the text. No modification is possible. The text can only be modified on the master database by using the appropriate job maintenance function as described in Writing and Viewing Online Documentation for a Job.

## Displaying Prerequisites for Active Jobs

The message field on the Active Jobs or All Active Jobs screen shows only one pending prerequisite (conditions, resources, scheduled times, etc.) for which a job is waiting.

For a complete list of all pending prerequisites, proceed as described in the following instruction.

To display all waiting prerequisites for an active Job

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

  A Prerequisites window opens with a list of events for which the active job is waiting:

       17-04-14                ***** Entire Operations *****                10:30:03
       Active Jobs             Owner EXAMPLE    Network E60-FLOW   Version
       Selection AW________                                   Run from 4786_ to 4786_
      - +---------------------------------------------------------------------------+
        !                                                                           !
        !  Job JOB-012    Run  4786      17-04-14 10:30        Network E60-FLOW     !
        !  is waiting for the following Prerequisites:                              !
        !                                                                           !
        !  _ Job is in passive wait since 19.03 14:43                               !
        !  _ E60-J015-O - 4786  - RUN not found                                     !
        !  _ E60-J019-O - 4786  - RUN not found                                     !
        !                                                                           !
        !                                                                           !
        !                                                                           !
        !                                                                           !
        !                                                                           !
        !                                                                           !
        !                                                                           !
        !  R Reset Condition  S Set Condition  W Where Used                         !
        !  C Force Prerequisite Check                                               !
        !  ---PF1-----------PF3---------PF5---------PF6----------PF7--------PF8-----!
        !     Help          End         Force       JA-SD        Up         Down    !
        +---------------------------------------------------------------------------+

      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

  The listed message means that the current run of the job (run number `4786`) is waiting for the following:

  - The setting of the input condition `E60-J015-0` from the same run. See Messages in Active Jobs Lists in the Messages and Codes documentation for a full list of possible messages and their meaning.

  - The setting of the input condition `E60-J019-0` from the same run. See Messages in Active Jobs Lists in the Messages and Codes documentation for a full list of possible messages and their meaning.

  The text `Job is in passive wait since 19.03 14:43` indicates that the job has been in a passive wait for input conditions.

  In this case, the job is automatically returned to the active wait by setting one of the input conditions, i.e., the Monitor will execute a prerequisite check.

  Before this message, you can force an active prerequisite check using the line command `C`.

All line commands available in the Prerequisites window are described in Line Commands: Prerequisites for an Active Job.

### Line Commands: Prerequisites for an Active Job

The following line commands are available in the Prerequisites window:

Command | Description
--- | ---
`C` | Force an active prerequisite check. Only before the message `Job is in passive wait since ...`
`R` | Reset: If used for a condition wait: reset the condition to false. If used for a resource wait: delete the active prerequisite resource definition. The active job will then no longer wait for the resource. A window opens in which you can confirm the action by entering the condition name and pressing ENTER.
`S` | Set: Used for a condition wait: set the condition to true. A window opens in which you can confirm the action by entering the condition name and pressing ENTER.
`W` | Where used: If used for a condition wait: display the usage of the active condition. For further information, see Displaying Conditions for an Active Job. If used for a resource wait: display the usage of the resource. For further information, see Viewing and Modifying Resources Used by Active Jobs.

If the prerequisite is an input condition, you can set or reset the condition manually by typing `S` or `R` in the line command input field of the selected condition.

- Use the line command `S` to set the condition to true;

- Use the line command `R` to reset the condition to false.

In either case, a window opens in which you can confirm the manual (re)setting by entering the condition name. Type in the condition name and press ENTER to confirm the operation and close the window.

The following special PF keys are available in the prerequisites window:

PF Key | Name | Function
--- | --- | ---
PF5 | Force | Force an active prerequisite check. This can be used for all combinations of input conditions.
PF6 | JA-SD | Job Active - Show Details Show further and internal attributes of the active job. A window with more information will open. It shows Internal status codes 'Passive Wait for' information Time stamps This function is mainly intended for debugging purposes.

## Viewing and Modifying Resources Used by Active Jobs

You can display the resources used by active jobs.

You can also modify resources for the current run of an active job without changing the original resource specification on the master database for future job runs. This can be useful if different job runs require different amounts of a specific resource, for example paper or tape drives.

To list resources defined as prerequisites for an active job

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

   A Prerequisite Resources (active) screen appears with a list of resources allocated to the active job.

   This screen corresponds to the Prerequisite Resources (Master) screen which is explained in the section Job Maintenance. For explanations of the columns and fields provided on the screen, see Columns and Fields: Prerequisite Resource Definitions (Job Maintenance).

2. If you type `W` next to a resource listed on the Prerequisite Resources (active) screen and press ENTER, an Active Resource Usage screen appears. This screen is described in Listing Jobs Currently Using a Resource in the Administration documentation.

To list resources currently allocated by an active job

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

  An Allocated Resources (active) screen like the example below appears:

       03.12.19                ***** Entire Operations *****                17:41:02
                                  Allocated Resources (active)
       ------------------------------------------------------------------------------
       Owner SAG        Network B60-FLOW   Version                 Job JOB-01
       Run from 5     to 5                          required
       Cmd  Run Job        Resource             T   Quantity  A D DNO   allocated
       _      5 JOB-01     HUGO                 R       5.00  A K     03.12 17:14

       ******************************* Bottom of Data *******************************
       B Browse   D Delete   M Modify   R Master Definition   W Where Used

      Enter--PF1----PF2----PF3----PF5---------PF7----PF8-----------------------------
             Help   Add    End    Save        Up     Down

  The screen lists all resources currently allocated by the active job as indicated by the date and time in the allocated column. The information provided on the screen corresponds to the information provided on the Prerequisite Resources (active) screen.

To modify resources for an active job

- On the Prerequisite Resources (active) screen, enter `M` next to the resource you want to modify, and press ENTER.

  A Prerequisite Resource Definition (active) window opens.

  This window corresponds to the Prerequisite Resource Definition (Master) window. You can modify the resources for the active job in the same way as described in Displaying, Modifying and Adding a Prerequisite Resource Definition in the section Job Maintenance.

## Modifying Scheduling Parameters

You can modify the scheduling parameters for a specific job run without changing the originally defined job schedule table

To modify scheduling parameters for an active job

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

  An Active Scheduling Parameters window opens displaying the current schedule values in the same format as defined for the job on the master database.

  The fields and special PF keys available in the window correspond to the fields and PF keys in the Scheduling Parameters window of a job master. You can modify the schedule in the same way as described in Scheduling a Job.

## Browsing Active Job SYSOUT

You can view SYSOUT of an active job depending on the operating system installed at your site:

Operating System | SYSOUT Availability
--- | ---
z/OS | SYSOUT can be browsed immediately after job submission. It is readable until the current last line readable from the spooling system (for example, JES2).
BS2000 | The SYSOUT file can be browsed only after job termination. This is because the SYSOUT file is open during execution and cannot be read.
UNIX/Windows | The SYSOUT file can be browsed immediately after job submission. It is readable up to its current last line.

This section covers the following topics:

- Viewing Job SYSOUT

- SYSOUT File Types on z/OS

- Header and Symbol Information in SYSOUT

- SYSOUT Special Commands on z/OS

### Viewing Job SYSOUT

To view job SYSOUT

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

   If the job has been resubmitted or rescheduled several times, several job IDs can exist for the selected job. If this is the case, a window opens with a list of job IDs in the following format:

        18-03-06                ***** Entire Operations *****                09:00:02
        Active Jobs             Owner EXAMPLE    Network E01-CONTI  Version
        Selection AW________                                   Run from 11___ to 11___
       -------------------------- +----------------------------------------------+ ---
        C   Job          Run Typ  !                                              !
            *---------       ---  !  Owner EXAMPLE    Network E01-CONTI          !
        _   E01-J01       11 JOB  !  Run   11         Job     E01-J03            !
        _   E01-J02       11 JOB  !                                              ! 02
        S   E01-J03       11 JOB  !  Select a Job Id:                            ! ted
        _   E01-J04       11 JOB  !                            Repeat            ! 03
        _   E01-J05       11 JOB  !  Current:   X     208456        1            !
        _   E01-J06       11 JOB  !  Previous:  _     108565        0            ! 06
                                  !                                              !
                                  !                                              !
                                  !                                              !
                                  !                                              !
                                  !                                              !
        ************************* !  PF3 End PF7 Up PF8 Down                     ! ***
        A Sc.P B Brw C Can D Dea  +----------------------------------------------+ es.
        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

   The top half of the window identifies the job by owner, job network, network version, job name and run number, the bottom half contains a list of job IDs; the job ID assigned for the current run is at the top, followed by previous runs.

   If there are more than 5 previous executions, you can scroll through the list with PF7 (Up) and PF8 (Down).

2. Mark the job ID of the run for which you wish to see the SYSOUT file with any character, and press ENTER.

   If only one SYSOUT file exists for the selected job, this window is bypassed and the SYSOUT file is displayed immediately.

   In browse mode, the SYSOUT file is displayed in the editor and you can use editor PF keys and browse commands:

        JobId DUMMY (63346) Type SM File 1---------------------------- Columns 001 072
        ====>                                                          SCROLL===> CSR
        ***** ****************************** top of data *****************************
        00001 1                       J E S 2  J O B  L O G  --  S Y S T E M  D A E F
        00002 0
        00003  10.45.30 JOB63346 ---- SUNDAY,    25 SEP 2016 ----
        00004  10.45.30 JOB63346  IRR010I  USERID ESI      IS ASSIGNED TO THIS JOB.
        00005  10.45.31 JOB63346  ICH70001I ESI      LAST ACCESS AT 10:45:31 ON SUNDAY
        00006  10.45.31 JOB63346  $HASP373 DUMMY    STARTED - INIT 22   - CLASS K
        00007  10.45.31 JOB63346  IEF403I DUMMY - STARTED - TIME=10.45.31
        00008  10.45.31 JOB63346  -                                      ----TIMINGS (
        00009  10.45.31 JOB63346  -STEPNAME PROCSTEP    RC   EXCP   CONN       TCB
        00010  10.45.31 JOB63346  -STEP01               00      4      0  0.000091  0.
        00011  10.45.31 JOB63346  IEF404I DUMMY - ENDED - TIME=10.45.31
        00012  10.45.31 JOB63346  -DUMMY    ENDED.  NAME-                     TOTAL TC
        00013  10.45.31 JOB63346  $HASP395 DUMMY    ENDED - RC=0000
        00014 0------ JES2 JOB STATISTICS ------
        00015 -  25 SEP 2016 JOB EXECUTION DATE
        00016 -           25 CARDS READ
        00017 -           63 SYSOUT PRINT RECORDS
        00018 -            0 SYSOUT PUNCH RECORDS
        00019 -            7 SYSOUT SPOOL KBYTES
        00020 -         0.00 MINUTES EXECUTION TIME
        ***** **************************** bottom of data ****************************

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        End   Quit  Rfind       Up    Down        Left  Right Curso

> Notes about SYSOUT File Display

>   The following applies when viewing SYSOUT:

>   - Name of the SYSOUT file
>     In BS2000, UNIX and Windows, the SYSOUT file name is indicated in the upper left-hand corner of the screen.

>   - Automatic Logon to the Operating System Server
>     Before a SYSOUT file is displayed, Entire Operations checks whether the user is allowed to access the SYSOUT file. If necessary, an automatic logon is carried out with the user ID, which is entered for the user as a standard user ID for the operating system server (see Defining Node Default User IDs in the Administration documentation). If this automatic logon does not function, for BS2000 files, a further attempt will be made with the BS2000 user ID from the fully qualified file name. If this was successful, the current user ID is set accordingly for the operating system node. If the user does not (implicitly or explicitly) log on to the operating system server with the credentials required to access SYSOUT, the SYSOUT file cannot be displayed.

>   - Line Length under UNIX and Windows
>     Lines longer than 250 characters will be abbreviated in the SYSOUT display. They will be marked with `>>>` in the columns 247 to 250 of the display.

>   - Maximum SYSOUT Size
>     If a maximum SYSOUT size (in MB) is defined and no SYSOUT line limit is defined, the SYSOUT display is rejected with an error message. See Maximum SYSOUT Size (in MB) in Default Setting (4) in the Administration documentation.

>   - File Truncation
>     If the SYSOUT file or spool data set exceeds a given line limit, the display will be truncated: see SYSOUT Line Limit in Default Setting (4) in the Administration documentation.

>   - Number of Previous Executions
>     Entire Operations can display SYSOUT of up to 180 previous executions of the job (e.g., repetitions, cyclic executions).

### SYSOUT File Types on z/OS

On z/OS, SYSOUT files are identified by the following output types to distinguish their contents:

File Type | Purpose | Applies on
--- | --- | ---
`CC` | Summary of job steps and condition codes. |
`JL` | JCL of selected job. |
`SI` | SYSIN data. |
`SM` | System messages. |
`SO` | SYSOUT data. |

The file types listed in the table above can be used in the `FILE` special command described in SYSOUT Special Commands on z/OS.

### Header and Symbol Information in SYSOUT

You can generate standard header information and symbol replacement information that is inserted as comments into job SYSOUT of submitted JCL if the appropriate Entire Operations default settings are activated:

- For header information, activate the Generate Header in submitted JCL option in the Default Setting (2) (see the Administration documentation).

  Header information in job SYSOUT looks like the following example:

       JobId JOB01 (506414) Type SM File 2--------------------------- Columns 001 072
       ====>                                                          SCROLL===> CSR
       ***** ****************************** top of data *****************************
       00001         1 //JOB01 JOB ,SAG,CLASS=G,
       00002           //         MSGCLASS=X,MSGLEVEL=(1,1)
       00003           /* LINES=3
       00004           //* =====================================================
       00005           //* S O F T W A R E   A G
       00006           //* Entire Operations             Version 5.5.1.3
       00007           //*
       00008           //* Owner            SAG          Run              2
       00009           //* Network          E60-FLOW     Symbol Table     EXAM-ST1
       00010           //* Version                       Version
       00011           //* Job              JOB-01       Escape Act.      @ Sub. $
       00012           //* Job Type         JOB          Repetition       2
       00013           //*                               Submit User ID   SID
       00014           //* JCL Node         146          Exec.Node        146
       00015           //* JCL Location     MAC          NPR Version      3.6.3
       00016           //* Monitor Codepage              IBM01140
       00017           //* Job is resubmitted/rescheduled/reactivated. Old JobId(s)
       00018           //* (1) 505605 (0) 505567
       00019           //*
       00020           //* 13.02.20 18:19 created/modified .. SAG
       00021           //* 14.02.20 14:25 activated ......... SAG - Origin M
       00022           //* 14.02.20 17:07 last action ....... SAG
       00023           //* 14.02.20 17:07 submitted
       00024           //* =====================================================
       00025           //* Symbols replaced at JCL Loading:
       00026           //*
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help        End   Quit  Rfind       Up    Down        Left  Right Curso

  Notes:

  1. The `Submit User ID` is always shown.
  2. The created/modified user ID is modified only if the job definition or JCL was modified. Activation or reactivation does not count as a modification.
  3. In BS2000, the LOGON statement is checked. If nothing else was specified at job definition, the LOGON parameters, account-number, job-class, monitoring job variable (with password, if specified) are taken from here. Job priority, run priority and CPU time limit can also be given via LOGON statement.

- For symbol replacement information, activate the Log Symbol Values in submitted JCL option in the Default Setting (2) (see the Administration documentation).

  Symbol replacement information shows replaced symbols and their current values if any symbols were replaced at job submission as shown in the following example:

      JobId JOB01 (506414) Type SM File 2--------------------------- Columns 001 072
      ====>                                                          SCROLL===> CSR
      00027           //* Symbol  : CLASS
      00028           //*   Owner : SAG Symbol Table: EXAM-ST1 Version:
      00029           //*   Type  : JA - Symbol table of active job
      00030           //*   Modif.: SID on 2011-11-03 at 16:49
      00031           //*   Value : G
      00032           //* Symbol  : MSGCLASS
      00033           //*   Owner : SAG Symbol Table: EXAM-ST1 Version:
      00034           //*   Type  : JA - Symbol table of active job
      00035           //*   Modif.: SID on 2011-11-03 at 16:49
      00036           //*   Value : X
      00037           //* Symbol  : JOBLIB
      00038           //*   Owner : SAG Symbol Table: EXAM-ST1 Version:
      00039           //*   Type  : JA - Symbol table of active job
      00040           //*   Modif.: SID on 2011-11-03 at 16:49
      00041           //*   Value : NOP.EXAMPLE.LOAD
      00042           //* =====================================================
      00043           //*

### SYSOUT Special Commands on z/OS

On z/OS, in addition to the standard editor browse commands, the following special commands are available to display selected SYSOUT files:

Command | Description | Applies on
--- | --- | ---
`[FILE] number` | Display the SYSOUT file by `number`, for example, `FILE 4`. If you omit the `FILE` keyword, the command scans the current file for a line number and displays the text from this line. | z/OS only
`[FILE] type` | Display the SYSOUT file by `type`, for example, `FILE SO`. See also SYSOUT File Types on z/OS and. |
`[FILE] type number` | Select the SYSOUT file by `type` and `number`, for example, `FILE SO 4`. See also SYSOUT File Types on z/OS and. | z/OS only
`LINE 2` | Split all lines too long for display into 2 lines. Return to normal display with an unqualified `LINE` command. | z/OS only
`NEXT` | Display the next SYSOUT file. |
`PREV` | Display the previous SYSOUT file. |

Square brackets `[ ]` around the command keyword `FILE` denote that the keyword is optional.

### On this page

- Listing Active Jobs
- Listing Jobs of an Active Subnetwork
- Adding a New Job to the Active Network
- Viewing and Modifying the Active Jobs Schedule
- Cancelling, Holding and Releasing Active Jobs
- Resubmitting Active Jobs
- Deactivating a Job in an Active Network
- Reactivating an Active Job
- Displaying and Modifying an Active Job Definition
- Modifying EOJ Checking and Actions
- Viewing Long Descriptions of Active Jobs
- Displaying Prerequisites for Active Jobs
- Viewing and Modifying Resources Used by Active Jobs
- Modifying Scheduling Parameters
- Browsing Active Job SYSOUT