dsmInitEx

Parameter

dsUint32_t *dsmHandleP (O)

Die Kennung, die diese Initialisierungssitzung identifiziert und nachfolgenden IBM® Storage Protect -Aufrufen zuordnet.

dsmInitExIn_t *dsmInitExInP

Diese Struktur enthält die folgenden Eingabeparameter:

dsmApiVersion *dsmApiVersionP (I)

Dieser Parameter ist ein Verweis auf die Datenstruktur, die die Version der API identifiziert, die der Anwendungsclient für diese Sitzung verwendet. Die Struktur enthält die Werte der vier Konstanten DSM_API_VERSION, DSM_API_RELEASE, DSM_API_LEVEL und DSM_API_SUBLEVEL, die in der Datei dsmapitd.h definiert sind. Rufen Sie dsmQueryApiVersionEx auf und stellen Sie sicher, dass die API-Version des Anwendungsclients und die Version der API-Bibliothek, die auf der Workstation des Benutzers installiert ist, kompatibel sind.

char *clientNodeNameP (I)

Dieser Parameter ist ein Zeiger auf den Knoten für die IBM Storage Protect -Sitzung. Alle Sitzungen müssen einem Knotennamen zugeordnet sein. Die Konstante DSM_MAX_NODE_LENGTH in der Datei dsmapitd.h legt die maximale Größe für einen Knotennamen fest.

Beim Knotennamen muss die Groß-/Kleinschreibung nicht beachtet werden.

Wenn dieser Parameter auf NULL und die Option passwordaccess auf prompt gesetzt wird, versucht die API, den Knotennamen zunächst aus der übergebenen Optionszeichenfolge abzurufen. Ist er dort nicht vorhanden, versucht die API anschließend, den Knotennamen aus der Konfigurationsdatei oder der Optionsdatei abzurufen. Wenn diese Versuche, den Knotennamen zu finden, fehlschlagen, verwendet die UNIX-oder Linux® -API den Systemhostnamen, während die APIs von anderen Betriebssystemen zurückgegeben werden.DSM_RC_REJECT_ID_UNKNOWN.

Wenn dieser Parameter NULL ist und die Option passwordaccess in der Datei dsm.opt (für die Windows-API) oder in der Datei dsm.sys (für die UNIX-oder Linux -API) auf generategesetzt ist, verwendet die API den Wert der Option nodename oder den Namen des Systemhosts.

char *clientOwnerNameP (I)

Dieser Parameter ist ein Zeiger auf den Eigner der IBM Storage Protect -Sitzung. Wenn das Betriebssystem eine Mehrbenutzerplattform ist, hat der Eignername NULL (der Rootbenutzer) die Berechtigung zum Sichern, Archivieren, Zurückschreiben oder Abrufen von Objekten, die zu der Anwendung gehören, unabhängig vom Eigner des Objekts.

Beim Eignernamen muss die Groß-/Kleinschreibung beachtet werden.

Wenn dieser Parameter NULL ist und die Option passwordaccess in der Datei dsm.sys auf generate gesetzt wird, verwendet die API die Anmelde-Benutzer-ID.

Hinweis: Auf einer Mehrbenutzerplattform muss der Eignername nicht mit der aktiven Benutzer-ID der Sitzung übereinstimmen, in der die Anwendung ausgeführt wird.

char *clientPasswordP (I)

Ein Zeiger auf das Kennwort des Knotens, auf dem die IBM Storage Protect -Sitzung ausgeführt wird. Mit der Konstanten DSM_MAX_VERIFIER_LENGTH in der Datei dsmapitd.h wird die maximale Größe festgelegt, die für ein Kennwort zulässig ist.

Für das Kennwort muss die Groß-/Kleinschreibung nicht beachtet werden.

Außer wenn die Kennwortdatei zuerst gestartet wird, wird der Wert dieses Parameters ignoriert, wenn die Option passwordaccess auf generate gesetzt ist.

char *userNameP;

Ein Verweis auf den Namen des Benutzers mit Verwaltungsaufgaben, der über Clientberechtigung für diesen Knoten verfügt.

char *userPasswordP;

Ein Verweis auf das Kennwort für den Parameter userName, sofern ein Wert angegeben ist.

char *applicationType (I)

Gibt die Anwendung an, die die IBM Storage Protect -Sitzung ausführt. Der Anwendungsclient identifiziert den Wert.

Jedes Mal, wenn ein API-Anwendungsclient eine Sitzung mit dem Server startet, wird der Anwendungstyp (bzw. das Betriebssystem) des Clients auf dem Server aktualisiert. Der Wert wird in das Feld platform auf dem Server eingegeben. Ziehen Sie die Verwendung einer Betriebssystem-ID im Wert in Betracht. Die maximale Länge der Zeichenfolge wird in der Konstanten DSM_MAX_PLATFORM_LENGTH definiert.

Um den aktuellen Wert des Anwendungstyps anzuzeigen, rufen Sie dsmQuerySessInfoauf.

char *configfile (I)

Verweist auf eine Zeichenfolge, die den vollständig qualifizierten Namen einer API-Konfigurationsdatei enthält. Optionen, die in der API-Konfigurationsdatei angegeben werden, überschreiben die entsprechende Angabe in der Clientoptionsdatei. Optionsdateien werden definiert, wenn IBM Storage Protect (Client oder API) installiert wird.

char *options (I)

Verweist auf eine Zeichenfolge, die Benutzeroptionen wie die folgenden enthalten kann:

• Compressalways
• Servername (nur UNIX-und Linux -Systeme)
• TCPServeraddr (nicht für UNIX-Systeme)
• Von Knoten
• Fromowner
• Passwordaccess

Der Anwendungsclient kann die Werte für diese Optionen, die in der Konfigurationsdatei definiert sind, mithilfe der Optionsliste überschreiben.

Optionen weisen das folgende Format auf:

1. Jede Option, die in der Optionsliste angegeben ist, beginnt mit einem Gedankenstrich (-) gefolgt vom Optionsschlüsselwort.
2. Auf das Schlüsselwort folgt ein Gleichheitszeichen (=) und dann der Optionsparameter.
3. Wenn der Optionsparameter ein Leerzeichen enthält, schließen Sie den Parameter in Hochkommas oder Anführungszeichen ein.
4. Wenn mehrere Optionen angegeben werden, trennen Sie die einzelnen Optionen jeweils durch ein Leerzeichen voneinander.

Wenn Optionen NULL sind, werden die Werte für alle Optionen aus der Benutzeroptionsdatei oder der API-Konfigurationsdatei übernommen.

dirDelimiter

Der Verzeichnisbegrenzer, der als Präfix vor Dateibereichsnamen, übergeordneten und untergeordneten Namen angegeben wird. Sie müssen den Parameter dirDelimiter nur angeben, wenn die Anwendung die Systemstandardwerte überschreibt. In einer UNIX-oder Linux -Umgebung ist der Standardwert ein Schrägstrich (/). In einer Windows-Umgebung ist der Standardwert ein Backslash (\).

useUnicode

Ein boolesches Flag, das angibt, ob Unicode aktiviert ist. Das Flag useUnicode muss auf false gesetzt sein, um plattformübergreifende Interoperabilität zwischen UNIX-und Windows-Systemen zu erreichen.

bCrossPlatform

Ein boolesches Flag, das gesetzt werden muss (bTrue), um eine plattformübergreifende Interoperabilität zwischen UNIX-und Windows-Systemen zu erreichen. Wenn das Flag bCrossPlatform gesetzt ist, stellt die API sicher, dass für die Dateibereiche nicht Unicode verwendet wird und die Anwendung nicht Unicode verwendet. Eine Windows-Anwendung, die Unicode verwendet, ist nicht mit Anwendungen kompatibel, die Nicht-Unicode-Codierungen verwenden. Das Flag bCrossPlatform darf nicht für eine Windows-Anwendung gesetzt werden, die Unicode verwendet.

UseTsmBuffers

Gibt an, ob die Pufferkopieneliminierung verwendet werden soll.

numTsmBuffers

Anzahl Puffer, wenn useTsmBuffers=bTrue gesetzt ist.

bEncryptKeyEnabled

Gibt an, ob Verschlüsselung mit anwendungsverwaltetem Schlüssel verwendet wird.

encryptionPasswordP

Das Verschlüsselungskennwort.

Einschränkung: Wenn encryptkey=saveist und ein Verschlüsselungsschlüssel vorhanden ist, wird der in encryptionPasswordP angegebene Wert ignoriert.

dsmAppVersion *appVersionP (I)

Dieser Parameter ist ein Verweis auf die Datenstruktur, die die Versionsinformationen der Anwendung enthält, die eine API-Sitzung startet. Die Struktur enthält die Werte für die vier Konstanten applicationVersion, applicationRelease, applicationLevel und applicationSubLevel, die in der Datei tsmapitd.h definiert werden.

dsmInitExOut_t *dsmInitExOut P

Diese Struktur enthält die Ausgabeparameter.

dsUint32_t *dsmHandle (0)

Die Kennung, die diese Initialisierungssitzung identifiziert und nachfolgenden API-Aufrufen zuordnet.

infoRC

Zusätzliche Informationen zum Rückkehrcode. Überprüfen Sie sowohl den Funktionsrückkehrcode als auch den Wert von infoRC. Der infoRC -Wert DSM_RC_REJECT_LASTSESS_CANCELED (69) gibt IBM Storage Protect an, dass der Administrator die letzte Sitzung abgebrochen hat.

Rückkehrcodes

Die Rückkehrcodenummern sind in runden Klammern ( ) angegeben.