RSiNextCx or RSiNextCxx Subroutine

Purpose

Returns the next subcontext of an SpmiCx context.

Library

RSI Library (libSpmi.a)

Syntax

#include sys/Rsi.h

struct SpmiCxLink *RSiNextCx(rhandle, context, link, name,
descr)
RSiHandle rhandle;
cx_handle *context;
struct SpmiCxLink *link;
char **name;
char **descr;

struct SpmiCxLink *RSiNextCxx(rhandlex, context, link, name,
descr)
RSiHandlex rhandlex;
cx_handle *context;
struct SpmiCxLink *link;
char **name;
char **descr;

Description

The RSiNextCx or RSiNextCxx subroutine performs the following actions:

1. Validates that the context identified by the second argument exists.
2. Returns a handle to the next element of the list of subcontexts defined for the context.
3. Returns the short name and description of the subcontext.

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 point to a valid 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, RSiPathGetCxx subroutine call.

link

Must be a pointer to a structure of type struct SpmiCxLink, which was previously returned by a successful RSiFirstCx or RSiFirstCxx subroutine call or RSiNextCx or RSiNextCxx subroutine call.

name

Must be a pointer to a pointer to a character array. The pointer must be initialized to point at a character array pointer. When the subroutine call is successful, the short name of the subcontext is returned in the character array pointer.

descr

Must be a pointer to a pointer to a character array. The pointer must be initialized to point at a character array pointer. When the subroutine call is successful, the description of the subcontext is returned in the character array pointer.

Return Values

If successful, the subroutine returns a pointer to a structure of type struct SpmiCxLink . If an error occurs, or if no more subcontexts exist for the context, NULL is returned 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