Aller au contenu

Commande CL IBM i (AS/400)

WRKDSTQ

Gérer files de distribution

En bref

La commande WRKDSTQ (Gérer les files d'attente de distribution) permet d'afficher et de gérer les demandes de distribution placées dans les files d'attente SNADS (Services de distribution SNA).

WRKDSTQ se lit WRK (Gérer) + DSTQ. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKDSTQ

Paramètres

Astuce : dans une session 5250, tapez WRKDSTQ 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 WRKDSTQ (Gérer les files d'attente de distribution) permet d'afficher et de gérer les demandes de distribution placées dans les files d'attente SNADS (Services de distribution SNA). Pour plus de détails sur SNADS, consultez le manuel SNA Distribution Services, SC41-5410.

Les noms de files d'attente de distribution sont convertis au jeu de caractères graphiques et à la page de codes 930 500 à l'aide du CCSID du travail.

Restrictions :

  • Cette commande est fournie avec le droit public *EXCLUDE et les profils utilisateur QPGMR et QSYSOPR disposent des droits privés permettant de l'utiliser.
  • Avant que cette commande ne soit exécutée pour la première fois, le sous-système QSNADS doit avoir été préalablement démarré afin de créer les objets internes SNADS utilisés par cette commande.
  • Des messages d'erreur relatifs aux files d'attente de distribution peuvent afficher ou imprimer des caractères différents de ceux que vous avez entrés pour le nom de la file d'attente de distribution en raison de transformations internes du système. De même (selon la langue utilisée pour le poste de travail), la valeur interne utilisée pour un nom de file d'attente de distribution peut être différente des caractères affichés pour la commande WRKDSTQ (Gérer les files d'attente de distribution). Une erreur peut être signalée si la valeur de chaîne de caractères indiquée à l'invite File d'attente de distribution (paramètre DSTQ) n'obéit pas aux règles de valeur interne de file d'attente de distribution ou si elle ne correspond pas à la valeur interne de toute file d'attente de distribution définie (sans tenir compte des minuscules).

Paramètres

Mot-clé Description Valeurs possibles Remarques
QUEUE Distribution Liste d'éléments Facultatif, positionnel 1
Élément 1: File d'attente Valeur caractère, *ALL
OUTPUT Sortie *, *PRINT Facultatif

Distribution (QUEUE)

Indique le nom de la file d'attente de distribution à afficher ou à imprimer. Cette file doit avoir été préalablement configurée à l'aide de la commande CFGDSTSRV (Configurer les services de distribution) ou ADDDSTQ (Ajouter une file d'attente de distribution).

Les valeurs possibles sont les suivantes :

*ALL
Toutes les files d'attente de distribution SNADS sont affichées ou imprimées par ordre alphabétique.
nom-file-attente-distribution
Indiquez une file d'attente SNADS spécifique.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

Les valeurs possibles sont les suivantes :

*
Le résultat est affiché (si demandé par un travail interactif) ou placé dans un fichier spoule de la file d'attente en sortie (si demandé par un travail en traitement par lots).
*PRINT
Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Exemples

Exemple 1 : Gestion de toutes les files d'attente de distribution

WRKDSTQ

Cette commande permet à l'utilisateur de gérer l'état et le contenu de toutes les files d'attente de distribution. Les parties de chaque file d'attente de distribution ayant une propriété normale ou élevée sont affichées ou imprimées.

Exemple 2 : Impression des informations

WRKDSTQ   OUTPUT(*PRINT)

Cette commande imprime les informations relatives à toutes les files d'attente de distribution. L'état des parties des files d'attente de distribution ayant une priorité normale est imprimé, suivi d'une liste de demandes de distribution portant sur les parties à priorité normale et élevée de chaque file d'attente.

Messages d'erreur

Messages *ESCAPE

CPF8802
File d'attente de distribution &1 non trouvée.
CPF8806
Valeur &1 incorrecte pour le nom système ou le groupe système.
CPF8807
Une erreur s'est produite lors de l'utilisation du journal QSNADS.
CPF8809
Erreurs détectées sur files d'attente internes SNADS.
CPF8812
Erreur pendant traitement de files d'attente de distribution.
CPF8813
Aucun poste.
CPF8819
Valeur spéciale non admise pour le nom de file d'attente de distribution.
CPF9845
Erreur lors de l'ouverture du fichier &1.
CPF9846
Erreur lors du traitement du fichier &1 de &2.
CPF9847
Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
CPF9850
Substitution non admise pour fichier imprimante &1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.