WRKSPLF

La commande WRKSPLF (Gérer les fichiers spoule) permet d'afficher la liste de tous les fichiers spoule du système ou une liste sélective de ces fichiers. Vous pouvez choisir de modifier, de suspendre, de supprimer, d'afficher ou de libérer tout ou partie des postes affichés.

Remarques relatives aux performances du système : Le temps nécessaire à l'affichage est directement proportionnel aux critères de sélection et au nombre de fichiers spoule figurant dans la liste. Dans le cas d'un système comportant un grand nombre de fichiers spoule, il peut s'avérer nécessaire de consulter une liste sélective de fichiers spoule. Pour plus d'informations sur les performances de la commande WRKSPLF, reportez-vous à la rubrique "Spool Performance Considerations experience" dans le manuel IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Paramètres

Sélection des fichiers pour (SELECT)

Indique quel groupe de fichiers est sélectionné pour l'affichage. 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, le pool de mémoire secondaire contenant le fichier, ou le nom du fichier spoule. 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-générique

Sélectionne les fichiers créés par tous les utilisateurs répondant aux critères. Un nom générique est une chaîne de caractères contenant un ou plusieurs caractères suivis d'un astérisque (*) (ABC*, par exemple). L'astérisque se substitue à n'importe quel caractère admis. Si aucun astérisque n'est indiqué dans le nom, le système considère qu'il s'agit d'un nom d'utilisateur complet.

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

valeur-caractère

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.

données-utilisateur-génériques

Les fichiers contenant une marque de données répondant aux critères sont sélectionnés. Une marque de données utilisateur générique est une chaîne de caractères contenant un ou plusieurs caractères et se terminant par un astérisque (*) (ABC*, par exemple). L'astérisque se substitue à n'importe quel caractère admis. Si un astérisque est imbriqué en milieu de chaîne (par exemple 'AB*C*'), il est considéré comme faisant partie de la chaîne de comparaison.

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.

Elément 6 : Fichier spoule

*ALL

Tous les fichiers, quel que soit leur nom, sont sélectionnés.

nom-générique

Tous les fichiers spoule dont le nom correspond au nom générique sont sélectionnés. Un nom générique est une chaîne de caractères contenant un ou plusieurs caractères suivis d'un astérisque (*) (ABC*, par exemple). L'astérisque se substitue à n'importe quel caractère admis. Si aucun astérisque n'est indiqué dans le nom, le système considère qu'il s'agit d'un nom de fichier spoule complet.

nom

Indiquez le nom des fichiers spoule à sélectionner.

Travail (JOB)

Indique le nom du ou des travaux qui ont créé les fichiers spoule à sélectionner.

Remarque :Ce paramètre est admis uniquement si la valeur *ALL est indiquée pour l'élément de nom d'utilisateur au paramètre SELECT.

Valeurs uniques

*ALL

Les fichiers spoule créés par tous les travaux doivent être inclus.

Qualificatif 1 : Sélection des travaux

nom-générique

Les fichiers spoule créés par des travaux ayant le nom générique indiqué doivent être inclus. Un nom générique est une chaîne de caractères contenant un ou plusieurs caractères suivis d'un astérisque (*) (ABC*, par exemple). L'astérisque se substitue à n'importe quel caractère admis. Un nom de travail générique indique tous les travaux dont le nom commence par le préfixe générique.

nom

Les fichiers spoule créés par des travaux ayant le nom indiqué doivent être inclus.

Qualificatif 2 : Utilisat

*ALL

Tous les fichiers spoule créés par les travaux correspondant au nom de travail indiqué sont inclus.

nom-générique

Les fichiers spoule créés par des travaux ayant le nom d'utilisateur générique indiqué doivent être inclus.

nom

Les fichiers spoule créés par des travaux ayant le nom d'utilisateur indiqué doivent être inclus.

Qualificatif 3 : Numéro

*ALL

Tous les fichiers spoule créés par les travaux correspondant au nom de travail et au nom d'utilisateur indiqués doivent être inclus.

000001-999999

Indiquez le numéro de travail pour qualifier davantage le nom de travail et le nom d'utilisateur.

Période (PERIOD)

Indique la période pour la sélection des fichiers spoule affichés. Il s'agit de l'heure et de la date de création des fichiers spoule. Ce paramètre contient deux listes d'éléments de deux éléments chacune.

Elément 1 : Heure et date de début

Elément 1 : Heure de début

L'un des éléments ci-après permet d'indiquer l'heure de début à laquelle ou après laquelle les fichiers spoule ont été créés. Les fichiers spoule créés avant la date et l'heure indiquées ne sont pas affichés.

*AVAIL

Tous les fichiers spoule créés à la date ou après la date de début indiquées sont affichés.

heure

Indiquez l'heure de début pour la date de début spécifiée. Cette heure est indiquée au format 24 heure avec ou sans séparateur d'heure :

• Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss) où hh = heures, mm = minutes et ss = secondes. Les heures, les minutes et les secondes doivent comporter exactement 2 chiffres. Utilisez des zéros en début de chaîne si nécessaire. Les valeurs admises pour hh vont de 00 à 23. Les valeurs admises pour mm et ss vont de 00 à 59.
• Si vous utilisez un séparateur d'heure, indiquez une chaîne de 5 ou 8 caractères, dans laquelle le séparateur d'heure indiqué pour votre travail permet de séparer les heures, les minutes et les secondes. Si vous entrez cette commande à partir de la ligne de commande, la chaîne doit être indiquée entre apostrophes. Si vous utilisez un séparateur d'heure différent de celui indiqué pour votre travail, la commande échouera.

Elément 2 : Date de début

L'un des éléments ci-après permet d'indiquer la date de début à laquelle ou après laquelle les fichiers spoule ont été créés. Les fichiers spoule créés avant la date indiquée ne sont pas affichés.

*BEGIN

Tous les fichiers spoule répondant aux autres critères de sélection sont affichés. Lorsque *BEGIN est indiquée comme date de début, toute valeur d'heure de début autre que *AVAIL est ignorée.

*CURRENT

La date du jour est utilisée comme date de début.

date

Indiquez la date de début. Cette date doit être entrée au format indiquée par la valeur de travail DATFMT et, si des séparateurs sont utilisés, il doit s'agir des séparateurs utilisés spécifiés par la valeur de travail DATSEP.

Elément 2 : Heure et date de fin

Elément 1 : Heure de fin

L'un des éléments ci-après permet d'indiquer l'heure de fin avant laquelle les fichiers spoule ont été créés.

*AVAIL

Tous les fichiers spoule créés à la date ou avant la date de début indiquées sont affichés.

heure

Indiquez l'heure de fin pour la date de fin avant laquelle les fichiers spoule ont été créés.

Elément 2 : Date de fin

L'un des éléments ci-après permet d'indiquer la date de fin avant laquelle ou à laquelle les fichiers spoule ont été créés.

*END

Le dernier jour auquel les fichiers spoule ont été créés est utilisé comme date de fin. Si la valeur *END est spécifiée, toute heure de fin autre que la valeur *AVAIL est ignorée.

date

Indiquez la date de fin. Cette date doit être entrée au format indiquée par la valeur de travail DATFMT et, si des séparateurs sont utilisés, il doit s'agir des séparateurs utilisés spécifiés par la valeur de travail DATSEP.

Unité ASP (ASPDEV)

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

Sortie (OUTPUT)

Indique si la sortie doit être affichée sur un poste de travail, ou imprimée. Si la première option est choisie, la sortie sera envoyée au poste de travail demandeur.

*

La sortie est affichée (s'il s'agit d'un travail interactif) ou imprimée (s'il s'agit d'un travail par lots).

*PRINT

La sortie est imprimée.

Remarque :Vous ne pouvez pas indiquer *PRINT si vous utilisez l'environnement 36. Si la commande est exécutée en interactif, la sortie sera affichée mais ne sera pas imprimée. Si la commande est exécutée en traitement par lots, un message d'erreur sera émis et aucune sortie ne sera générée.

Format d'affichage (DSPFMT)

Indique le format et la terminologie à utiliser pour les écrans obtenus à partir de cette commande.

Remarque :Si le format d'affichage de l'IBM 36 est utilisé, le paramètre OUTPUT (Sortie) n'est pas pris en compte et les données sont affichées sur le clavier-écran de l'utilisateur.

*INLENV

Le format et la terminologie utilisés sont déterminés par la valeur SPCENV (environnement spécial) indiquée dans votre profil utilisateur. Si la valeur SPCENV est *S36, la terminologie de l'IBM 36 sera utilisée. Pour toutes les autres valeurs, la terminologie utilisée sera celle de ce système.

*S36FMT

Utilise la terminologie de l'IBM 36.

Remarque :Les fichiers spoule résidant sur des ASP principaux ou auxiliaires ne seront pas affichés si le format d'affichage est *S36FMT.

*NORMAL

Utilise la terminologie du système.

Niveau d'assistance (ASTLVL)

Indique l'interface utilisateur à utiliser.

*PRV

L'interface utilisateur précédemment utilisée est affichée.

*USRPRF

L'interface utilisateur indiquée au paramètre ASTLVL (Niveau d'assistance) du profil utilisateur est utilisée.

*BASIC

L'interface utilisateur d'Assistant est utilisée.

Remarque :Si un numéro d'ASP (1-32) est indiqué pour le paramètre SELECT et que l'interface utilisateur d'Assistant est utilisée, les fichiers spoule de l'ASP système (ASP 1) et de tous les ASP utilisateur de base (ASP 2-32) sont répertoriés. Les fichiers spoule résidant sur des ASP principaux ou auxiliaires ne seront pas affichés si le format d'affichage est *S36FMT.

*INTERMED

L'interface utilisateur du système est utilisée.

Exemples

Exemple 1 : Gestion de tous les fichiers spoule

WRKSPLF   SELECT(*ALL *ALL *ALL *ALL *ALL *ALL)  DSPFMT(*NORMAL)

Cette commande permet d'afficher l'écran Gestion des fichiers spoule présentant la liste de tous les fichiers spoule du système. La terminologie utilisée est déterminée par la valeur du paramètre SPCENV du profil utilisateur. Les informations sont affichées à l'écran par défaut.

Exemple 2 : Gestion de fichiers spoule sélectionnés

WRKSPLF   SELECT(CASMITH *ALL *ALL MEMO *ALL *ALL)

Cette commande permet de gérer tous les fichiers spoule du système pour l'utilisateur nommé CASMITH et contenant 'MEMO' dans les données utilisateur.

Exemple 3 : Gestion des fichiers spoule par données utilisateur

WRKSPLF   SELECT(*ALL *ALL *ALL '*SAV*' *ALL *ALL)

Cette commande permet de gérer tous les fichiers spoule du système contenant '*SAV' dans les quatre premiers caractères des données utilisateur du fichier spoule.

Exemple 4 : Gestion des fichiers spoule par date

WRKSPLF   SELECT(*ALL)
          PERIOD(('11:30:00' '01/12/2005') ('20:00:00' '01/12/2005'))

Cette commande permet de gérer tous les fichiers spoule du système dont la date et l'heure de création se situent entre 11:30 AM et 8:00 PM le 12 janvier 2005.

Messages d'erreur

Messages *ESCAPE

CPF1E94

Le nom d'utilisateur &1 n'existe pas.

CPF1E95

Imprimante &1 introuvable.

CPF1E99

Erreur non prévue.

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.

CPF3302

Substitution du fichier d'impression &1 par &2 incorrecte.

CPF3330

Ressource nécessaire non disponible.

CPF33FD

Unité ASP &1 non admise.

CPF3420

Affichage en format 36 impossible en traitement par lots.

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.

CPF9825

Accès non autorisé à l'unité &1.

CPF9833

*CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9871

Erreur lors du traitement.

CPFB8ED

La description d'unité &1 est incorrecte pour l'opération.