EOJ command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (→‎Usage notes: minor formatting)
No edit summary
Line 15: Line 15:
The <var>EOJ</var> command signals an end-of-job condition and begins the process of <var class="product">Model&nbsp;204</var> termination. It should be used in conjunction with the <var>[[EOD command|EOD]]</var> and <var>[[BUMP command|BUMP]]</var> commands. Any users who are still active when <var>EOJ</var> is issued are forced off <var class="product">Model&nbsp;204</var>. If files are being updated at this time, their integrity might be damaged.</p>  
The <var>EOJ</var> command signals an end-of-job condition and begins the process of <var class="product">Model&nbsp;204</var> termination. It should be used in conjunction with the <var>[[EOD command|EOD]]</var> and <var>[[BUMP command|BUMP]]</var> commands. Any users who are still active when <var>EOJ</var> is issued are forced off <var class="product">Model&nbsp;204</var>. If files are being updated at this time, their integrity might be damaged.</p>  
<p>
<p>
You can issue an <var>EOJ</var> command from the terminal or can include it at the end of User 0's input stream. If <var>EOJ</var> is omitted from this stream, a user restart is invoked and the return code is set to 6.</p>
You can issue an <var>EOJ</var> command from the terminal or can include it in the User 0 input stream (CCAIN). When the <var>EOJ</var> command is invoked from CCAIN, the Online is immediately terminated, witbout any of the prompts described below.</p>
<p>
If <var>EOJ</var> is omitted from the User 0 input stream, a user restart is invoked and the return code is set to 6.</p>
<p>
<p>
If you enter an <var>EOJ</var> command from a terminal, you must confirm the command before it is executed:</p>
If you enter an <var>EOJ</var> command from a terminal, you must confirm the command before it is executed:</p>

Revision as of 15:55, 4 June 2016

Summary

Privileges
System manager or User 0
Function
Specifies end of job and initiates Model 204 termination, forcing active users off Model 204.

Syntax

EOJ

Usage notes

The EOJ command signals an end-of-job condition and begins the process of Model 204 termination. It should be used in conjunction with the EOD and BUMP commands. Any users who are still active when EOJ is issued are forced off Model 204. If files are being updated at this time, their integrity might be damaged.

You can issue an EOJ command from the terminal or can include it in the User 0 input stream (CCAIN). When the EOJ command is invoked from CCAIN, the Online is immediately terminated, witbout any of the prompts described below.

If EOJ is omitted from the User 0 input stream, a user restart is invoked and the return code is set to 6.

If you enter an EOJ command from a terminal, you must confirm the command before it is executed:

  • If you are on a full screen thread and the SIRPRMPT X'04' bit is on, you are prompted for the name of the Online for confirmation.
  • If you are on a line-at-a-time thread and SIRPRMPT X'08' is on, you are prompted for the name of the Online for confirmation.
  • If SIRPRMPT has not been set, you are prompted whether to end the run (Yes or No).

    If the your response is Yes, Model 204 is terminated. If your response is No, the EOJ command is ignored. The default response is Y if the PROMPT parameter includes the X'10' bit.

The name of the Online is the Online's job name if CUSTOM is set to 37, or the location of the Online if the LOCATION parameter is set.

Examples:

If CUSTOM=37 is set:

M204.1076: Do you really want to end the run for jobname?

If CUSTOM=37 is not set, and LOCATION is set:

M204.1076: Do you really want to end the run for location?

If CUSTOM=37 is not set, and LOCATION is not set:

M204.1076: Do you really want to end the run?

If the RESTART command (ROLL BACK or ROLL FORWARD) is executing when the EOJ command is entered, the following message is displayed prior to the request for confirmation:

*** M204.1453: RESTART RECOVERY IS RUNNING

No confirmation is requested when the EOJ command is supplied by User 0, either in the CCAIN input stream or from the console in a single-user z/VM run.

If the EOJPW parameter has been set, the following prompt will appear:

M204.0347: Password

and you must enter the value of EOJPW to end the run.

Checkpoint logging

If checkpoint logging is enabled in the Model 204 run, the EOJ command requests that a checkpoint be performed before Model 204 termination processing begins. This checkpoint request waits until the values of the CPTO and CPTQ parameters are exceeded. If updating users are finished, their work is captured by the checkpoint, otherwise it might be lost. After the checkpoint is taken or times out, termination processing proceeds.

When Model 204 processes EOJ, it abruptly ends all update units in progress and does not invoke transaction backout.

For more information about: