UnterprogrammRSiPathGetCx oder RSiPathGetCxx

Zweck

Durchsucht die Kontexthierarchie nach einem SpmiCx -Kontext, der mit einem Kontextpfadnamen übereinstimmt.

Bibliothek

RSI Library (libSpmi.a)

Syntax

#include sys/Rsi.h

cx_handle *RSiPathGetCx (rhandle, path)
RSiHandle rhandle;
char *path;

cx_handle *RSiPathGetCxx (rhandlex, path)
RSiHandlex  rhandlex;
char *path;

Beschreibung

Das Unterprogramm RSiPathGetCx oder RSiPathGetCxx führt die folgenden Aktionen aus:

1. Durchsucht die Kontexthierarchie nach einem bestimmten Pfadnamen eines Kontexts.
2. Gibt eine Kennung zurück, die verwendet werden soll, wenn anschließend auf den Kontext verwiesen wird

Dieses Unterprogramm ist Teil des lizenzierten Produkts Performance Toolbox for AIX®.

Parameter

rhandle

Muss auf ein gültiges RSiHandle -Handle verweisen, das zuvor von der Subroutine RSiOpen initialisiert wurde

Rhandlex

Muss auf eine gültige Kennung RSiHandlex verweisen, die zuvor von der Subroutine RSiOpenx initialisiert wurde.

Pfad

Der Pfadname eines Kontexts, für den eine Kennung zurückgegeben werden soll. Der Kontextpfadname muss der vollständige Pfadname sein und darf keinen abschließenden Schrägstrich enthalten. Beachten Sie, dass Kontextpfadnamen nie mit einem Schrägstrich beginnen.

Rückgabewerte

Bei Erfolg gibt die Subroutine eine Kennung zurück, die als Zeiger auf eine Struktur des Typs cx_kennungdefiniert ist. Wenn ein Fehler auftritt, wird NULL zurückgegeben und ein Fehlertext kann in das externe Zeichenarray RSiEMsgeingefügt werden.

Fehlercodes

Alle RSI-Subroutinen (Remote Statistic Interface) verwenden externe Variablen, um Fehlerinformationen bereitzustellen. Für den Zugriff auf diese Variablen muss ein Anwendungsprogramm die folgenden externen Variablen definieren:

• extern char RSiEMsg[];
• extern int RSiErrno;

Wenn die Subroutine ohne Fehler zurückkehrt, wird die Variable RSiErrno auf RSiOkay gesetzt und das Zeichenarray RSiEMsg ist leer. Wenn ein Fehler festgestellt wird, gibt die Variable RSiErrno einen Fehlercode zurück, der in der Aufzählung RSiErrorType definiert ist.

Dateien