RSiInstantiate or RSiInstantiatex Subroutine

Purpose

Creates (instantiates) all subcontexts of an SpmiCx context object.

Library

RSI Library (libSpmi.a)

Syntax

#include sys/Rsi.h

int RSiInstantiate(rhandle, context)
RSiHandle rhandle;
cx_handle *context;

int RSiInstantiatex(rhandlex, context)
RSiHandlex rhandlex;
cx_handle *context;

Description

The RSiInstantiate or RSiInstantiatex subroutine performs the following actions:

1. Validates that the context identified by the second argument exists.
2. Instantiates the context so that all subcontexts of that context are created in the context hierarchy. Note that this subroutine call currently only makes sense if the context's SiInstFreq is set to SiContInst or SiCfgInst because all other contexts would have been instantiated whenever the xmservd daemon was started.

The RSiInstantiate or RSiInstantiatex subroutine explicitly instantiates the subcontexts of an instantiable context. If the context is not instantiable, do not call the RSiInstantiate or RSiInstantiatexsubroutine.

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 subroutine.

rhandlex

Must be an RSiHandlex handle, which was previously initialized by the RSiOpenx subroutine.

context

Must be a handle of type cx_handle, which was previously returned by a successful RSiPathGetCx or RSiPathGetCxx subroutine call.

Return Values

If successful, the subroutine returns a zero value; otherwise it returns an error code as defined in SiError and an error text may be placed in the external character array RSiEMsg.

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