IFATTN (HLI function) - Revision history

ELowell at 22:04, 12 July 2016

2016-07-12T22:04:10Z

← Older revision		Revision as of 22:04, 12 July 2016
Line 1:		Line 1:
	The conventions used on this page are described in [[HLI: Function ~~call list~~#Function call notation conventions\|Function call notation conventions]].		The conventions used on this page are described in [[HLI: Function summary#Function call notation conventions\|Function call notation conventions]].
	==Summary==		==Summary==
	<dl>		<dl>

ELowell at 21:01, 11 July 2016

2016-07-11T21:01:31Z

← Older revision		Revision as of 21:01, 11 July 2016
Line 1:		Line 1:
			The conventions used on this page are described in [[HLI: Function call list#Function call notation conventions\|Function call notation conventions]].
	==Summary==		==Summary==
	<dl>		<dl>

ELowell at 20:12, 6 July 2016

2016-07-06T20:12:06Z

← Older revision		Revision as of 20:12, 6 July 2016
Line 2:		Line 2:
	==Summary==		==Summary==
	<dl>		<dl>
	<dt>Description		<dt>Description</dt>
	<dd>The IFATTN call (ATTENTION) sends an attention interrupt signal.		<dd>The IFATTN call (ATTENTION) sends an attention interrupt signal.</dd>
	<dt>Thread type		<dt>Thread type</dt>
	<dd>IFDIAL		<dd>IFDIAL</dd>
	<dt>IFCALL function number		<dt>IFCALL function number</dt>
	<dd>43		<dd>43</dd>
	</dl>		</dl>

Line 15:		Line 15:

	<dl>		<dl>
	<dt>Compile-only form		<dt>Compile-only form</dt>
	<dd>Not available		<dd>Not available</dd>
	<dt>Execute-only form		<dt>Execute-only form</dt>
	<dd>Not available		<dd>Not available</dd>
	</dl>		</dl>

ELowell at 21:16, 1 July 2016

2016-07-01T21:16:50Z

← Older revision		Revision as of 21:16, 1 July 2016
Line 1:		Line 1:

	==~~Function~~==		==Summary==
	<p>		<dl>
	The IFATTN call (ATTENTION) sends an attention interrupt signal. </p>		<dt>Description
			<dd>The IFATTN call (ATTENTION) sends an attention interrupt signal.
	==Thread type==		<dt>Thread type
	IFDIAL		<dd>IFDIAL
			<dt>IFCALL function number
			<dd>43
			</dl>

	==Syntax==		==Syntax==

	~~===Full syntax (43)===~~
	<p class="syntax">IFATTN(RETCODE)</p>		<p class="syntax">IFATTN(RETCODE)</p>

	~~===~~Compile-only ~~syntax===~~		<dl>
	<p>		<dt>Compile-only form
	~~A compile-only form of IFATTN is not available.~~</p>		<dd>Not available
			<dt>Execute-only form
	~~===~~Execute-only ~~syntax===~~		<dd>Not available
	<p>		</dl>
	~~An execute-only form of IFATTN is not available.~~</p>

	~~===Parameters===~~
	<table>		<table>
	<tr class="head">		<tr class="head">
Line 32:		Line 32:
	</table>		</table>

	==~~Notes and tips~~==		==Usage notes==
	<p>		<p>
	Use the IFATTN call only with an IFDIAL connection.</p>		Use the IFATTN call only with an IFDIAL connection.</p>

Admin at 20:41, 1 July 2016

2016-07-01T20:41:25Z

← Older revision		Revision as of 20:41, 1 July 2016
Line 54:		Line 54:
	CALL "IFATTN" USING RETCODE.</p>		CALL "IFATTN" USING RETCODE.</p>

	[[Category: HLI ~~function calls~~]]		[[Category: HLI functions]]

Admin: Admin moved page IFATTN (HLI function call) to IFATTN (HLI function) without leaving a redirect: remove "function call" terminology; keep "function"

2016-05-04T00:15:13Z

Admin moved page IFATTN (HLI function call) to IFATTN (HLI function) without leaving a redirect: remove "function call" terminology; keep "function"

← Older revision	Revision as of 00:15, 4 May 2016
(No difference)

ELowell: ELowell moved page HLI: IFATTN call to IFATTN (HLI function call): better searchability; consistency with existing topic names

2016-05-03T21:28:56Z

ELowell moved page HLI: IFATTN call to IFATTN (HLI function call): better searchability; consistency with existing topic names

← Older revision	Revision as of 21:28, 3 May 2016
(No difference)

ELowell: Created page with " ==Function==
The IFATTN call (ATTENTION) sends an attention interrupt signal.
==Thread type== IFDIAL ==Syntax== ===Full syntax (43)===
IFATTN(RE..."

2016-04-29T21:43:31Z

Created page with " ==Function== The IFATTN call (ATTENTION) sends an attention interrupt signal. ==Thread type== IFDIAL ==Syntax== ===Full syntax (43)=== IFATTN(RE..."

New page

==Function==

The IFATTN call (ATTENTION) sends an attention interrupt signal. 

==Thread type==
IFDIAL

==Syntax==

===Full syntax (43)===
IFATTN(RETCODE)

===Compile-only syntax===

A compile-only form of IFATTN is not available.

===Execute-only syntax===

An execute-only form of IFATTN is not available.

===Parameters===
<table>
<tr class="head">
<th>Parameter</th>
<th>Description</th>
</tr>
<tr>
<td>RETCODE</td>
<td>[O,i,r] The Model 204 return code is the required output parameter. The code is a binary integer value.</td>
</tr>
</table>

==Notes and tips==

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.

[[Category: HLI function calls]]