IFATTN (HLI function)

From m204wiki
Jump to navigation Jump to search

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.