SpmiCreateHotSet

Purpose

Creates an empty hotset.

Library

SPMI Library (libSpmi.a)

Syntax

#include sys/Spmidef.h

struct SpmiHotSet *SpmiCreateHotSet()

Description

The SpmiCreateHotSet subroutine creates an empty hotset and returns a pointer to an SpmiHotSet structure.This structure provides the anchor point for a hotset and must exist before the SpmiAddSetHot subroutine can be successfully called.

This subroutine is part of the server option of the Performance Aide for AIX® licensed product.

Return Values

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

Error Codes

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

• extern char SpmiErrmsg[];
• extern int SpmiErrno;

If the subroutine returns without an error, the SpmiErrno variable is set to 0 and the SpmiErrmsg character array is empty. If an error is detected, the SpmiErrno variable returns an error code, as defined in the sys/Spmidef.h file, and the SpmiErrmsg variable contains text, in English, explaining the cause of the error.

Files