IFATTN (HLI function): Difference between revisions
Jump to navigation
Jump to search
m (ELowell moved page HLI: IFATTN call to IFATTN (HLI function call): better searchability; consistency with existing topic names) |
No edit summary |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions|Function call notation conventions]]. | |||
== | ==Summary== | ||
< | <dl> | ||
The IFATTN call (ATTENTION) sends an attention interrupt signal. </ | <dt>Description</dt> | ||
<dd>The IFATTN call (ATTENTION) sends an attention interrupt signal.</dd> | |||
<dt>Thread type</dt> | |||
IFDIAL | <dd>IFDIAL</dd> | ||
<dt>IFCALL function number</dt> | |||
<dd>43</dd> | |||
</dl> | |||
==Syntax== | ==Syntax== | ||
<p class="syntax">IFATTN(RETCODE)</p> | <p class="syntax">IFATTN(RETCODE)</p> | ||
<dl> | |||
< | <dt>Compile-only form</dt> | ||
<dd>Not available</dd> | |||
<dt>Execute-only form</dt> | |||
<dd>Not available</dd> | |||
< | </dl> | ||
<table> | <table> | ||
<tr class="head"> | <tr class="head"> | ||
| Line 32: | Line 32: | ||
</table> | </table> | ||
== | ==Usage notes== | ||
<p> | <p> | ||
Use the IFATTN call only with an IFDIAL connection.</p> | Use the IFATTN call only with an IFDIAL connection.</p> | ||
| Line 54: | Line 54: | ||
CALL "IFATTN" USING RETCODE.</p> | CALL "IFATTN" USING RETCODE.</p> | ||
[[Category: HLI | [[Category: HLI functions]] | ||
Latest revision as of 22:04, 12 July 2016
The conventions used on this page are described in Function call notation conventions.
Summary
- Description
- The IFATTN call (ATTENTION) sends an attention interrupt signal.
- Thread type
- IFDIAL
- IFCALL function number
- 43
Syntax
IFATTN(RETCODE)
- Compile-only form
- Not available
- Execute-only form
- Not available
| Parameter | Description |
|---|---|
| RETCODE | [O,i,r] The Model 204 return code is the required output parameter. The code is a binary integer value. |
Usage notes
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.
Completion return code (RETCODE)
If the IFATTN call is unsuccessful, Model 204 returns an error code of 4 if the connection was lost.
Coding example (COBOL)
. . . PROCEDURE DIVISION. . . . CALL "IFATTN" USING RETCODE.