Maintaining Active JCL (Job Control Language)

#### Search Results

Search

# Maintaining Active JCL (Job Control Language)

This document covers the following topics:

- Defining JCL for an Active Job

- Browsing Active JCL

- Editing Active JCL

- Release Edit Lock

- Exchanging Active JCL

- Regenerating Active JCL

#### Related Topics:

See also the following in the section Job Maintenance:

- Pregenerating Active JCL

- Defining and Managing JCL for a Job

- Editing Master JCL and Natural Sources

## Defining JCL for an Active Job

To insert or modify the job control definition of an active job

1. On the Active Jobs or All Active Jobs screen, type `J` in the line command input field next to the required job, and press ENTER.

   A Job: JCL Definition (active) window opens displaying the current definitions.

How to modify the JCL definition is described in Defining the Job Control (JCL) in the section Job Maintenance.

Note
The modifications to the JCL definition of an active job are only valid for the current run.

## Browsing Active JCL

You can view the actual JCL submitted to the operating system for execution. It is produced from the master JCL when the job or network is activated. The symbols are replaced with values from the active symbol table. If it is dynamic JCL, the generation is performed at this time. The active JCL is stored in the active Entire Operations database.

To browse active JCL

1. On the Active Jobs or All Active Jobs screen, type `B` in the line command input field next to the required job, and press ENTER.

2. The active JCL is displayed in the editor. You cannot modify the source.

## Editing Active JCL

For the current job run, you can edit the active JCL of an active job. Editing active JCL is useful, for example, for correcting JCL errors after job failure.

The following applies when editing active JCL:

- While editing active JCL, an implicit logon is triggered to establish the connection to the required node. The logon is not prompted if you have already logged on to the node within this session. For further information on logging on a node, see Logon Function in the section Using Entire Operations GUI Client.

- The source changes for the current job run only. The master JCL definition remains unchanged. If you want to edit the JCL for all runs, you must edit the master JCL.

- For jobs of the type `NAT` (Natural program) with JCL location `NAT` (Natural source), the original Natural source object is edited.

- Any changes to JCL made from the Active Jobs or All Active Jobs screen affect the current job run only.

- Browsing or editing of active JCL is prohibited, while JCL regeneration for the same active job is in progress.

- If you modify active JCL before the job is submitted, Entire Operations submits the job automatically according to its defined prerequisites.

- If you modify the JCL after the job terminated and want to resubmit the job with the new JCL, issue the `R` line command for the job on the Active Jobs or All Active Jobs screen (see Resubmitting an Active Job).

To edit active JCL

1. On the Active Jobs or All Active Jobs screen, type `E` in the line command input field next to the required job, and press ENTER.

   The active JCL is displayed in the editor.

2. Modify the source as required by using editor commands and PF keys. See also Editing Master JCL and Natural Sources in the section Job Maintenance.

## Release Edit Lock

This function can only be executed by administrators.

This function removes a lock from active JCL held on the source by a user who previously edited it. The unlock action is archived in the Entire Operations log.

Important
This function is for emergency use only. Data loss can occur when you remove the lock from a source while it is being edited by several concurrent users.

To remove the edit lock

- On the All Active Jobs screen, type `F` in the line command input field next to the required job, and press ENTER.

  A window opens and you are prompted to confirm the release action.

See also Locking of Natural Sources in the section Job Maintenance.

## Exchanging Active JCL

When modifying an active job, you can specify another JCL member and library by overtyping the current values in the corresponding input fields. This allows you to run a different job in place of the old one using the same input conditions, End-of-Job handling, etc. The replacement is valid for the current network run only.

When you have specified a different JCL member and/or library, Entire Operations replaces the old JCL with the new and notifies you of the replacement with a message. The new member can use dynamically generated JCL as described in Dynamic JCL Generation (JCL Location MAC).

Note
After exchanging the JCL, the job must be restarted with the line command `R` (resubmit). For further information, see Resubmitting an Active Job.

## Regenerating Active JCL

The JCL for operating system jobs is generated (copied to the active database) when Entire Operations activates a job network. Entire Operations allows you to regenerate the JCL while the job is in the active database. This is useful when you wish to refresh the variables in dynamically generated JCL in MAC-type jobs or when you wish to (re)submit active jobs with their original JCL after editing their JCL for a specific job run.

If pregenerated JCL exists, this command uses it for the regeneration. Symbol values are taken in their current status from the active symbol table. If necessary, the active symbol table should be checked beforehand.

This section covers the following topics:

- Symbol Prompting During JCL Regeneration

- Regenerating Active JCL

- Resubmitting the Active Job after JCL Regeneration

### Symbol Prompting During JCL Regeneration

If a symbol entry is defined for at least one symbol of the symbol table of the job, the symbol is prompted now and a Symbol Prompting for Table screen appears. If you choose Cancel Activation, prompting is cancelled, and the JCL is not regenerated.

Symbol prompting during the JCL regeneration can be switched on or off by a global switch in the Entire Operations defaults. See the corresponding option setting described in Default Setting (2) in the Administration documentation.

The (re)generation of active JCL is always being performed online, i.e., not by the Entire Operations Monitor. This also applies to MAC-type jobs.

See also Symbol Prompting during Network or Job Activation in the section Symbol Table and Symbol Maintenance.

### Regenerating Active JCL

To regenerate active JCL

1. On the Active Jobs or All Active Jobs screen, type `G` in the line command input field next to the required job, and press ENTER.

   A confirmation window opens.

2. Enter `Y` (yes) and press ENTER to confirm the JCL regeneration and close the window.

3. The message JCL regenerated for job appears in the message field of the selected job on the Active Jobs or All Active Jobs screen.

### Resubmitting the Active Job after JCL Regeneration

After regeneration of the JCL with the line command `G` (Gen. JCL), the active job is not automatically restarted. You must resubmit the job.

In addition, regenerating JCL for a NET type job (re)activates the subnetwork. However, it does not automatically start a subnetwork as a consequence. The subnetwork receives a new run number because of this action.

To start a job (and a subnetwork) after regeneration of the JCL

- On the Active Jobs or All Active Jobs screen, enter the line command `R` (Resub.) next to the required job.

See also Resubmitting an Active Job of NET type (Subnetwork).

### On this page

- Defining JCL for an Active Job
- Browsing Active JCL
- Editing Active JCL
- Release Edit Lock
- Exchanging Active JCL
- Regenerating Active JCL