SHOW-PARTITIONS

Informationen über die logische Verfügbarkeit von Partitionen einer partitionierten Tabelle ausgeben

Geltungsbereich

DBH-Administration

Siehe auch

Administrationsanweisung REUSE-PARTITIONS

Funktionsbeschreibung

Mit der Anweisung SHOW-PARTITIONS geben Sie den Verfügbarkeitsstatus aller Partitionen einer geöffneten partitionierten Tabelle aus.

Für jede eingerichtete Partition wird (aufsteigend nach der Partitionsnummer) eine Informationszeile mit folgendem Inhalt ausgegeben:

• Nummer der Partition

• Spacename

• Status:

  • AVAILABLE (Partition ist logisch verfügbar)

  • NOT AVAILABLE (Partition ist logisch nicht verfügbar)
    Dieser Status wird auch dann ausgegeben, wenn der Zugriff auf die Partition nur bedingt möglich ist, z.B. wenn sich der Space im Zustand "copy pending" befindet.

• Zusätzliche Informationen:
  Hier wird z.B. der SQL-State oder der DVS-Fehlercode ausgegeben, falls die Partition aus bekannten Gründen nicht verfügbar ist.

In der laufenden DBH-Session können Sie die logische Verfügbarkeit von Partitionen mit der Administrationsanweisung REUSE-PARTITIONS (siehe "REUSE-PARTITIONS") wieder herstellen. Weitere Informationen zu Partitionen finden Sie im " Basishandbuch".

SHOW-PARTITIONS

CATALOG-NAME = <filename 1..18 without-cat-user-gen-vers>
,SCHEMA-NAME = <c-string 1..31 with-lower-case>
,TABLE-NAME = <c-string 1..31 with-lower-case>
,STRUCTURE-OUTPUT = *NONE / *SYSINF / <structured-name 1..20>(...)
	<structured-name 1..20>(...)
		|	WRITE-MODE = *REPLACE / *EXTEND

Operandenbeschreibung

CATALOG-NAME = <filename 1..18 without-cat-user-gen-vers>

Logischer Datenbankname der Datenbank.

SCHEMA-NAME = <c-string 1..31 with-lower-case>
Name des Schemas der Basistabelle.

TABLE-NAME = <c-string 1..31 with-lower-case>
Name der Basistabelle.

STRUCTURE-OUTPUT = *NONE / *SYSINF / <structured-name 1..20>

(WRITE-MODE = *REPLACE / *EXTEND)

Gibt in S-Prozeduren an, ob die Informationsausgabe in S-Variablen erfolgen soll (siehe Abschnitt „Syntax für die Ausgabe in S-Variablen“).

Ausgabe in S-Variablen

Ausgabe-Information	Name der S-Variablen	T	Inhalt
Nummer der Partition	var(*LIST).PARTITION	S	<integer 1..16>
Spacename	var(*LIST).SPACE	S	<filename 1..18>
Status der Partition	var(*LIST).STATE	S	AVAILABLE / NOT AVAILABLE
Zusätzliche Informationen	var(*LIST).INFORMATION	S	SQL-STATE: xxxxx / DMS-ERROR: xxxx / CC-NUMBER: xx/xx/xx / '' (leer)

Beispiel

Bildschirmausgabe nach Eingabe der Administrationsanweisung SHOW-PARTITIONS:

%SHOW-PARTITIONS CAT=CAT-1,SCHEMA='SCH-1',TABLE='TAB-1'
-------------------------------------------------------------------------- 
 NUMBER ! SPACE-NAME         ! STATUS        ! INFO 
-------------------------------------------------------------------------- 
      2 ! TABLESPACE         ! AVAILABLE     ! 
      3 ! TABLESP002         ! AVAILABLE     ! 
      9 ! TABLESP003         ! NOT AVAILABLE ! SQL-State: 81SA6 
%  <date> <time> SES7215 END OF OUTPUT 
%// 

Administrationskommando im ISP-Format und an der CALL-DML-Schnittstelle

Hier entspricht der Administrationsanweisung SHOW-PARTITIONS das Administrationskommando PARTITION,INF.

PARTITION,INF,C[ATALOG]=name,S[CHEMA]=name,T[ABLE]=name

Für name dürfen jeweils die zuvor bei den entsprechenden Operanden beschriebenen Werte eingegeben werden.