ANSI C, C++

#include <dcadm.h>
int dc_adm_get_nd_status_begin (char *sub_area,
                                DCLONG *entry_count,
                                DCLONG flags)

K&R C

#include <dcadm.h>
int dc_adm_get_nd_status_begin (sub_area, entry_count,
                                flags)
char       *sub_area;
DCLONG     *entry_count;
DCLONG      flags;

The function dc_adm_get_nd_status_begin() starts acquiring the status of an OpenTP1 node. When this function terminates normally, it returns the number of OpenTP1 nodes whose status will be acquired.

sub_area

Specify the pointer to the multinode subarea identifier or character string (*). Add a null character after the multinode subarea identifier. If the pointer to the character string (*) is specified, the function will acquire the statuses of all OpenTP1 nodes making up the multinode area.

The length of the multinode subarea identifier must be equal to or less than the maximum length defined by DCADM_SUB_AREA_NAME_SIZE. If a longer identifier is specified, the function returns with an error.

entry_count

Specify the pointer to the area to which the number of OpenTP1 nodes will be returned. The area set here will contain the number of OpenTP1 nodes in the multinode subarea identified by sub_area. If the pointer to the character string (*) is specified for sub_area, the number of all OpenTP1 nodes in the multinode area will returned to the area.

flags

Specify DCNOFLAGS.