DSPSPLF

Afficher un fichier spoule

En bref

La commande DSPSPLF (Afficher un fichier spoule) permet d'afficher les enregistrements du fichier spoule indiqué.

DSPSPLF se lit DSP (Afficher) + SPLF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPSPLF FILE(…)

Paramètres

FILE Fichier spoule obligatoire
JOB Travail
SPLNBR Numéro de fichier spoule
JOBSYSNAME Nom de système de travail
CRTDATE Fichier spoule créé
FOLD Enregistrements multilignes

Astuce : dans une session 5250, tapez DSPSPLF puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande DSPSPLF (Afficher un fichier spoule) permet d'afficher les enregistrements du fichier spoule indiqué. Le contenu en cours du fichier (enregistrements) peut être affiché chaque fois qu'un poste correspondant au fichier spoule est placé dans la file d'attente en sortie. L'écran propose diverses fonctions permettant d'afficher différentes parties du fichier et de rechercher une chaîne de caractères spécifique.

La fonction de table SYSTOOLS.SPOOLED_FILE_DATA renvoie des informations similaires.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier spoule	Nom	Obligatoire, positionnel 1
JOB	Travail	Valeurs uniques: * Autres valeurs: Nom de travail qualifié	Facultatif, positionnel 2
	Qualificatif 1: Travail	Nom
	Qualificatif 2: Utilisat	Nom
	Qualificatif 3: Numéro	000000-999999
SPLNBR	Numéro de fichier spoule	1-999999, ONLY, LAST, *ANY	Facultatif, positionnel 3
JOBSYSNAME	Nom de système de travail	Nom, ONLY, CURRENT, *ANY	Facultatif
CRTDATE	Fichier spoule créé	Valeurs uniques: ONLY, LAST Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Date de création	Date
	Élément 2: Heure de création	Heure, ONLY, LAST
FOLD	Enregistrements multilignes	NO, YES	Facultatif

Fichier spoule (FILE)

Indique le fichier spoule dont les enregistrements doivent être affichés.

Ce paramètre est obligatoire.

nom: Indiquez le nom du fichier spoule à afficher.

Travail (JOB)

Indique le nom du travail ayant créé le fichier spoule dont les enregistrements doivent être affichés.

Valeurs uniques

*: Cette commande a été émise par le travail qui a créé le fichier spoule.

Qualificatif 1 : Travail

nom: Indiquez le nom du travail ayant créé le fichier spoule.

Qualificatif 2 : Utilisat

nom: Indiquez le nom d'utilisateur qui identifie le profil utilisateur sous lequel le travail est exécuté.

Qualificatif 3 : Numéro

000000-999999: Indiquez le numéro de travail attribué par le système.

Numéro de fichier spoule (SPLNBR)

Indique le numéro du fichier spoule qui doit être affiché.

*ONLY: Un seul fichier spoule du travail porte le nom indiqué ; il n'est donc pas nécessaire de préciser son numéro.

*LAST: Le fichier spoule avec le nom indiqué et dont le numéro est le plus élevé est utilisé.

*ANY: Le numéro du fichier spoule n'est pas utilisé pour déterminer le fichier spoule en cours d'utilisation. Utilisez cette valeur pour donner la priorité au paramètre du nom du système de travail ou à celui de la date et heure de création du fichier spoule par rapport au le numéro de ce dernier lors de la sélection d'un fichier spoule.

1-999999: Indiquez le numéro du fichier spoule portant le nom indiqué dont les enregistrements doivent être affichés.

Nom de système de travail (JOBSYSNAME)

Indique le système où s'exécute le travail ayant créé le fichier spoule (paramètre JOB). Ce paramètre est considéré après que les conditions des paramètres nom du travail, de l'utilisateur, numéro du travail, nom et numéro du fichier spoule sont satisfaites.

*ONLY: Il y a un fichier spoule correspondant aux noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, date et heure de création de fichier spoule précisés.
*CURRENT: Le fichier spoule, créé sur le système en cours, avec ce nom de travail, d'utilisateur, ce numéro de travail, ce nom et numéro de fichier spoule, ces date et heure de création de fichier spoule, est utilisé.
*ANY: Le nom du système de travail n'est pas utilisé pour déterminer le fichier spoule en cours d'utilisation. Utilisez cette valeur pour donner la priorité au paramètre de date et heure de création du fichier spoule par rapport au nom du système de travail lors de la sélection d'un fichier spoule.
nom: Indiquez le nom du système où s'exécute le travail ayant créé le fichier spoule.

Fichier spoule créé (CRTDATE)

Indique la date et l'heure de création du fichier spoule. Ce paramètre est considéré après que les conditions des paramètres nom du travail, de l'utilisateur, numéro du travail, nom et numéro du fichier spoule et nom du système de travail sont satisfaites.

Valeurs uniques

*ONLY: Il y a un fichier spoule correspondant à ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule et nom du système de travail précisés.
*LAST: Le fichier spoule, correspondant à la dernière date et heure de création de ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule et nom du système de travail précisés, est utilisé.

Elément 1 : Date de création

date: Indiquez la date de création du fichier spoule.

Elément 2 : Heure de création

*ONLY: Il y a un fichier spoule correspondant à ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, nom du fichier de travail et date de création de fichier spoule précisés.
*LAST: Le fichier spoule, correspondant à la dernière heure de création de ces noms de travail, d'utilisateur, numéro de travail, nom et numéro de fichier spoule, nom du système de travail et date de création de fichier spoule précisés, est utilisé.
heure: Indiquez l'heure de création du fichier spoule.

Enregistrements multilignes (FOLD)

Indique si les enregistrements du premier écran continuent sur la ligne suivante s'ils dépassent la longueur de la ligne d'affichage.

*NO: Les enregistrements ne sont pas multilignes. Lorsque la longueur de l'enregistrement dépasse une ligne, les positions excédentaires ne sont pas affichées.
*YES: Le premier écran affiche le premier enregistrement sur une ou plusieurs lignes si la longueur de celui-ci dépasse une ligne.

Exemples

DSPSPLF   FILE(QPRINT)  JOB(PAYROLL01)  SPLNBR(4)  FOLD(*NO)

Cet exemple présente le fichier spoule QPRINT. Ce fichier est le quatrième fichier généré par le travail PAYROLL01. Les positions d'enregistrement dont la longueur est supérieure à celle de la ligne d'affichage sont tronquées sur le premier écran.

Messages d'erreur

Messages *ESCAPE

CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF3303: Fichier &1 non trouvé dans travail &5/&4/&3.
CPF3308: Erreur lors de l'affichage des données.
CPF3309: Aucun fichier portant le nom &1 n'est actif.
CPF3330: Ressource nécessaire non disponible.
CPF3340: Plusieurs fichiers du nom indiqué dans travail &5/&4/&3.
CPF3342: Travail &5/&4/&3 non trouvé.
CPF3343: Plusieurs travaux portant le même nom.
CPF3344: Le fichier &1 numéro &8 n'est plus dans le système.
CPF3359: Impossible d'afficher les données.
CPF3386: &1 de &2 n'est pas un fichier base de données.
CPF3387: Impossible d'afficher les données du fichier &1 de &2.
CPF3394: Impossible de convertir les données du fichier spoule.
CPF33F9: Error occurred while displaying file &1 number &6.
CPF3427: Le travail &5/&4/&3 n'est pas interactif.
CPF3428: Commande DSPSPLF arrêtée pour fichier &1 numéro &8.
CPF3429: Le fichier &1 numéro &7 ne peut pas être affiché, copié ou envoyé.
CPF3434: Les données du fichier &1 de &2 membre &3 ne sont pas au format requis.
CPF3435: Données demandées non trouvées dans fichier &1 de &2 mbr &3.
CPF3478: Fichier &1 non trouvé dans travail &5/&4/&3 en file d'attente en sortie &6 de &7.
CPF3492: Non autorisé à utiliser le fichier spoule.
CPF7D41: Erreur lors de la consignation de la demande d'assistance pour commande.
CPF7D42: Erreur lors de l'exécution d'une opération de base de données.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9815: Membre &5 du fichier &2 dans &3 non trouvé.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.
CPF9871: Erreur lors du traitement.