CHECKIN LIBVOLUME (Speicherdatenträger in ein Speicherarchiv zurückstellen)

Berechtigungsklasse

Für diesen Befehl ist Systemberechtigung oder uneingeschränkte Speicherberechtigung erforderlich.

Parameter

Kassettenarchivname (Erforderlich)

Gibt den Namen des Kassettenarchivs an.

volume_name

Gibt den Datenträgernamen des Speicherdatenträgers an, der zurückgestellt wird. Dieser Parameter ist erforderlich, wenn SEARCH dem Wert NO entspricht. Geben Sie diesen Parameter nicht ein, wenn der Parameter SEARCH dem Wert YES, BULK oder ALL entspricht. Wird ein Datenträger in ein SCSI-Speicherarchiv mit mehreren Eingangs-/Ausgangsanschlüssen zurückgestellt, wird der Datenträger in dem Schacht mit der niedrigsten Nummer zurückgestellt.

STATus (Erforderlich)

Gibt den Datenträgerstatus an. Gültige Werte:

PRIvate

Gibt an, dass der Datenträger ein privater Datenträger ist, der nur geladen wird, wenn er mit seinem Namen angefordert wird.

SCRatch

Gibt an, dass der Datenträger ein neuer Arbeitsdatenträger ist. Dieser Datenträger kann bereitgestellt werden, um Anforderungen zum Bereitstellen eines Arbeitsdatenträgers während Datenspeicherungs- oder Exportoperationen zu erfüllen.

Hat ein Datenträger einen Eintrag in der Datenträger-History, können Sie den Datenträger nicht als Arbeitsdatenträger zurückstellen.

CLEaner

Gibt an, dass der Datenträger eine Reinigungskassette und keine Datenkassette ist. Der Parameter CLEANINGS ist für eine Reinigungskassette erforderlich und muss auf die Anzahl der Reinigungsdurchläufe gesetzt werden.

CHECKLABEL=YES ist zum Einchecken einer Reinigungskassette nicht gültig. Verwenden Sie STATUS=CLEANER, um eine Reinigungskassette getrennt von einer Datenkassette einzuchecken.

OWNer

Gibt an, welcher Speicherarchivclient der Eigner eines privaten Datenträgers in einem Speicherarchiv ist, das in einem SAN gemeinsam genutzt wird. Der Datenträger, für den das Eigentumsrecht angegeben wird, muss ein privater Datenträger sein. Für einen Arbeitsdatenträger können Sie kein Eigentumsrecht angeben. Darüber hinaus können Sie keinen Eigner angeben, wenn Sie SEARCH=YES oder SEARCH=BULK verwenden.

Wenn Sie den Befehl CHECKIN LIBVOLUME ausgeben, überprüft der Server den Eigner. Wurde dieser Parameter nicht angegeben, verwendet der Server den Standardwert und übergibt das Datenträgereigentumsrecht an den Speicherarchivclient als Eigner, wie in der Protokolldatei für Datenträger auf dem Speicherarchivmanager aufgezeichnet ist. Hat der Datenträger keinen Speicherarchivclient als Eigner, übergibt der Server das Eigentumsrecht an den Speicherarchivmanager.

SEARCH

Gibt an, ob der Server das Speicherarchiv nach Datenträgern durchsucht, die nicht zurückgestellt wurden. Dieser Parameter ist wahlfrei. Der Standardwert ist NO.

Einschränkungen:

• Geben Sie für SCSI-Kassettenarchive nicht CHECKLABEL=NO und einen der folgenden Parameter im selben Befehl an:
  • SEARCH=YES
  • SEARCH=BULK
  • SEARCH=ALL
• Wenn Sie SEARCH=NO angeben, muss das Band in den ersten Steckplatz der Eingangs-/Ausgangsports in einer SCSI-Bibliothek eingelegt werden. Wenn es in der Bibliothek keinen Eingangs-/Ausgangsanschluss gibt, muss das Band in den ersten Speicherschacht der Bibliothek eingelegt werden.
• Wenn Sie SEARCH=YES und VOLRange angeben, müssen alle Datenträger der gleichen Generation angehören. VOLRange unterstützt kein Mischmedium.

Gültige Werte:

No

Gibt an, dass nur der angegebene Datenträger in das Speicherarchiv zurückgestellt wird.

• Bei SCSI-Kassettenarchiven gibt der Server eine Anforderung aus, um den Datenträger in einen Kassettenschacht in dem Kassettenarchiv einzulegen oder, falls verfügbar, in einen Eingangsanschluss. Der Kassettenschacht oder Eingangsanschluss wird durch die Elementadresse identifiziert.
• Bei 349X-Kassettenarchiven kann sich der Datenträger möglicherweise bereits in dem Kassettenarchiv befinden, oder Sie können ihn bei entsprechender Aufforderung in die E/A-Station einlegen.

Yes

Gibt an, dass der Server das Speicherarchiv nach Datenträgern durchsucht, die zurückgestellt werden sollen.

Tipps:

• Sie können den Parameter VOLRANGE oder VOLLIST verwenden, um die Suche zu begrenzen.
• Wird das Speicherarchiv von Anwendungen gemeinsam genutzt, kann der Server einen Datenträger untersuchen, der von einer anderen Anwendung benötigt wird. Bei 349X-Speicherarchiven fragt der Server den Speicherarchivmanager nach allen Datenträgern ab, die der Kategorie SCRATCH oder PRIVATE und der Kategorie INSERT zugeordnet sind.

Bulk

Gibt an, dass der Server die Eingangs-/Ausgangsanschlüsse des Speicherarchivs nach Datenträgern durchsucht, die automatisch zurückgestellt werden können. Diese Option gilt nur für SCSI-Speicherarchive.

Tipp: Sie können den Parameter VOLRANGE oder VOLLIST verwenden, um die Suche einzugrenzen.

All

Gibt an, dass der Server sowohl die Speicherschacht des Kassettenarchivs als auch die Eingang-/Ausgang-Anschlüsse des Kassettenarchivs für Datenträger durchsucht, die automatisch eingecheckt werden können. Diese Option gilt nur für SCSI-Speicherarchive.

Tipps:

• Sie können den Parameter VOLRANGE oder VOLLIST verwenden, um die Suche zu begrenzen.
• Wird das Speicherarchiv von Anwendungen gemeinsam genutzt, kann der Server einen Datenträger untersuchen, der von einer anderen Anwendung benötigt wird. Bei 349X-Speicherarchiven fragt der Server den Speicherarchivmanager nach allen Datenträgern ab, die der Kategorie SCRATCH oder PRIVATE und der Kategorie INSERT zugeordnet sind.

VOLRange

Gibt einen Bereich von Datenträgernamen an, die durch Kommas voneinander getrennt sind. Mit diesem Parameter können Sie die Suche nach Datenträgern begrenzen, die eingecheckt werden sollen, wenn Sie SEARCH=YES (349X-, ACSLS- und SCSI-Kassettenarchive), SEARCH=BULK (nur SCSI-Kassettenarchive) oder SEARCH=ALL (nur SCSI-Kassettenarchive) angeben. Sind keine Datenträger in dem Speicherarchiv vorhanden, die sich in dem angegebenen Bereich befinden, wird der Befehl ohne Fehler beendet.

Einschränkung: Wenn Sie SEARCH=YES angeben und VOLRange spezifiziert ist, müssen alle Bände derselben Generation angehören. VOLRange unterstützt kein Mischmedium.

Geben Sie nur Datenträgernamen an, die numerisch erhöht werden können. Neben dem Bereich für den Erhöhungswert kann ein Datenträgername ein alphanumerisches Präfix und ein alphanumerisches Suffix enthalten.

Parameter	Beschreibung
volrange=bar110,bar130	Die 21 Datenträger werden zurückgestellt: bar110, bar111, bar112,...bar129, bar130.
volrange=bar11a,bar13a	Die 3 Datenträger werden zurückgestellt: bar11a, bar12a, bar13a.
volrange=123400,123410	Die 11 Datenträger werden zurückgestellt: 123400, 123401, ...123409, 123410.

VOLList

Gibt eine Liste mit Datenträgern an. Mit diesem Parameter können Sie die Suche nach Datenträgern begrenzen, die eingecheckt werden sollen, wenn Sie SEARCH=YES (349X-, ACSLS- und SCSI-Kassettenarchive), SEARCH=BULK (nur SCSI-Kassettenarchive) oder SEARCH=All (nur SCSI-Kassettenarchive) angeben. Sind in dem Speicherarchiv keine Datenträger vorhanden, die sich in der Liste befinden, wird der Befehl ohne Fehler beendet.

Gültige Werte:

volume_name

Gibt einen oder mehrere Datenträgernamen an, die durch Kommas und ohne Leerzeichen voneinander getrennt sind. Beispiel: VOLLIST=TAPE01,TAPE02.

FILE: Dateiname

Gibt den Namen einer Datei an, die eine Liste der Datenträger für den Befehl enthält. In der Datei muss sich jeder Datenträgername auf einer separaten Zeile befinden. Leerzeilen und Kommentarzeilen, die mit einem Stern beginnen, werden ignoriert. Um beispielsweise die Datenträger TAPE01, TAPE02 und TAPE03 zu verwenden, erstellen Sie die Datei TAPEVOL, die die folgenden Zeilen enthält:

TAPE01
TAPE02
TAPE03

Die Datenträger können für den Befehl wie folgt angegeben werden: VOLLIST=FILE:TAPEVOL.

Achtung: Beim Dateinamen muss die Groß-/Kleinschreibung beachtet werden.

CHECKLabel

Gibt an, wie oder ob der Server Kennsätze sequenzieller Datenträger lesen soll. Dieser Parameter ist wahlfrei. Der Standardwert ist YES.

Gültige Werte:

Yes

Gibt an, dass während des Zurückstellens versucht wird, den Datenträgerkennsatz zu lesen.

Achtung:

1. Bei SCSI-Kassettenarchiven können Sie CHECKLABEL=NO nur angeben, wenn SEARCH dem Wert NO entspricht.
2. Für andere WORM-Datenträger als 3592 müssen Sie YES angeben.

No

Gibt an, dass der Datenträgerkennsatz während des Zurückstellens nicht gelesen wird. Das Unterdrücken der Kennsatzprüfung kann jedoch später zu Fehlern führen (z. B. kann ein falscher Kennsatz oder ein nicht richtig gekennzeichneter Datenträger Fehler verursachen). Geben Sie für 349X- und ACSLS-Speicherarchive NO an, um das Laden von Kassetten in ein Laufwerk zum Lesen des Datenträgerkennsatzes zu vermeiden. Diese Speicherarchive geben immer die externen Kennsatzinformationen zu Kassetten zurück und IBM Storage Protect verwendet diese Informationen.

Barcode

Gibt an, dass der Server das Barcodeetikett liest, wenn das Speicherarchiv über einen Barcodeleser verfügt und die Datenträger externe Barcodeetikett haben. Die Zeit für das Zurückstellen kann durch die Verwendung des Barcodes verkürzt werden. Dieser Parameter gilt nur für SCSI-Speicherarchive.

Kann der Barcodeleser das Barcodeetikett nicht lesen oder verfügt das Band über kein Barcodeetikett, lädt der Server das Band und liest den internen Kennsatz.

DEVType

Gibt den Einheitentyp des Datenträgers an, der zurückgestellt wird. Dieser Parameter ist erforderlich, wenn keines der Laufwerke in diesem Speicherarchiv über definierte Pfade verfügt.

3590

Gibt an, dass der Einheitentyp des Datenträgers, der zurückgestellt wird, 3590 ist.

3592

Gibt an, dass der Einheitentyp des Datenträgers, der zurückgestellt wird, 3592 ist.

SWAP

Gibt an, ob der Server Datenträger auslagert, wenn kein leerer Speicherarchivschacht verfügbar ist. Der für die Auslagerungsoperation ausgewählte Datenträger (Zielauslagerungsdatenträger) wird aus dem Speicherarchiv ausgegeben und durch den zurückgestellten Datenträger ersetzt. Der Server identifiziert einen Zielauslagerungsdatenträger, indem nach einem verfügbaren Arbeitsdatenträger gesucht wird. Ist keiner vorhanden, identifiziert der Server den am wenigsten geladenen Datenträger.

Dieser Parameter ist wahlfrei. Der Standardwert ist NO. Dieser Parameter ist nur gültig, wenn in dem Befehl ein Datenträgername angegeben ist. Gültige Werte:

No

Gibt an, dass der Server den Datenträger nur zurückstellt, wenn ein leerer Schacht verfügbar ist.

Yes

Gibt an, dass der Server Kassetten auslagert, um den Datenträger zurückzustellen, wenn kein leerer Schacht verfügbar ist.

WAITTime

Gibt die Anzahl Minuten an, die der Server auf Ihre Antwort auf eine Anforderung wartet. Geben Sie einen Wert im Bereich 0-9999 an. Möchten Sie vom Server zur Eingabe aufgefordert werden, geben Sie eine Wartezeit größer als Null an. Der Standardwert ist 60 Minuten. Angenommen, Sie werden vom Server aufgefordert, ein Band in den Eingangs-/Ausgangsanschluss eines Speicherarchivs einzulegen. Haben Sie eine Wartezeit von 60 Minuten angegeben, gibt der Server eine Anforderung aus und wartet 60 Minuten auf Ihre Antwort. Angenommen, Sie geben eine Wartezeit von 0 an. Wenn Sie bereits ein Band eingefügt haben, führt eine Wartezeit von null dazu, dass die Operation ohne Aufforderung fortgesetzt wird. Haben Sie kein Band eingelegt, hat eine Wartezeit mit dem Wert Null zur Folge, dass die Operation fehlschlägt.

CLEanings

Den empfohlenen Wert für die einzelne Reinigungskassette eingeben (ist normalerweise auf der Kassette angegeben). Reinigungen gelten nur für SCSI-Speicherarchive. Dieser Parameter ist bei der Angabe von STATUS=CLEANER erforderlich.

Werden mehrere Reinigungskassetten in das Speicherarchiv zurückgestellt, wird nur eine Reinigungskassette verwendet, bis ihr Wert für den Parameter CLEANINGS den Wert Null erreicht hat. Anschließend wird eine andere Reinigungskassette ausgewählt, und die erste Reinigungskassette kann entnommen und entsorgt werden.

Zugehörige Befehle