EOJ command: Difference between revisions
No edit summary |
|||
| Line 13: | Line 13: | ||
==Usage notes== | ==Usage notes== | ||
<p> | <p> | ||
The <var>EOJ</var> command signals an end-of-job condition and begins the process of <var class="product">Model 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 204</var>. If files are being updated at this time, their integrity might be damaged. You can issue an <var>EOJ</var> command from the terminal or 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> | The <var>EOJ</var> command signals an end-of-job condition and begins the process of <var class="product">Model 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 204</var>. If files are being updated at this time, their integrity might be damaged.</p> | ||
<p>You can issue an <var>EOJ</var> command from the terminal or 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> | |||
<p> | <p> | ||
If you enter an <var>EOJ</var> command from a terminal, you must confirm the command before it is executed | If you enter an <var>EOJ</var> command from a terminal, you must confirm the command before it is executed:</p> | ||
< | <ul> | ||
</ | <li>If you are on a full screen thread and <var>[[SIRPRMPT parameter|SIRPRMPT 4]] </var> is on, you are prompted for the name of the online for confirmation.</li> | ||
<li>If you are on a line-at-a-time thread and <var>[[SIRPRMPT parameter|SIRPRMPT 8]] </var> is on, you are prompted for the name of the online for confirmation.</li> | |||
<li>If SIRPRMPT has not been set, you are prompted whether to end the run (<code>Yes</code> or <code>No</code>). | |||
<p> | <p> | ||
If the | If the your response is <code>Yes</code>, <var class="product">Model 204</var> is terminated. If your response is <code>No</code>, the <var>EOJ</var> command is ignored. The default response is <code>Y</code> if the <var>[[PROMPT parameter|PROMPT]]</var> parameter includes the X'10' setting.</p></li> | ||
</ul> | |||
The name of the online is the online's job name if <var>[[CUSTOM parameter|CUSTOM=37]]</var> is set, or the location of the online if the <var>[[LOCATION parameter|LOCATION]]</var> parameter is set. | |||
<p>Examples:</p> | |||
If CUSTOM=37 is set: | |||
<p class="syntax">M204.1076: Do you really want to end the run for <span class="term">jobname</span>?</p> | |||
If CUSTOM=37 is not set, and LOCATION is set: | |||
<p class="syntax">M204.1076: Do you really want to end the run for <span class="term">location</span>?</p> | |||
If CUSTOM=37 is not set, and LOCATION is not set: | |||
<p class="syntax">M204.1076: Do you really want to end the run?</p> | |||
<p>If the <var>RESTART</var> command (ROLL BACK or ROLL FORWARD) is executing when the <var>EOJ</var> command is entered, the following message is displayed prior to the request for confirmation: </p> | |||
<p class="code">*** M204.1453: RESTART RECOVERY IS RUNNING | <p class="code">*** M204.1453: RESTART RECOVERY IS RUNNING | ||
</p> | </p> | ||
<p> | <p> | ||
No confirmation is requested when the <var>EOJ</var> command is supplied by User 0, either in the CCAIN input stream or from the console in a single-user z/VM run.</p> | No confirmation is requested when the <var>EOJ</var> command is supplied by User 0, either in the CCAIN input stream or from the console in a single-user z/VM run.</p> | ||
<p>If the <var>[[EOJPW parameter|EOJPW]]</var> parameter has been set, you will be prompted for a password to end the run.</p> | |||
===Checkpoint logging=== | |||
<p> | <p> | ||
If checkpoint logging is enabled in the <var class="product">Model 204</var> run, the <var>EOJ</var> command <b>requests</b> that a checkpoint be performed before <var class="product">Model 204</var> termination processing begins. This checkpoint request waits until the values of the <var>CPTO</var> and <var>CPTQ</var> 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.</p> | If checkpoint logging is enabled in the <var class="product">Model 204</var> run, the <var>EOJ</var> command <b>requests</b> that a checkpoint be performed before <var class="product">Model 204</var> termination processing begins. This checkpoint request waits until the values of the <var>CPTO</var> and <var>CPTQ</var> 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.</p> | ||
Revision as of 22:24, 2 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 include it at the end of User 0's input stream. If EOJ is omitted from this 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 SIRPRMPT 4 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 8 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 (
YesorNo).If the your response is
Yes, Model 204 is terminated. If your response isNo, the EOJ command is ignored. The default response isYif the PROMPT parameter includes the X'10' setting.
The name of the online is the online's job name if CUSTOM=37 is set, 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, you will be prompted for a password 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:
- Model 204 update units, see Update units and transactions
- EOJ and ONLINE termination, see ONLINE termination.