EOJ command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (→‎Usage notes: minor formatting)
m (misc formatting)
 
(3 intermediate revisions by 2 users not shown)
Line 4: Line 4:
<dd>System manager or User 0
<dd>System manager or User 0
<dt>Function
<dt>Function
<dd>Specifies end of job and initiates <var class="product">Model&nbsp;204</var> termination, forcing active users off <var class="product">Model&nbsp;204</var>.
<dd>Specifies end of job and initiates <var class="product">Model&nbsp;204</var> termination, forcing active users off <var class="product">Model&nbsp;204</var>
</dl>
</dl>


Line 12: Line 12:


==Usage notes==
==Usage notes==
<ul>
<li>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. </li>
<li>You can include the <var>EOJ</var> command in the User 0 input stream (CCAIN). When the <var>EOJ</var> command is invoked from CCAIN, the Online is immediately terminated, without any of the prompts described on the rest of this wiki page.
<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>
If the end of the User 0 input stream is reached without an <var>EOJ</var> command, a user restart is invoked and the return code is set to 6.<!--Don't think it's worth cluttering the discsussion here with ALTIODEV distraction--></p></li>
<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>
<li>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 the <var>[[SIRPRMPT parameter|SIRPRMPT]]</var> X'04' bit is on, you are prompted for the name of the Online for confirmation.</li>
<li>If you are on a full screen thread and the <var>[[SIRPRMPT parameter|SIRPRMPT]]</var> X'04' bit 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]]</var> X'08' 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</var> X'08' 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>).
<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' bit.</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' bit. </p></li>
</ul>  
</ul>  
 
<p>
The name of the Online is the Online's job name if <var>[[CUSTOM parameter|CUSTOM]]</var> is set to 37, 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 <var>[[CUSTOM parameter|CUSTOM]]</var> is set to 37, or the location of the Online if the <var>[[LOCATION parameter|LOCATION]]</var> parameter is set. </p>
<p>
<p>
Examples:</p>
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>
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>
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>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>
<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>
If <code>CUSTOM=37</code> is set: </p>
 
<p class="code">M204.1076: Do you really want to end the run for <i>jobname</i>? </p>
If the <var>[[EOJPW parameter|EOJPW]]</var> parameter has been set, the following prompt will appear:
<p>
<p class="code" style="display:table">M204.0347: Password </p>
If <code>CUSTOM=37</code> is not set, and <var>LOCATION</var> is set: </p>
and you must enter the value of <var>EOJPW</var> to end the run.
<p class="code">M204.1076: Do you really want to end the run for <i>location</i>? </p>
<p>
If <code>CUSTOM=37</code> is not set, and <var>LOCATION</var> is not set: </p>
<p class="syntax">M204.1076: Do you really want to end the run? </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>
<p>
No confirmation is requested when the <var>EOJ</var> command is supplied by User&nbsp;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 was set, the following prompt will appear, and you must enter the value of <var>EOJPW</var> to end the run: </p>
<p class="code">M204.0347: Password </p></li>
</ul>


===Checkpoint logging===
===Checkpoint logging===
<p>
<p>
If checkpoint logging is enabled in the <var class="product">Model&nbsp;204</var> run, the <var>EOJ</var> command <b>requests</b> that a checkpoint be performed before <var class="product">Model&nbsp;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&nbsp;204</var> run, the <var>EOJ</var> command <i><b>requests</b></i> that a checkpoint be performed before <var class="product">Model&nbsp;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>
<p>
<p>
When <var class="product">Model&nbsp;204</var> processes <var>EOJ</var>, it abruptly ends all update units in progress and does not invoke transaction backout. </p>
When <var class="product">Model&nbsp;204</var> processes <var>EOJ</var>, it abruptly ends all update units in progress and does not invoke transaction backout. </p>

Latest revision as of 19:33, 18 June 2018

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 include the EOJ command in the User 0 input stream (CCAIN). When the EOJ command is invoked from CCAIN, the Online is immediately terminated, without any of the prompts described on the rest of this wiki page.

    If the end of the User 0 input stream is reached without an EOJ command, 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 was set, the following prompt will appear, and you must enter the value of EOJPW to end the run:

    M204.0347: Password

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: