dsmQuerySessOptions

Online bearbeiten

Mit dem Funktionsaufruf dsmQuerySessOptions werden wichtige Optionswerte, die in der in dsmHandle angegebenen Sitzung gültig sind, abgefragt. Eine Struktur des Typs optStruct wird in dem Aufruf übergeben und enthält die Informationen.

Dieser Aufruf wird nach einem erfolgreichen Aufruf dsmInitEx gestartet. Die Werte, die zurückgegeben werden, können sich, abhängig von Werten, die an den Aufruf dsmInitEx übergeben werden, von den Werten, die in einem Aufruf dsmQueryCliOptions zurückgegeben werden, unterscheiden; dies betrifft in erste Linie optString und optFile. Informationen zur Rangfolge von Optionen finden Sie unter Informationen zu Konfigurations-und Optionsdateien.

Es gibt keine spezifischen Rückkehrcodes für diesen Aufruf.

Syntax

dsInt16_t dsmQuerySessOptions
    (dsUint32_t    dsmHandle,
    optStruct      *optstructP);

Parameter

dsUint32_t dsmhandle(I)

Die Kennung, die diesen Aufruf einem vorherigen Aufruf dsmInitEx zuordnet.

optStruct *optstructP (I/O)

Dieser Parameter übergibt die Adresse der Struktur, die die API ausführt. Der Anwendungsclient ist für das Zuordnen von Speicher für die Struktur zuständig. Bei der erfolgreichen Rückkehr enthalten die Felder in der Struktur die entsprechenden Informationen.

In der Struktur des Typs 'optStruct' werden die folgenden Informationen zurückgegeben:

	Name	Beschreibung
	dsmiDir	Der Wert der Umgebungsvariablen DSMI_DIR.
	dsmiConfig	Die Datei dsm.opt, die in der Umgebungsvariablen DSMI_CONFIG angegeben ist.
	serverName	Der Name der IBM® Storage Protect -Serverzeilengruppe in der Optionsdatei.
	commMethod	Die ausgewählte Übertragungsmethode. Siehe #defines für DSM_COMM_* in der Datei dsmapitd.h.
	serverAddress	Die Adresse des Servers auf der Basis der Übertragungsmethode.
	nodeName	Der Name des Knotens (der Maschine) des Clients.
	compression	Der Wert für die Option 'compression' (bTrue=on und bFalse=off).
	compressAlways	Der Wert der Option compressalways ( bTrue=on und bFalse=off ).
	passwordAccess	Wert bTrue für 'generate' und bFalse für 'prompt'.