GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-12
^BEGINTRANSACTION
BEGIN
CALL ^FILEINFO (......);
IF error = 26 THEN
.
.
^BEGINTRANSACTION
This procedure initiates a new TMF transaction. See Appendix D, Using Pseudo
Procedures in a TS/MP Environment for an example of using this procedure.
A trace record is written after a successful call to ^BEGINTRANSACTION if bit 3 of
trace^control^flags in DCCBDECS is set to 1. The trace records contain the calling
task number and the TMF transaction identifier. See Tracing GDSX on page 2-80 for
more information.
Except for the following considerations, the syntax, condition code settings, and
considerations regarding this procedure are the same as given for the TMF counterpart
in the NonStop TMF Application Programmer’s Guide.
Considerations
•
This procedure differs from its TMF counterpart by not allowing the trans-
begin-tag parameter. Even though you may not use this parameter, a transid
for the TMF transaction is returned to TSCODE and is stored in the variable
transtag of tcb^template.
•
A maximum of 100 concurrent TMF transactions are allowed for any single
multithreaded Guardian process. An attempt to issue more than 100 concurrent
^BEGINTRANSACTION calls is rejected with error 83.
A warning message displays when GDSX is started with more than 100 tasks
configured and the TMF configuration parameter is set to 2. The warning message
is:
10016 Number of tasks exceed limit with TMF
See MAXTASKS on page 2-68.
BIT^MAP
This procedure searches a specified range within a bit map table in either global or
extended memory, and returns the index value for the first bit found that is available
(equal to 0). The search begins with the leftmost bit (number 0) of the first word.
index := BIT^MAP ( table !
i
,minimum !
i
,maximum ); !
i