[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 2

RSiCreateHotSet Subroutine

Purpose

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

Library

RSI Library (libSpmi.a)

Syntax

#include sys/Rsi.h

struct SpmiHotSet *RSiCreateHotSet(rhandle)
RSiHandle rhandle;

Description

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

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

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

Parameters

rhandleMust be an RSiHandle, which was previously initialized by the RSiOpen (RSiOpen Subroutine) subroutine.

Return Values

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

Error Codes

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

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. RSi error codes are described in List of RSi Error Codes .

Files

/usr/include/sys/Rsi.h Declares the subroutines, data structures, handles, and macros that an application program can use to access the RSI.

Related Information

For related information, see:

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]