iX V6.5 (30391-90011)

Chapter 5 137

TurboIMAGE/XL Library Procedures

Using TurboIMAGE/XL Intrinsics

Table 5-2. illustrates the forms of the call statements for the languages that can be used to

call the procedures. Chapter 6 contains examples of using the procedures and

speciﬁcations for declaration of parameters for some of these languages. It also provides a

sample RPG program.

All procedures can be called from programs in any of the host languages.

Intrinsic Numbers

An intrinsic number is provided for each procedure. This number, which uniquely

identiﬁes the procedure within TurboIMAGE/XL and the MPE/iX operating system, is

returned with other status information when an error occurs. You can use it to identify the

procedure that caused the error or call DBEXPLAIN to interpret the number and other

information.

DBMEMO When logging, writes user information to the log ﬁle.

DBOPEN Initiates access to a database. Speciﬁes the user access mode and user class

number for the duration of the process.

DBPUT Adds a new entry to a manual master or detail data set.

DBUNLOCK Releases those locks obtained with previous call(s) to DBLOCK.

DBUPDATE Modiﬁes the values of data items. Cannot be used to update master data set

key items. Can be used to update detail data set search and sort items in

database access mode 1, 3, or 4 if permitted by the critical item update

(CIUPDATE) option settings for the database and the current process.

DBXBEGIN Designates the beginning of a dynamic transaction. Refer to "Transactions"

later in this chapter for a description of dynamic transactions.

DBXEND Designates the end of a dynamic transaction.

DBXUNDO Rolls back the active dynamic transaction.

Table 5-2. Calling a TurboIMAGE/XL Procedure

COBOL II CALL "name" USING parameter,parameter,...,parameter.

FORTRAN 77 CALL name (parameter,parameter,...,parameter)

Pascal name (parameter,parameter,...,parameter);

BBASIC linenumber CALL name (parameter,parameter,...,parameter)

C name (parameter,parameter,...,parameter);

Table 5-1. TurboIMAGE/XL Procedures

Procedure Function