LU 6.2 API Application Programmer's Reference Guide (30294-90008)

Chapter 5 69
Intrinsic Descriptions
TPStarted
TPStarted
Initializes access to LU 6.2 API and allocates resources.
Syntax
CA I16 I32
TPStarted( LocalTPName , TPID , Status ,
I16 I16V CA CA
[ TraceOn ], [ TraceSize ], [ TraceFile ], [ DefaultFile ]);
Parameters
LocalTPName Required; character array; input. This parameter is
an 8-character array, left justified and padded with
blanks. It identifies the name of the transaction
program being executed. For remotely initiated TPs on
MPE XL, this parameter must match the
LocalTPName of the MCGetAllocate intrinsic.
TPID Required; 16-bit signed integer; output. This number
is assigned to the specific execution instance of the TP.
(More than one instance of the same TP may be
executing at once, and the
TPID uniquely identifies a
single instance of a TP.)
Status Required; 32-bit signed integer; output. Indicates the
result of intrinsic execution. See the “Status
Parameter” section, earlier in this chapter, for more
information.
TraceOn 16-bit signed integer; input. Indicates the type of
intrinsic tracing, if any, to be enabled. Possible values
are as follows:
0 = no tracing
1 = API intrinsic tracing
2 = APPC subsystem intrinsic tracing
3 = API and APPC subsystem intrinsic
tracing
Default: 0 (no tracing)
NOTE Specify TraceOn values of 2 and 3 only when asked to do so by your HP
representative.
TraceSize 16-bit signed integer by value; input. This is a number