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:

     17-02-07                ***** Entire Operations *****                11:46:58 
                              Network Schedule Definition                          
                         Owner SAGTEST     Network B60-FLOW                        
    -------------------------------------------------------------------------------
        Schedule Owner ==> SAGTEST___                                              
        Schedule       ==> __________  effective from ==> ________ ________        
                                                                                   
                                                                                   
           Schedule    Earliest   Latest   Days           Days                     
       Cmd Dependency  Start      Start    later Deadline later                    
        _  +WY+123     09:25:00   09:25:00 1__   17:00:00 1__                      
        _              08:00:00   09:00:00 ___   ________ 2__                      
        _              ________   ________ ___   ________ ___                      
        _              ________   ________ ___   ________ ___                      
        _              ________   ________ ___   ________ ___                      
                                                                                   
        Number of Activations ==> 10___  every ==> 30___ 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 of 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 Schedule dependency of a time frame definition.

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 Behavior for Schedule Times.

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 Behavior for Schedule Times.

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 Behavior for Schedule Times.

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

See also Behavior for Schedule Times.

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.

Defining and Deleting Time Frames for a Network

Rules for Time Frame Definitions

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.

Active Jobs

If this function is invoked for an active job, the time frames contain the complete calculated date and time. Both can be modified.

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 Behavior for Schedule Times.

  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:

     17-03-03                ***** Entire Operations *****                17:44:58 
                              Network Schedule Definition                          
                         Owner EXAMPLE     Network B60-FLOW                        
    ----------- +---------------------------------------------------------------+ -
        Schedul !                                                               !  
        Schedul !       Schedule Dependency Definition for Time Frame           !  
                !                                                               !  
                !  Owner   EXAMPLE         Job                                  !  
           Sche !  Network B60-FLOW        Condition                            !  
       Cmd Depe !                                                               !  
        m       !  The time frame will be used on this(+)/all other(-) dates,   !  
        _       !  if the execution date has the following position in the      !  
        _       !  job network schedule or calendar:                            !  
        _       !                                                               !  
        _       !        Usage ==> _  + only              - except              !  
                !                     A after Holiday too B before Holiday too  !  
        Number  !         Type ==> _  H is Holiday    X is Workday              !  
        or acti !                     C Calendar Day  W Workday  S Schedule Day !  
                !    in Period ==> _  W Week          M Month    Y Year         !  
        Day Dea !  at Position ==> ______                                       !  
                !  ----PF1------PF3---------PF5------------------PF9----------- !  
                !      Help     End         Save                 Delete         !  
                +---------------------------------------------------------------+  
                                                                                    
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End   ExplD Save        Sch.L Sch.M Delet             Menu

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

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.

Behavior for Schedule Times

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

  2. If Latest Start or Deadline is given and Days later is empty, Days later is automatically filled as described above.

  3. 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.

  4. If Latest Start or Deadline is before Earliest Start and their Days later fields are empty, the Days later value of Earliest Start (or the following day, if necessary) is used for the Days later fields of Latest Start and Deadline.

  5. If Deadline is before Earliest Start and Days later is empty, days later is set to 1 so this time follows the earliest start time.

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, press 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, press 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. Explicit exclusion dates on the network level will be set implicitly by the network activation canceling function.
  4. Deletions of planned activations can cause the setting of "dates to be excluded" in this table (see also Fields: Network Schedule – Explicit Dates).

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

  1. Press 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. Press 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. Press 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

  1. until end of schedule day;

  2. until latest start;

  3. by the defined number of activations.

which ever 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 press 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 press 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. Press 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 canceling 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.

Canceling Planned Starts

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

  • Press 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

  • Press 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

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

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

    +------------------------------------------------------------+
    !                                                            !
    !Owner TESTBED     Network NET01-517                         !
    !Next Start Times                                            !
    !                                                            !
    !  Cmd  Date     Act.  Start   Run Type                      !
    !  _    01.03.10 07:29 07:29  4789 Schedule, active          !
    !  _    01.03.10 09:29 09:29  4790 Schedule, active          !
    !  _    01.03.10 11:29 11:29  4791 Schedule, active          !
    !       02.03.10 00:00 07:29       Schedule Table            !
    !       03.03.10 00:00 07:29       Schedule Table            !
    !       04.03.10 00:00 07:29       Schedule Table            !
    !       05.03.10 00:00 07:29       Schedule Table            !
    !       08.03.10 00:00 07:29       Schedule Table            !
    !       09.03.10 00:00 07:29       Schedule Table            !
    !       10.03.10 00:00 07:29       Schedule Table            !
    !  -------------------- Bottom of Data --------------------  !
    !  D Delete   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 delete manual activations with the D (delete) line command. Scheduled activations can only be changed by modifying the schedule definition.

    Note:
    To display a system-wide list of planned activations, press 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
D  Delete

Cancels a planned network start.

M  Start Time

Modifies 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.

Canceling a planned Network Start

You can cancel a planned network start only if a run number has already been assigned to the network.

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. Press PF5 (Save) to save the modified active symbol table.

  8. Press 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:

Activation: Active Symbol Tables

The list of active symbol tables for network activation can be invoked from different windows.

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

+---------------------------------------------------------------------+
!                                                                     !
!  Owner SN         Network A-1        Version V00003     Run 6186    !
!                        Active Symbol Tables                         !
!                                                                     !
!       Cmd SymTab     Version         Cmd SymTab     Version         !
!       _   SN-01                                                     !
!       _   SN-05                                                     !
!       _   ABC1A                                                     !
!                                                                     !
!                                                                     !
!                                                                     !
!                                                                     !
!                                                                     !
!                                                                     !
!                                                                     !
!  Select Symbol Table by marking.                                    !
!                                                                     !
!  PF3 End   PF7 Up   FP8 Down                                        !
+---------------------------------------------------------------------+

This screen displays all active symbol tables that are used for this network activation (run).

Columns: Active Symbol Tables

The following table explains the columns for the data listed in the Active Symbol Tables window:

Column Description
Cmd One-character input field for line commands

Select an active symbol table by any character.

SymTab Name of the symbol table
Version Version of the symbol table
Line Commands: Active Symbol Tables

Use the following line command to perform the described function on any network start listed on the Next scheduled Network Starts screen.

Line Command Description
any character List or modify active symbol table.

The Active Symbol Table window opens.

Next Planned Network Starts

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

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

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

     16-07-18                ***** Entire Operations *****                10:35:21 
                             Next scheduled Network Starts                         
     ------------------------------------------------------------------------------
     C Owner      Network      Run Version    Job        Date  Start Type          
       *--------- *---------                             07-18 18:30               
     _ SAGNET     N1459C     22171                       07-18 18:30 Schedule, acti
     _ SAGNET     N1459C     22172                       07-18 19:30 Schedule, acti
     _ SAGTEST    SAGTEST       39                       07-18 20:00 Schedule, acti
     _ SAGNET     N1459C     22173                       07-18 20:30 Schedule, acti
     _ SAGTEST    SAGTEST       40                       07-18 20:30 Schedule, acti
     _ SAGTEST    SAGTEST       41                       07-18 21:00 Schedule, acti
     _ SAGNET     N1459C     22174                       07-18 21:30 Schedule, acti
     _ SAGTEST    SAGTEST       42                       07-18 21:30 Schedule, acti
     _ SAGTEST    SAGTEST       43                       07-18 22:00 Schedule, acti
     _ SAGNET     N1459C     22175                       07-18 22:30 Schedule, acti
     _ INCIDENT   I5095089A   1088                       07-18 23:40 Schedule, acti
     _ INCIDENT   I1042163     576                       07-19 00:00 Schedule, acti
     _ SAGNET     A-ITRAC      325                       07-19 00:00 Schedule, acti
     *********************************** m o r e **********************************
     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. Enter M in the line command field of the appropriate network. Press ENTER.

    A Start Time Modification window opens:

    29.10.08               ***** Entire Operations *****                 15:17:32
     Owner SN                 Schedule TIME-PCSN1 Year 2006                       
                  +------------------------------------------------------------+  
                  !                                                            !  
     Monday       !    +------------------------------------------------+      !  
     Tuesday      !    !                                                !      !  
     Wednesday    !    !         Start Time Modification                !      !  
     Thursday     !  C !                                                !      !  
     Friday       !  m !    Owner     ==> SN                            !      !  
     Saturday     !    !    Network   ==> TIME-PCSN1                    !      !  
     Sunday       !    !    Job       ==> -                             !      !  
                  !    !    Run       ==> 527                           !      !  
                  !    !                                                !      !  
     Monday       !    !  Start                                         !      !  
     Tuesday      !    !    planned   ==> 06.07.06  00:00               !      !  
     Wednesday    !    !    new       ==> 06.07.06  00:00               !      !  
     Thursday     !    !                                                !      !  
     Friday       !    !  Keep predefined Job Time Frames ==> N         !      !  
     Saturday     !  - !                                                ! ---  !  
     Sunday       !  D !  -PF1------PF3------PF5---------------         !      !  
                  !  P !   Help     End      Save                       !      !  
    Enter-PF1---P +--- +------------------------------------------------+ -----+ --
          Help        End   Overv             Up    Down  Calen Histo NxtSt
  2. You can enter a new date and start time, but they must be greater than or equal to the current values.

  3. Press PF5 (Save) to save the new start time.

  4. Press PF3 (End) to return to the Next scheduled Network Starts screen.

Fields: Start Time Modification

The input field of the Start Time Modification window is described in the following table:

Field Description
Keep predefined Job Time Frames N All job time frames will be adapted (default value).
Y Jobs with master time frame definitions will not be adapted.

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.

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. Press 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 press PF4 (Day).

    Or:
    Else: Press 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.