\item [list]
\index[console]{list}
- The list command lists the requested contents of the Catalog. The
- various fields of each record are listed on a single line. The various
- forms of the list command are:
+ Das list-Kommando zeigt den angegebenen Inhalt der Katalog-Datenbank an.
+ Die verschiedenen Felder jedes Eintrags werden in einer Zeile ausgegeben.
+ Die verschiedenen M\"{o}glichkeiten sind:
\footnotesize
\begin{verbatim}
list jobs
- list jobid=<id> (list jobid id)
+ list jobid=<id> (zeigt jobid <id> an)
- list ujobid<unique job name> (list job with unique name)
+ list ujobid<unique job name> (zeigt den job mit dem Namen <unique job name> an)
- list job=<job-name> (list all jobs with "job-name")
+ list job=<job-name> (zeigt alle Jobs mit dem Namen <job-name> an)
- list jobname=<job-name> (same as above)
+ list jobname=<job-name> (identisch mit dem oberen)
- In the above, you can add "limit=nn" to limit the output to
- nn jobs.
+ Im oberen Beispiel k\"{o}nnen Sie auch den Parameter limit=nn
+ hinzuf\"{u}gen, um die Ausgabe des Kommandos auf nn Jobs zu begrenzen
list jobmedia
\end{verbatim}
\normalsize
- What most of the above commands do should be more or less obvious. In
- general if you do not specify all the command line arguments, the
- command will prompt you for what is needed.
-
- The {\bf list nextvol} command will print the Volume name to be used by
- the specified job. You should be aware that exactly what Volume will be
- used depends on a lot of factors including the time and what a prior job
- will do. It may fill a tape that is not full when you issue this
- command. As a consequence, this command will give you a good estimate
- of what Volume will be used but not a definitive answer. In addition,
- this command may have certain side effect because it runs through the
- same algorithm as a job, which means it may automatically purge or
- recycle a Volume. By default, the job specified must run within the
- next two days or no volume will be found. You can, however, use the
- {\bf days=nnn} specification to specify up to 50 days. For example,
- if on Friday, you want to see what Volume will be needed on Monday,
- for job MyJob, you would use {\bf list nextvol job=MyJob days=3}.
-
- If you wish to add specialized commands that list the contents of the
- catalog, you can do so by adding them to the {\bf query.sql} file.
- However, this takes some knowledge of programming SQL. Please see the
- {\bf query} command below for additional information. See below for
- listing the full contents of a catalog record with the {\bf llist}
- command.
-
- As an example, the command {\bf list pools} might produce the following
- output:
+ Die meisten der oben genannten Parameter sollten selbsterkl\"{a}rend sein.
+ \"{U}blicherweise werden Sie, falls Sie nicht gen\"{u}gend Parameter angeben,
+ von der Console nach den fehlenden Informationen gefragt.
+
+ Das {\bf list nextvol}-Kommando gibt den Volume-Namen aus, der von dem angegebenen Job
+ beim n\"{a}chsten Backup benutzt werden wird. Allerdings sollten Sie beachten, dass
+ das tats\"{a}chlich benutzte Volume von einer Reihe von Faktoren, wie zum Beispiel
+ von den vorher laufenden Jobs oder der Zeit wann der Job l\"{a}uft, abh\"{a}ngen kann.
+ Eventuell wird ein Tape schon voll sein, das aber noch freien Platz hatte, als Sie
+ das Kommando ausf\"{u}hrten. Dieses Kommando gibt Ihnen also nur einen Hinweis darauf,
+ welches Tape benutzt werden k\"{o}nnte, aber es kann keine definitive Aussage dar\"{u}ber treffen.
+ Zus\"{a}tzlich kann dieses Kommando mehrere Seiteneffekte haben, da es den selben
+ Algorithmus durchl\"{a}uft, wie ein echter Backup-Job. Das bedeutet, dass es dazu f\"{u}hren kann,
+ dass aufgrund dieses Kommandos Volumes automatisch recycled oder gelöscht (purged) werden.
+ Standardm\"{a}{\ss}ig muss der angegebene Job innerhalb der n\"{a}chsten zwei Tage laufen,
+ ansonsten wird kein Volume f\"{u}r den Job gefunden. Allerdings k\"{o}nnen Sie durch Angabe des Parameters
+ {\bf days=nnn} bis zu 50 Tage in die Zukunft angeben, die das Kommando in die Berechnung
+ mit einbeziehen soll. Falls Sie, zum Beispiel, Freitags sehen wollen, welches Volume am Montag
+ vorrausssichtlich benutzt wird, k\"{o}nnen Sie folgendes Kommando benutzen:
+ {\bf list nextvol job=MyJob days=3}.
+
+ Wenn Sie bestimmte, von Ihnen \"{o}fter ben\"{o}tigte, eigene Kommandos anlegen wollen
+ um sich bestimmte Inhalte der Katalog-Datenbank anzeigen zu lassen,
+ k\"{o}nnen Sie diese der Datei {\bf query.sql} hinzu\"{u}gen. Allerdings
+ erfordert das einiges an Wissen \"{u}ber SQL-Kommandos. Lesen Sie dazu bitte
+ den Abschnitt \"{u}ber das {\bf query}-Kommando in diesem Kapitel.
+
+ Weiter unten finden Sie auch eine Beispiel-Ausgabe des {\bf llist}-Kommandos,
+ das Ihnen den kompletten Inhalt des Katalogs zu einem bestimmten Konfigurations-Eintrag
+ anzeigt.
+
+ Als ein Beispiel, kann Ihnen der Aufruf des Kommandos {\bf list pools} die folgenden
+ Ausgaben anzeigen:
\footnotesize
\begin{verbatim}