OpenTP1 Version 7 Programming Guide

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

7.2.1 Acquisition of OpenTP1 node status

By using a function from a UAP, the status of an OpenTP1 node contained in a cluster/parallel mode system can be acquired. Through the acquisition of OpenTP1 node statuses, the multinode area or subarea can be monitored by the UAP.

The statuses that can be acquired are:

Whether to acquire the statuses of multiple OpenTP1 nodes in succession or to acquire the status of only the specified OpenTP1 node can be specified.

Organization of this subsection
(1) How to acquire the statuses of OpenTP1 nodes in succession
(2) How to acquire the status of only the specified OpenTP1 node

(1) How to acquire the statuses of OpenTP1 nodes in succession

The statuses of all OpenTP1 nodes in each multinode area or subarea are acquired.

To acquire the statuses of all nodes in succession, call the function dc_adm_get_nd_status_begin() with the multinode area or subarea identifier specified. This function returns the number of OpenTP1 nodes in the specified area. Then, call the function dc_adm_get_nd_status_next() to acquire OpenTP1 node statuses. Continue calling the function dc_adm_get_nd_status_next() until the statuses of the last candidate node is acquired. Finally, call the function dc_adm_get_nd_status_done() to terminate status acquisition.

Once the function dc_adm_get_nd_status_begin() is called, it cannot be called (that is, the function dc_adm_get_nd_status_begin() cannot be nested).

The figure below shows the procedure for acquiring OpenTP1 node statuses in succession.

Figure 7-2 Procedure for acquiring OpenTP1 nodes in succession

[Figure]

(2) How to acquire the status of only the specified OpenTP1 node

To acquire the status of only the specified OpenTP1 node, call the function dc_adm_get_nd_status(). This function returns the status concerning the node identifier of the OpenTP1 node specified in the function.