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

111 lines
3.8 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">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Preattention Program Exit Program</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. -->
<!-- Begin Header Records ========================================= -->
<!-- WM SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
<!-- File cleanup completed Nov 2001 by v2cdijab -->
<!-- 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>Preattention Program Exit Program</h2>
<div class="box" style="width: 60%;">
<br>
&nbsp;&nbsp;Required Parameter: None<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Exit Point Name: QIBM_QWT_PREATTNPGMS&nbsp;&nbsp;<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;Exit Point Format Name: ATTN0100<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The Preattention Program exit program is called when the user presses the
System Attention key.</p>
<p>When a user presses the System Attention key, the operating system calls the
user-written exit program through the registration facility. There are no input
or output parameters. After the exit programs from the registration facility
are called, the system attention program is called.</p>
<p>This exit point supports eight exit programs. (For information about adding
an exit program to an exit point, see the <a href="reg1.htm">Registration
Facility APIs</a>.)</p>
<p>Before any of the exit programs in the registration facility are called, the
user profile for each user intending to use this function will need to be
updated. The Set Profile Exit Program (QWTSETPX) API will need to be called.
This API will set for the requested user profile which of the eight allowed
exit programs to call. The user can have none or all eight possible exit
programs called. No exit programs will be called until the QWTSETPX API is
called to set the values in the user profile. To display which exit programs
will be called for a particular user, the Retrieve Profile Exit Program
(QWTRTVPX) API can be called. (For more information about both of these APIs,
see the <a href="wm1.htm">Work Management APIs</a>.)</p>
<p><strong>Notes:</strong></p>
<ol>
<li>The Preattention Program
exit point ignores any return codes or error messages that are sent from the
exit programs.<br>
<br>
</li>
<li>It is recommended that the Preattention Program exit program exist in a
library in the system auxiliary storage pool (ASP) or in a basic user ASP. It
might not be found if it exists in a library in an independent ASP.</li>
</ol>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>User Profile Authority</em></dt>
<dd>All object (*ALLOBJ) and security administrator (*SECADM)
special authorities are needed
to add exit programs to the registration facility
or to remove exit programs from the registration facility.</dd>
</dl>
<br>
<h3>Required Parameter</h3>
<p>None.</p>
<hr>
Exit program introduced: V3R7
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"wm1.htm">Work Management APIs</a> | <a href="aplist.htm">APIs by
category</a></td>
</tr>
</table>
</center>
</body>
</html>