Returns the next subcontext of an SpmiCx context.
RSI Library (libSpmi.a)
#include sys/Rsi.h
struct SpmiCxLink *RSiNextCx(rhandle, context, link, name, descr) RSiHandle rhandle; cx_handle *context; struct SpmiCxLink *link; char **name; char **descr;
The RSiNextCx subroutine:
This subroutine is part of the Performance Toolbox for AIX licensed product.
rhandleMust point to a structure of type RSiHandle, which was previously initialized by the RSiOpen (RSiOpen Subroutine) subroutine.
contextMust be a handle of type cx_handle, which was previously returned by a successful RSiPathGetCx (RSiPathGetCx Subroutine) subroutine call.
linkMust be a pointer to a structure of type struct SpmiCxLink, which was previously returned by a successful RSiFirstCx (RSiFirstCx Subroutine) or RSiNextCx subroutine call.
nameMust 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.
descrMust 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.
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.
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.
/usr/include/sys/Rsi.h | Declares the subroutines, data structures, handles, and macros that an application program can use to access the RSI. |
For related information, see: