dsmSendObj

Parameter

dsUint32_t dsmHandle (I)

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

dsmSendType sendType (I)

Dieser Parameter gibt den Sendetyp an, der ausgeführt wird. Gültige Werte umfassen:

	Name	Beschreibung
	stBackup	Ein Sicherungsobjekt, das an den Server gesendet wird.
	stArchive	Ein Archivierungsobjekt, das an den Server gesendet wird.
	stBackupMountWait	Ein Sicherungsobjekt, für das der Server warten soll, bis die erforderliche Einheit bereitgestellt wird , z. B. ein Band geladen wird.
	stArchiveMountWait	Ein Archivierungsobjekt, für das der Server warten soll, bis die erforderliche Einheit bereitgestellt wird, z. B. ein Band geladen wird.

Anmerkung: Verwenden Sie die Typen MountWait , wenn die Möglichkeit besteht, dass der Anwendungsbenutzer Daten an ein Band sendet.

void *sendBuff (I)

Dieser Parameter ist ein Verweis auf eine Struktur, die andere Informationen enthält, die für den Sendetyp (sendType) in dem Aufruf spezifisch sind. Derzeit ist nur für einen Sendetyp (sendType) mit dem Wert stArchive eine Struktur zugeordnet. Diese Struktur hat den Namen sndArchiveData und enthält die Archivierungsbeschreibung.

dsmObjName *objNameP (I)

Dieser Parameter ist ein Verweis auf die Struktur, die den Dateibereichsnamen, den übergeordneten Objektnamen, den untergeordneten Objektnamen und den Objekttyp enthält. Weitere Informationen finden Sie unter Objektnamen und IDs .

ObjAttr *objAttrPtr (I)

Dieser Parameter übergibt Objektattribute, die für die Anwendung von Interesse sind. Informationen zur Typdefinition finden Sie unter Quellendateien für API-Typdefinitionen .

Die Attribute sind:

• owner bezieht sich auf den Eigner des Objekts. Beim Abrufen des Objekts aus dem IBM Storage Protect -Speicher ist es wichtig zu ermitteln, ob der Eigner als bestimmter Name oder als leere Zeichenfolge deklariert ist. Weitere Informationen finden Sie unter Als Sitzungseigner auf Objekte zugreifen .
• sizeEstimate ist die bestmögliche Schätzung der Gesamtgröße des Datenobjekts, das an den Server gesendet werden soll. Diese Größe sollte so genau wie möglich geschätzt werden, da der Server dieses Attribut für die effiziente Bereichszuordnung und Objektpositionierung in seinen Speicherressourcen verwendet.
  Ist die von Ihnen angegebene Größenschätzung erheblich geringer als die tatsächliche Anzahl Byte, die gesendet wird, hat der Server möglicherweise Schwierigkeiten, ausreichend Speicherbereich zuzuordnen, und beendet die Transaktion mit dem Ursachencode 11 (DSM_RS_ABORT_NO_REPOSIT_SPACE).

  Hinweis Die Größenschätzung bezieht sich auf die Gesamtgröße des Datenobjekts in Byte.

  Objekte mit einer geringeren Größe als DSM_MIN_COMPRESS_SIZE werden nicht komprimiert.

  Wenn Ihr Objekt keine Bitdaten (sondern nur Attributinformationen dieses Aufrufs) enthält, sollte der Wert für sizeEstimate null sein.

  Hinweis: Ab Version 5.1.0wird das Kopierziel innerhalb einer Transaktion nicht auf Konsistenz für Objekte mit einer Länge von null geprüft.
• objCompressed ist ein boolescher Wert, der angibt, ob die Objektdaten bereits komprimiert wurden oder nicht.

  Wenn das Objekt komprimiert ist (object compressed = bTrue ), versucht IBM Storage Protect nicht, es erneut zu komprimieren. Wenn es nicht komprimiert ist, entscheidet IBM Storage Protect, ob das Objekt komprimiert wird, basierend auf den Werten der vom Administrator festgelegten Komprimierungsoption, die in den API-Konfigurationsquellen eingestellt ist.

  Soll Ihre Anwendung eine Zurückschreibung oder einen Abruf von Teilobjekten ausführen, können die Daten während des Sendevorgangs nicht komprimiert werden. Um dies zu erzwingen, setzen Sie ObjAttr.objCompressed auf bTrue.

• Mit objInfo werden Informationen zu dem spezifischen Objekt gespeichert.
  Einschränkung: Informationen werden hier nicht automatisch gespeichert. Wenn dieses Attribut verwendet wird, müssen Sie das Attribut objInfoLength definieren, um die Länge für objInfo anzugeben.
• mcNameP enthält den Namen einer Verwaltungsklasse, die die aus dsmBindMCabgerufene Verwaltungsklasse überschreibt.
• disableDeduplication ist ein boolescher Wert. Wird er auf wahr gesetzt, wird das Objekt nicht vom Client dedupliziert.

Wenn die clientseitige Deduplizierung aktiviert ist und es sich bei dem gesendeten Objekt um ein Verzeichnis handelt, müssen das Objektattribut und der Objektnamentyp wie folgt konfiguriert werden:

objAttrArea.disableDeduplication = bTrue;
objName.objType = DSM_OBJ_DIRECTORY;

DataBlk *dataBlkPtr (I/O)

Dieser Parameter verweist auf eine Struktur, die sowohl einen Zeiger auf den Puffer für die Daten enthält, die gesichert oder archiviert werden sollen, als auch einen Zeiger auf die Größe des Puffers. Dieser Parameter gilt nur für dsmSendObj . Wenn Sie mit dem Senden von Daten bei einem nachfolgenden dsmSendData -Aufruf beginnen wollen und nicht beim Aufruf dsmSendObj , setzen Sie den Pufferzeiger in der Struktur DataBlk auf NULL. Bei der Rückkehr enthält diese Struktur die Anzahl tatsächlich übertragener Byte. Informationen zur Typdefinition finden Sie unter Quellendateien für API-Typdefinitionen .

Rückkehrcodes

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