287 lines
8.1 KiB
HTML
287 lines
8.1 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>CALL Program for an Action List Option and Pull-Down Field
|
||
|
|
Choice</title>
|
||
|
|
<!-- 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. -->
|
||
|
|
<!-- Change History: -->
|
||
|
|
<!-- YYMMDD USERID Change description -->
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<!--Java sync-link-->
|
||
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<a name="Top_Of_Page"></a>
|
||
|
|
|
||
|
|
<h2>CALL Program for an Action List Option and Pull-Down Field Choice</h2>
|
||
|
|
|
||
|
|
<p>An action list option can specify the CALL dialog command on the ENTER,
|
||
|
|
EXTENTER, PROMPT, and EXTPROMPT attributes of the list action (LISTACT) tag.
|
||
|
|
When processing an action list, the UIM calls the specified program.</p>
|
||
|
|
|
||
|
|
<p>A pull-down choice can specify the CALL dialog command on the ACTION
|
||
|
|
attribute of the pull-down field choice (PDFLDC) tag. When processing a
|
||
|
|
selected pull-down choice, the UIM calls the specified program.</p>
|
||
|
|
|
||
|
|
<p>The CALL dialog command on an action list or pull-down choice with
|
||
|
|
ACTFOR=LIST on the PDFLDC tag allows the application to handle a request for a
|
||
|
|
single list entry. When processing the list, the UIM calls the program once for
|
||
|
|
each selected entry in the list. Care must be taken in changing other list
|
||
|
|
entries and the current position because the UIM is accessing the same
|
||
|
|
information to perform the remaining action list processing. For example,
|
||
|
|
changing the current position past some selected list entries causes the UIM to
|
||
|
|
not process the skipped ones.</p>
|
||
|
|
|
||
|
|
<p>The CALL dialog command on a pull-down choice with ACTFOR=PANEL on the
|
||
|
|
PDFLDC tag allows the application to handle a request related to the panel as a
|
||
|
|
whole. The UIM calls the program only once before redisplaying the panel.</p>
|
||
|
|
|
||
|
|
<p>An escape message received by the UIM while performing list processing stops
|
||
|
|
the processing and displays the messages. The action or selection field still
|
||
|
|
contains the option number or selection character and is marked in error.</p>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<h3>Single Parameter Interface</h3>
|
||
|
|
|
||
|
|
<p>QSYSINC Member Name: EUIALCL</p>
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt><strong>Structure level</strong></dt>
|
||
|
|
|
||
|
|
<dd>BINARY(4); positions 1-4
|
||
|
|
|
||
|
|
<p>The interface level supported by this structure, indicating which fields and
|
||
|
|
values are available for the current interface level.</p>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Reserved</strong></dt>
|
||
|
|
|
||
|
|
<dd>CHAR(8); positions 5-12<br>
|
||
|
|
<br>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Type of call</strong></dt>
|
||
|
|
|
||
|
|
<dd>BINARY(4); positions 13-16
|
||
|
|
|
||
|
|
<p>Set to one of the following values:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="5 95" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><strong>3</strong></td>
|
||
|
|
<td align="left" valign="top">A program is called for action list option
|
||
|
|
processing or pull-down choice processing when ACTFOR=LIST is specified on the
|
||
|
|
PDFLDC tag.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><strong>9</strong></td>
|
||
|
|
<td align="left" valign="top">A pull-down choice. A program is called for
|
||
|
|
pull-down choice processing when ACTFOR=PANEL is specified on the PDFLDC
|
||
|
|
tag.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<br>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Application handle</strong></dt>
|
||
|
|
|
||
|
|
<dd>CHAR(8); positions 17-24
|
||
|
|
|
||
|
|
<p>The application handle of the application currently being processed by the
|
||
|
|
UIM.</p>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Panel name</strong></dt>
|
||
|
|
|
||
|
|
<dd>CHAR(10); positions 25-34
|
||
|
|
|
||
|
|
<p>The name of the panel currently being processed by the UIM.</p>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>List name</strong></dt>
|
||
|
|
|
||
|
|
<dd>CHAR(10); positions 35-44
|
||
|
|
|
||
|
|
<p>The name of the list currently being processed by the UIM. Blanks indicate
|
||
|
|
that the pull-down choice being processed does not operate against a list entry
|
||
|
|
because ACTFOR=PANEL is specified on the PDFLDC tag.</p>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>List entry handle</strong></dt>
|
||
|
|
|
||
|
|
<dd>CHAR(4); positions 45-48
|
||
|
|
|
||
|
|
<p>The list entry handle currently being processed by the UIM. Hexadecimal
|
||
|
|
zeros indicate that the pull-down choice being processed does not operate
|
||
|
|
against a list entry.</p>
|
||
|
|
|
||
|
|
<p>The following value may be used:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="10 90" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>EXTE</em></td>
|
||
|
|
<td align="left" valign="top">Processes the extended action entry.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<br>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Option number</strong></dt>
|
||
|
|
|
||
|
|
<dd>BINARY(4); positions 49-52
|
||
|
|
|
||
|
|
<p>The option number of the list action or pull-down choice being
|
||
|
|
processed.</p>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Function qualifier</strong></dt>
|
||
|
|
|
||
|
|
<dd>BINARY(4); positions 53-56
|
||
|
|
|
||
|
|
<p>One of the following values:</p>
|
||
|
|
|
||
|
|
<table cellpadding="5">
|
||
|
|
<!-- cols="5 95" -->
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top"><em>0</em></td>
|
||
|
|
<td align="left" valign="top">Performs the action specified on the ENTER or
|
||
|
|
EXTENTER attribute of the LISTACT tag or the ACTION attribute of the PDFLDC
|
||
|
|
tag.</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top" nowrap><em>-10</em></td>
|
||
|
|
<td align="left" valign="top">Performs the action specified on the PROMPT or
|
||
|
|
EXTPROMPT attribute of the LISTACT tag.</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<br>
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt><strong>Pull-down field name</strong></dt>
|
||
|
|
|
||
|
|
<dd>CHAR(10); positions 57-66
|
||
|
|
|
||
|
|
<p>The name of the pull-down field from which the pull-down choice is selected.
|
||
|
|
If this pull-down field does not have a name, this field is set to blanks.</p>
|
||
|
|
|
||
|
|
<p>This field is only available when the field for the structure level is set
|
||
|
|
to two or greater.</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<h3>Multiple Parameter Interface</h3>
|
||
|
|
|
||
|
|
<p>The description of parameters listed in the following table is the same as
|
||
|
|
the corresponding field in the structure for a single parameter interface. The
|
||
|
|
positions listed for each field in the structure do not apply to the multiple
|
||
|
|
parameter interface.</p>
|
||
|
|
|
||
|
|
<div class="box" style="width: 60%;">
|
||
|
|
<br>
|
||
|
|
Parameters for interface level 1:<br>
|
||
|
|
<!-- iddvc RMBR -->
|
||
|
|
<br>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top" width="10%">1</td>
|
||
|
|
<td align="left" valign="top" width="50%">Type of call</td>
|
||
|
|
<td align="left" valign="top" width="20%">Input</td>
|
||
|
|
<td align="left" valign="top" width="20%">Binary(4)</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">2</td>
|
||
|
|
<td align="left" valign="top">Application handle</td>
|
||
|
|
<td align="left" valign="top">Input</td>
|
||
|
|
<td align="left" valign="top">Char(8)</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">3</td>
|
||
|
|
<td align="left" valign="top">Panel name</td>
|
||
|
|
<td align="left" valign="top">Input</td>
|
||
|
|
<td align="left" valign="top">Char(10)</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">4</td>
|
||
|
|
<td align="left" valign="top">List name</td>
|
||
|
|
<td align="left" valign="top">Input</td>
|
||
|
|
<td align="left" valign="top">Char(10)</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">5</td>
|
||
|
|
<td align="left" valign="top">List entry handle</td>
|
||
|
|
<td align="left" valign="top">Input</td>
|
||
|
|
<td align="left" valign="top">Char(4)</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">6</td>
|
||
|
|
<td align="left" valign="top">Option number</td>
|
||
|
|
<td align="left" valign="top">Input</td>
|
||
|
|
<td align="left" valign="top">Binary(4)</td>
|
||
|
|
</tr>
|
||
|
|
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top">7</td>
|
||
|
|
<td align="left" valign="top">Function qualifier</td>
|
||
|
|
<td align="left" valign="top">Input</td>
|
||
|
|
<td align="left" valign="top">Binary(4)</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
Additional parameter for interface level 2:<br>
|
||
|
|
<!-- iddvc RMBR -->
|
||
|
|
<br>
|
||
|
|
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td align="center" valign="top" width="10%">8</td>
|
||
|
|
<td align="left" valign="top" width="50%">Pull-down field name</td>
|
||
|
|
<td align="left" valign="top" width="20%">Input</td>
|
||
|
|
<td align="left" valign="top" width="20%">Char(10)</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<hr>
|
||
|
|
Exit program introduced: V2R2
|
||
|
|
|
||
|
|
<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>
|
||
|
|
|