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-44
atp.fml_buffer Object
Properties
fml_type (read-only)
This property identifies the TUXEDO buffer type: either “fml” or “fml32”. If the
buffer represents a request, this type will always match the value supplied to the
constructor; if the buffer represents a reply, the type is determined by the service that
created the reply.
reply (read-only)
The tpcall() method sets this property. For successful requests, the property
contains an automatically created fml_buffer object, which is used to access and
process the application reply data.
view
The application sets this property to a TUXEDO view name to communicate with a
TUXEDO service that accepts only view buffers. ATP uses the TUXEDO FML
views interface to convert the data in the fml_buffer object to a view. If the response
is a view, it is converted also. This step requires that the relevant TUXEDO field
tables and view files be complete and that the needed TUXEDO environment
variables are specified in iTP Secure WebServer commands. The variables required
for this operation are FIELDTBLS, FLDTBLDIR, FIELDTBLS32,
FLDTBLDIR32, VIEWFILES, and VIEWDIR. On return from the tpcall()
method, the view property contains the name of the view returned by the TUXEDO
service. The service can also return an FML buffer.
user_return_code (read-only)
This property is the tpurcode returned by the TUXEDO service. It is set by the
tpcall() method.
error (read-only)
This property is the error number set by unsuccessful method calls. It reflects the
NonStop TUXEDO tperrno or Ferror (depending on the method).
error_text (read-only)
This property contains a string of error message text. It reflects the NonStop
TUXEDO tpstrerror or Fstrerror (depending on the method).
Methods
tpcall (service [,transaction])
This method sends the fml_buffer object's data to the identified TUXEDO service
(for example, TRANSFER). The method returns a value of false in any of the
following cases: