RLSSPLF

Libérer un fichier spoule

En bref

La commande RLSSPLF (Libérer un fichier spoule) permet de libérer le fichier indiqué dans une file d'attente en sortie.

RLSSPLF se lit RLS (Libérer) + SPLF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RLSSPLF 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 RLSSPLF 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 RLSSPLF (Libérer un fichier spoule) permet de libérer le fichier indiqué dans une file d'attente en sortie. Le fichier libéré est toujours généré à partir du début. Cette commande peut libérer un fichier spoule suspendu par :

une commande HLDSPLF
le paramètre HOLD(*YES), indiqué pour le fichier unité ou dans une commande de substitution
le paramètre SAVE(*YES), indiqué pour le fichier unité, dans une commande de substitution ou dans la commande CHGSPLFA
la valeur SAVE(*IMMED) indiquée dans la commande CHGSPLFA
les commandes HLDWTR et RLSWTR avec le paramètre OPTION(*BYPASS)
l'annulation par l'opérateur d'une demande système d'ajout de papier dans l'imprimante

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 nom du fichier spoule à libérer pour que son écriture s'effectue sur une unité de sortie (imprimante ou disquette).

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 libéré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 à libérer.

Travail (JOB)

Indique le travail ayant créé le fichier spoule en cours de libération pour traitement.

Valeurs uniques

*: Le travail qui a émis la commande RLSSPLF (Libérer un fichier spoule) est identique à celui qui a créé le fichier spoule.

Qualificatif 1 : Travail

nom: Indiquez le nom du travail ayant créé le fichier que vous voulez libérer.

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 à libérer.

Numéro de fichier spoule (SPLNBR)

Indique le numéro du ficher spoule à libérer.

*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 libéré est celui dont le numéro est le plus élevé parmi les fichiers spoule 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.

1-999999: Indiquez le numéro du fichier spoule à libérer portant le nom indiqué.

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 devant être libéré. 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

RLSSPLF   FILE(STOCK14)  JOB(000047/SMITH/MASTER)

Cette commande permet de libérer le fichier spoule STOCK14 créé dans le travail nommé MASTER. Ce fichier peut alors être sélectionné pour être traité par l'éditeur de spoule. Le travail a été exécuté sous le profil utilisateur SMITH avec pour numéro 000047, attribué par le système.

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.
CPF3304: Le fichier &1 numéro &8 ne peut pas être libéré.
CPF3309: Aucun fichier portant le nom &1 n'est actif.
CPF3322: Fichier &1 numéro &8 non libéré.
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.
CPF3357: File d'attente en sortie &1 de &2 non trouvée.
CPF3362: Objets dans QTEMP incorrects comme valeurs de paramètres.
CPF3492: Non autorisé à utiliser le fichier spoule.
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.