RLSDSTQ
Libérer file de distribution
En bref
La commande RLSDSTQ (Libérer une file de distribution) permet de libérer une file d'attente de distribution afin d'en permettre l'envoi.
RLSDSTQ se lit RLS
(Libérer) + DSTQ.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
RLSDSTQ DSTQ(…) PTY(…)Paramètres
Astuce : dans une session 5250, tapez RLSDSTQ 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 RLSDSTQ (Libérer une file de distribution) permet de libérer une file d'attente de distribution afin d'en permettre l'envoi.
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 de distribution à libérer. 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 file d'attente normale ou prioritaire qui est à libérer.
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 : Libération de la partie d'une file d'attente ayant une priorité normale
RLSDSTQ DSTQ(CHICAGO) PTY(*NORMAL)
Cette commande libère la partie de la file d'attente de distribution CHICAGO ayant une priorité normale.
Exemple 2 : Libération de la partie d'une file d'attente ayant une priorité élevée
RLSDSTQ DSTQ(ATLANTA) PTY(*HIGH)
Cette commande libère 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.