QUERY SCRIPT ( IBM Storage Protect -Scripts abfragen)

Mit diesem Befehl können Informationen über Prozeduren angezeigt werden.

Dieser Befehl kann mit dem Befehl DEFINE SCRIPT verwendet werden, um eine neue Prozedur unter Verwendung des Inhalts aus einer anderen Prozedur zu erstellen.

Berechtigungsklasse

Die für diesen Befehl erforderliche Berechtigungsklasse hängt davon ab, ob der Parameter Outputfile im Befehl angegeben ist.

Ist der Parameter Outputfile nicht angegeben, kann jeder Administrator diesen Befehl ausgeben.
Ist der Parameter Outputfile angegeben und ist die Serveroption REQSYSAUTHOUTFILE auf YES gesetzt, muss der Administrator die Systemberechtigung haben.
Ist der Parameter Outputfile angegeben und ist die Serveroption REQSYSAUTHOUTFILE auf NO gesetzt, muss der Administrator die Bedienerberechtigung, die Maßnahmenberechtigung, die Speicherberechtigung oder die Systemberechtigung haben.

Syntax

Parameter

Prozedurname

Gibt den Namen der Prozedur an, für die Informationen angezeigt werden sollen. Es kann ein Platzhalterzeichen verwendet werden, um diesen Namen anzugeben.

Wichtig: Wenn Sie kein Script angeben, zeigt die Abfrage Informationen zu allen Scripts an. Die zur Verarbeitung dieses Befehls erforderliche Zeit und der Umfang der angezeigten Informationen kann sehr umfangreich sein.

Format

Gibt das Ausgabeformat für die Anzeige der Prozedurinformationen an. Der Standardwert ist STANDARD. Gültige Werte:

Standard: Gibt an, daß nur der Prozedurname und die Beschreibung in einer Prozedur angezeigt werden.
Detailed: Gibt an, daß ausführliche Informationen über die Prozedur angezeigt werden. Diese Informationen enthalten die Befehle in der Prozedur und ihre Zeilennummern, das Datum der letzten Aktualisierung und den Administrator, der die Aktualisierungen ausgeführt hat.
Lines: Gibt an, daß der Prozedurname, die Zeilennummer der Befehle, die Kommentarzeilen und die Befehle in der Prozedur angezeigt werden.
Raw: Gibt an, dass die in der Prozedur enthaltenen Befehle in eine Datei geschrieben werden, die mit dem Parameter Outputfile angegeben wird. Dieses Format ist eine Möglichkeit, die Ausgabe eines Scripts an eine Datei zu übertragen, damit sie mit dem Befehl DEFINE SCRIPT in ein anderes Script kopiert werden kann.
Wenn keine Ausgabedatei angegeben wird, gibt der IBM® Storage Protect -Server das Abfragescript mit "format = raw" an der Konsole aus.

Outputfile

Gibt den Namen der Datei an, in die die Ausgabe umgeleitet wird, wenn FORMAT=Raw angegeben wird. Die angegebene Datei muss sich auf dem Server befinden, der diesen Befehl ausführt. Ist die Datei vorhanden, wird die Abfrageausgabe an das Ende der Datei angehängt.

Beispiel: Die Prozedurbeschreibungen auflisten

Die Standardinformationen über Prozeduren anzeigen.

query script *

Name             Description
---------------  ----------------------------------------------------
QCOLS            Display columns for a specified SQL table
QSAMPLE          Sample SQL Query
EXAMPLE          Backup the store pools and database when no sessions

Beispiel: Den Inhalt einer Prozedur mit Zeilennummern anzeigen

Die Zeilen mit Informationen für die Prozedur Q_AUTHORITY anzeigen.

query script q_authority format=lines

Name         Line    Command                                          
             Number  
----------   ------  -------------------------------------------------
Q_AUTHORITY  1       /* ------------------------------------------*/  
             5       /* Script Name:  Q_AUTHORITY                 */  
             10      /* Description: Display administrators that  */  
             15      /*              have the authority to issue  */  
             20      /*              commands requiring a         */  
             25      /*              specific privilege.          */  
             30      /* Parameter 1: privilege name - in the form */  
             35      /*              x_priv - EX. policy_priv     */  
             40      /* Example:  run q_authority storage_priv    */  
             45      /* ------------------------------------------*/  
             50      select admin_name from admins where -            
             55        upper(system_priv) <> 'NO' or -             
             60        upper($1) <> 'NO'

Beispiel: Eine Prozedur aus einer vorhandenen Prozedur erstellen

Die Prozedur ENGDEV abfragen und die Ausgabe in die Datei MY.SCRIPT umleiten.

query script engdev format=raw outputfile=my.script

Beispiel: Ausführliche Informationen zur Prozedur anzeigen

Ausführliche Informationen zu Prozeduren anzeigen. Für Feldbeschreibungen siehe Feldbeschreibungen .

query script * format=detailed

                          Name: QCOLS
                   Line Number: DESCRIPTION
                       Command: Display columns for a specified SQL
                                table
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 12/02/1997 16:05:29
 
                          Name: QCOLS
                   Line Number: 1
                       Command: select colname from columns where 
                                tabname='$1'
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 12/02/1997 16:05:29

Feldbeschreibungen

Name: Der Name der Prozedur.
Line Number: Die Zeilennummer der Prozedur oder die Zeichenfolge DESCRIPTION.
Command: Der Befehl in der Zeile, die im vorherigen Feld angezeigt wurde.
Last Update by (administrator): Der Name des Administrators, der die Prozedur definiert oder zuletzt aktualisiert hat.
Last Update Date/Time: Das Datum und die Uhrzeit, an dem bzw. zu der der Administrator die Prozedur definiert oder aktualisiert hat.

Zugehörige Befehle

Tabelle 1. Zugehörige Befehle für QUERY SCRIPT
Befehl	Beschreibung
SCRIPT KOPIEREN	Erstellt eine Kopie einer Prozedur.
DEFINE SCRIPT	Definiert ein Script für den IBM Storage Protect-Server.
DELETE SCRIPT	Löscht eine Prozedur oder einzelne Zeilen aus einer Prozedur.
SCRIPT UMBENENNEN	Vergibt einen neuen Namen für eine Prozedur.
AUSFUEHREN	Führt ein Script aus
UPDATE SCRIPT	Ändert Zeilen oder fügt Zeilen in einer Prozedur hinzu.