IFATTN (HLI function): Difference between revisions

Latest revision as of 22:04, 12 July 2016

The conventions used on this page are described in Function call notation conventions.

Description: The IFATTN call (ATTENTION) sends an attention interrupt signal.
Thread type: IFDIAL
IFCALL function number: 43

IFATTN(RETCODE)

Parameter	Description
RETCODE	[O,i,r] The Model 204 return code is the required output parameter. The code is a binary integer value.

Use the IFATTN call only with an IFDIAL connection.

The IFATTN call can be issued when a completion code of 1, 2, or 12 is returned from the previous call to IFREAD or IFWRITE call.

When the IFATTN call is issued, any current SOUL request is purged. Follow IFATTN with IFWRITE if processing is to continue.

If the IFATTN call is unsuccessful, Model 204 returns an error code of 4 if the connection was lost.

. . . PROCEDURE DIVISION. . . . CALL "IFATTN" USING RETCODE.

@@ Line 1: / Line 1: @@
+The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions|Function call notation conventions]].
-==Function==
+==Summary==
-<p>
+<dl>
-The IFATTN call (ATTENTION) sends an attention interrupt signal. </p>
+<dt>Description</dt>
+<dd>The IFATTN call (ATTENTION) sends an attention interrupt signal.</dd>
-==Thread type==
+<dt>Thread type</dt>
-IFDIAL
+<dd>IFDIAL</dd>
+<dt>IFCALL function number</dt>
+<dd>43</dd>
+</dl>
 ==Syntax==
-===Full syntax (43)===
 <p class="syntax">IFATTN(RETCODE)</p>
-===Compile-only syntax===
+<dl>
-<p>
+<dt>Compile-only form</dt>
-A compile-only form of IFATTN is not available.</p>
+<dd>Not available</dd>
+<dt>Execute-only form</dt>
-===Execute-only syntax===
+<dd>Not available</dd>
-<p>
+</dl>
-An execute-only form of IFATTN is not available.</p>
-===Parameters===
 <table>
 <tr class="head">
@@ Line 32: / Line 32: @@
 </table>
-==Notes and tips==
+==Usage notes==
 <p>
 Use the IFATTN call only with an IFDIAL connection.</p>