ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/endrjessn.htm

179 lines
7.0 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>End RJE Session (ENDRJESSN)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="ENDRJESSN.Top_Of_Page"></a>
<h2>End RJE Session (ENDRJESSN)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#ENDRJESSN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ENDRJESSN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ENDRJESSN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ENDRJESSN"></a>
<h3>End RJE Session</h3>
<p>The ENDRJESSN command ends communications with the host subsystem in either a controlled or an immediate manner.
</p>
<h3>Error messages for ENDRJESSN</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>RJE0003</b></dt>
<dd>RJE session &amp;1 is not active.
</dd>
<dt><b>RJE0063</b></dt>
<dd>RJE session &amp;1 is already ending.
</dd>
<dt><b>RJE0147</b></dt>
<dd>RJE did not find message file QRJEMSG.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDRJESSN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDRJESSN.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#ENDRJESSN.SSN"><b>SSN</b></a></td>
<td valign="top">Active RJE session</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#ENDRJESSN.OPTION"><b>OPTION</b></a></td>
<td valign="top">Cancel</td>
<td valign="top"><b><u>*CNTRLD</u></b>, *IMMED</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#ENDRJESSN.DELAY"><b>DELAY</b></a></td>
<td valign="top">Delay time in sec, if *CNTRLD</td>
<td valign="top">0-99999, <b><u>*NOLIMIT</u></b></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#ENDRJESSN.IDLETIME"><b>IDLETIME</b></a></td>
<td valign="top">Idle time in minutes</td>
<td valign="top">0-99, <b><u>0</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ENDRJESSN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ENDRJESSN.SSN"></a>
<h3>Active Session (SSN)</h3>
<p>Specifies the name of the session being ended.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDRJESSN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDRJESSN.OPTION"></a>
<h3>Cancel (OPTION)</h3>
<p>Specifies whether the session is ended in a controlled manner (allowing RJE to perform end processing), or it is canceled immediately.
</p>
<p>The possible values are:
</p>
<ul>
<li>*CNTRLD: The session ends in a controlled manner. BSC sessions send a SIGNOFF command to the host subsystem before ending communications. When an end-of-file is received from the host subsystem for each active printer and punch device, and an end-of-file is sent to the host subsystem for each active reader job, RJE ends communications.
<p>RJE continues to send and receive printer, punch, reader, and message data until the output and input streams are completed. A new SBMRJEJOB command request is honored until the idle time has elapsed. After that, reader job queues for the session are held.
</p>
</li>
<li>*IMMED: The session ends immediately, meaning the programs that are running are not allowed to perform any cleanup. Reader job queues for the session are held. This option may cause undesirable results if data has been partially updated and, therefore, should be used only after a controlled ending has been attempted unsuccessfully.
<p>
<b>Note: </b>For BSC, the /*SIGNOFF command is not sent to the host subsystem. This will cause the session to end abnormally, and may result in the logging of error messages on the host.
</p>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDRJESSN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDRJESSN.DELAY"></a>
<h3>Delay Time (DELAY)</h3>
<p>Specifies the number of seconds allowed for the controlled ending. If the amount of time specified has passed and the end processing is not complete, the session being processed is ended immediately.
</p>
<p>The possible values are:
</p>
<ul>
<li>*NOLIMIT: A controlled ending process has no time limit.
</li>
<li><i>delay-time-in-seconds:</i> Specify the number of seconds of delay time. Valid values range from 0 through 99999 seconds. When the delay time has elapsed, the end request is changed to an immediate end request. The delay time countdown begins when the command is processed.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDRJESSN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ENDRJESSN.IDLETIME"></a>
<h3>Idle Time (IDLETIME)</h3>
<p>Specifies the number of minutes the session remains idle before it ends in a controlled manner.
</p>
<p>The possible values are:
</p>
<ul>
<li>0: The idle time value is zero. All reader job queues for the session are put on hold.
</li>
<li><i>idletime-in-minutes:</i> Specify the number of minutes that the session remains idle after the files are closed. The idle time countdown begins following the end-of-file of the last file that is sent or received, and is reset each time data becomes available for sending or receiving. If any input streams have started but not ended (except for console input streams), the idle time countdown does not begin. Valid values range from 0 through 99 minutes.
</li>
</ul>
<p>If an ENDRJESSN command specifies a controlled ending, its IDLETIME parameter overrides that of the session description. If it specifies an immediate ending, the IDLETIME value of the session description is ignored.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDRJESSN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ENDRJESSN.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDRJESSN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ENDRJESSN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>RJE0003</b></dt>
<dd>RJE session &amp;1 is not active.
</dd>
<dt><b>RJE0063</b></dt>
<dd>RJE session &amp;1 is already ending.
</dd>
<dt><b>RJE0147</b></dt>
<dd>RJE did not find message file QRJEMSG.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ENDRJESSN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>