Maintaining Job Network Definitions

This document covers the following topics:


Listing all Network Definitions

Start of instruction set To list all networks defined for an owner

  • Select the Network and Job Maintenance option on the Main Menu.

    Or:
    Use the direct command LIST NETWORKS as described in the Direct Commands documentation.

    A Network Maintenance screen similar to the example below appears:

    17.12.13                ***** Entire Operations *****                17:16:28 
     Owner EXAMPLE                 Network Maintenance                             
     Selection OR________                                                          
    -------------------------------------------------------------------------------
     Cmd #Run Owner      Network    Node  Description                              
              *--------- *---------                                                
     _        EXAMPLE    ADMIN      N0146 Administrator workshop                   
     _        EXAMPLE    ADMIN2     N0146 Administrator workshop                   
     _        EXAMPLE    B60-FLOW   N0194 Job Flow, BS2000                         
     _        EXAMPLE    B60-FLOWFX N0194 Job Flow, BS2000                         
     _        EXAMPLE    B60-FLOW38 N0038 Job Flow, BS2000                         
     _        EXAMPLE    B60-FX     N0031 Job Flow, BS2000                         
     _        EXAMPLE    B60FLOW194 N0194 Job Flow, BS2000                         
     _        EXAMPLE    B60FLOW211 N0031 Job Flow, BS2000                         
     _        EXAMPLE    DEMO-NET   N0146 BRY-DEMO-NET                             
     _        EXAMPLE    E01-CO-FX  N0146 Completion-Codes, Job Duration           
     _        EXAMPLE    E01-CO-148 N0148 Completion-Codes, Job Duration           
     *********************************** m o r e **********************************
      A Active C Copy D Delete F Flow G Grant H Check L List Jobs M Modify N Deact 
      P Descr R Activate S Schedule T Acct U Vers.Usage W Disp.Sched. X History    
     Command => ____________________________________________________________       
    
    
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Add   End         Save        Up    Down              NxtAc Menu

    When one or more job networks are defined for the owner, they appear in the main information section of this screen.

Columns: Network Maintenance

The Network Maintenance screen contains the following columns:

Column Description
Cmd  One-character line command input field. Possible values are listed in the command section of the screen (see also the section Line Commands: Network Maintenance).

Note:
The letter L (loop) appears between the Cmd and #Run columns if a loop was found during a loop test for the corresponding network. For further information, see the field description for Loop exists.

#Run  Number of currently active runs for the corresponding network.
Owner  Owner name of the network; the first line contains the prefix specification used to obtain the list of networks: enter an asterisk (*) and press ENTER to list networks belonging to the current owner (see screen header) and networks of all other owners for which you are authorized, or enter ABC* and press ENTER to list networks belonging to all owners whose names begin with ABC.
Network  User-defined network name.

The first line contains the prefix specification used to obtain the list of networks: enter an asterisk (*) to list all networks belonging to the specified owners, or enter ABC* to list networks whose names begin with ABC. You can also use a question mark (?) as a wildcard at any position in the selection string, for example, A?C.

Node  Default execution node for the jobs in the network.
Description  Short description of the network.

Selecting a Range of Networks to be Listed

You can specify the range of networks to be listed by entering one or more of the following values in the Selection field on the Network Maintenance screen and pressing ENTER:

Value Description
A  Only networks with at least one active run are listed.
G   Granted networks are listed for the current user and the owner selected on the Network Maintenance screen (excluding current owner).
O  Networks of the current owner are listed. Owner selected on Network Maintenance screen has no effect.
R Number of active runs is shown in the #Run column. Using this option could increase database access.
U Networks granted for the user.

You must specify at least either O or G. You can specify both O and G together. The default value is OR.

If you enter a question mark (?) in the first position of the Selection field and press ENTER, a Network Selection window opens where you can enter the required value(s).

Commands: Network Maintenance Screen

This section describes the commands available on the Network Maintenance screen:

Line Commands: Network Maintenance

You can perform the following functions on any network listed on the Network Maintenance screen:

Cmd Description
A  List all active jobs for the network. Use this command to maintain active jobs.
Copy all definitions of the selected network for a new network, or clone a network version.
D  Delete the selected network, including all jobs and all other definitions for this network.

If several network versions exist, a network version selection window opens. Mark the version you want to delete.

F  Display overview of job flow within network.

If several network versions exist, a network version selection window opens. Mark the version you want to delete.

G  Grant other users or owners access to this network.
H  Check for loops in the network.

If several network versions exist, a network version selection window opens. Mark the version you want to delete.

L  List all jobs defined for this network. Use this command for job maintenance.

If several network versions exist, a network version selection window opens. Mark the version you want to delete.

M  Modify selected network definition.

If several network versions exist, a network version selection window opens. Mark the version you want to delete.

N  Deactivate active jobs, selectable by dates.
P  Description. Invoke the Entire Operations editor to write an online text description for the selected network.

If several network versions exist, a network version selection window opens. Mark the version you want to delete.

R  Activate the selected network manually.
S  Network schedule definition.
T  Display network accounting data. See also Network and Job Accounting Data.
U Maintain the usage of network versions.
W  Viewing a Network Schedule Definition as a Calendar.
X  Display the execution history (previous network runs)

Special PF Keys: Network Maintenance

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

PF Key Name Function
PF2  Add  Add a network definition.
PF11   NxtSt  Display a system-wide list of all planned job and network activations.

Displaying and Modifying a Network Definition

Start of instruction setTo view or modify a network definition

  1. Type M in the line command field of the selected network on the Network Maintenance screen and press ENTER.

    A Network Modification window opens similar to the example below opens:

     30.11.15                ***** Entire Operations *****                11:18:46 
     Owner EXAMPLE                 Network Maintenance                             
      +------------------------------------------------------------------------+   
    - |                                                                        | --
      |                          Network Modification                          |   
      |  Owner EXAMPLE    Network EXA-NET1__ Version __________                |   
      |  Description  Example Network___________________________________       |   
      |                                                      Loop existing  N  |   
      |  Default Values for the Jobs                                           |   
      |    Execution Node N0146 MVS/ESA               Symbol Table __________  |   
      |    JCL Node       N0146 MVS/ESA       Symbol Table Version __________  |   
      |    JCL Location   ___                 Symbol Table  Activation Mode X  |   
      |                                                    Escape Act @ Sub $  |   
      |                End-of-Job Action Errors set 'not ok' Conditions ==> N  |   
      |                                                                        |   
      |    File    ______________________________________________________      |   
      |    VolSer  ______                              Password                |   
      |                                                 defined  no            | **
      |  --PF1-----PF3-----PF5---PF6---PF7---PF8---PF9---PF10---PF11---------  | t 
      |    Help    End     Save  Spec  Symb  SP-UR DfJb  Copy   MsgRe          |   
      +------------------------------------------------------------------------+   
                                                                                   
                                                                                 
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Add   End         Save        Up    Down              NxtSt Menu

    The window shows the current values defined for the network.

    The fields and commands available are explained in Fields and Commands: Network Definition.

  2. Press PF5 (Save) to save any changes.

  3. Press PF3 (End) to close the window.

Adding a Network Definition

Start of instruction set To add a new network definition

  1. Press PF2 (Add) on the Network Maintenance screen.

  2. A Network Addition window opens.

    Define the network by entering the required values in the input fields.

    The fields and commands available correspond to the fields and commands available in the Network Modification window. They are described in Fields and Commands: Network Definition.

  3. Press PF5 (Save) to save your new network definition.

Fields and Commands: Network Definition

The fields in the Network Addition/Modification window are described in the following table:

Field Description
Owner Owner of the network.
Network Network name. Together with owner name, uniquely identifies the network in the master database.
Version Network version.

You may add a new network with a non-blank version. It is possible to invoke the network addition multiply for the same network, but with different versions.

New network versions can be created by cloning too as described in Copying Job Network Definitions; Cloning Network Versions.

For further information on network versions, see Object Versioning in the Concepts and Facilities documentation.

Description   Short description of the network. This text appears in the list of networks on the Network Maintenance screen.

A longer description of the network can be added using the editor (see Documenting Your Networks).

Loop existing
Y Loop exists: a loop has been found in the network while linking network jobs via their input and output conditions or while defining input and output conditions of a job.
N Loop does not exist: no loop has been found in the network, or no loop test has yet been performed, for example, with the line command H.
Default Values for the Jobs The input fields under this heading are used to specify default values for subsequent new job definitions in the network. Each default value specified here can be overridden at the job level.
Execution Node Default node ID on which jobs within this network are submitted. This value can be modified here or overridden at the job level. To list the possible nodes, type an asterisk (*) here and press ENTER. The operating system type appears after a valid node number. To display the field help, type a question mark (?) here and press ENTER.
JCL Node Node on which JCL can be accessed. The default is the same as for the Execution Node. The operating system type appears after a valid node number.
JCL Location Type of storage for the JCL: see List of JCL Locations.

The default is used in new job definitions and can be overridden there.

Symbol Table   Default symbol table for those jobs in the network that use the dynamic JCL generation facility. Can be overridden at the job level and is therefore optional here.

Enter an asterisk (*) and press ENTER to display a selection list of available symbol tables. The selected symbol table can be edited using PF7 (Symb).

Symbol Table Version

(symbol table)

You can maintain several versions of a symbol table.

Enter an asterisk (*) and press ENTER to display a selection list of available symbol tables.

Reserved names:

blank Unknown (implicit) version.
(current) Is replaced by the current version for the activation date or determination date.
(nv) Is replaced by the version of the network used.

For further information, see Object Versioning in the Concepts and Facilities documentation.

Symbol Table Activation Mode
A During the network activation. No symbol prompting is possible.
X After schedule extraction. Symbol prompting can be used for scheduled networks. This is the default.
Esc Act Activation Escape Character = Network default value

This escape character is the prefix for Natural code lines and symbols to be replaced at activation time.

Caution:
Existing Dynamic JCL might become invalid after changing this escape character and applying defaults to jobs.

Esc Sub Submission Escape Character = Network default value

This escape character is the prefix for Natural code lines and symbols to be replaced at submission time.

Caution:
Existing Dynamic JCL might become invalid after changing this escape character and applying defaults to jobs.

End-of-Job Action Errors set 'not ok' Conditions If Y is specified here, output condition(s) are set for the job after all end-of-job actions are performed. This includes end-of-job action (EJA) exits. Any errors in the end-of-job action processing will cause the setting of the conditions for job not ok. If the job was already set to not ok, it will remain not ok, regardless of the definition here.

Notes:

  1. Setting this flags may cause a longer elapsed time of a network, because the condition setting waits for the termination of the other end-of-job actions.
  2. The network level setting will be overridden by job settings.

If N is specified, errors during end-of-job action processing will have no impact on the job result. Job level: If the field is empty, the network level definition will be inherited at activation time. This is the default.

File  Name of the file or Natural library according to the value of the JCL Location field.

For BS2000: The default pubset will be stripped from the file name prior to storing it. This allows easier migration to another default pubset.

VolSer  Volume serial number of data set (if data set is not cataloged).
Password defined  Password if the file or library specified in the Data set field is password protected:
no No password is defined.
yes Password is defined.

Special PF Keys: Network Addition/Modification

You can perform the following functions using these PF keys in the Network Addition/Modification window:

PF Key Name Function
PF6  Spec  Special definitions for different operating systems and environments.
PF7  Symb  Open the Usable Symbol Tables window, and select a symbol table for browsing or modification. See also Listing Usable Symbol Tables in the section Symbol Table and Symbol Maintenance.
PF8  SP-UR  Define a symbol prompt user exit. See also Specifying User Exits for Symbol Modification in the section Symbol Table and Symbol Maintenance.
PF9  DfJb  Apply network defaults to jobs.
PF10  Copy  Copy a network definition.
PF11  MsgRe  Specify message recipients for the network.
  1. Press PF5 (Save) to save the network definition.

  2. Press PF3 (Exit) to return to the Network Maintenance screen.

  3. The new network is now listed on the Network Maintenance screen.

Operating System and Environment Defaults

Start of instruction set To specify operating system specific defaults

  1. Press PF6 (Spec) in the Network Modification window.

    The following window opens:

     29.10.08               ***** Entire Operations *****                    11:24:09 
      Owner SN                      Network Maintenance                             
      Selection OR________                                                          
     - +------------------------------------------------------------------------+ --
       !                                                                        !   
       !                          Network Modification                          !   
       !  Network      ===> A-1_______                   Owner ===> SN          !   
       !  Description  ===> Time Range Test ...__________________________       !   
       !                                                  Loop existing ===> N  !   
       !  Default Values f +----------------------------------------+           !   
       !    Execution Node !                                        ! -01_____  !   
       !    JCL Node       !  Please select the Operating System    ! b ===> _  !   
       !    JCL Location   !                                        ! e ===> X  !   
       !                   !          _  BS2000                     !           !   
       !    File   ===> NO !          _  MVS                        ! ________  !   
       !    VolSer ===> __ !          _  VSE                        !           !   
       !                   !          _  UNIX, Windows              ! no        !   
       !  --PF1-----PF3--- !                                        ! --PF12--  ! **
       !    Help    End    !  or Environment                        !   Menu    !   
       +------------------ !                                        ! ----------+   
      Command => _________ !          _  SAP                     ! _______       
     Enter-PF1---PF2---PF3 !                                        ! -PF11--PF12---
           Help  Add   End +----------------------------------------+  NxtSt Menu
     
  2. Choose an entry and press ENTER.

    Depending on the operating system selected, a Network Defaults window similar to the examples below opens:

    For BS2000:

    +-----------------------------------------------------------------+ 
    |                                                                 | 
    |                     Network Defaults  (BS2000)                  | 
    |                                                                 | 
    |  Network     B60-FLOW    Version                Owner EXAMPLE   | 
    |  Description Job Flow, BS2000                                   | 
    |  JCL Node    N0194                     Execution Node N0082     | 
    |                                                                 | 
    |  Default Values for the Jobs                                    | 
    |   Esc Activation _                     Submit User ID ________  | 
    |       Esc Submit _                     SYSOUT User ID ________  | 
    |  Default User ID NOP_____              SYSOUT Cat  ID ____      | 
    |      JCL User ID ________                Job Priority ___       | 
    |        Job Class ________                Run Priority ___       | 
    |   Account Number ________                                       | 
    |                                                                 | 
    |  --PF1-----PF3--------PF5-------------------------------------- | 
    |    Help    End        Save                                      | 
    +-----------------------------------------------------------------+

    For z/OS:

    +-----------------------------------------------------------------+
    |                                                                 |
    |                      Network Defaults  (z/OS)                   |
    |                                                                 |
    |  Network     B60-FLOW    Version                Owner EXAMPLE   |
    |  Description Job Flow, BS2000                                   |
    |  JCL Node    N0194                     Execution Node N0082     |
    |                                                                 |
    |  Default Values for the Jobs                                    |
    |   Esc Activation _                        JCL User ID ________  |
    |       Esc Submit _                     Submit User ID ________  |
    |                                                                 |
    |                                                                 |
    |  --PF1-----PF3--------PF5-------------------------------------- |
    |    Help    End        Save                                      |
    +-----------------------------------------------------------------+

    For z/VSE:

    +-----------------------------------------------------------------+
    |                                                                 |
    |                     Network Defaults  (z/VSE)                   |
    |                                                                 |
    |  Network     B60-FLOW    Version                Owner EXAMPLE   |
    |  Description Job Flow, BS2000                                   |
    |  JCL Node    N0194                     Execution Node N0082     |
    |                                                                 |
    |  Default Values for the Jobs                                    |
    |   Esc Activation _                                              |
    |       Esc Submit _                                              |
    |                                                                 |
    |  --PF1-----PF3--------PF5-------------------------------------- |
    |    Help    End        Save                                      |
    |                                                                 |
    +-----------------------------------------------------------------+

    For UNIX and Windows:

    +-------------------------------------------------------------------+ 
    |                                                                   | 
    |                Network Defaults  (UNIX, Windows)                  | 
    |                                                                   | 
    |  Network     B60-FLOW    Version                Owner EXAMPLE     | 
    |  Description Job Flow, BS2000                                     | 
    |  JCL Node    N0194                     Execution Node N0082       | 
    |                                                                   | 
    |  Default Values for the Jobs                                      | 
    |   Esc Activation  _                                               | 
    |       Esc Submit  _                                               | 
    |      JCL User ID  ____________________                            | 
    |      JCL   Group  ____________________                            | 
    |                                                                   | 
    |   Submit User ID  ____________________                            | 
    |   Submit   Group  ____________________                            | 
    |                                                                   | 
    |  --PF1-----PF3--------PF5---------------------------------------  | 
    |    Help    End        Save                                        | 
    +-------------------------------------------------------------------+

    For SAP:

    +-------------------------------------------------------------------+
    |                                                                   |
    |                      Network Defaults (SAP)                       |
    |                                                                   |
    |  Network     B60-FLOW    Version                Owner EXAMPLE     |
    |  Description Job Flow, BS2000                                     |
    |                                                                   |
    |  Default Values for the Jobs                                      |
    |      System ID  ___                System Number  __              |
    |      Client     ___                                               |
    |                                                                   |
    |  --PF1-----PF3--------PF5---------------------------------------  |
    |    Help    End        Save                                        |
    +-------------------------------------------------------------------+
  3. Enter the required values.

    For more information about the specific operating system settings, see the Input Fields: Network Defaults.

  4. Press PF5 (Save) to save your changes and then PF3 (End) to close the window.

This section covers the following topic:

Input Fields: Network Defaults

The input fields available in the Network Defaults window depend on the operating system selected as indicated in the following table:

Field Description
Esc Activation Activation Escape Character = Network default value specific for operating system

This escape character is the prefix for Natural code lines and symbols to be replaced at activation time.

Caution:
Existing Dynamic JCL might become invalid after changing this escape character and applying defaults to jobs.

Esc Submit Submission Escape Character = Network default value specific for operating system

This escape character is the prefix for Natural code lines and symbols to be replaced at submission time.

Caution:
Existing Dynamic JCL might become invalid after changing this escape character and applying defaults to jobs.

JCL User ID  (Not applicable to z/VSE)

The user ID to be used for JCL loading

BS2000:

If this field is not empty, the JCL is loaded with the rights of this BS2000 user ID. It can be overwritten with specific definitions. TSOS may only be defined if the user himself has logged on under TSOS. Default: The user ID from the fully qualified file name.

If this field is left empty in a job definition, then the Default User ID will be inserted during the activation of the job.

z/OS:

JCL in z/OS will be loaded under this user ID by the Entire Operations Monitor. You can define this field only if you are logged on to the JCL node with the same user ID.

Default: If this field is left blank, the user ID of the last modification will be used as JCL user ID.

UNIX and Windows:

With the authorization of this user ID, the Entire Operations Monitor loads the JCL of type TXT.

See also the default setting User ID Definition (Default Setting (1), Administration documentation), Operating System User IDs and Default User ID Determination.

Submit User ID  (Not applicable to z/VSE)

The user ID to be used at job start

BS2000:

The Entire Operations Monitor starts jobs in BS2000 under this user ID. In the network definition, this is a default value for the jobs.

If this field is left empty in a job definition, then the Default User ID is inserted during the activation of the job.

z/OS:

The Entire Operations Monitor starts jobs in z/OS under this user ID. You can only define this user ID if you have logged on to the executing node with the same user ID.

Default: If this field is empty, the user ID of the last modification is taken as submit user ID.

UNIX and Windows:

With the authorization of this user ID, the Entire Operations Monitor starts the script or the executable program.

See also the default setting User ID Definition (Default Setting (1), Administration documentation), Operating System User IDs and Default User ID Determination.

Applies to BS2000 only:
Default User ID This user ID is a default for all objects of this job network or job which are linked to a user ID.
Job Class  This job class is a default for all jobs in the network. It can be overridden by specific definitions.
Account Number  This account number is a default for the Submit User ID defined for the job network. It can be overridden by specific definitions.
Job Priority If not empty, this job priority will be used during submission and will override a possible setting in the LOGON statement. The default value on network level will be used for new job definitions.
Run Priority If not empty, this run priority will be used during submission and will override a possible setting in the LOGON statement. The default value on network level will be used for new job definitions.
SYSOUT User ID  This is the user ID under which internal SYSOUT files are created by Entire Operations. If you do not enter an ID here, the Submit User ID is used.

See also the default setting User ID Definition (Default Setting (1), Administration documentation), Operating System User IDs and Default User ID Determination.

SYSOUT Cat ID  This is the catalog ID under which internal SYSOUT files are created by Entire Operations. This field is meaningful only if a SYSOUT user ID different from the submit user ID is used.
Applies to UNIX and Windows only:
JCL Group

Applies to UNIX only (optional)

If this field is left blank, the standard group of the UNIX user ID is used as defined under /etc/passwd. Otherwise, this field must contain one of the groups issued by the UNIX command groups.
Submit Group

Applies to UNIX only (optional)

If this field is left blank, the standard group of the UNIX user ID is used as defined under /etc/passwd. Otherwise, this field must contain one of the groups issued by the UNIX command groups.
Applies to SAT only:
System ID SAP System ID (SID), as required by jexa4S.
System Number SAP System Number, as required by jexa4S.
Client  SAP Client

Symbol replacement is possible (except at logon).

Specifying Recipients for Network Messages

This function is used to specify single or multiple users to receive network-related messages that are sent when a specified event occurs. This is especially useful for sending information about the abnormal end of a job.

Among the events, which can cause a message to be sent, are:

  • a calendar not defined for next year;

  • a network not correctly terminated;

  • symbol prompting requests.

The specific message text is generated automatically by the Entire Operations Monitor.

Start of instruction set To define a message recipient

  • In the Network Modification window, press PF11 (MsgRe).

    A Message and Message Recipients window similar to the example below opens:

                                                                                   
     30.11.15                ***** Entire Operations *****                18:39:26 
     Owner N +------------------------------------------------------------+        
      +----- |                                                            | ---+   
    - |      |  Owner NOPALL     Network I1029186A  Version               |    | --
      |      |    Job                                                     |    |   
      |  Own |                                                            |    |   
      |  Des |            Message and Message Recipients                  |    |   
      |      |                                                            | N  |   
      |  Def |  Text ==> (Network-related Messages)___________________    |    |   
      |    E |                                                            | _  |   
      |    J |    to ==>    Destination Type      Node                    | _  |   
      |    J |              __________  ________  _____                   | X  |   
      |      |              __________  ________  _____                   | ¬  |   
      |      |              __________  ________  _____                   | N  |   
      |      |              __________  ________  _____                   |    |   
      |    F |              __________  ________  _____                   |    |   
      |    V |              __________  ________  _____                   |    |   
      |      |              __________  ________  _____                   |    | **
      |  --P |              __________  ________  _____                   | -  | t 
      |    H |                                                            |    |   
      +----- |  Execute if temp. Dummy (EOJ only) ===> _                  | ---+   
             |  Enter-PF1---PF3---------PF5--------PF9----------------    |        
             |        Help  End         Save       Delete                 |        
             +------------------------------------------------------------+        
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Add   End         Save        Up    Down              NxtSt Menu

    For further information, refer to Message Sending and the following sections:

Granting Definition: Authorizing Other Users or Owners to Access a Network

Entire Operations allows you to authorize other users and owners to access a network that belongs to you.

Users grouped under the owner SYSDBA have unlimited access to all networks in the system. They do not need the authorization described in this section.

Users and linked owners (lower than administrator) have limited access rights to granted networks in accordance with the rights specified in their user profiles and the restrictions specified in their individual network granting definition.

Start of instruction setTo add or modify a granting definition

  1. Type G in the line command field of the selected network on the Network Maintenance screen.

  2. Press ENTER.

  3. A Granting Definition window similar to the example below opens:

     17-07-10                ***** En +------------------------------------------+ 
     Owner SAGTEST                 Ne !                                          ! 
     Selection OR________             !    Owner SAGTEST    Network B60-FLOW     ! 
    --------------------------------- !                     Version (unnamed)    ! 
     Cmd #Run Owner      Network    N !            Granting Definition           ! 
              *--------- *---------   !      ------------------------------      ! 
     G P      SAGTEST    B60-FLOW     !      Cmd Type   Name        Option       ! 
     _        SAGTEST    SAG-PROMPT   !       _  Owner  SAGTEST___  O_____       ! 
     _      1 SAGTEST    SAGNET       !       _  User_  DEMO______  R_____       ! 
     _      1 SAGTEST    SAGNET-HEB   !       _  Owner  EXAMPLE___  D_____       ! 
     _        SAGTEST    SAGNET-P   5 !       _  _____  __________  ______       ! 
     _      1 SAGTEST    SAGNETHEB    !       _  _____  __________  ______       ! 
     _        SAGTEST    SAGNETSUB1   !       _  _____  __________  ______       ! 
     _        SAGTEST    SAGNETSUB2   !       _  _____  __________  ______       ! 
     _        SAGTEST    SAGNET2      !       _  _____  __________  ______       ! 
                                      !       _  _____  __________  ______       ! 
                                      !       _  _____  __________  ______       ! 
     *******************************  !      ------------------------------      ! 
      A Active C Copy D Delete F Flow !       D Delete                           ! 
      P Descr R Activate S Schedule T !                                          ! 
     Command => _____________________ ! Enter-PF1---PF3-----PF5-----PF7---PF8--- ! 
                                      !       Help  End     Save    Up    Down   ! 
                                      +------------------------------------------+ 
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Add   End         Save        Up    Down              NxtSt Menu
  4. Type in the user ID or owner you want to authorize network access and the level of access to be granted.

    The columns and options available are described in Fields: Granting Definition.

  5. Press PF5 (Save) to save the definition.

  6. You can enter up to 30 different names and options. If current window is full, press PF8 (Down) to scroll forward to next window. Press PF7 (Up) to scroll back to previous window.

  7. Press PF3 (Exit) to return to the Network Maintenance screen.

  8. The network appears on the Network Maintenance screen when the authorized user logs on to Entire Operations. You can also use this function to delete existing authorizations.

Start of instruction setTo delete a granting definition

  • In the Granting Definition window, type D (Delete) next to the user or owner whose definition you want to remove and press ENTER.

The users and owners you can remove depend on your user authorization. For the delete restrictions that apply, see Deleting a User/Owner Link in the Administration documentation.

Fields: Granting Definition

The columns and input options in the Granting Definition window are described in the following table:

Column/Field Description
Cmd One-character line command input field. Possible option: D to delete a specified user or owner.
Type Specifies the object to be authorized. Possible options:
Owner All users linked to the Entire Operations owner specified in the Name field.
User A defined user.

You can enter O for Owner or U for User.

Name  The user or owner to be granted access. If the access rights are given to an owner, all linked users can obtain these access rights.

Use an asterisk (*) for selection.

Option Level of access granted to a user or owner.

You can specify one or more (for example RA for read and activate access) of the following authorization levels:

R Read access to the network (no maintenance).
W Read and write access to the network (maintenance allowed except delete network).
D Read, write and delete access to the network.
O Read, write and delete access to the network. In addition, the specified user or owner can also allow network access to other users and owners.
A User is allowed to activate the network.

Documenting Your Networks

You can add a brief description of a job network when defining a network in the Network Addition/Modification window. This short description appears in the list of networks on the Network Maintenance screen.

If you wish to add more online documentation for a network, you can invoke the Entire Operations editor.

Start of instruction set To create or modify a detailed description for a job network

  1. Type P in the line command field of the selected network.

  2. Press ENTER.

  3. The Entire Operations editor screen appears:

    Edit Description Nw: E01-CO-148------------------------  ==> Description saved
     ====>                                                          Scroll===> CSR 
     ***** ****************************** top of data *****************************
     00001 Network 'E01-CONTI'                                                     
     00002 -------------------                                                     
     00003 This network consists of 6 independent jobs. Each of them forces        
     00004 a defined event at end-of-job time. Each job executes the               
     00005 program 'NOPCONTI' which resides on the installation library            
     00006 'NOPnnn.LOAD'. The necessary JCL which is named as 'NOPE*' is stored on 
     00007 the installation library 'NOPnnn.SRCE'.                                 
     00008                                                                         
     00009 This is a short description to enable the user to define his             
     00010 own test examples.                                                      
     00011                                                                         
     00012  Log Jobname           Event at End-of-job                              
     00013  -----------           -------------------                              
     00014                                                                         
     00015  +---------+                                                            
     00016  ! E01-J01 !           Job ended ok.                                    
     00017  +---------+                                                            
     00018       !                                                                 
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End         Rfind Rchan Up    Down  Impo  Left  Right Curso

You can enter and edit text using editor commands. For a detailed description of the Entire Operations editor, see the Software AG Editor documentation.

Once a text is written, it can be read by any user who is authorized to access the network. The line command P entered for the network in the list of networks displays the current text.

You can also display or print online documentation in the Entire Operations Reporting Facility (Reports option on the Main Menu - see the section Reporting).

You can also create online documentation at the job level (see the section Job Maintenance).

Deleting a Job Network

Only authorized users can delete a network. Only networks without active runs and version usage can be deleted.

Deleting a network also deletes all definitions made for the network on lower levels using network and job maintenance functions.

Entire Operations saves the last run number of a deleted network. The first run of a new network under the same name receives the last run number incremented by 1.

Start of instruction set To delete a network

  1. Type D in the line command field of the selected network on the Network Maintenance screen.

  2. Press ENTER.

  3. If several network versions exist, a network version selection window opens. Select the version you want to delete.

  4. A window opens in which you can confirm the deletion by entering the network name.

  5. Type in the network name and press ENTER to delete the network.