This document covers the following topics:
This section describes how to list all job masters defined for a network.
Listing Active Jobs in the section Active Job Networks
To list all jobs defined
for a network
On the Network Maintenance
screen, type L
in the line command field
of the network for which you wish to list all jobs, and press
ENTER.
Or:
Use the direct command
LIST
JOBS
as described in the Direct Commands
documentation.
If several network versions exist, a Network Version Selection window like the example below opens first:
18-03-12 ***** Entire Operations ***** 18:38:08 Owner SA +-------------------------------------------------------------------+ Selectio ! ! --------- ! Network Version Selection ! Cmd Runs ! Owner SAGTEST Network SAGNET ! ! Version Usage ! _ P ! _ (unnamed) unnamed version ! _ P ! _ V1 ! _ P ! _ V2 ! _ ! ! L ! ! _ ! ! _ ! ! _ ! ! _ ! ! _ ! ! _ ! ! ******** ! ! A Activ ! ** Bottom ** ! P Descr ! ----------PF3-----------PF7---PF8----------------------------- ! Command ! End Up Down ! +-------------------------------------------------------------------+ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add End Save Up Down NxtSt Menu |
The window shows a list of the versions defined for a
network.
If a current version exists for the current date, it is
presented in the first line.
The other versions appear in alphabetical order after
the current version.
If necessary, use PF7 to scroll up or
PF8 to scroll down.
Select the required network version by marking it with any character and press ENTER.
A Job Maintenance screen like the example below appears:
18-03-06 ***** Entire Operations ***** 10:21:46 Job Maintenance Owner SAGTEST Network B60-FLOW Version ------------------------------------------------------------------------------ Cmd C R PU Job Type Loc Description File or Library Member *--------- --- _ C2R2 JOB-01 DUM Where it all starts _ C1R2P JOB-012 JOB NAT Depending on Job-01 SYSEORU B60-P01 _ C1R2 JOB-013 JOB NAT Depending on JOB-012 B60-M01 _ R2 JOB-015 DUM NAT Depending on JOB-014 _ C1 JOB-019 JOB NAT Depending on JOB-01 B60-M01 _ C1R1 JOB-02 JOB NAT Mail Test BIZDEMO JOB-02 _ C1 JOB-03 NAT NAT Depending on JOB-02 B60-P01 _ C1R1 JOB-04 JOB NAT Depending on JOB-03 B60-M01 _ C1 JOB-05 STC NAT Depending on JOB-04 _ C1R1 JOB-06 JOB NAT Where it all ends B60-M02 _ C3 J2-SUB NAT NAT Subnetwork Job for Su SYSEORU ABX--001 _ C2R1 SUBNETJOB1 NET Subnetwork job for su SAGTEST/SAGNETSUB (D) *********************************** m o r e ********************************** A Dep. B Browse C Copy D Del. E Edit G Pregen. I Input Cond. J JCL L Resources M Mod. O EOJ Chk + Act P Prose R Activate S Sched.Parms U Ext.Log Z Subnet Command => ____________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add End Save Up Down Menu |
This screen displays all jobs defined for the selected network.
The screen columns are described in Columns: Job Maintenance.
This section covers the following topics:
The following table explains the columns of the Job Maintenance screen.
Column | Description | |
---|---|---|
Cmd | One-character line command input field. Possible commands are described in Line Commands: Job Maintenance. | |
Special job type.
The unnamed column between Cmd and C indicates special job types. Possible indicators are: |
||
C |
Cyclic execution. | |
D |
Execute as a dummy job but keep definitions | |
G |
Pre-generated JCL is available. See
also Pregenerating Active
JCL.
This indicator is only displayed if no other indicator is already used for the job. |
|
P |
For job type SRV : Stop a Windows service.
For job type |
|
R |
Recovery job, usually not activated.
See also Defining Recovery Actions. |
|
C | If input conditions have
been defined for the job listed, C appears here followed by the
number of conditions defined. For example: C4 indicates that four
input conditions exist.
For more than nine conditions, a plus sign
( |
|
R | If resources have been
defined for the job listed, R appears here followed by the number
of resources defined for the job. For example: R4 indicates that
four resources are defined for the job.
For more than nine resources, a plus sign
( |
|
P | If a description is
available for the job listed, P appears here.
|
|
U | If an extended log has
been defined for the job listed, U appears here. See also
Defining Extended Log
Information for a Job.
|
|
Job | User-defined job name.
In the input field of the Job column, you can make a preselection using a wildcard. The preselection is kept until you switch to another network. |
|
Type | Job type. They are
described in the section Job
Types.
See also the field Job Type described in Fields: Job Definition (Master). In the input field of the
Type column, you can enter a job type (for example,
|
|
Loc | JCL location.
(Empty if no JCL is defined, or if no JCL is required for the job type.) For possible JCL locations, see List of JCL Locations. |
|
Description | Short description of the
job.
Note: |
|
File or Library | Physical storage of JCL
according to the JCL location.
For a job of the type |
|
Member | The member which
contains the JCL. This refers to the JCL
location.
For possible members, see List of JCL Locations. For a job of the type |
You can perform several functions on any job listed on the Job Maintenance screen using line commands. The following line commands are available:
Line Command | Description |
---|---|
A
|
Display job dependencies (previous and following jobs). Includes connection and disconnection of jobs. See Displaying Job Dependencies and Connecting or Disconnecting Jobs. |
B |
Display JCL or a Natural source in read-only mode. |
C
|
Copy a job definition to a new job, including all associated definitions. |
D
|
Delete a job definition, including its input conditions and End-of-Job checking and actions. |
E
|
Edit JCL or a Natural source. |
G |
Pregenerate active JCL. |
I
|
List input conditions for the job. |
J
|
Define the JCL for the job. |
L
|
Handle prerequisite resources for the job. |
M
|
Modify a job definition: see Displaying and Modifying a Job Definition. |
O
|
Define End-of-Job checking and actions. |
P |
Invoke the editor to write a long description for the job. See Writing and Viewing Online Documentation for a Job. |
R
|
Activate a single job. |
S
|
Define scheduling parameters for the job (see the section Schedule Maintenance). |
U
|
Define additional (extended) information for the system log. See Defining Extended Log Information for a Job. |
Z
|
List jobs in subnetwork (for jobs of type
NET only). See
Listing Jobs of a
Subnetwork.
|
The PF keys of the Job Maintenance screen have the standard behavior, except the following:
PF Key | Name | Function |
---|---|---|
PF2 | Add | Add a job definition. |
PF3 | End | Leave the job maintenance screen.
If the job maintenance screen has been invoked by the
line command |
The following sections give detailed descriptions of the functions you can perform on each job using line commands.
To select a range of job definitions to be listed
Enter your selection criteria in the input fields loacted above the Job and/or Type columns of the Job Maintenance screen.
Press Enter.
The filtered job definitions are displayed.
To view and modify a job definition
On the Job
Maintenance screen, type M
in the line
command input field next to the job you want to view or modify.
Press ENTER.
A Job Definition (Master) window opens containing the current values for the job:
21.08.22 ***** Entire Operations ***** 14:28:28 Job Maintenance Owner EXAMPLE Network B60-FLOW Version ------------------------------------------------------------------------------ +------------------------------------------------------------------------+ ! ! ! Job Definition (Master) ! 2 ! ! 1 ! Job Name ==> JOB-01____ Mod ==> SN 08.01.20 14:44 ! 1 ! Description ==> Where it all starts_______________________________ ! 1 ! Job Type ==> JOB ! ! Execution Node ==> 121 BS2000 ! 1 ! ! 2 ! Special Type ==> ________ Symbol Table ==> __________ ! 1 ! Milestones ==> ________ Symbol Table Version ==> __________ ! 1 ! Restartable ==> _ ! ! Suffix Symbol ==> ________________________________________ ! 2 ! Escape Characters: Activation ==> § ! ! Submit ==> $ ! ** ! End-of-Job Action Errors set 'not ok' Conditions ==> _ ! es ! ! ! Enter-PF1---PF2--PF3--PF4---PF5---PF6---PF7---PF8---PF9--PF10---PF12- ! ! Help Add End Edit Save Spec Symb Net JCL Browse Menu ! -- +------------------------------------------------------------------------+ |
You can change the values in the fields described in the section Fields: Job Definition (Master).
Note:
Depending on your job type or operating system, you may
have to define additional parameters. Choose PF6 (Specials) to open
a window with the additional parameters. For further information, see
Displaying Job
Dependencies and Connecting or Disconnecting Jobs.
Choose PF5 (Save) to save all changes.
Choose PF3 (End) to return to the Job Maintenance screen.
This section covers the following topics:
The fields in the Job Definition (Master) window are described in the following table.
Note:
The fields and tabbed pages available depend on the
Job Type,
the Special
Type and the operating system of the Execution
Node specified for the job.
Field | Description | |
---|---|---|
Job Name | Job name.
Entire Operations recognizes a job by this name. It can, but need not be the same name as the JCL source used by the job (the operating system recognizes a job by its JCL name). Note: |
|
Description | Short description of the
job.
The maximum input is 50 characters. This text appears in the list of jobs on the Job Maintenance screen. Note: You can add a long description for the job: see Writing and Viewing Online Documentation for a Job. |
|
Job Type | Job type as defined to Entire Operations. For further information, see the section Job Types. | |
Special Type | Leave
this field empty if this is a normal job or enter one of the following values:
|
|
Execution Node | Node on which to submit
the job.
The default is the value specified in the job network definition (see the field Execution Node in the section Network Maintenance). You can enter a different node for the job here. The name of the operating system appears after the node number. You can define the execution node as a symbol. For details, see Symbols in Node Definitions in the section Symbol Table and Symbol Maintenance. |
|
Symbol Table | Name of the symbol table
to be referenced for substitution of variables in dynamic JCL.
Enter an asterisk ( Note: |
|
Symbol Table Version | Version of the symbol
table to be used.
Reserved names (are replaced). |
|
current |
Current version for the activation date or determination date. | |
nv |
Version of the using network. | |
svn |
Symbol table version of the using network. | |
Suffix Symbol | (Optional field)
If multiple instances of the job are to be activated in parallel, this field must contain a symbol name. The symbol will be searched in the symbol search hierarchy current at activation time. The symbol must contain the suffixes to be appended to active job names and output conditions. The sum of the lengths (prefix+suffix) must not exceed the maximum field lengths for job names or conditions. For example, if the job master name is
If Suffix Symbol does not contain any values, the job is activated as a temporary dummy job. For information about the definition of multiple symbol values, see Defining Multiple Symbol Values in the section Symbol Table and Symbol Maintenance. For information about the assignment of multiple symbol values to Suffix Symbol, see Symbol Replacement with Multiple Symbol Values. |
|
Restartable | Only applies to BS2000.
Job can be restarted automatically. Possible values:
Additional Restart
Criteria:
Job submission time must be before the last IPL time and
the job must not be terminated. The field MonJV must
contain |
|
Mod | User ID, date and time of the last modification of the job definition. | |
End-of-Job Action Errors set 'not ok' Conditions | Job output conditions.
Possible values:
See also the field End-of-Job Action Errors set 'not ok' Conditions in the network master definition. |
|
Milestones |
Milestone job types.
You can set single or multiple milestone attributes (types) for a job that performs an important task within a job network, such as tracking significant events or controlling the successful completion of other jobs. Possible values for user-defined milestones:
Possible values for system milestones dynamically set by Entire Operations during job submission (applies to active jobs only):
You can use the application programming interface
For further information on milestone jobs, see the section Event Store Milestones in the System Automation Tools documentation. |
|
Escape Characters: | This is the
activation escape
character. It is a prefix for Natural code lines and symbols to be
replaced at activation time. If you change this character, dynamic JCL can
become invalid.
See also Symbol Escape Characters (Symbol Maintenance) and Notes about Escape Characters. |
|
Escape Characters: | This is the
submission escape character.
It is a prefix for symbols to be replaced at submission time. If you change
this character, dynamic JCL can become invalid.
Default is the dollar sign ( See also Symbol Escape Characters (Symbol Maintenance) and Notes about Escape Characters. |
- Note about Escape Characters
The job escape characters are used for symbol replacements and Macro JCL.
When a job is created or when an escape character is reset, the default value is taken in the following order from:
Network defaults (operating system specific) if defined for the current operating system;
Network definition if non-blank;
Global operating system specific defaults for z/OS and z/VSE, BS2000, UNIX and Windows (Administration documentation).
If you change the execution node to another operating system, you might want to delete the escape character definitions, so that they will be newly preset with the operating system specific defaults for the new operating system. See also Symbol Escape Characters in the section Symbol Maintenance.
You can perform the following functions using these PF keys in the Job Definition (Master) window:
PF Key | Name | Function |
---|---|---|
PF4 | Edit | Edit the
JCL.
You can edit the job's JCL directly from here. Make sure that you have defined JCL in advance. The JCL definition can be invoked with PF9 from this screen. |
PF6 | Spec |
Define job execution features. Depending on whether you choose PF6 in the Specials for Job Type window or in the Specials, Execution window, you can define job execution features specific to the job type or operating system. The input fields available are described in Fields: Job Type Specific Execution Features and Fields: Operating System Specific Execution Features. |
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 | Net | Subnetwork definition (for jobs of type
NET only).
See Defining a
Subnetwork |
PF9 | JCL | JCL definition This action is required for all job types with JCL. See Define the JCL for a job. |
PF10 | Browse | Browse JCL or Natural program source code for the job. |
When defining a new job, you can either enter all required attributes individually, or copy all attributes from an existing job master including all input conditions and End-of-Job activities defined for the job.
This section covers the following topics:
To add a job definition
On the Network Maintenance
screen, type L
in the line command field
of the network for which you wish to add a job and press ENTER.
Or:
Use the direct command
ADD JOB
as described in Direct Commands documentation.
The Job Maintenance screen appears.
Choose PF2 (Add).
A Job Definition (Master) window like the example below opens:
21.08.22 ***** Entire Operations ***** 14:20:22 Job Maintenance Owner EXAMPLE Network B60-FLOW Version ------------------------------------------------------------------------------ +------------------------------------------------------------------------+ ! EOR1080 - Job Network Defaults inserted ! ! Job Definition (Master) ! 2 ! ! 1 ! Job Name ==> __________ Mod ==> SAG 21.08.22 14:25 ! 1 ! Description ==> __________________________________________________ ! 1 ! Job Type ==> ___ ! ! Execution Node ==> 121 BS2000 ! 1 ! ! 2 ! Special Type ==> ________ Symbol Table ==> EXA-SYMBOL ! 1 ! Milestones ==> ________ Symbol Table Version ==> SV98______ ! 1 ! Restartable ==> N ! ! Suffix Symbol ==> ________________________________________ ! 2 ! Escape Characters: Activation ==> & ! ! Submit ==> " ! ** ! End-of-Job Action Errors set 'not ok' Conditions ==> N ! es ! ! ! Enter-PF1---PF2--PF3--PF4---PF5---PF6---PF7---PF8---PF9--PF10---PF12- ! ! Help Add End Edit Save Spec Symb Net JCL Browse Menu ! -- +------------------------------------------------------------------------+ |
Enter values for the fields described in Fields: Job Definition (Master).
Note:
Depending on your operating system, you may have to
define additional parameters. Choose PF6 (Spec) to open a window
with the additional parameters. For further information, see
Displaying Job
Dependencies and Connecting or Disconnecting Jobs.
You can copy a job within the current network or between networks.
Prerequisites for copying are:
You must be allowed to perform the copy function; see the settings of the write permissions in the Network Maintenance Functions of your user profile (Administration documentation).
You must be granted access to the networks of a specified target owner.
The target network must exist; you cannot create a new network with the copy function.
On the Job
Maintenance screen, type C
in the line
command field next to the job whose definition you want to copy and press
ENTER.
A Job Master Definition Copy window like the example below opens:
+-------------------------------------------------------------+ | | | Job Master Definition Copy | | | | From To | | Owner ==> EXAMPLE Owner ==> EXAMPLE___ | | Network ==> B60-FLOW Network ==> B60-FLOW__ | | Version ==> Version ==> __________ | | Job ==> JOB-01 Job ==> __________ | | | | | | PF1 Help PF3 End | +-------------------------------------------------------------+ |
The From section contains read-only fields with the name of the job selected for copying and the owner and network to which the job belongs.
The To section contains modifiable target fields which are preset to the name of the owner, network and version (if applicable) of the selected job.
In the To section, enter the names
required to specify the new job and its target environment. You can use an
asterisk (*
) as a wildcard to open a window and select a name from
a list.
When you are finished, press ENTER to save the new job and close the window.
The new job appears in the list of jobs on the Job Maintenance screen for the owner specified for the new job.
You can add a short description of a job when defining a job in the Job Definition (Master) window. This short description appears in the list of jobs on the Job Maintenance screen.
If you wish to add more online documentation for a job, proceed as described in the following instruction.
To create, view or modify a long job description
On the Job
Maintenance screen, type P
in
the line command input field next to the required job.
Press ENTER.
The description is displayed on an editor screen like the example below:
Edit Description Jb: ABC3A Nw: EORACCT------------------------------ Columns 001 072 ====> SCROLL===> CSR ***** ****************************** top of data ***************************** 00001 Job 'ABC3A' 00002 ----------- 00003 This job forces a defined event at end-of-job time and executes the 00004 program 'EORCONTI' which resides on the installation library 00005 'EORnnn.LOAD'. The necessary JCL which is named 'EORE*' is stored in 00006 the installation library 'EORnnn.SRCE'. ***** **************************** bottom of data **************************** |
The example above shows the screen with 6 lines of text.
(If no documentation exists for the selected job, the editor screen appears without text.)
Write new or replace existing text using editor commands which are briefly described in the online help. For detailed descriptions of all editor functions, see Software AG Editor in the Natural documentation.
Choose PF3 when you are finished.
The text is saved and the editor window closes.
On the Job Maintenance screen, the letter
P
in the P column next to the modified job
indicates that a long description exists for this job.
Once online documentation is written, it can be read by any user who
is authorized to access the network to which the job belongs. Use the line command P
to display the
current text.
You can also display or print online documentation by using the Reports facility described in the section Reporting. If long job descriptions exist, they are included in the Network Description (detailed) report as shown under item 5 of the Example of Network Description (detailed).
Note:
Deleting a job definition also deletes all definitions made at
the job level, including its input conditions and
End-of-Job checking and
actions. The original JCL is not deleted.
To delete a job definition
On the Job
Maintenance screen, type D
in
the line command input field next to the job you want to delete.
Press ENTER.
A window prompts you to confirm the deletion by entering the job name.
Press ENTER to delete the job definition.
The Job Maintenance facility allows you to see which jobs must run before a specific job can start, and which jobs run after it.
You can trace job dependencies through whole networks and display cross-network job links.
You can connect or disconnect jobs from the same or different networks.
Note:
An overview of the job flow for the whole network is available
from the Network Maintenance screen described in
Displaying the Job Flow within a
Network.
This section covers the following topics:
To display job dependencies for a specific job
On the Job
Maintenance screen, type A
in
the line command input field next to the required job.
Press ENTER. A Job Dependencies window opens:
19-02-07 ***** Entire Operations ***** 11:38:10 Job Maintenance Owner NATSAG Network A-OGCDEMO Version +--------------------------------------------------------------------------+ | | | Predecessors Job Dependencies Successors | | --------------------------+ +--------------------------- | | M Network Job I I Output Condition | | Input Condition I I Network Job M | | _ A-OGCDEMO J-OGCDEMO I I=> OGC-DEMO1-OK | | OGC-DEMO-OK =>I I A-OGCDEMO J-OGCDEMO2 _ | | _ +---------------+=> OGC-DEMO-NOK | | => Ow NATSAG A-OGCDEMO J-OGCDEMO7 _ | | _ Nw A-OGCDEMO => | | => Job J-OGCDEMO1 _ | | _ +---------------+=> | | =>I I _ | | _ I I=> | | =>I I _ | | --------------------------+ +--------------------------- | | X Chain D Disconnect X Chain D Disconnect | | Enter----PF1---PF2------PF3-------PF5---------PF7---PF8--------------- | | Help Connect End Save Up Down | +--------------------------------------------------------------------------+ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add End Save Up Down Menu |
The selected job name and network name appear in the middle of the window with its dependencies displayed in the two smaller windows on either side of the selected job name:
The Predecessors window on the left of the selected job contains the job and network names of the jobs that must run before the selected job can run. Directly beneath these are the linking conditions.
The Successors window on the right of the selected job contains the job and network names of the jobs for which the selected job is a prerequisite. Directly above these are the linking conditions.
You can scroll both lists by using PF7 (Up) and PF8 (Down).
In the M column of the Job Dependencies window, you can enter the following line commands to perform the described functions on any job displayed in the window:
Line Command | Description |
---|---|
D
|
Disconnect the job from a predecessor or successor
job.
See also Disconnecting Jobs. |
X
|
Chain. Move the selected job into the center of the window and display its dependencies. |
You can perform the following function from the Job Dependencies window using this PF key:
PF Key | Name | Function |
---|---|---|
PF2 | Connect | Connect
the job to a predecessor job. For the standard case, event Job OK.
See Connecting Jobs from the Same or Different Networks. |
You can connect two jobs within the same or different networks without defining logical conditions for them by using the Entire Operations default condition.
This function is also useful to link jobs across networks. In this
case, you should check the input condition reference of the successor job. Use
a reference different from RUN
.
Note:
After connecting jobs within a network, a loop check is
performed for the affected network. The same conditions apply as described in
Checking for a Loop in a Job
Network in the section Network
Maintenance, with one exception: if a loop is detected in the job
flow, no corresponding message appears.
To connect two jobs
Choose PF2 (Connect) in the Job Dependencies window of the job you wish to connect.
A Job Connection window opens in which you can define a job which must precede the selected job:
10.02.10 ***** Entire Operations ***** 16:31:28 Owner SN Job Maintenance Network A-1 +--------------------------------------------------------------------------+ ! EOR1141 - No Dependencies found ! ! Predecessors Job Dependencies Successors ! ! --------------------------+ +--------------------------- ! ! M Network Job I I Output Condition ! ! Input Condition I I Network Job M ! ! _ I I=> ! ! =>I I _ ! ! _ +-------------------------------------------------------+ ! ! ! ! _ ! ! _ ! Job Connection ! ! ! ! ! _ ! ! _ ! from Owner: SN________ to Owner: SN ! ! ! ! Network: A-1_______ Network: A-1 ! _ ! ! _ ! Job: __________ Job: D1 ! ! ! ! Event: OK ! _ ! ! ---- ! ! ------- ! ! X Ch ! PF3 End ! ct ! ! Ente +-------------------------------------------------------+ ------- ! E ! Help Connect End Save Up Down ! +--------------------------------------------------------------------------+ |
The identifiers of the selected job appear in the protected fields on the right in the window.
This section covers the following topics:
The input fields in the Job Connection window have the following meaning:
Field | Description | |
---|---|---|
from/ Owner | Enter owner of job to run as predecessor. | |
from/ Network | Enter network name of job to run as predecessor. | |
from/ Job | Enter name of job to run as predecessor. | |
Event | OK |
Job ended ok
The condition
|
NO |
Job ended not ok
The condition
If an output condition already exists for a mentioned event, it is used for the linkage (instead of creating a new condition). |
To disconnect two jobs linked by conditions
In the Job Dependencies
window, type D
in the line command input
field of the second job in the sequence.
Press ENTER.
A confirmation window opens:
23.10.08 ***** Entire Operations ***** 15:35:41 Owner SN Job Maintenance Network BIG-1 +--------------------------------------------------------------------------+- ! NOP1457 - Several Predecessor Jobs ! ! Predecessors Job Dependencies Successors ! ! --------------------------+ +--------------------------- ! ! M Network Job Output Condition ! ! Input Condition Network Job M ! ! _ BIG-1 JOB-012 => E60-J013-O ! ! E60-J0 +----------------------------------------------+JOB-014 d ! ! _ BIG-1 ! ! ! ! E60-JO ! Please confirm ! _ ! ! _ ! the Disconnection from JOB-014 ! ! ! ! by entering 'Y' ===> _ ! _ ! ! _ ! ! ! ! ! PF3 End ! _ ! ! _ +----------------------------------------------+ ! ! => _ !* ! --------------------------+ +--------------------------- ! ! X Chain D Disconnect X Chain D Disconnect ! ! Enter----PF1---PF2------PF3-------PF5---------PF7---PF8--------------- ! E ! Help Connect End Save Up Down !- +--------------------------------------------------------------------------+ |
Enter Y
.
Press ENTER to perform the disconnection and close the window. You can disconnect any two jobs linked by conditions using this function. There is no need to delete any defined conditions.
Note:
No disconnection is performed if the use of the
conditions is not unique, for example:
Note:
Remove the condition definitions manually if the link is
not unique.
- Disconnection from a Predecessor Job
When disconnecting from a predecessor job, the linking input condition definition of the job displayed in the center (of the Job Dependencies window) is deleted.
- Disconnection from a Successor Job
When disconnecting from a successor job, the linking output condition definition of an event definition of the job displayed in the center (of the Job Dependencies window) is deleted.
Note:
The input condition definitions of the successor job remain unchanged. After the output condition definition is deleted, the successor job can wait for a condition which is never satisfied.
- Restrictions:
A linking condition is deleted, only if it links no more than two jobs.
If the
X
line command (Chain) was invoked for jobs in different networks, a disconnection of this type is not possible.
Just as you can perform an ad-hoc manual activation of a job network at any time to allow it to run outside of its scheduled times, you can also manually activate any job at any time, regardless of its position within a job network.
The activated job is assigned its own run number (in sequence with the network run number) and, if you do not change the date or time, is submitted immediately by the Entire Operations Monitor. If the job contains symbols as placeholders for variables, symbol prompting takes place as described in the section Symbol Prompting during Network or Job Activation. If other symbol tables are required, they are prompted too.
The differences between the manual activation of a single job and the manual activation of a job network are that when a single job is activated:
No check for defined input conditions for the job is performed;
No output conditions are set by the job.
All other End-of-Job actions defined for the job are executed.
To activate a job manually
Type R
in the line command input
field for the selected job in the Job Maintenance
screen.
Press ENTER.
A Job Activation window like the example below opens:
18-03-06 ***** Entire Operations ***** 10:31:35 Job Maintenance Owner SAGTEST Network SAGNET Version V1 ------------------------------------------------------------------------------ Cmd C R PU Job Type Loc Description File or Library Member *--- +-----------------------------------------+ R C JOB- ! ! JCLJOB _ C1 SUBN ! Job Activation ! SAGNETSUB (D) ! ! ! Owner ==> SAGTEST ! ! Network ==> SAGNET ! ! Version ==> V1 ! ! Job ==> JOB-01 ! ! ! ! Preferred Run Number ==> ______ ! ! Use Time from Schedule ==> N (Y/N) ! ! or activate at Date ==> 18-03-06__ ! ! Time ==> 10:31:42 ! *************** ! JCL Check only ==> N (Y/N) ! ****************** A Dep. B Browse ! Enter----PF1---PF3------------------- ! J JCL L Resources M Mod. O EOJ Ch ! Activate Help End ! t.Log Z Subnet Command => ____ +-----------------------------------------+ ___________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add End Save Up Down Menu |
This section covers the following topics:
The fields of the Job Activation window are described in the following table:
Field | Description |
---|---|
Owner | Owner of network in which job is to be activated. |
Network | Network of the job that is to be activated. |
Version | Network version of the job that is to be activated. |
Job | Job to be activated. |
Preferred Run Number | If input is allowed for this field, you
can enter the run number you want to be used for the activated job. Run numbers
for further job activations increment from this number.
If the requested run number is in use, Entire Operations assigns the next free number. If this field contains a zero ( Field input is allowed or not allowed (default) in the network default settings: see the option Activation: Allow run number setting in the section Default Setting (4) in the Administration documentation. |
Use Time in Schedule | Enter Y (yes)
here to activate the job
within the defined time
frames (earliest start, latest start, deadline), even if the current
date is not a scheduled date for this network. With this option, you can force
the same time dependencies as if the network was scheduled and activated
automatically.
For more information on network time frames, see Activating a Job Network Manually in the section Network Maintenance. |
or activate at Date/Time | Shows the current date and time. You can modify date
and time to force activation at any time on any date. There is no limitation
for future date and time settings.
See also Date and Time Formats. Note: |
JCL Check only | Only a JCL check is performed for the job. See JCL Check only for further reference. |
If set to
N (no):
Normal job submission is used for job activation. This is the default. |
Entire Operations allows you to define which information is to be logged in addition to the Entire Operations standard system log.
Additional (extended) log information can be viewed as described in Displaying Extended Log Information in the section Log Information.
Extended log information is defined at the job level.
To define extended log information
Type U
in the line command input
field of the selected job on the Job Maintenance screen
and press ENTER.
An Extended Log screen opens in which you can specify the information to be logged:
24.03.20 ***** Entire Operations ***** 11:20:33 Extended Log Owner EXAMPLE Network E60-FLOW Version v2.1 Job JOB-01 ------------------------------------------------------------------------------ Log SYSOUT ==> Y (Y/N) Files ==> ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ Log JCL ==> Y (Y/N) Log Messages M Code M Code M Code M Code _ IEF403I _______ _______ _______ _ IEF404I _______ _______ _______ _______ _______ _______ _______ _______ _______ _______ _______ _______ _______ _______ _______ S Message Contents Selection Command ==> ____________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help End Save Menu |
Specify the information to be logged.
The input fields and options are explained in Fields: Extended Log.
Choose PF5 (Save) to save your entries.
Choose PF3 (End) to return to the Job Maintenance screen.
The logged information can be viewed after job termination using the Log Information facility described in the section Log Information.
This section covers the following topics:
The input fields of the Extended Log screen are described in the following table:
Field/Column | Description | |
---|---|---|
Log SYSOUT | Specifies logging of job SYSOUT files after job termination. Possible values: | |
Y |
Logs SYSOUT. | |
N |
No SYSOUT files are logged. | |
SYSOUT logging can also
be defined as SYSOUT
action.
If the SYSOUT file or spool data set exceeds a given line limit, the log display is truncated: see SYSOUT Line Limit in Default Setting (4) in the Administration documentation. |
||
Files | (z/OS only)
Input valid only if Log SYSOUT is specified. Enter number(s) of SYSOUT file(s) to be logged. If left blank and Log SYSOUT is specified, all files are logged. |
|
Log JCL | Specifies logging of JCL
after job termination.
This is useful for dynamically generated JCL or if JCL is frequently modified for different job runs. Possible values: |
|
Y |
Logs JCL. | |
N |
No JCL is logged. | |
See also JCL Log. | ||
Log Messages | Specifies messages to be logged if returned from a SYSOUT file
(BS2000, UNIX and Windows) or JES SM spool data set (z/OS).
Enter a message code (for example, If used as a code prefix, it specifies a range of codes
to be logged. For example: If you enter |
- Message Contents Selection
+----------------------------------------------------------+ | | | Message Contents Selection | | | | Network E60-FLOW Version v2.1 Job JOB-01 | | | | Log Message IEF403I , if it contains one of the | | following strings: | | ________________________________________ | | ________________________________________ | | ________________________________________ | | ________________________________________ | | ________________________________________ | | | | PF1 Help PF3 End | +----------------------------------------------------------+Messages are logged if they are selected by their message code, and if one of the following conditions is true:
No message contents selection is specified. (No selection strings defined.)
A message contents selection is specified, and at least one of the strings is found within the pre-selected message.
- JCL Log
The JCL log is generated from the following sources:
BS2000 From the ENTER file. (The ENTER file is deleted after copying into the Entire Operations Log.)
z/OS If Entire Operations runs on a mainframe: from the SYSOUT (JES output). If Entire Operations does not run on a mainframe: from the active JCL.
z/VSE From the active JCL. UNIX From the effectively submitted shell script. Windows From the effectively submitted BAT file or PowerShell script.