RSiClose or RSiClosex Subroutine

Purpose

Terminates the Remote Statistic Interface (RSI) interface for a remote host connection.

Library

RSI Library (libSpmi.a)

Syntax

#include sys/Rsi.h

void RSiClose(rhandle)
RSiHandle rhandle;

void RSiClosex(rhandlex)
RSiHandlex rhandlex;

Description

The RSiClose subroutine is responsible for:

1. Removing the data-consumer program as a known data consumer on a particular host. This is done by sending a going_down packet to the host.
2. Marking the RSI handle as not active.
3. Releasing all memory allocated in connection with the RSI handle.
4. Terminating the RSI interface for a remote host.

A successful RSiOpen or RSiOpenx subroutine creates tables on the remote host it was issued against. Therefore, a data consumer program that has issued successful RSiOpen or RSiOpenx subroutine calls must issue an RSiClose or RSiClosex subroutine call for each RSiOpen or RSiOpenx call before the program exits so that the tables in the remote xmservd daemon can be released.

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.

The macro RSiIsOpen can be used to test whether an RSI handle is open. It takes an RSiHandle as argument and returns true (1) if the handle is open, otherwise false (0).

Files