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

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

6.5.6 CBLDCTRS('INFO ') - Post information 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 'CBLDCTRS' USING identifier-1
 
DATA DIVISION
 
01 identifier-1.
   02 data-name-A   PIC X(8)  VALUE 'INFO    '.
   02 data-name-B   PIC X(5).
   02 FILLER       PIC X(1).
   02 data-name-C
     03 data-name-D PIC S9(4) COMP VALUE ZERO.
   02 data-name-E   PIC 9(9) COMP.
 
(b) In a single-thread environment
PROCEDURE DIVISION
 
CALL 'CBLDCTRN' USING identifier-1
 
DATA DIVISION
 
01 identifier-1.
   02 data-name-A   PIC X(8)  VALUE 'INFO    '.
   02 data-name-B   PIC X(5).
   02 FILLER       PIC X(1).
   02 data-name-C
     03 data-name-D   PIC S9(4) COMP VALUE ZERO.
 

(2) Purpose

Checks if the CUP that issued CBLDCTRS('INFO ') is currently working as a transaction.

(3) Data area where the UAP sets values

(4) Data area for which a value is returned

(5) Status codes

Status code Meaning
00001 The CUP process that executed CBLDCTRS('INFO ') is outside the scope of the transaction.
00000 The CUP process that executed CBLDCTRS('INFO ') is within the scope of the transaction.
02501 The request code (data-name-A) may be invalid.
02544 The client ID specified for data-name-E differs from the one received with CBLDCCLS('CLTIN ') or CBLDCCLS('EXCLTIN ').