OpenTP1 Version 7 Programming Guide

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

7.2.2 Acquisition of user server status

By calling a function from a UAP, the statuses of user servers at OpenTP1 nodes making up a cluster/parallel mode system can be acquired. Through the acquisition of user server statuses, the user servers in the multinode subarea can be monitored.

The statuses that can be acquired are:

Whether to acquire the statuses of multiple user servers in succession or to acquire the status of only the specified user server can be specified.

Organization of this subsection
(1) How to acquire the statuses of user servers in succession
(2) How to acquire the status of only the specified user server

(1) How to acquire the statuses of user servers in succession

The statuses of all user servers at the node identified by the OpenTP1 node identifier are acquired.

To acquire the statuses of all user servers in succession, call the function dc_adm_get_sv_status_begin() with the node identifier specified. This function returns the number of user servers at the specified OpenTP1 node. Then, call the function dc_adm_get_sv_status_next() to acquire the user server statuses. Continue issuing the function dc_adm_get_sv_status_next() until the status of the last candidate user server is acquired. Finally, call the function dc_adm_get_sv_status_done() to terminate status acquisition.

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

The figure below shows the procedure for acquiring user server statuses in succession.

Figure 7-3 Procedure for acquiring user server statuses in succession

[Figure]

(2) How to acquire the status of only the specified user server

To acquire the status of only the specified user server, call the function dc_adm_get_sv_status(). This function returns the status of the user server identified by the node identifier specified in the function.