SNAX/APN Application Programming Manual

The ITI Interface

SNAX/APN Application Programming Manual—420111-001

3-4

Functions Available With the ITI Protocol

The following table lists the set of functions you can use when using the ITI protocol to

communicate with 3270-type terminals, along with the procedure calls that perform

these functions:

Each of the SETMODE functions is described in the following subsections.

In the syntax diagrams used in this subsection, filenum is a number identifying an

open file, which in turn identifies the device to receive the procedure call. For more

information on the syntax of the SETMODE, SETPARAM, and CONTROL procedure

calls, see the Guardian Procedure Calls Reference Manual.

Setting Transfer Mode (SETMODE Function 8)

The transfer mode means the way you transfer data; it can be block mode (page mode)

or conversational (line-at-a-time) mode. The ITI protocol supports conversational-mode

communication. However, an application can use the SETMODE procedure to switch

between block mode and conversational mode as follows:

param1

0 Enables conversational mode.

1 Enables block mode.

When you switch to block mode, the PA1 (simulated BREAK) and PA2 (simulated

CONTROL-Y) keys are released to the application for its own use, and all text written to

the device must be formatted with the proper 3270 buffer orders. Two-step reads are

supported in block mode communication.

Function Procedure Call

Setting transfer mode SETMODE function 8

BREAK key-related functions:

Setting BREAK key ownership SETMODE function 11

Setting and fetching BREAK parameters SETPARAM function 3

Setting terminal access mode and file access type SETMODE function 12

Obtaining SNA sense codes SETMODE function 53

Setting line spacing:

(For the WRITE procedure calls) Enabling line spacing SETMODE function 6

(For the WRITE procedure calls) Setting line spacing mode SETMODE function 27

(For read operations) Setting auto line feed SETMODE function 7

Setting echo mode SETMODE function 20

Resetting to default values SETMODE function 28

CALL SETMODE ( filenum , 8 , param1 ) ;