IFATTN (HLI function): Difference between revisions
Jump to navigation
Jump to search
m (Admin moved page IFATTN (HLI function call) to IFATTN (HLI function) without leaving a redirect: remove "function call" terminology; keep "function") |
mNo edit summary |
||
| Line 54: | Line 54: | ||
CALL "IFATTN" USING RETCODE.</p> | CALL "IFATTN" USING RETCODE.</p> | ||
[[Category: HLI | [[Category: HLI functions]] | ||
Revision as of 20:41, 1 July 2016
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
| Parameter | Description |
|---|---|
| RETCODE | [O,i,r] The Model 204 return code is the required output parameter. The code is a binary integer value. |
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.