ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/quscmdln.htm

162 lines
6.2 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Display Command Line Window (QUSCMDLN) API</title>
<!-- Begin Header Records ========================================== -->
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!--Edited by Kersten Nov 2001 -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!--Java sync-link-->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>Display Command Line Window (QUSCMDLN) API</h2>
<div class="box" style="width: 60%;">
<br>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Threadsafe: No<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Display Command Line Window (QUSCMDLN) API displays a window containing
a command line. A <strong>window</strong> is an area on the display that is
treated as a separate display. Windows have visible boundaries and appear to
overlay the display from which they are requested.</p>
<p>From the command line displayed, the user can:</p>
<ul>
<li>Enter commands.</li>
<li>Retrieve commands and run programs.</li>
<li>Prompt for commands.</li>
<li>Use help for CL commands.</li>
<li>Request override commands. When the command line window is removed, all
overrides are deleted.</li>
</ul>
<br>
<!-- Please NOTE: DO NOT DELETE THIS SECTION if this API has no authorities and locks. -->
<!-- Instead, use the commented out coding below to indicate NONE. -->
<h3>Authorities and Locks</h3>
<!-- Use this if there are no authorities and locks. -->
<p>None.</p>
<br>
<h3>Parameters</h3>
<p>None.</p>
<br>
<h3>Usage Notes</h3>
<p>For consistency with other i5/OS displays, you should use the F9 key to
request a command line window.</p>
<p>The command line window produced by the QUSCMDLN API is shown at the bottom
of the following display:</p>
<pre>
+--------------------------------------------------------------------------------+
| CSTINV <strong>Customer Invoice Menu</strong> |
| |
| Select one of the following: |
| |
| 1. Enter or change orders |
| 2. Print picking slips |
| 3. Release orders |
| 4. Print invoices |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| .............................................................................. |
| : Command : |
| : : |
| : ===&gt; <em> </em> : |
| : F4=Prompt F9=Retrieve F12=Cancel : |
| : : |
| :............................................................................: |
+--------------------------------------------------------------------------------+
</pre>
<h3>Display Appearance Problems</h3>
<p>There are two rare situations where portions of the underlying display might
not be shown correctly while the command line window is shown. The underlying
display is not actually changed, and it is shown correctly once the command
line window is removed.</p>
<p>The situations are:</p>
<ol>
<li>The underlying display is a text editor or other display that uses special
work station printer mode functions. While the command line window is
displayed, the special work station printer mode characters are not shown.</li>
<li>The underlying display is a bidirectional right-to-left display. While the
command line window is displayed, the underlying display is flipped and shown
from left-to-right.</li>
</ol>
<br>
<h3>Error Messages</h3>
<table width="100%" cellpadding="5">
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td width="15%" valign="top">CPF3C90 E</td>
<td width="85%" valign="top">Literal value cannot be changed.</td>
</tr>
<tr>
<td align="left" valign="top">CPF9871 E</td>
<td align="left" valign="top">Error occurred while processing.</td>
</tr>
</table>
<br>
<hr>
API Introduced: V1R3
<hr>
<table cellpadding="2" cellspacing="2" align="center">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"uim1.htm">User Interface Manager (UIM) APIs</a> | <a href="aplist.htm">APIs by
category</a> </td>
</tr>
</table>
</body>
</html>