Pathway/iTS TCP and Terminal Programming Guide

Writing User Conversion Procedures
Compaq NonStop™ Pathway/iTS TCP and Terminal Programming Guide—426751-001
4-10
Intelligent Device Input Procedures
Intelligent Device Input Procedures
Two procedures can be called to convert input received from an intelligent device: one
procedure to convert numeric input and the other to convert alphanumeric input.
You can use the input procedures to:
•
Receive and format an input message
•
Specify the actual scale of a numeric item or the actual length of a nonnumeric item
•
Convert any fill characters in the message
•
Right justify alphanumeric data in the message
•
Report whether data was actually sent and, if sent, whether the data is nonblank
When USER CONVERSION is specified for a message field, the TCP calls the numeric
procedure if the data is to be moved to a numeric working-storage field; it calls the
alphanumeric procedure if the data is to be moved to an alphanumeric field.
When USER CONVERSION is specified in a SEND MESSAGE statement, the TCP
calls the alphanumeric procedure regardless of the message data type. The input
procedures are performed before the standard conversion or formatting of the send-
message data.
If a USER CONVERSION clause is specified for both a Message Section message field
and the SEND MESSAGE statement that sends the message, the TCP first calls the
procedure for the SEND MESSAGE statement, then calls the procedure for the message,
and finally calls the procedure for the message field.
Figure 4-6
illustrates the data flow of the processing of Message Section items on input.
The sequence of events performed for each elementary data field input from an
intelligent device is shown; processing steps relevant to user conversion routines are
highlighted.
Undefined %075 -1 (Selector Pen Attn)
Undefined %055 -1 (No AID--Display)
Undefined %131 -1 (No AID--Printer)
Other -- -1
Table 4-1. Mapping of Internal 3270 Key Number to Pathway/iTS Key
Number (page 3 of 3)
* The AID byte value for this key varies from terminal vendor to terminal vendor. Refer to the manual that
came with your terminal for the value.