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-36
atp.buffer Object
Methods
send (pathmon, server_class, transaction)
This method sends the application-message buffer to the specified Pathway server
class. You must first construct the message in a buffer object by using the
setData() method.
pathmon
This parameter contains the name of a map class define (for example,
=payroll) that refers to the required application's PATHMON process. You
set up a map class define by using the MapDefine command in the
atp.config file, for example:
MapDefine =payroll /G/payr
The predefined value =loopback causes the reply to have exactly the same
contents as the buffer sent to the server.
The predefined value =TANDEM_PATHMON_NAME is also the default value. It
represents the PATHMON environment established by the httpd.config file
that includes this atp.config file.
server_class
This parameter contains the name of the Pathway server class to which the
application message should be sent.
transaction (optional)
This parameter is an atp.transaction object under whose TMF
transaction the current send operation should be initiated.
setData (data, field, subscript1, subscript2, ...)
This method moves data to be sent to the Pathway server class to the application-
message buffer. The setData() method differs from the setBinary() method
in that the data is converted according to the field definition of the destination.
data
This parameter is the data to be put into the application-message buffer. Express
the data as a string, regardless of the data type it represents. (For example, it
could represent a floating point number.) To convert a value to a string, use the
JavaScript .toString feature.
Note. ATP does not validate application data except to ensure that adjacent data, for
instance an adjacent column, is not corrupted. Your application must validate input
data for both type and range. Invalid data will cause unpredictable results.