Special Monitor Functions and Batch Jobs

#### Search Results

Search

# 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

- Accessing Special Functions

- Global Schedule Extraction

- Cleanup of the Active Database

- Removal of All Monitor Commands

- JCL File Password: Global Exchange

- Force Prerequisite Check for Jobs in Passive Wait

- Pending Tasks

## 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
- Use

#### 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

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

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

- Deleting Dates and Times Set for Extraction

- Columns/Fields: Global Schedule Extraction

### Setting Dates and Times for Extraction

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:

   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.

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

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.

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

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

To 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:

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

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

To 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).

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

### On this page

- Defining and Using Monitor Start Networks
- Accessing Special Functions
- Global Schedule Extraction
- Cleanup of the Active Database
- Removal of All Monitor Commands
- JCL File Password: Global Exchange
- Force Prerequisite Check for Jobs in Passive Wait
- Pending Tasks