DLTSPLF

Supprimer un fichier spoule

En bref

La commande DLTSPLF (Supprimer un fichier spoule) est utilisée pour enlever un fichier spoule de la file d'attente en sortie.

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

Syntaxe minimale

DLTSPLF 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éé
SELECT Sélection des fichiers pour
ASPDEV Unité ASP

Astuce : dans une session 5250, tapez DLTSPLF 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 : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande DLTSPLF (Supprimer un fichier spoule) est utilisée pour enlever un fichier spoule de la file d'attente en sortie. Si ce fichier est en cours d'écriture sur une unité, il est aussitôt arrêté et enlevé. Toutes les données qui n'ont pas été écrites sont perdues.

La procédure SYSTOOLS.DELETE_OLD_SPOOLED_FILES exécute une fonction similaire.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier spoule	Nom, *SELECT	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
SELECT	Sélection des fichiers pour	Liste d'éléments	Facultatif
	Élément 1: Utilisat	Nom, CURRENT, ALL
	Élément 2: Unité imprimante	Nom, ALL, OUTQ
	Élément 3: Type d'imprimé	Valeur caractère, ALL, STD
	Élément 4: Référence utilisateur	Valeur caractère, *ALL
	Élément 5: ASP	1-32, ALL, ASPDEV
ASPDEV	Unité ASP	Nom, , SYSBAS, *CURASPGRP	Facultatif

Fichier spoule (FILE)

Indique le fichier spoule qui doit être enlevé de la file d'attente en sortie.

Ce paramètre est obligatoire.

*SELECT: Tous les fichiers spoule satisfaisant aux critères de sélection indiqués au paramètre (SELECT (Sélection des fichiers pour) sont supprimés. Cette valeur est incompatible avec toute autre valeur indiquée au paramètre JOB (Travail), SPLNBR (Numéro de fichier spoule), JOBSYSNAME (Nom de système de travail) ou CRTDATE (Fichier spoule créé).
nom: Indiquez le nom du fichier spoule à supprimer.

Travail (JOB)

Indique le nom du travail qui a généré (ou génère) le fichier spoule à enlever de la file d'attente en sortie.

Valeurs uniques

*: Le fichier spoule à supprimer a été créé par le travail qui a émis cette commande.

Qualificatif 1 : Travail

nom: Indiquez le nom du travail qui a généré le fichier à supprimer.

Qualificatif 2 : Utilisat

nom: Indiquez le nom de l'utilisateur qui identifie le profil utilisateur sous lequel le travail s'exécute.

Qualificatif 3 : Numéro

000000-999999: Indiquez le numéro, attribué par le système, du travail ayant créé le fichier spoule.

Numéro de fichier spoule (SPLNBR)

Indique le numéro du fichier spoule qui doit être enlevé de la file d'attente en sortie.

*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 à supprimer est celui dont le numéro est le plus élevé parmi les fichiers portant le nom indiqué.

*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.

numéro-fichier-spoule: Indiquez le numéro du fichier spoule avec le nom de fichier à supprimer.

Nom de système de travail (JOBSYSNAME)

Indique le nom du 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.

Sélection des fichiers pour (SELECT)

Indique le groupe de fichiers à sélectionner pour une suppression. Des valeurs à position fixe peuvent être indiquées pour sélectionner les fichiers : l'utilisateur qui a créé le fichier, l'unité correspondant à la file d'attente en sortie contenant le fichier, le type d'imprimé indiqué, la marque de référence utilisateur associée au fichier ou le pool de mémoire secondaire contenant le fichier. Seuls les fichiers répondant à tous ces critères sont suspendus.

Elément 1 : Utilisat

*CURRENT: Sélectionne uniquement les fichiers créés par l'utilisateur ayant lancé cette commande.
*ALL: Sélectionne les fichiers créés par tous les utilisateurs.
nom: Indiquez un nom d'utilisateur. Seuls les fichiers créés par cet utilisateur seront sélectionnés.

Elément 2 : Unité imprimante

*ALL: Sélectionne les fichiers figurant dans toutes les files d'attente en sortie créées par une unité ou l'utilisateur.
*OUTQ: Sélectionne tous les fichiers placés dans une file d'attente en sortie créée par l'utilisateur. Ce type de file d'attente n'est pas généré automatiquement par une unité. Une file d'attente en sortie créée par l'utilisateur n'a généralement pas le même nom qu'une unité ; toutefois, si tel est le cas, elle ne figure pas dans la bibliothèque QUSRSYS.
nom: Indiquez un nom d'unité. Seuls les fichiers figurant dans la file d'attente en sortie créée par cette unité sont sélectionnés. On appelle file d'attente en sortie créée par une unité toute file d'attente ayant le même nom qu'une unité et figurant dans la bibliothèque QUSRSYS. A moins qu'elle n'existe déjà, elle sera automatiquement générée par le système lors de la création de l'unité. Il est impossible de supprimer une file d'attente en sortie créée par une unité.

Elément 3 : Type d'imprimé

*ALL: Sélectionne les fichiers associés à n'importe quel type de papier.
*STD: Seuls sont sélectionnés les fichiers pour lesquels le type d'imprimé standard est indiqué.
type-papier: Indiquez un type de papier. Seuls les fichiers utilisant celui-ci seront sélectionnés.

Elément 4 : Référence utilisateur

*ALL: Sélectionne tous les fichiers correspondant à la référence utilisateur indiquée.
référence-utilisateur: Indiquez la référence utilisateur pour sélectionner le fichier.

Elément 5 : ASP

*ALL: Tous les fichiers sont sélectionnés, comme indiqué au paramètre ASPDEV.
*ASPDEV: Les fichiers indiqués au paramètre ASPDEV sont sélectionnés.
1-32: Indiquez le pool de mémoire secondaire (ASP) des fichiers sélectionnés.

Unité ASP (ASPDEV)

Indique le nom de l'unité ASP depuis laquelle les fichiers spoule sont sélectionnés. Ce paramètre n'est admis que si l'élément de numéro d'ASP (ASP) du paramètre SELECT est *ALL ou *ASPDEV.

*: Les fichiers résidant dans les ASP appartenant à l'espace de nom de bibliothèque de l'unité d'exécution sont sélectionnés. Il s'agit de l'ASP système (ASP 1), de tous les ASP utilisateur de base (ASP 2-32) et, si l'unité d'exécution possède un groupe d'ASP, des ASP principaux et auxiliaires du groupe d'ASP de l'unité d'exécution.
*SYSBAS: Les fichiers résidant dans l'ASP système (ASP 1) et l'ensemble des ASP utilisateur de base (ASP 2-32) définis sont sélectionnés.
*CURASPGRP: Les fichiers résidant sur les ASP principaux et auxiliaires du groupe d'ASP de l'unité d'exécution sont sélectionnés. Si aucun groupe d'ASP n'est associé à l'unité d'exécution, une erreur est signalée.
nom: Indiquez la description d'unité du pool de mémoire secondaire. Les fichiers résidant sur l'ASP principal ou auxiliaire indiqué sont sélectionnés. Il est possible d'indiquer uniquement les ASP principaux ou auxiliaires du groupe d'ASP de l'unité d'exécution. Si aucun groupe d'ASP n'est associé à l'unité d'exécution, une erreur est signalée.

Exemples

DLTSPLF   FILE(WEEKLY)  JOB(000146/SMITH/PAYROLL5)

Cette commande permet de supprimer de la file d'attente en sortie le fichier spoule WEEKLY (travail PAYROLL5, utilisateur SMITH, numéro de travail 000146). Elle n'affecte pas les fichiers spoule portant un autre nom et générés par le travail PAYROLL5. Si le travail a généré plusieurs fichiers nommés WEEKLY, aucun fichier n'est supprimé car la commande SPLNBR(*ONLY) est prise par défaut.

Messages d'erreur

Messages *ESCAPE

CPF337E: L'unité ASP &1 n'est pas dans le groupe d'ASP en cours pour l'unité d'exécution.
CPF337F: Unité ASP &1 non admise avec ASP numéro &2.
CPF33D0: Il n'existe pas d'imprimante &1.
CPF33D1: Il n'existe pas d'utilisateur &1.
CPF3303: Fichier &1 non trouvé dans travail &5/&4/&3.
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.
CPF34A4: Le fichier &1, numéro &8, n'a pas été suspendu ni supprimé.
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.
CPF8128: Dommage &8 sur file d'attente en sortie &4 de &9.
CPF9825: Accès non autorisé à l'unité &1.
CPF9833: *CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.
CPFB8ED: La description d'unité &1 est incorrecte pour l'opération.