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

169 lines
5.9 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>Sign Off (SIGNOFF)</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="SIGNOFF.Top_Of_Page"></a>
<h2>Sign Off (SIGNOFF)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#SIGNOFF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SIGNOFF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SIGNOFF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SIGNOFF"></a>
<p>The Sign Off (SIGNOFF) command ends an interactive job or causes all jobs in a group to end. You enter this command to sign off at a work station.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>This command is valid only in an interactive job.
</li>
<li>If the SIGNOFF command is issued in a CL program, all subsequent commands in the CL program are bypassed.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#SIGNOFF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SIGNOFF.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="#SIGNOFF.LOG"><b>LOG</b></a></td>
<td valign="top">Job log</td>
<td valign="top"><b><u>*NOLIST</u></b>, *LIST</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#SIGNOFF.DROP"><b>DROP</b></a></td>
<td valign="top">Drop line</td>
<td valign="top"><b><u>*DEVD</u></b>, *YES, *NO</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#SIGNOFF.ENDCNN"><b>ENDCNN</b></a></td>
<td valign="top">End connection</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional, Positional 3</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SIGNOFF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SIGNOFF.LOG"></a>
<h3>Job log (LOG)</h3>
<p>Specifies whether the job log for this interactive job is deleted or is included in the job's spooled output for printing. This entry takes precedence over the log value specified for the job itself.
</p>
<dl>
<dt><b><u>*NOLIST</u></b></dt>
<dd>The information in the job log, which has already been displayed throughout the job, is no longer needed and is being deleted.
</dd>
<dt><b>*LIST</b></dt>
<dd>The job log is spooled for printing, along with the job's remaining spooled output, if any.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SIGNOFF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SIGNOFF.DROP"></a>
<h3>Drop line (DROP)</h3>
<p>Specifies, for switched lines only, whether the switched line attached to the work station is disconnected (dropped) if no other work stations on the same line are signed on. This parameter is ignored if the work station is attached to a nonswitched line.
</p>
<dl>
<dt><b><u>*DEVD</u></b></dt>
<dd>The value specified for the <b>Drop line (DROP)</b> parameter of the work station's device description is assumed.
</dd>
<dt><b>*YES</b></dt>
<dd>The switched line is disconnected when the job is ended if no other work stations on the line are signed on.
</dd>
<dt><b>*NO</b></dt>
<dd>The switched line is not disconnected when the job is ended.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SIGNOFF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SIGNOFF.ENDCNN"></a>
<h3>End connection (ENDCNN)</h3>
<p>Specifies whether to end the connection to the current system. Ending the connection allows the user to bypass the sign-on display of the target system and return to the source system. For communication functions that do not support this option, this parameter is ignored.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The connection does not end. The sign-on display of the target system is shown.
</dd>
<dt><b>*YES</b></dt>
<dd>The connection ends and the user is returned to the source system. No sign-on screen or error messages are shown from the target system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SIGNOFF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SIGNOFF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Signing Off and Ending an Interactive Job</b>
</p>
<p>
<pre>
SIGNOFF
</pre>
</p>
<p>This command signs off the user of the work station and ends the interactive job. The switched line is dropped only if specified in the device description of this work station and if no other work station on this line is active. An end-of-job message that gives the job start and stop times is written in the job's log.
</p>
<p><b>Example 2: Printing the Job Log</b>
</p>
<p>
<pre>
SIGNOFF LOG(*LIST) DROP(*NO)
</pre>
</p>
<p>This command ends the interactive job, but the switched line is not released. The job log is printed with the job's spooled output.
</p>
<p><b>Example 3: Signing Off and Ending the Connection</b>
</p>
<p>
<pre>
SIGNOFF ENDCNN(*YES)
</pre>
</p>
<p>This command ends the connection and transfers the user back to the source system.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SIGNOFF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SIGNOFF.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SIGNOFF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>