OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/W, TP1/Client/P

[Contents][Index][Back][Next]

6.5.7 CBLDCCLS('GETTRNID') - Collection of identifiers for current transaction

Organization of this subsection
(1) Form
(2) Purpose
(3) Data area where the UAP sets values
(4) Data area for which a value is returned
(5) Status codes

(1) Form

(a) In a multi-thread environment
PROCEDURE DIVISION
 
CALL 'CBLDCCLS' USING identifier-1
 
DATA DIVISION
 
01 identifier-1.
   02 data-name-A PIC X(8)  VALUE 'GETTRNID'.
   02 data-name-B PIC X(5).
   02 FILLER     PIC X(3).
   02 data-name-C PIC X(17).
   02 data-name-D PIC X(17).
   02 FILLER     PIC X(2).
   02 data-name-E PIC 9(9) COMP.
 
(b) In a single-thread environment
PROCEDURE DIVISION
 
CALL 'CBLDCCLT' USING identifier-1
 
DATA DIVISION
 
01 identifier-1.
   02 data-name-A PIC X(8)  VALUE 'GETTRNID'.
   02 data-name-B PIC X(5).
   02 FILLER     PIC X(3).
   02 data-name-C PIC X(17).
   02 data-name-D PIC X(17).
   02 data-name-E PIC 9(9) COMP.
 

(2) Purpose

Collects the current transaction global identifier and transaction branch identifier.

OpenTP1 allocated these identifiers when any of the following programs started the transaction.

(3) Data area where the UAP sets values

(4) Data area for which a value is returned

(5) Status codes

Status code Meaning
00000 Normal termination
02501 Invalid value for the data name. The request code (data-name-A) may be invalid.
02502 The program is issued from an incorrect context.
02504 Insufficient memory
02544 The client ID specified for data-name-E differs from the one received with CBLDCCLS('CLTIN ') or CBLDCCLS('EXCLTIN ').