OpenTP1 Version 7 Programming Guide

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

4.3.3 Procedure for accessing an internode shared table

This subsection explains the procedure for accessing an internode shared table from a UAP. Access to an internode shared table cannot be committed or rolled back by using a transaction function.

Organization of this subsection
(1) Opening internode shared tables
(2) Procedure for referencing/updating records
(3) Closing internode shared tables

(1) Opening internode shared tables

Before accessing an internode shared table from a UAP, the table must be opened first. To open the table, call the function dc_ist_open() [CBLDCIST('OPEN')]. When the table is opened, the table descriptor is returned. For processing after the table is opened, specify this table descriptor in the function to access the table. Keep the table descriptor in the UAP even for processing after the table is opened.

(2) Procedure for referencing/updating records

To input an internode shared table record, call the function dc_ist_read() [CBLDCIST('READ')]. To output data to an internode shared table record, call the function dc_ist_write() [CBLDCIST('WRIT')]. To call each of these functions, specify in its argument the table descriptor returned by the function dc_ist_open().

To input or output a record, the key values of more than one record can be specified collectively. A key value should be specified as a structure in the corresponding function. More than one structure can be specified.

(3) Closing internode shared tables

To close an internode shared table, call the function dc_ist_close() [CBLDCIST('CLOS')]. To call this function, specify in its argument the table descriptor returned by the function dc_ist_open().

The figure below shows the procedures for accessing internode shared tables.

Figure 4-21 Procedures for accessing internode shared tables

[Figure]