HLDDSTQ
Suspendre file de distribution
En bref
La commande HLDDSTQ (Suspendre une file de distribution) permet d'empêcher l'envoi d'une file d'attente de distribution.
HLDDSTQ se lit HLD
(Suspendre) + DSTQ.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
HLDDSTQ DSTQ(…) PTY(…)Paramètres
Astuce : dans une session 5250, tapez HLDDSTQ 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 HLDDSTQ (Suspendre une file de distribution) permet d'empêcher l'envoi d'une file d'attente de distribution.
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.
- 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).
File d'attente de distribution (DSTQ)
Indique le nom de la file d'attente de distribution à suspendre. 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).
Ce paramètre est obligatoire.
Priorité (PTY)
Indique si c'est la partie normale ou prioritaire de la file d'attente qui est à suspendre.
Les valeurs possibles sont les suivantes :
- *NORMAL
- La file d'attente normale correspond aux distributions dotées d'un niveau de service Données non prioritaires.
- *HIGH
- La file d'attente prioritaire correspond aux distributions dotées d'un niveau de service Messages, Etat réseau ou Données prioritaires.
Remarque :Cette valeur n'est pas admise pour une file d'attente de distribution de type SVDS (SystemView).
Ce paramètre est obligatoire.
Exemples
Exemple 1 : Suspension de la partie d'une file d'attente ayant une priorité normale
HLDDSTQ DSTQ(CHICAGO) PTY(*NORMAL)
Cette commande suspend la partie de la file d'attente de distribution CHICAGO ayant une priorité normale.
Exemple 2 : Suspension de la partie d'une file d'attente ayant une priorité élevée
HLDDSTQ DSTQ(ATLANTA) PTY(*HIGH)
Cette commande suspend la partie de la file d'attente de distribution ATLANTA ayant une priorité élevée.
Messages d'erreur
Messages *ESCAPE
- CPF8802
- File d'attente de distribution &1 non trouvée.
- CPF8805
- Valeur spéciale non admise ou mal utilisée pour nom/groupe de système.
- CPF8806
- Valeur &1 incorrecte pour le nom système ou le groupe système.
- CPF881C
- File prioritaire non admise pour *SVDS &1.
- CPF8812
- Erreur pendant traitement de files d'attente de distribution.
- CPF8816
- Sous-système QSNADS non actif.
- CPF8817
- La file d'attente de distribution est suspendue.
- 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.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.