Übersicht (Befehl OUTPUT OPEN)

Die OUTPUT -Befehle (OUTPUT NEW, OUTPUT NAME, OUTPUT ACTIVATE, OUTPUT OPEN, OUTPUT SAVE, OUTPUT CLOSE) bieten die Möglichkeit, ein oder mehrere Ausgabedokumente programmgesteuert zu verwalten. Diese Funktionen ermöglichen Ihnen Folgendes:

  • Speichern Sie ein Ausgabedokument über die Syntax.
  • Partitionieren Sie die Ausgabe programmgesteuert in separate Ausgabedokumente (z. B. Ergebnisse für Männer in einem Ausgabedokument und Ergebnisse für Frauen in einem separaten Ausgabedokument).
  • Mit mehreren geöffneten Ausgabedokumenten in einer bestimmten Sitzung arbeiten und selektiv neue Ergebnisse an das entsprechende Dokument anhängen.

Der Befehl OUTPUT OPEN öffnet ein Viewer-Dokument, das zum designierten Ausgabedokument wird. Mit OUTPUT OPEN können Sie die Ausgabe an ein vorhandenes Ausgabedokument anhängen. Nach dem Öffnen wird die nachfolgende Prozedurausgabe an das Dokument übertragen, bis es geschlossen oder ein anderes Ausgabedokument erstellt, geöffnet oder aktiviert wird.

Basisspezifikation

Die Basisspezifikation für OUTPUT OPEN ist der Befehlsname gefolgt von einer Dateispezifikation für die zu öffnende Datei.

Schlüsselwort NAME

Das neu geöffnete Ausgabedokument erhält standardmäßig einen eindeutigen Namen. Sie können optional einen benutzerdefinierten Namen für das Ausgabedokument angeben und den Standardnamen überschreiben. Der Dokumentname wird verwendet, um in allen nachfolgenden OUTPUT ACTIVATE-, OUTPUT SAVE-und OUTPUT CLOSE -Befehlen auf das Dokument zu verweisen.

  • Der angegebene Name muss den Namensregeln für Variablen entsprechen. Weitere Informationen finden Sie im Thema Variablennamen .
  • Wenn der angegebene Name einem anderen Dokument zugeordnet ist, wird diese Zuordnung unterbrochen und der Name dem neu geöffneten Dokument zugeordnet. Dem Dokument, das zuvor dem angegebenen Namen zugeordnet war, wird ein neuer eindeutiger Name zugeordnet.

Schlüsselwort LOCK

Das Schlüsselwort LOCK gilt nur, wenn eine Datei aus einem IBM® SPSS® Collaboration and Deployment Services Repositorygeöffnet wird. Sie gibt an, ob die Datei beim Öffnen gesperrt ist (im Repository). Das Sperren einer Datei verhindert, dass sie von anderen Benutzern geändert wird, während Sie damit arbeiten. Andere Benutzer können gesperrte Dateien öffnen, aber nicht im Repository speichern. Die Sperre wird aufgehoben, wenn die Datei geschlossen wird oder die aktuelle Sitzung beendet wird.

  • Standardmäßig werden Dateien als gesperrt geöffnet.
  • Das Schlüsselwort LOCK wird ignoriert, wenn sich die angegebene Datei nicht in einem IBM SPSS Collaboration and Deployment Services Repositorybefindet.

Weitere Informationen finden Sie im Abschnitt Dateispezifikationen für IBM SPSS Collaboration and Deployment Services Repository -Objekte .

password, Schlüsselwort

Das Schlüsselwort PASSWORD gibt das Kennwort an, das zum Öffnen einer verschlüsselten Ausgabedatei von IBM SPSS Statistics erforderlich ist. Der angegebene Wert muss in Anführungszeichen eingeschlossen werden und kann verschlüsselt oder als Klartext angegeben werden. Verschlüsselte Kennwörter werden beim Einfügen von Befehlssyntax aus dem Dialogfeld "Ausgabe speichern unter" erstellt. Das Schlüsselwort PASSWORD wird ignoriert, wenn die Datei nicht verschlüsselt ist.

Syntaxregeln

  • Wenn ein Schlüsselwort mehrmals angegeben wird, tritt ein Fehler auf.
  • Schlüsselwörter müssen vollständig geschrieben werden.
  • Die im Syntaxdiagramm verwendeten Gleichheitszeichen (=) sind erforderliche Elemente.

Operationen

  • Das Ausgabedokument wird in einem Fenster in der Benutzerschnittstelle geöffnet und wird zum festgelegten Ausgabefenster.
  • Es tritt ein Fehler auf, aber die Verarbeitung wird fortgesetzt, wenn die angegebene Datei nicht gefunden wird. Die Ausgabe wird weiterhin an das zuletzt angegebene Ausgabedokument übertragen.
  • Es tritt ein Fehler auf, aber die Verarbeitung wird fortgesetzt, wenn die angegebene Datei kein Viewer-Dokument ist. Die Ausgabe wird weiterhin an das zuletzt angegebene Ausgabedokument übertragen.
  • OUTPUT OPEN berücksichtigt Dateikennungen und Änderungen am Arbeitsverzeichnis, die mit dem Befehl CD vorgenommen wurden.

Einschränkungen

  • Da für jedes Fenster eine minimale Speicherkapazität erforderlich ist, gibt es eine Begrenzung für die Anzahl der Fenster, IBM SPSS Statistics , die auf einem bestimmten System gleichzeitig geöffnet sein können. Die bestimmte Anzahl hängt von den Spezifikationen Ihres Systems ab und kann aufgrund von Einschränkungen des Betriebssystems unabhängig vom Gesamtspeicher sein.
  • OUTPUT OPEN wird in IBM SPSS Statistics Batch Facility (verfügbar mit IBM SPSS Statistics Server) nicht unterstützt.

Beispiel

OUTPUT OPEN FILE='/examples/output/Q1Output.spv'.
GET FILE='/examples/data/March.sav'.
FREQUENCIES VARIABLES=ALL.
OUTPUT SAVE OUTFILE='/examples/output/Q1Output.spv'.
  • OUTPUT OPEN öffnet das Viewer-Dokument /examples/output/Q1Output.spv. Das Dokument enthält Zusammenfassungen für die Monate Januar und Februar.
  • Der Befehl GET öffnet eine Datei mit Daten für den Monat März.
  • Der Befehl FREQUENCIES erzeugt Zusammenfassungen für Märzdaten, die an das angegebene Ausgabedokument angehängt werden.
  • OUTPUT SAVE speichert das angegebene Ausgabedokument in /examples/output/Q1Output.spv. Das gespeicherte Dokument enthält Ergebnisse für jeden der drei Monate im ersten Quartal.