Scheduling a Network

This document covers the following topics:


Defining a Network Schedule

Start of instruction setTo define a schedule for a network

  1. On the Network Maintenance screen, type S in the Cmd column next to the required network. Press ENTER.

    A Network Schedule Definition screen similar to the example below appears:

     13.12.18                ***** Entire Operations *****                18:27:51 
                              Network Schedule Definition                          
                         Owner EXAMPLE     Network B60-FLOW                        
    -------------------------------------------------------------------------------
        Schedule Owner ==> EXAMPLE___                                              
        Schedule       ==> TEST-SCHED  effective from ==> ________ ________        
                                                                                   
                                                                                   
           Schedule          Earliest   Latest    Days              Days           
       Cmd Dependency        Start      Start    later T  Deadline later T         
        _  +WM +24           07:00:00   10:00:00   1__ W  18:00:00   2__ C         
        _                    ________   ________   ___ _  ________   ___ _         
        _                    ________   ________   ___ _  ________   ___ _         
        _                    ________   ________   ___ _  ________   ___ _         
        _                    ________   ________   ___ _  ________   ___ _         
                                                                                   
        Number of Activations ==> _____  every ==> _____ minutes                   
        or activate at ==> _____ _____ _____ _____ _____                           
                           _____ _____ _____ _____ _____                           
        Day Deadline   ==> _____                                                   
                                                                                  
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End   ExplD Save        Sch.L Sch.M Delet             Menu
  2. Enter the required values or replace existing entries.

    All fields, line commands and special PF keys provided on the screen are explained in the following section.

This section covers the following topics:

Fields: Network Schedule Definition

The input fields on the Network Schedule Definition screen are described in the following table:

Field Description
Schedule Owner Owner of the schedule to be used.

Wildcard selection is possible.

Default: Owner of the network

Schedule Name of the schedule to be used.

Schedule comprises a link to a calendar.

Definition of dates on which the network is to be executed.

effective from Schedule effective from (date and time)

If a schedule should not become effective immediately, enter the date (and time) of the validity begin here.

If no time is specified, the schedule becomes effective at 00:00.

Cmd Input field for line commands: see Line Commands: Network Schedule Definition.
Schedule Dependency This option is used to specify days when the network is deactivated and not executed.

See Adding and Modifying a Time Frame Definition.

Earliest Start Earliest start time for the network.

No job in the network can start before this time. The Earliest Start time is used to compute network schedule times.

See also Date and Time Formats (section Using Entire Operations) and Processing of Time Frame Definitions.

Latest Start Latest start time for the network.

The first job in the network must start by this time, if possible. If not, a warning message is sent and the job is not submitted.

See also Date and Time Formats (section Using Entire Operations) and Processing of Time Frame Definitions.

You can specify the number of workdays or calendar days to be used for later starts: see Days later below.

Deadline Time by which the last job in the network must be finished.

The deadline is used to compute the earliest and latest start times for the jobs in the network.

See also Date and Time Formats (section Using Entire Operations) and Processing of Time Frame Definitions.

Days later This field is to be used if Latest Start and/or Deadline are later than 24 hours after the Earliest Start.

Valid values: 1 - 999 days.

Default for Deadline: 2 calendar days later.

See also Processing of Time Frame Definitions.

Note:
The Entire Operation default settings provide the option to define later start times in units of hours instead of integer days, for time ranges that are not a multiple of 24.

T

Specifies the day type:

C Calendar day (default).
W Workday as defined in the calendar linked to the schedule.
Number of Activations This field is used to activate a network more than once a day. In this case, enter the number of activations per day.

If the network is to be activated once per schedule day only, leave this field blank.

Valid input values: 2 to 999

every ... minutes:

If a network is to be activated more than once per day, you can enter the time interval between two subsequent network activations.

This field can be used without Number of Activations, too. In this case, the number of activations will be limited by the defined latest network start time.

Unit: minutes

See also Defining Multiple Network Activations for further information.

or activate at In these fields, you can enter up to 10 activation times, as an alternative to Number of Activations.

Format: HH:MM or HHMM or HH

Examples: 20:11, 1314, 18

Note:
If activation times are defined for a network, the job-specific time frames will be adapted to fit into the network time frame.

See also Defining Multiple Network Activations for further information.

Day Deadline If a Day Deadline is defined, the Deadline of multiple activations (everyminutes or Activate at) is limited to this time on the day of the activation.

Format: HH:MM

Line Commands: Network Schedule Definition

The line commands available for the time frame columns on the Network Schedule Definition screen are described in the following table:

Line Command Description
D Delete the time frame definition.

See also Deleting Time Frame Definitions for a Network.

I Insert an empty line before the current line.
M Add or modify the schedule dependency of the time frame definition.

See also Adding and Modifying a Time Frame Definition.

Special PF Keys: Network Schedule Definition

You can perform the following function from the Network Schedule Definition screen using these PF keys:

PF Key Name Function
PF4 ExplD Explicit Date.

Define explicit execution dates at the network level.

See also Defining Explicit Dates for a Single Network only and Date and Time Formats.

PF7 Sch.L Schedule list.

Display the linked schedule in a half-year calendar format.

PF8 Sch.M Schedule modification.

Invoke the schedule definition of the defined schedule.

PF9 Delete Delete (reset) all fields of the screen.

Processing of Time Frame Definitions

This section describes the rules and processes that apply when specifying time frames for a network or job schedule on the Network Schedule Definition screen or the Scheduling Parameters window of a job master or job active:

Hierarchical Order

Time frames defined on the job level override time frame definitions made on the network level for this job. If no time frames are defined here, the job network defaults apply.

Changes to Time Frames of Active Jobs

All modifications to time frames of an active job affect the active database and the current job run only. Time frame definitions for the job master remain unchanged.

Time Frame Selection Rules for a Network

Time frames are selected according to the following rules:

  • A blank line with no time frame dependency entry is applied as the network start date if no other time frame dependency entry matches the network start date.

  • From top to bottom, each line with a defined schedule dependency condition is applied to the network. If a condition is satisfied, the respective time frame values are used for the active network.

    Example: The definition +CW+3 means this definition applies if the network starts on Wednesday. -CW+3 means this definition applies if the network starts on all other weekdays except Wednesday.

  • If none of the defined lines is selected, the network uses the default time settings. See also Default Setting (2) in the Administration documentation.

Time Frame Rules for Start/End Times and Day Later Definitions

  • If both Latest Start or Deadline and Days later are not specified, the Entire Operation defaults specified for Default Latest Start after Earliest Start and Default Deadline after Earliest Start on the Default Setting (2) screen apply (see the Administration documentation).

  • If Latest Start or Deadline is given and Days later is not specified, Days later is automatically filled as described above.

  • If applying any of the above rules and Days later of Latest Start or Deadline becomes greater than 999, it remains empty and an error message is issued.

  • If Latest Start is before Earliest Start and Days later is not specified, the Days later value for Latest Start is set to 1 by default.

  • If Deadline is before Earliest Start and Days later is not specified, Days later is set to 1 so that this time follows the earliest start time.

Defining and Deleting Time Frames for a Network

Adding and Modifying a Time Frame Definition

Start of instruction setTo add or modify a time frame definition for a network

  1. If you want to create or modify a time frame definition, enter or replace the required values in the time frame columns on the Network Schedule Definition screen.

    For valid input values, see Fields: Network Schedule Definition.

    For valid time formats, see Date and Time Formats in the section Using Entire Operations.

    See also Time Frame Selection Rules for a Network and Processing of Time Frame Definitions.

  2. If you want to add or modify the schedule dependency for a time frame, type M in the Cmd column next to the line that contains the required time frame.

    A Schedule Dependency Definition for Time Frame window similar to the example below opens:

    +---------------------------------------------------------------+
    |                                                               |
    |       Schedule Dependency Definition for Time Frame           |
    |                                                               |
    |  Owner   EXAMPLE         Job                                  |
    |  Network B60-FLOW        Condition                            |
    |                                                               |
    |  The time frame will be used on this(+)/all other(-) dates,   |
    |  if the execution date has the following position in the      |
    |  schedule or calendar:                  Schedule Usage ==> _  |
    |                                                               |
    |        Usage ==> +  + only              - except              |
    |                     A after Holiday too B before Holiday too  |
    |         Type ==> W  H is Holiday    X is Workday              |
    |                     C Calendar Day  W Workday  S Schedule Day |
    |    in Period ==> M  W Week          M Month    Y Z Year       |
    |  at Position ==> 24__                                         |
    |     or Month ==> __ Day ==> __                                |
    |  ----PF1------PF3---------PF5------------------PF9----------- |
    |      Help     End         Save                 Delete         |
    +---------------------------------------------------------------+

    The input fields contained in the window are described in Fields: Schedule Dependency Definition.

Deleting Time Frame Definitions for a Network

Start of instruction setTo delete a single time frame definition

  1. On the Network Schedule Definition screen, type D in the Cmd column next to the time frame definition you want to delete.

    A confirmation window opens.

  2. Enter Y (Yes) to confirm the deletion. N (No) cancels the action. Press ENTER.

    The selected time frame definition is removed from the Network Schedule Definition screen.

Start of instruction setTo delete all time frame definitions

  1. On the Network Schedule Definition screen, choose PF9 (Delete).

    A confirmation window opens.

  2. Enter Y (Yes) to confirm the deletion. N (No) cancels the action.

    Press ENTER.

    All time frame definitions are removed from the Network Schedule Definition screen.

Start of instruction setTo delete a time frame dependency from a time frame definition

  1. In the Schedule Dependency Definition for Time Frame window, choose PF9 (Delete).

    A confirmation window opens.

  2. Enter Y (Yes) to confirm the deletion. N (No) cancels the action.

    Press ENTER.

    The time frame dependency is removed from the time frame definition on the Network Schedule Definition screen.

Defining Dates for Explicit Network Execution

You can define explicit dates on which a network always or never executes, regardless of any other schedule definitions. Explicit dates supersede all other schedule definitions.

You can define explicit dates for all networks linked to a schedule or for a single network only.

This section covers the following topics:

Defining Explicit Dates for a Schedule

Start of instruction setTo add or modify explicit dates for a schedule

  • On the Schedule Definition screen, enter the required dates in the input lines under Explicit Dates as shown in the example of a Schedule Definition screen.

    For valid input values, see the field Explicit Dates in Fields: Schedule Definition.

Defining Explicit Dates for a Single Network only

You can define explicit schedule dates on the network level. Dates defined here are network-specific in contrast to schedule definitions which affect all linked networks.

Notes:

  1. Any modification made with this function causes the recalculation of the current schedule of the network.
  2. Explicit dates override all definitions made in schedule(s) linked to the network.
  3. Deletions of planned activations can cause that the day of deletion is added to the dates to be excluded on the Explicit Dates screen (for example, 29.01.19-). This is to avoid that the network is again activated on this day. (Explicit exclusion dates on the network level are set implicitly by the network activation cancelling function.)

Start of instruction setTo define explicit dates for a single network only

  1. Choose PF4 (ExplD) on the Network Schedule Definition screen.

    A Network Schedule - Explicit Dates screen similar to the example below appears:

     26.02.10                ***** Entire Operations *****                12:52:05 
    
     Owner TESTBED         Network Schedule - Explicit Dates     Network NET01-517 
    
    -------------------------------------------------------------------------------
    
    
     Explicit Dates:                                                               
    
      27.02.10-  28.02.10-  01.03.10-  03.03.10-  _________  _________  _________  
    
      _________  _________  _________  _________  _________  _________  _________  
    
      _________  _________  _________  _________  _________  _________  _________  
    
      _________  _________  _________  _________  _________  _________  _________  
                                                         
    
                                                                                   
                                                                                  
    
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
    
          Help        End         Save                    Reset

    Enter or replace the dates you want to explicitly use for the selected network. The input fields and special PF key are described in the following section.

  2. Choose PF3 (End) to return to the Network Schedule Definition screen.

Special PF Keys: Network Schedule – Explicit Dates

You can perform the following function from the Network Schedule - Explicit Dates screen using this PF key:

PF Key Name Function
PF9 Reset Reset (delete) all definitions.

Fields: Network Schedule – Explicit Dates

The input fields of the Network Schedule - Explicit Dates screen are described in the following table:

Field Description
Explicit Dates A list of explicit dates in the date format specified within Entire Operations defaults.

If the date is followed by a minus sign (-), the date will be excluded from the schedule.

Example: 21.12.16-

The network is not activated on 21.12.2016.

Defining Multiple Network Activations

You can repeat network activations multiple times.

Note:
If activation times are defined for a network, the job-specific time frames will be adapted to fit into the network time frame.

Start of instruction setTo define multiple network activations

  1. On the Network Schedule Definition screen, enter (or replace) either or both of the following:

    Or:
    On the Network Schedule Definition screen, enter the following:

    • In the input fields next to or activate at, enter single or multiple times to be used for network activation.

  2. If required, enter a time limit for activation in the Day Deadline.

  3. Choose PF5 (Save) to save your entries.

The rules that apply when defining multiple activations are described in the following section:

Activation End

Multiple activations are limited

  • until the end of the schedule day,

  • until the latest start,

  • by the defined number of activations,

whichever comes first.

Calculation of Time Frames for Multiple Activations

The following applies if both Number of Activations (na) and every ... minutes (em) have a non-zero value:

  • The latest start time of a time frame (tf_latest_start) is interpreted as the latest start time of the first multiple activation.

  • For activation 1 <= n <= na, the latest start time of the specific activation will be set to tf_latest_start + (n - 1) * em .

  • The multiple activation end time (mae) will be calculated as mae = schedule_date + tf_latest_start + (na * em)

If the multiple activation end time (mae) is after the defined deadline of a time frame, it will be set to the deadline of the time frame.

If the multiple activation end time (mae) is after the end of the schedule day, it will be set to the end of the schedule day.

Note:
A network is no longer treated as "already activated on the current day" if there was a multiple activation on the day before, which resulted in some runs that were executed after midnight. In this case, automatic activations (due to schedule) will not be blocked by the "activation on current day" check.

Viewing a Network Schedule Definition as a Calendar

Start of instruction setTo display the calendar view of a network schedule

  1. On the Network Maintenance screen, type W in the line command field of the selected network. Press ENTER.

    A Network Schedule screen similar to the example below appears:

     16-07-02                ***** Entire Operations *****                16:20:20 
     Owner SAGTEST     Network Schedule B60-FLOW   Year 2016                       
                                                                                   
                     July                 August               September           
     Monday          .  .  .  .        .  .  .  .  .           .  .  .  .          
     Tuesday         .  .  .  .        .  .  .  .  .           .  .  .  .          
     Wednesday       .  .  .  .        .  .  .  .  .           .  .  .  .          
     Thursday        .  .  . 28        .  .  .  .           .  .  .  .  .          
     Friday       .  .  .  .  .        .  .  .  .           .  .  .  .  .          
     Saturday     .  .  .  .  .        .  .  .  .           .  .  .  .             
     Sunday       .  .  .  .  .        .  .  .  .           .  .  .  .             
                                                                                   
                     October              November             December            
     Monday          .  .  .  .  .        .  .  .  .           .  .  .  .          
     Tuesday         .  .  .  .        .  .  .  .  .           .  .  .  .          
     Wednesday       .  .  .  .        .  .  .  .  .           .  .  .  .          
     Thursday        .  .  .  .        .  .  .  .           .  .  .  .  .          
     Friday          .  .  .  .        .  .  .  .           .  .  .  .  .          
     Saturday     .  .  .  .  .        .  .  .  .           .  .  .  .  .          
     Sunday       .  .  .  .  .        .  .  .  .           .  .  .  .             
                                                                                   
    
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End   Overv             Up    Down  Calen Histo NxtSt

    The current half of the year in displayed in the calendar format. The dates on which the network is to be activated appear on the schedule.

    The network based on this schedule is activated every weekday from January to June except on Saturday and Sunday.

    You can enter any valid year in the Year field in the header section of the screen to display the schedule for the specified year.

    If a calendar is linked to the schedule but not defined for the displayed year, you are notified by an error message.

Note:
There are two different formats for all schedule and calendar displays. The format can be modified in the Default Setting (1) option of the Entire Operations Defaults described in the Administration documentation.

Special PF Keys: Network Schedule

You can perform the following functions from the Network Schedule screen using these PF keys:

PF Key Name Function
PF4    Overv    Overview

Produces a network start summary for a given date: see Producing a Network Start Summary.

(Only if your Natural online system runs under z/OS)

Before you choose this key, place the cursor on a valid date.

PF7 Up Displays the previous half of the year or previous years.
PF8 Down Displays the next half of the year or following years.
PF9  Calen  Calendar

Displays the calendar linked to this schedule (if defined).

The calendar can be modified as described in the section Calendar Maintenance.

PF10  Histo  History

Displays the previous execution dates of the network.

See also Displaying the Network Execution History.

PF11   NxtSt  Next Starts

Displays the next network and job activations for the network and whether they are scheduled or manual activations.

See also Producing a Network Start Summary.

Producing a Network Start Summary

This section describes how to produce a network start summary for a single network. The report looks similar to the example of a Network Start Summary shown in the Reporting section.

If you want to produce a Network Start Summary for all network activations on a given day, see the corresponding report described in the section Reporting.

Start of instruction set To produce a network start summary for the current network

  1. On the Network Schedule screen, select a valid date and choose PF4 (Overv). In a z/OS environment, you can place the cursor on the required date.

    The following windows open:

      29.10.08             +--------------------------------------------------+1:16
      Owner EXAMPLE        !                                                  !
                           !             Network Start Summary                !
                      Janu !                                                  !
      Monday       1  8 15 !  Owner EXAMPLE Network E50-USRT                  !
      Tuesday      2  9 16 +--------------------------------------------------+
      Wednesday    3 10 17 24 31           7 14 21 28           7 14 21 28
      Thursday     4 11 18 25           1  8 15 22           1  8 15 22 29
      Friday       5 12 19 26           2  9 16 23           2  9 16 23 30
      Saturday     .  .  .  .           .  .  .  .           .  .  .  .  .
      Sunday       .  .  .  .           .  .  .  .           .  .  .  .
                      April                May                  June
      Monday          2  9 16 23 30        7 14 21 28           4 11 18 25
      Tuesday         3 10 17 24        1  8 15 22 29           5 12 19 26
      Wednesday       4 11 18 25        2  9 16 23 30           6 13 20 27
      Thursday        5 12 19 26 +-----------------------------------------------+
      Friday          6 13 20 27 !                                               !
      Saturday        .  .  .  . !      Send Output to Printer ?  N (Y/N)        !
      Sunday       .  .  .  .  . !                                               !
                                 +-----------------------------------------------+
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        End   Overv             Up    Down  Calen Histo NxtSt
  2. In the window at the bottom of the screen you are asked Send Output to Printer?

    If you enter Y and press ENTER, output is printed on the printer assigned to Workfile 1.

    If you enter N and press ENTER, the Network Start Summary screen appears for the selected date as shown in the following example:

    MORE
     2***** Entire Operations *****                      13:21:46
                        Network Start Summary for 29.10.08                Page    1
     ------------------------------------------------------------------------------
     EXAMPLE    E50-USRT
    
     ---------------------          Aw. Symbol prompting
     ( 237) 29.10 00:00             Symbol prompting request to EXAMPLE
            29.10 00:00             ***** End of Report *****
  3. Choose PF3 (End) to return to the Network Schedule screen.

Schedule Modification and Planned Starts

In the Entire Operations Defaults, the system administrator can define that network schedules are to be extracted several days before the network starts. These planned starts are represented by activation trigger records, which already have a run number.

If your schedule modification affects any planned start, you have the option of cancelling the starts or keeping them active. The following window opens:

  29.10.08               ***** Entire Operations *****                    12:58:28
  Owner EXAMPLE                Schedule Definition
   +---------------------------------------------------+
 - !                                                   !------------------------
   !       Owner EXAMPLE     Network E50-USRT          !
   !                                                   !
   !   The following planned starts would be           !eekly   E Explicit Dates
   !   cancelled due to your schedule modification:    !
   !                                                   !
   !            Date     Time          Run             !
   !            17.11.08 10:32         142             !
   !                                                   !
   !                                                   !
   !                                                   !
   !                                                   !
   !                                                   !
   !                                                   !
   !                                                   !
   !                                                   !
   !                                                   !
   !  ---------------------------------------------    !_________________
 E !  PF5 Cancel   PF6 Do not cancel                   !F9---PF10--PF11--PF12---
   +---------------------------------------------------+al               Menu  

Special PF Keys: Planned Starts

The Planned Starts window provides the following special PF keys:

PF Key Name Function
PF5 Cancel Cancels starts listed. A confirmation window opens for each start to be cancelled.
PF6 Do not cancel Keeps all listed starts active, regardless of your schedule modification.

Cancelling Planned Starts

Start of instruction set To cancel one or more of the planned starts listed

  • Choose PF5 (Cancel).

    A confirmation window opens for each start to be cancelled:

      29.10.08               ***** Entire Operations *****                    13:08:28
      Owner EXAMPLE                Schedule Definition
       +---------------------------------------------------+
     - !                                                   !------------------------
       !       Owner EXAMPLE     Network E50-USRT          !
       !                                                   !
       !   The following planned starts would be           !eekly   E Explicit Dates
       !   cancelled due to your schedule modification:    !
       !                                                   !
       !            +----------------------------------------------+
       !            !                                              !
       !            !  Please confirm                              !
       !            !  Start Cancel of E50-USRT (142)              !
       !            !  by entering E50-USRT                        !
       !            !          ==> ______________________________  !
       !            !  PF3 End                                     !
       !            +----------------------------------------------+
       !                                                   !
       !                                                   !
       !                                                   !
       !  ---------------------------------------------    !_________________
     E !  PF5 Cancel   PF6 Do not cancel                   !F9---PF10--PF11--PF12---
       +---------------------------------------------------+al               Menu

Keeping Planned Starts

Start of instruction set To keep all listed starts active, regardless of schedule modifications you have made

  • Choose PF6 (Do not cancel).

Displaying Next Network Starts - Single Network

This section covers the following topics:

Displaying the Next Network and Job Starts

Start of instruction set To display the next network and job starts for a network

  • Choose PF11 (NxtSt) on the Network Schedule screen.

    A Next Start Times window similar to the example below opens:

    +-----------------------------------------------------------------------+
    |                                                                       |
    |  Owner EXAMPLE     Network B60-FLOW                                   |
    |  Next Start Times                                                     |
    |                                                                       |
    |  Cmd  Date     Act.  Start   Run Version    Type                      |
    |  _    18.02.19 08:48 08:48  2976            Hold for Symbol Entry     |
    |  _    18.02.19 08:55 08:55  2978            Hold for Symbol Entry     |
    |  _    01.03.19 00:00 00:00  2985            Schedule, active          |
    |       01.03.19 00:00 10:00                  Schedule Table            |
    |       04.03.19 00:00 10:00                  Schedule Table            |
    |       05.03.19 00:00 10:00                  Schedule Table            |
    |       06.03.19 00:00 10:00                  Schedule Table            |
    |       07.03.19 00:00 10:00                  Schedule Table            |
    |       08.03.19 00:00 10:00                  Schedule Table            |
    |       11.03.19 00:00 10:00                  Schedule Table            |
    |  ***************************** m o r e *****************************  |
    |  A Active Jobs   D Deactivate   M Start Time   S Active Symbols       |
    |  PF1 Help  PF2 Add  PF3 End  PF7 Up  PF8 Down                         |
    +-----------------------------------------------------------------------+

    This window displays a list of planned activations for one network only.

    The Type column displays the activation type (scheduled, manual).

    You can cancel manual activations with the D (Deactivate) line command. Scheduled activations can only be changed by modifying the schedule definition.

    Note:
    To display a system-wide list of planned activations, choose PF11 (NxtSt) from the Network Maintenance or Active Job Networks screen. For further information, see Displaying Next Network Starts - System-Wide.

Columns: Next Start Times

The following table explains the columns for the data listed in the Next Start Times window:

Column Description
Cmd  One-character input field for line commands.

Possible values are listed in the command section of the screen (see also Line Commands: Next Start Times).

Date  Date of planned network start.

See also Date and Time Formats.

Act.  Time of planned network start.

See also Date and Time Formats.

Start  Time of planned start of network in its operating system.
Run  Run number for this activation.
Type  Displays the current status of the activation.

Possible status types are, for example:

  • Schedule Table,

  • on request,

  • Schedule, active,

  • Activation in Progress,

  • Aw. Symbol Prompting,

  • Symbol Entry in Progress.

Special PF Keys: Next Start Times

The Next Start Times window provides the following special PF key:

PF Key Name Function
PF2  Add  Activates a network manually: see Activating a Job Network Manually in the section Network Maintenance.
Line Commands: Next Start Times

The following line commands are available for planned starts (activations) of job networks to which run numbers are assigned:

Line Command Description
A Active Jobs

List all active jobs of the selected network run.

D  Deactivate

Cancel (deactivate) a planned network start.

M  Start Time

Modify the start time of a planned network start.

S      Active Symbols
When you enter this command for a network whose Type is: ... you can ... :
Schedule, active ... modify the active symbols in the active symbol table(s) of the network.
Awaiting Symbol Prompting ... perform symbol prompting for this planned start.

Cancelling (Deactivating) a Planned Network Start

You can cancel (deactivate) a planned network start only if a run number has already been assigned to the network. Jobs already activated for this run will be deactivated.

A planned network start without a run number can be removed by modifying the network schedule definition or the schedule linked to the network schedule definition.

If an activation is removed for a scheduled date, the date is excluded from the network schedule definition (explicit dates) to prevent further activations for that date.

Symbol Prompting

You can perform symbol prompting only if a run number is assigned to the network planned to start (be activated).

Start of instruction set To perform symbol prompting for a planned start

  1. In the Next Start Times window, enter S in the line command field of the appropriate job or network with Type = Aw. Symbol Prompting.

  2. Press ENTER.

  3. A Symbol Prompting screen appears.

For further information, see Symbol Prompting during Network or Job Activation in the section Symbol Table and Symbol Maintenance.

Modifying an Active Symbol Table

Start of instruction set To modify the active symbols in a network's active symbol table(s)

  1. In the Next Start Times window, enter S in the line command field of the appropriate job or network with Type = Schedule, active.

  2. Press ENTER.

  3. An Active Symbol Tables window similar to the example below opens:

      29.10.08               ***** Entire Operations *****                    14:31:54
      Owner EXAMPLE            Schedule DEMO-NET   Year 2007     Calendar DEMOCAL
                   +-------------------------------------------------+----------+
                   !                                                 !          !
      Monday       !  Owner EXAMPLE    Network DEMO-NET   Run 136    !          !
      Tuesday      !               Active Symbol Tables              !          !
      Wednesday    !                                                 !          !
      Thursday     !       Cmd Table            Cmd Table            !          !
      Friday       !        _  SN-01             _                   !ting      !
      Saturday     !        _  DEMO              _                   !ting      !
      Sunday       !        _                    _                   !ting      !
                   !        _                    _                   !ting      !
                   !        _                    _                   !ting      !
      Monday       !        _                    _                   !ting      !
      Tuesday      !        _                    _                   !          !
      Wednesday    !        _                    _                   !Progress  !
      Thursday     !        _                    _                   !ting      !
      Friday       !        _                    _                   !          !
      Saturday     !                                                 !--------  !
      Sunday       !  Select Symbol Table by marking.                !          !
                   !  PF3 End                                        !          !
     Enter-PF1---P +-------------------------------------------------+----------+---
           Help        End   Overv             Up    Down  Calen Histo NxtSt
  4. Mark the appropriate symbol table with any character. Press ENTER.

    An Active Symbol Table screen similar to the example below appears:

      29.10.08               ***** Entire Operations *****                    14:52:44
      Owner   EXAMPLE         Active Symbol Table SN-01
      Network DEMO-NET                                                   Run 136
      ------------------------------------------------------------------------------
      C Symbol            F P Value                        modified by
      _ A1                A N 'HUGO'                       SN       07.12.05 14:09
      _ A2                A N '''QUOTED'''                 SN       07.12.05 14:10
      _ A3                A E 'XXX   '                     SN       26.03.06 15:33
      _ A4                A E ' '                          SN       22.04.06 15:42
      _ A5                A E AAA                          SN       27.04.06 11:28
      _ A6                N A 777                          SN       17.05.06 10:25
      _ A7                A E PROMPTED AT 14:25            SN       20.05.06 14:20
      _ A8                A E DFFDDFFD                     SN       20.05.06 14:20
      _ CLASS             A A G                            SN1      22.05.06 11:45
      _ CLASS-PRIV        A E *** empty ***                SN1      22.05.06 11:42
      _ DATE              D A 20060818                     SN       18.08.06 15:19
      _ EMPTY             A E YYYYYYYYY                    SN       11.09.06 11:31
      _ HUGO              A E A VERY LONG STRING TO TEST S SN       22.10.06 10:31
      _ JOBLIB            A E NOP.DEV.LOAD                 SN       18.11.06 14:21
      ********************************** More **************************************
      D Delete  M Modify
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Add   End         Save        Up    Down        Print
  5. Enter M in the line command field of the appropriate symbol. Press ENTER.

    An Active Symbol Modification window opens for the symbol selected.

    The window is identical to the Master Symbol Addition window. For further information, see the following descriptions in the Symbol Table and Symbol Maintenance section:

  6. Modify the symbol(s) as required.

  7. Choose PF5 (Save) to save the modified active symbol table.

  8. Choose PF3 (End) twice to close the Active Symbol Modification window and return to the Next Activations window.

Displaying Next Network Starts - System-Wide

Scheduled starts are extracted from the network schedules and put into a pre-activation status. The extraction is usually performed at midnight, one day in advance.

Manual starts are explicitly invoked as manual activations by any user. If a special start time was not entered, the daily time frame is used. See Activating a Job Network Manually in the section Network Maintenance.

This section covers the following topics:

Next Planned Network Starts

Start of instruction set To display a system-wide list of all planned job and network starts

  • Choose PF11 (NxtSt) from the Network Maintenance or Active Job Networks screen.

    A Next scheduled Network Starts screen similar to the example below appears:

     28.02.19                ***** Entire Operations *****                14:12:44 
                             Next scheduled Network Starts                         
     ------------------------------------------------------------------------------
     C Owner      Network      Run Version    Job        Date  Start Type          
       EXAMPLE--- *---------                             28.02 14:12               
     _ EXAMPLE    B60-FLOW    2985                       01.03 00:00 Schedule, acti
     _ EXAMPLE    E60-FLOW    5518 v2.1                  01.03 00:00 Schedule, acti
     _ EXAMPLE    E01-CONTI   1404                       01.03 05:00 Schedule, acti
                                                                                   
     
                                                                                   
                                                                                   
                                                                                   
                                                                                   
     ******************************* Bottom of Data *******************************
     A Active Jobs   D Deactivate   M Start Time   S Active Symbols                
     Command => ____________________________________________________________       
                                                                                 
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End                     Up    Down        Left  Right Menu

    This screen displays a chronological list of all planned network or job starts, both scheduled and manual.

Line Commands: Next Scheduled Network Starts

Use the line commands described in Line Commands: Next Start Times to perform the described functions on any network start listed on the Next scheduled Network Starts screen.

Columns: Next Scheduled Network Starts

The following table explains the columns for the data listed on the Next scheduled Network Starts screen:

Column Description
C  One-character input field for line commands: see Line Commands: Next Scheduled Network Starts.
Owner  Owner of the network to be activated

Above this column, you can make an owner preselection. If this field only contains an asterisk (*), all owners will be displayed. Your selection is stored in the user profile and is available when you invoke this function the next time.

Network  Network to be activated

Above this column, you can make a network preselection. If this field only contains an asterisk (*), all networks for the current owner selection will be displayed. The network preselection is possible only if an owner was selected uniquely.

Your selection is stored in the user profile and is available when you invoke this function the next time.

Run  Run number for this activation.
Version Version of the network
Job  If the activation is for one job only, the job name appears in this column.
Date  Date of activation

You can enter a start date and/or time in the fields above the Date and Start columns to display only those activations due to start after that time.

For valid date and time input formats, see Date and Time Formats.

Start  Starting time of activation.
Type  Displays the current status of the activation.

Possible status types are, for example:

  • Schedule Table,

  • on request,

  • Schedule, active,

  • Aw. Symbol Prompting,

  • Symbol Entry in Progress.

Modifying Planned Network Start Times

You can modify a network start time only if a run number is assigned to the network planned to start (be activated).

Start of instruction set To modify the start time of a planned network activation

  1. On the Next scheduled Network Starts screen, enter M (Start Time) in the line command field of the appropriate network. Press ENTER.

    A Start Time Modification window opens:

    +------------------------------------------------+
    |                                                |
    |         Start Time Modification                |
    |                                                |
    |    Owner     ==> EXAMPLE                       |
    |    Network   ==> B60-FLOW                      |
    |    Run       ==> 2985                          |
    |    Job       ==> -                             |
    |                                                |
    |  Start                                         |
    |    planned   ==> 01.03.19  00:00               |
    |    new       ==> 01.03.19  00:00               |
    |                                                |
    |  Keep predefined Job Time Frames ==> N         |
    |                                                |
    |  -PF1------PF3------PF5---------------         |
    |   Help     End      Save                       |
    +------------------------------------------------+
  2. Enter a new date and start time that is greater than or equal to the current values.

    If required, change the setting of the Keep predefined Job Time Frames option:

    N All job time frames will be adapted (default value).
    Y Jobs with master time frame definitions will not be adapted.
  3. Choose PF5 (Save) to save the new start date/time.

    Or:
    Choose PF3 (End) to save the new start date/time and close the window.

    If saved successfully, the new start date/time is entered on the Next scheduled Network Starts screen and used for the next network start.

Notes:

  1. A start time up to the current time plus "activation before earliest start" causes an immediate activation of the jobs of the network.
  2. The job time frames will be shifted with the same time offset as the planned network start, as long as the job time frames fit into the network time frame.
  3. If active jobs already exist for this network run, their time frames are adapted accordingly.

Displaying the Network Execution History

The execution history is a record of past schedules. It shows the days on which the network was scheduled for execution. The data on a History screen cannot be modified.

There is history data on past network executions for the current and for the two preceding years (provided the network already existed at that time).

Start of instruction set To display the execution history

  1. Type X in the line command field of the selected network. Press ENTER.

    A History screen similar to the example below appears. The display is in calendar format starting with the current half year. The dates on which the network ran appear on the history:

     29.10.08               ***** Entire Operations *****                    15:26:21
     Owner EXAMPLE            History  DEMO-NET   Year 2007     Calendar DEMOCAL
    
    
                     January              February             March
     Monday       .  8  .  .  .           .  . 19  .           .  .  .  .
     Tuesday      .  . 16  .  .           .  .  .  .           .  .  .  .
     Wednesday    .  .  .  .  .           .  .  .  .           .  .  .  .
     Thursday     . 11 18  .           .  . 15  .           1  .  .  .  .
     Friday       . 12 19  .           .  . 16  .           2  .  .  .  .
     Saturday     .  .  .  .           .  .  .  .           .  .  .  .  .
     Sunday       .  .  .  .           .  .  .  .           .  .  .  .
    
    
                     April                May                  June
     Monday          .  .  .  .  .        .  .  .  .           .  .  .  . 
     Tuesday         .  .  .  .        .  .  .  .  .           .  .  .  .
     Wednesday       .  .  .  .        .  .  .  .  .           .  .  .  .
     Thursday        .  .  .  .        .  .  .  .  .           .  .  .  .
     Friday          .  .  .  .        .  .  .  .           .  .  .  .  .
     Saturday        .  .  .  .        .  .  .  .           .  .  .  .  .
     Sunday       .  .  .  .  .        .  .  .  .           .  .  .  .
    
    
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End   Day               Up    Down

    You can enter any valid year in the Year field in the header section of the screen to display the execution history for the specified year.

  2. Choose PF8 (Down) to display the next half of the year and PF7 (Up) to display the previous half of the year. You can also use these PF keys to change to the previous or following year. If no history data exists for a given year, an appropriate message is issued.

  3. To display the execution history for a particular day:

    Under z/OS: Place the cursor on the appropriate day and choose PF4 (Day).

    Or:
    Else: Choose PF4 (Day). A window opens. Enter the appropriate day and press ENTER.

    A Network Start History screen appears with the detailed execution history for one day:

     16-07-07                ***** Entire Operations *****                12:27:17
     Owner  SAGTEST              Network Start History           Network SAGNET
                                                                    Date 16-07-04
    -------------------------------------------------------------------------------
         Run  Version     Job          Date     Time                               
           7              (Network)    16-07-04 10:33:18                           
           8              (Network)    16-07-04 14:30:50                           
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
     ******************************* Bottom of Data *******************************
                                                                                  
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End                     Up    Down

    If history data exists for the selected network and date, execution information on all network starts is provided on the screen as shown in the example above. The screen columns are explained in Columns: Network History.

This section covers the following topic:

Columns: Network History

The columns of the Network Start History screen are described in the following table:

Column Description
Run  Run number of the job network that executed.
Version Network version (if available) of the network that executed.
Job  Job name if a single job was activated for execution, or (Network) if the entire network was activated.
Date  Date on which the network executed.

See also Date and Time Formats.

Time  Time at which the network executed.

See also Date and Time Formats.