RSiCreateStatSet Subroutine

Purpose

Creates an empty statset on the remote host identified by the argument.

Library

RSI Library (libSpmi.a)

Syntax

#include sys/Rsi.h

struct SpmiStatSet *RSiCreateStatSet(rhandle)
RSiHandle rhandle;

Description

The RSiCreateStatSet subroutine allocates an SpmiStatSet structure. The structure is initialized as an empty SpmiStatSet and a pointer to the SpmiStatSet structure is returned.

The SpmiStatSet structure provides the anchor point to a set of statistics and must exist before the RSiPathAddSetStat (RSiPathAddSetStat Subroutine) subroutine can be successfully called.

This subroutine is part of the Performance Toolbox for AIX® licensed product.

Parameters

rhandle

Must point to a valid RSiHandle handle, which was previously initialized by the RSiOpen (RSiOpen Subroutine) subroutine.

Return Values

The RSiCreateStatSet subroutine returns a pointer to a structure of type SpmiStatSet if successful. If unsuccessful, the subroutine returns a NULL value.

Error Codes

All Remote Statistic Interface (RSI) subroutines use external variables to provide error information. To access these variables, an application program must define the following external variables:

• extern char RSiEMsg[];
• extern int RSiErrno;

If the subroutine returns without an error, the RSiErrno variable is set to RSiOkay and the RSiEMsg character array is empty. If an error is detected, the RSiErrno variable returns an error code, as defined in the enum RSiErrorType.

Files