Special Monitor Functions and Batch Jobs

This section describes special global functions, control and recovery functions provided for system administrators.

Note:
Some of these functions should be used only as recovery for uncommon situations.

Außerdem behandelt dieses Kapitel, wie Sie ein Monitor-Start-Netzwerk anlegen und benutzen können.

In addition, this section describes how to define and use a monitor start network.


Defining and Using Monitor Start Networks

(Administrator rights for owner SYSDBA required)

You can define a job network to be executed after each Monitor start and before the activation of any other job.

This section covers the following topics:

Monitor Start Network

If a job network with the name MON-START is defined under the owner SYSDBA, this network is executed exclusively at each Monitor startup. This is called the Monitor start network.

No other job network is started until the start network is terminated correctly.

The last job of the start network must not set any condition (but can reset conditions). During execution of the start network, the absolute condition MON-START-RUNNING (owner SYSDBA) is set.

If any job of the start network ends not OK, this condition remains true and blocks any other Monitor action. The condition can be reset manually to free continuation of other processing. While the absolute condition is active, the message Start Network still running appears in the log and on the system console during each Monitor pass.

Execution

The start network is intended to run exclusively before any other network. Therefore, the absolute condition MON-START-RUNNING (owner SYSDBA) is set at activation time.

The setting of this condition is automatically taken over by the first job of the start network. This job sets no conditions during End-of-Job checking and actions.

Note:
The absolute condition MON-START-RUNNING is to be reset, only if the whole start network ends normally. Any other activity of the Monitor is blocked during execution of the start network. If any error occurs in the start network, the whole processing of other networks is blocked until there is a manual intervention. To force the normal processing to start, reset the condition MON-START-RUNNING manually.

Day Start Network

You can define a job network to be executed at the start of each day (when the date changes) and before the activation of any other job. If the Monitor is not active at this time, it is executed at Monitor start time.

If a network with the name DAY-START is defined under the owner SYSDBA, it is executed at Monitor start time.

Day Start Execution

The start network is intended to run exclusively before any other network. Therefore, the absolute condition DAY-START-RUNNING (owner SYSDBA) is set at activation time.

The setting of this condition is automatically taken over by the first job of the start network. This job sets no conditions during End-of-Job checking and actions.

Note:
The absolute condition DAY-START-RUNNING is to be reset only if the whole start network ends normally. Any other activity of the Monitor is blocked during execution of the start network. If any error occurs in the start network, the whole processing of other networks is blocked until there is a manual intervention. To force the normal processing to start, reset the condition DAY-START-RUNNING manually.

Common Start Network Considerations

The considerations in this section apply to the Monitor start network and the day start network.

Exclusive Execution

While a start network is running, a warning message is repeatedly written to the log.

During the execution of the start network, the following Monitor activities are blocked:

  • Schedule extraction

  • Activation (except start network)

  • Cleanup

Note:
The Monitor start network and the day start network can execute in parallel.

Use

Some possibilities for the use of the start network are:

  • Preparation of symbol tables for other networks;

  • Activation of other networks;

  • Condition setting;

  • Any Entire System Server functions.

Accessing Special Functions

Start of instruction setTo access special functions

  1. In the object workspace, select Administration and choose Special Functions from the context menu.

    A Special Functions window like the example below opens.

    graphics/specialfunctions_administration.png

  2. Open the drop-down list box and select the required function.

  3. Choose OK.

Global Schedule Extraction

The Entire Operations Monitor performs the following steps to activate networks:

  • Extracts schedules at the beginning of a new day by default.

  • Activates extracted job networks at or shortly before the earliest start time of the network.

Examination of schedules can be forced at any time by using the Global Schedule Extraction feature. Several schedule extractions on the same day have no influence on already extracted activations.

Note:
Any modification to a schedule automatically implies an activation extraction for the networks linked to this schedule.

This section covers the following topics:

Setting Dates and Times for Extraction

Start of instruction set To add an extraction date and time for schedule extraction

  1. In the object workspace, select Administration.

  2. Invoke the context menu and select Special Functions.

  3. From the Special Functions drop-down list box, select Global Schedule Extraction.

    A Global Schedule Extraction window like the example below opens:

    graphics/globalscheduleextraction_administration.png

    The columns are explained in Columns/Fields: Global Schedule Extraction.

  4. Choose Add.

    An Add new Start time window opens. The fields are explained in Columns/Fields: Global Schedule Extraction.

  5. Select or enter the required date and time and choose OK.

    The window closes, and the new start date and time are listed in the Global Schedule Extraction window.

Start of instruction set To modify a date and time set for schedule extraction

  1. In the Global Schedule Extraction window, select the row that contains the date and time you want to modify.

  2. Choose Modify.

    A Modify Start time window opens. The fields are explained in Columns/Fields: Global Schedule Extraction.

Deleting Dates and Times Set for Extraction

Start of instruction set To delete a date and time set for schedule extraction

  1. In the Global Schedule Extraction window, select the row that contains the date and time you want to delete.

  2. Choose Delete and then Yes to confirm the deletion.

    The window closes, and the selected date and time are removed from the Global Schedule Extraction window.

Columns/Fields: Global Schedule Extraction

The following table describes the columns and fields contained in the Global Schedule Extraction and related subordinate windows.

Column/Fields Meaning
Global Schedule Extraction window:
Time Date and time of activation extraction.

See also Date and Time Formats in the User's Guide.

Status  Status of network activation processing.

Possible status values:

Global schedule, active on demand
Activation now
Activation in progress
Sched. job
Demand job
Schedule table
Aw. symbol prompting
Activation error
Symbol entry in progress
Hold for symbol entry

Add new Start time window:
Date/Time Date and time to be used for activation extraction.

See also Date and Time Formats in the User's Guide.

Modify Start time window:
New start time/Old start time The planned (old) start time previously set and the new start time to be used instead.

For valid input values, see Date and Time Formats in the User's Guide.

Keep predefined Job Time Frames Adapt the job time frames.

Possible check box settings:

unchecked All job time frames are adapted (default).
checked Jobs with master time frame definitions are not adapted.

Cleanup of the Active Database

Normally, the active database is cleaned automatically every time the Entire Operations Monitor starts up or at the beginning of a new day.

An immediate cleanup of the active database can be triggered at any time. It is executed by the Entire Operations Monitor (in the background). This cleanup removes expired active job entries, pending tasks, log records, and related material from the Entire Operations database file. The retention periods of the Entire Operations default settings (see Defaults for Time Ranges) are used.

Alternatively, the cleanup of the active database can be performed in batch mode. See Cleanup of the Active Database in Batch Mode described in the User's Guide.

All operations performed during the cleanup are recorded in the Entire Operations log.

Start of instruction setTo clean up the active database

  1. In the object workspace, select Administration.

  2. Invoke the context menu and select Special Functions.

  3. From the Special Functions drop-down list, select Cleanup of the Active Database.

  4. Choose OK and then Yes to confirm the cleanup.

Removal of All Monitor Commands

This function removes all internal commands from the internal Entire Operations Monitor command queue.

Warning:
Use this function only in case of emergency and with extreme care.

Start of instruction setTo remove all Monitor commands

  1. In the object workspace, select Administration and choose Special Functions from the context menu.

  2. From the Special Functions drop-down list, select Removal of Monitor Functions.

  3. Choose OK and then Yes to confirm the removal.

    The Monitor functions are removed.

JCL File Password: Global Exchange

The JCL File Password Exchange function allows the system administrator to exchange the file password for all definitions of a given file. This function should be used after the modification of a file password on the operating system level.

Start of instruction setTo exchange the JCL file password

  1. In the object workspace, select Administration and choose Special Functions from the context menu.

  2. From the Special Functions drop-down list, select JCL File Password Exchange and choose OK.

    A JCL File Password Exchange window like the example below opens:

    graphics/jclpasswordexchange_administration.png

  3. Select the required node and file and enter a password. The input fields are explained in Fields: JCL File Password Exchange Administration.

  4. Choose OK when you are finished.

    The password is changed.

This section covers the following topics:

Fields: JCL File Password Exchange Administration

Field Meaning
Node  Number of the Entire System Server node on which the file can be accessed.
File   The password for the file specified here will be exchanged in all job definitions.
Password  The new replacement password (invisible when entered).

This password must then be used when editing or selecting members, as well as for JCL loading of the Monitor.

Force Prerequisite Check for Jobs in Passive Wait

This function forces an active prerequisite check for all jobs which have been set to the status passive wait.

Start of instruction setTo force a prerequisite check

  1. In the object workspace, select Administration and choose Special Functions from the context menu.

  2. From the Special Functions drop-down list, select Force Prerequisite Check.

  3. Choose OK and then Yes to confirm the action.

    The prerequisite check is performed.

Pending Tasks

This function shows pending file delete requests.

The main reason for pending delete states are file in use errors during a delete attempt.

Pending tasks are deleted during the next database cleanup (see the relevant section).

Start of instruction setTo view all pending tasks

  1. In the object workspace, select Administration and choose Special Functions from the context menu.

  2. From the Special Functions drop-down list, select Pending Tasks.

    A Pending Tasks window opens.

    All pending tasks are listed in the window. (The list is empty if no tasks are pending.)

    The columns in the window are explained in Columns: Pending Tasks.

    You can refresh the list by using the Refresh button.

  3. Choose OK.

Columns: Pending Tasks

The columns of the Pending Tasks window are described in the following table:

Column Meaning
Owner Owner of the affected network.
Network Network that contains the affected job.
Run Run number of the affected job.
Job Job that references the affected file.
Type Type of delete request. Possible values:
O Online or Monitor request.
B Batch cleanup.
Wait Hours since the delete request is pending.
File File affected by the delete request.