EOJ command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
m (minor formatting)
Line 8: Line 8:


==Syntax==
==Syntax==
<p class="syntax">EOJ
<p class="syntax"><span class="literal">EOJ</span>
</p>
</p>


Line 14: Line 14:
<p>
<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>  
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>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>
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>
<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>
<ul>
<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 full screen thread and <code>[[SIRPRMPT parameter|SIRPRMPT 4]]</code> 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>).
<li>If you are on a line-at-a-time thread and <code>[[SIRPRMPT parameter|SIRPRMPT 8]]</code> is on, you are prompted for the name of the Online for confirmation.</li>
 
<li>If <var>SIRPRMPT</var> has not been set, you are prompted whether to end the run (<code>Yes</code> or <code>No</code>).
<p>
<p>
If the your response is <code>Yes</code>, <var class="product">Model&nbsp;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>
If the your response is <code>Yes</code>, <var class="product">Model&nbsp;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>  
</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.  
The name of the Online is the Online's job name if <code>[[CUSTOM parameter|CUSTOM=37]]</code> is set, or the location of the online if the <var>[[LOCATION parameter|LOCATION]]</var> parameter is set.  
<p>Examples:</p>
<p>
If CUSTOM=37 is set:  
Examples:</p>
If <code>CUSTOM=37</code> is set:  
<p class="syntax">M204.1076: Do you really want to end the run for <span class="term">jobname</span>?</p>
<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:  
If <code>CUSTOM=37</code> is not set, and <var>LOCATION<var> is set:  
<p class="syntax">M204.1076: Do you really want to end the run for <span class="term">location</span>?</p>
<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:  
If <code>CUSTOM=37</code> is not set, and <var>LOCATION<var> is not set:  
<p class="syntax">M204.1076: Do you really want to end the run?</p>
<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>If the <var>RESTART</var> command (<code>ROLL BACK</code> or <code>ROLL FORWARD</code>) 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>
Line 44: Line 48:
If the <var>[[EOJPW parameter|EOJPW]]</var> parameter has been set, the following prompt will appear:
If the <var>[[EOJPW parameter|EOJPW]]</var> parameter has been set, the following prompt will appear:
<p class="code" style="display:table">M204.0347: Password </p>
<p class="code" style="display:table">M204.0347: Password </p>
and you must enter the value of EOJPW to end the run.
and you must enter the value of <var>EOJPW</var> to end the run.
 
===Checkpoint logging===
===Checkpoint logging===
<p>
<p>

Revision as of 19:35, 3 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 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 (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' 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, 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: