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-45
atp.fml_buffer Object
•
The TUXEDO tpcall fails
•
TMF problems occur
•
The TUXEDO application cannot be joined (tpinit())
To find out what type of error occurred, check the error property of the
atp.transaction object and the atp.fml_buffer object.
There is an implied join to the application on the first call to the tpcall() method
for a given atp server process. The implied underlying TUXEDO tpinit() call
uses default values of parameters unless one or more of the following environment
variables are configured using iTP Secure WebServer AddCGI commands or
provided with the request by means of a form or query URL:
TUXEDO_TPINIT_USRNAME
TUXEDO_TPINIT_CLTNAME
TUXEDO_TPINIT_GRPNAME
TUXEDO_TPINIT_PASSWD
TUXEDO_TPINIT_DATA
service
This parameter specifies the NonStop TUXEDO service to which the data is to
be sent. As a reply, the predefined service =loopback returns the same buffer
it received.
transaction
This parameter specifies an atp.transaction object under whose TMF
transaction the current operation should be initiated. If TM/MP (TMF)
protection is required, include a reference to an atp.transaction object.
setData(data, fml_field [,subscript])
This method puts data from the data parameter into the buffer.
data
This parameter is the data to be put into the 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.
Use the JavaScript keyword null as the value of the data parameter to delete
a field from the buffer. This method returns a value of true if the operation is
successful; it returns a value of false and sets the error property if the
operation is unsuccessful.
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.