STRSPLRCL

La commande STRSPLRCL (Démarrer récupération de spoule) permet de réparer les files d'attente en sortie et les fichiers spoule dont l'état est irrécupérable. Si un travail d'éditeur en écriture se termine anormalement ou si une mise à jour incomplète s'est produite, la file d'attente en sortie ou les fichiers spoule associés au travail d'éditeur en écriture peuvent conserver divers états (par exemple, WTR, PRT, PND et MSGW). La commande STRSPLRCL n'attend pas la fin de la fonction de récupération de spoule. Si * est indiqué au paramètre de groupe d'ASP (ASPGRP) et si l'unité d'exécution en cours contient un groupe d'ASP dans son espace de nom, deux demandes distinctes de récupération des files d'attente en sortie peuvent être envoyées. Si une file d'attente en sortie correspondante réside dans *SYSBAS, une demande est envoyée au travail de maintenance de spoule dans *SYSBAS. Si une file d'attente en sortie correspondante réside dans le groupe d'ASP indiqué, une demande est envoyée au travail de maintenance de spoule pour ce groupe d'ASP. Lorsque la fonction de récupération est terminée, le message CPC3309 est envoyé aux files d'attente de messages QHST et QSYSOPR par chaque travail de maintenance de spoule.

Si la valeur *ALL/*ALL est indiquée au paramètre File d'attente en sortie (OUTQ) et si la valeur *SYSBAS ou * est indiquée au paramètre Groupe ASP (ASPGRP), un nettoyage supplémentaire est effectué sur les files d'attente de travaux et sur les travaux terminés. Si un travail a l'état OUTQ mais qu'il ne possède aucun fichier spoule actif, le travail est supprimé du système.

Restriction :

• Vous devez disposer des droits spéciaux *SPLCTL pour pouvoir utiliser cette commande. Si une valeur Groupe ASP spécifique est indiquée au paramètre ASPGRP, l'utilisateur doit disposer du droit d'utilisation (*USE) sur toutes les descriptions d'unité ASP du groupe d'ASP et le statut de ce dernier doit être DISPONIBLE.

Paramètres

File d'attente en sortie (OUTQ)

Indique le nom de la file d'attente en sortie à récupérer.

Ce paramètre est obligatoire.

Qualificatif 1 : File d'attente en sortie

*ALL

Toutes les files d'attente en sortie du groupe d'ASP défini par le paramètre ASPGRP sont récupérées.

nom-générique

Indiquez le nom générique des files d'attente en sortie à récupérer.

nom

Indiquez le nom de la file d'attente en sortie à récupérer.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution.

*USRLIBL

S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*ALL

Toutes les bibliothèques du groupe d'ASP défini par le paramètre ASPGRP sont recherchées.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur des pools de mémoire secondaire (ASP) définies par le paramètre Groupe ASP (ASPGRP).

Les bibliothèques utilisateur sont des bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception de celles qui suivent :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques ci-après dont le nom commence par la lettre Q soient fournies par IBM, elles contiennent des données utilisateur fréquemment modifiées. En conséquence, elles sont également considérées comme des bibliothèques utilisateur :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*CURLIB

La file d'attente en sortie est recherchée dans la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant la file d'attente en sortie.

Groupe ASP (ASPGRP)

Indique le groupe d'ASP contenant les bibliothèques dont des files d'attente en sortie doivent être récupérées.

*

Les files d'attente en sortie résidant dans les ASP appartenant à l'espace de nom de bibliothèque de l'unité d'exécution sont récupérées. 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 files d'attente en sortie résidant dans l'ASP système (ASP 1) et tous les ASP utilisateur de base (ASP 2-32) définis sont récupérés.

*CURASPGRP

Les files d'attente en sortie résidant sur les ASP principaux et secondaires du groupe d'ASP de l'unité d'exécution sont récupérées. Si aucun groupe d'ASP n'est associé à l'unité d'exécution, une erreur est signalée.

nom

Indiquez le nom d'un groupe d'ASP. Les files d'attente en sortie résidant sur les ASP principaux et secondaires du groupe d'ASP indiqué sont récupérées.

Exemples

Exemple 1: Réparation d'une file d'attente en sortie unique

STRSPLRCL   OUTQ(QUSRSYS/PRT01)

Cette commande permet de récupérer la file d'attente en sortie PRT01 et tous les fichiers spoule résidant dans cette file d'attente.

Exemple 2: Réparation de plusieurs files d'attente en sortie d'une bibliothèque spécifique

STRSPLRCL   OUTQ(QUSRSYS/PRT*)

Cette commande permet de récupérer dans une bibliothèque QUSRSYS les files d'attente en sortie dont les trois premiers caractères sont 'PRT'. Les fichiers spoule résidant dans ces files d'attente sont également récupérés.

Exemple 3: Réparation de files d'attente en sortie dans le groupe d'ASP de l'utilisateur en cours

STRSPLRCL   OUTQ(*ALL/PRT01)  ASPGRP(*CURASPGRP)

Cette commande permet de récupérer les files d'attente en sortie nommées PRT01 de toutes les bibliothèques résidant dans le groupe d'ASP de l'utilisateur en cours. Les fichiers spoule résidant dans les files d'attente en sortie sélectionnées sont également récupérés.

Exemple 4: Réparation de toutes les files d'attente en sortie et fichiers spoule contenus dans l'ASP système et les ASP utilisateur de base

STRSPLRCL   OUTQ(*ALL/*ALL)  ASPGRP(*SYSBAS)

Cette commande permet de récupérer toutes les files d'attente en sortie de l'ensemble des bibliothèques résidant dans l'ASP système (ASP 1) et tous les ASP utilisateur de base définis (ASP 2 à 32). Les fichiers spoule résidant dans ces files d'attente sont également récupérés.

Messages d'erreur

Messages *ESCAPE

CPF338D

*SPLCTL nécessaire pour récupérer les files d'attente en sortie.

CPF338F

Valeur d'ASPGRP incorrecte avec la valeur spéciale de bibliothèque.

CPF339A

*CURASPGRP indiqué et unité d'exécution dépourvue de groupe d'ASP.

CPF339B

File d'attente en sortie &1 de &2 non trouvée.

CPF9825

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

CPFB8ED

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