LU 6.2 API Application Programmer's Reference Guide (30294-90008)
70 Chapter5
Intrinsic Descriptions
TPStarted
from 1 through 32767 that specifies the maximum
number of logical records in the user trace file. When
the maximum number of records is reached, the first
record is overwritten.
Default: 1024 logical records.
TraceFile
character array; input. This character array contains
an actual file designator of the trace file to be used. The
TraceFile
parameter is used only when tracing is
turned on with the
TraceOn
parameter.
TraceFile
can contain a fully qualified 35-character file name,
with lockword, in the following form:
filename/lockword.groupname.acctname
The
TraceFile
array must be terminated with a blank.
If the
TraceFile
parameter is used, the specified trace
file is overwritten every time the TP is invoked. If more
than one active TP specifies the same trace file name,
or if you try to execute more than one instance of the
same TP that references the file name, a status info
value of -1033 will be returned.
Default: The default trace file name is PSTRAC
nn
,
where
nn
is a number from 00 through 49. The default
trace file is created in the user’s logon group and
account. A new trace file is created every time
TPStarted is called with tracing enabled.
DefaultFile
character array; output. This is a 28-character ASCII
array, padded with blanks. It returns the name of the
default trace file in the form
PSTRAC
nn
.group.account, where
nn
is a number
from 00 through 49, and group.account is the user’s
logon group and account.
When user tracing is enabled, but the
TraceFile
parameter is not passed, you can use the
DefaultFile
parameter to get the name of the current trace file.
Description
The TPStarted intrinsic is executed only once within a TP. It allocates
resources for the TP and allows the TP to establish conversations.
When TPStarted is called, the
LocalTPName
is passed to LU 6.2 API.
LU 6.2 API then assigns a
TPID
to the instance of the TP that called
TPStarted. The
TPID
uniquely identifies each execution instance of a
TP. If several users execute the same TP at the same time, every
instance of that TP will have the same
LocalTPName
, but each instance
will have its own
TPID
.