Pathway/iTS TCP and Terminal Programming Guide

Writing User Conversion Procedures
Compaq NonStop™ Pathway/iTS TCP and Terminal Programming Guide—426751-001
4-7
3270 Key Mapping
USERCODE
contains the value given in the USER CONVERSION field characteristic clause.
This parameter can be used to select a particular type of conversion.
OUTPUT
indicates where the string of characters for output to the terminal is to be placed.
When the procedure is called, the location designated by this parameter contains the
result of the standard conversion.
OUTPUT^LEN
contains the length of the output string. If the procedure changes the output string,
the procedure should set OUTPUT^LEN to the associated length; in no case should
OUTPUT^LEN be greater than MAX^OUTPUT^LEN. If OUTPUT^LEN is less
than the field length, the fill character is used to pad the field.
MAX^OUTPUT^LEN
represents the maximum possible length of the particular converted output field.
This value should be used to control the maximum amount of data moved to
OUTPUT.
INTERNAL
contains the data to be converted.
•
For the numeric procedure, INTERNAL is a FIXED parameter. The
INTERNAL^SCALE parameter contains the number of decimal places.
•
For the alphanumeric procedure, INTERNAL is a STRING parameter. The
INTERNAL^LEN parameter contains the number of bytes in the string.
3270 Key Mapping
The user-replaceable procedure USER^3270^KEY^MAPPING is provided to support
program attention keys PA4 through PA10. These keys are used on terminals analogous
to the IBM 3270 terminal.
Keys PA4 through PA10 transmit a code called an attention-ID (AID) byte. The actual
codes vary among terminals of different vendors. To use these keys, you need to write
your own procedure that associates the AID byte transmitted by your terminal with the
appropriate Pathway/iTS key number.
Note. Do not expect the string represented by the INTERNAL parameter to be bounded by
nulls.