HLDSPLF

La commande HLDSPLF (Suspendre un fichier spoule) permet d'empêcher le traitement du fichier spoule indiqué par un éditeur de spoule. Si le fichier est en cours d'impression, l'éditeur interrompt son traitement et édite le fichier suivant. Lorsque le fichier est libéré et son impression lancée, le fichier est réimprimé à partir du début. Si des exemplaires multiples sont en cours d'impression lors de la suspension, l'exemplaire incomplet est réimprimé, ainsi que l'ensemble des exemplaires suivants.

Paramètres

Fichier spoule (FILE)

Indique le fichier spoule à suspendre.

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 suspendus. Cette valeur est incompatible avec les valeurs indiquées au paramètre JOB (Travail), SPLNBR (Numéro de fichier spoule), JOBSYSNAME (Nom de système de travail) et CRTDATE (Fichier spoule créé).

nom

Indiquez le nom du fichier spoule à suspendre.

Travail (JOB)

Indique le travail qui a créé le fichier spoule en cours de suspension.

Valeurs uniques

*

Le fichier a été créé par le travail ayant lancé la commande HLDSPLF (Suspendre un fichier spoule).

Qualificatif 1 : Travail

nom

Indiquez le nom du travail ayant créé le fichier à suspendre.

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 créé par le travail indiqué.

*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é à suspendre.

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 à suspendre. 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.

Quand suspendre le fichier (OPTION)

Indique quelle option utiliser lors de la suspension du fichier spoule.

Remarque :Une option ne s'applique que si le fichier est en cours d'impression.

*IMMED

Le fichier doit être suspendu au plus tôt.

*PAGEEND

Le fichier doit être suspendu à une limite de page.

Exemples

Exemple 1 : Suspension d'un fichier créé par un autre travail

HLDSPLF   FILE(SHIPITEMS)  JOB(00009/JONES/ORDER)

Cette commande permet de suspendre le traitement du fichier spoule SHIPITEMS créé par le travail ORDER.

Exemple 2 : Suspension d'un fichier à une limite de page

HLDSPLF   FILE(QPJOBLOG)  OPTION(*PAGEEND)

Cette commande permet de suspendre le fichier spoule QPJOBLOG à une limite de page.

Exemple 3 : Suspension immédiate d'un fichier

HLDSPLF   FILE(QPJOBLOG)  OPTION(*IMMED)

Cette commande permet de suspendre immédiatement le fichier spoule QPJOBLOG. Lorsque vous utilisez cette option pour suspendre un fichier spoule, la commande CHGSPLFA RESTART(*NEXT) risque d'être inexacte si le fichier spoule est en cours de traitement par un éditeur de spoule.

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.

CPF3337

Fichier &1 numéro &8 déjà suspendu ou sauvegardé.

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.

CPF34A4

Le fichier &1, numéro &8, n'a pas été suspendu ni supprimé.

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.