Présentation (commande OUTPUT OPEN)

Les commandes OUTPUT (OUTPUT NEW, OUTPUT NAME, OUTPUT ACTIVATE, OUTPUT OPEN, OUTPUT SAVE, OUTPUT CLOSE) permettent de gérer un ou plusieurs documents de sortie à l'aide d'un programme. Ces fonctions vous permettent d'effectuer les opérations suivantes:

  • Sauvegardez un document de sortie à l'aide de la syntaxe.
  • Partitionnez à l'aide d'un programme la sortie dans des documents de sortie distincts (par exemple, les résultats pour les hommes dans un document de sortie et les résultats pour les femmes dans un document distinct).
  • Utilisez plusieurs documents de sortie ouverts dans une session donnée, en ajoutant de manière sélective de nouveaux résultats au document approprié.

La commande OUTPUT OPEN ouvre un document du visualiseur qui devient le document de sortie désigné. Vous pouvez utiliser OUTPUT OPEN pour ajouter une sortie à un document de sortie existant. Une fois ouverte, la sortie de la procédure suivante est dirigée vers le document jusqu'à sa fermeture ou jusqu'à ce qu'un autre document de sortie soit créé, ouvert ou activé.

Spécification de base

La spécification de base pour OUTPUT OPEN est le nom de commande suivi d'une spécification de fichier pour le fichier à ouvrir.

mot-clé NAME (NOM)

Par défaut, le document de sortie nouvellement ouvert est fourni avec un nom unique. Vous pouvez éventuellement spécifier un nom personnalisé pour le document de sortie, en remplaçant le nom par défaut. Le nom du document est utilisé pour faire référence au document dans les commandes OUTPUT ACTIVATE, OUTPUT SAVEet OUTPUT CLOSE suivantes.

  • Le nom spécifié doit être conforme aux règles de dénomination des variables. Pour plus d'informations, voir la rubrique Noms des variables .
  • Si le nom spécifié est associé à un autre document, cette association est rompue et le nom est associé au document nouvellement ouvert. Un nouveau nom unique est affecté au document précédemment associé au nom spécifié.

Mot clé LOCK

Le mot clé LOCK s'applique uniquement lors de l'ouverture d'un fichier à partir d'un IBM® SPSS® Collaboration and Deployment Services Repository. Indique si le fichier est verrouillé (dans le référentiel) lors de son ouverture. Le verrouillage d'un fichier empêche les autres utilisateurs de le modifier lorsque vous l'utilisez. D'autres utilisateurs peuvent ouvrir des fichiers verrouillés, mais ils ne peuvent pas les sauvegarder dans le référentiel. Le verrou est libéré à la fermeture du fichier ou à la fin de la session en cours.

  • Par défaut, les fichiers sont ouverts comme verrouillés.
  • Le mot clé LOCK est ignoré si le fichier spécifié ne réside pas dans un IBM SPSS Collaboration and Deployment Services Repository.

Pour plus d'informations, voir la rubrique File Specifications for IBM SPSS Collaboration and Deployment Services Repository Objects .

mot clé password

Le mot clé PASSWORD indique le mot de passe requis pour ouvrir un fichier de sortie IBM SPSS Statistics chiffré. La valeur spécifiée doit être placée entre guillemets et peut être fournie sous forme chiffrée ou sous forme de texte en clair. Les mots de passe chiffrés sont créés lors du collage de la syntaxe de commande à partir de la boîte de dialogue Enregistrer la sortie sous. Le mot clé PASSWORD est ignoré si le fichier n'est pas chiffré.

Règles de syntaxe

  • Une erreur se produit si un mot clé est indiqué plusieurs fois.
  • Les mots clés doivent être orthographiés en entier.
  • Les signes égal (=) utilisés dans le graphique de syntaxe sont des éléments obligatoires.

Opérations

  • Le document de sortie est ouvert dans une fenêtre de l'interface utilisateur et devient la fenêtre de sortie désignée.
  • Une erreur se produit, mais le traitement se poursuit si le fichier indiqué est introuvable. La sortie continue d'être dirigée vers le dernier document de sortie désigné.
  • Une erreur se produit, mais le traitement se poursuit si le fichier spécifié n'est pas un document du visualiseur. La sortie continue d'être dirigée vers le dernier document de sortie désigné.
  • OUTPUT OPEN respecte les descripteurs de fichier et les modifications apportées au répertoire de travail à l'aide de la commande CD .

Limites

  • Etant donné que chaque fenêtre requiert une quantité minimale de mémoire, il existe une limite au nombre de fenêtres, IBM SPSS Statistics ou autre, pouvant être ouvertes simultanément sur un système donné. Ce nombre dépend des spécifications de votre système et peut être indépendant de la mémoire totale en raison des contraintes du système d'exploitation.
  • OUTPUT OPEN n'est pas pris en charge dans IBM SPSS Statistics Batch Facility (disponible avec IBM SPSS Statistics Server).

Exemple

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 ouvre le document du visualiseur /examples/output/Q1Output.spv. Le document contient des résumés pour les mois de janvier et février.
  • La commande GET ouvre un fichier contenant les données du mois de mars.
  • La commande FREQUENCIES génère des récapitulatifs pour les données de mars, qui sont ajoutés au document de sortie désigné.
  • OUTPUT SAVE sauvegarde le document de sortie désigné dans /examples/output/Q1Output.spv. Le document sauvegardé contient les résultats pour chacun des trois mois du premier trimestre.