iTP Active Transaction Pages (iTP ATP) Programmer's Guide

ATP Objects, Properties, and Methods
iTP Active Transaction Pages (iTP ATP) Programmer’s Guide—522292-002
4-37
atp.buffer Object
field
This parameter is an atp.field object (which is a property of an
atp.dictionary object, usually generated as a result of a field object
hierarchy). The field indicates the data type, the offset within the application-
message buffer, and other information needed to convert and place the data item.
subscript1, ...
Up to seven numeric subscripts are supported; each subscript represents an array
dimension. The value of any subscript starts at zero (0). Subscripts are optional.
setBinary (data, field, subscript1, subscript2, ...)
This method moves data to be sent to the Pathway server class to the application-
message buffer. The setBinary() method differs from the setData() method
in that the data is transferred byte by byte; that is, no data conversion is performed.
data
This parameter contains the data to be put into the application-message buffer.
The data is not converted to be consistent with DDL representation.
Furthermore, data can overflow a field; this feature provides automatic support
for variable-length messages and is especially useful when used with
atp.blob objects for forms-based file upload. Be careful not to overflow
fields accidentally.
field
This parameter is an atp.field object (which is a property of an
atp.dictionary object, usually generated as a result of a field object
hierarchy). The field indicates the data type, the offset within the application-
message buffer, and other information needed to place the data item.
subscript1, ...
Up to seven numeric subscripts are supported; each subscript represents an array
dimension. The value of any subscript starts at zero (0).
return = getData (field, subscript1, subscript2, ...)
This method retrieves converted data from the application-message buffer. The
getData() method differs from the getBinary() method in that the data is
converted according to the field definition of the destination.
return
The value of the data item from the application message is returned in string
format, regardless of the application data type. To perform computations with
the value, use the JavaScript parseInt feature.