Aller au contenu

SNDDSTQ

Envoyer file de distribution

En bref

La commande SNDDSTQ (Envoyer une file d'attente de distribution) permet d'effectuer les opérations suivantes :

SNDDSTQ se lit SND (Envoyer) + DSTQ. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SNDDSTQ DSTQ(…) PTY(…)

Paramètres

  • DSTQ File d'attente de distribution obligatoire
  • PTY Priorité obligatoire

Astuce : dans une session 5250, tapez SNDDSTQ 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 SNDDSTQ (Envoyer une file d'attente de distribution) permet d'effectuer les opérations suivantes :

  • Envoi des postes d'une file d'attente de distribution lorsque celle-ci est configurée pour un démarrage manuel alors qu'aucun opérateur n'est disponible.
  • Remplacement des attributs de planification de file d'attente et début d'envoi immédiat des postes d'une file d'attente.
  • Redémarrage d'un travail émetteur SNADS qui a échoué de façon anormale.

La commande SNDDSTQ est principalement réservée à un programme CL en différé. Elle permet les mêmes fonctions que l'option 2 (Envoyer file de distribution) du panneau d'options principal de la commande WRKDSTQ (Gérer les files d'attente de distribution). La commande SNDDSTQ permet le démarrage des fonctions à partir d'un travail par lots à la place d'un démarrage interactif.

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).

Paramètres

Mot-clé Description Valeurs possibles Remarques
DSTQ File d'attente de distribution Valeur caractère Obligatoire, positionnel 1
PTY Priorité *NORMAL, *HIGH Obligatoire, positionnel 2

File d'attente de distribution (DSTQ)

Indique le nom de la file d'attente de distribution à envoyer. 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 à envoyer.

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 : Envoi de distributions ayant une priorité normale

SNDDSTQ   DSTQ(CHICAGO)  PTY(*NORMAL)

Cette commande envoie les distributions figurant dans la partie de la file d'attente de distribution CHICAGO ayant une priorité normale.

Exemple 2 : Envoi de distributions ayant une priorité élevée

SNDDSTQ   DSTQ(ATLANTA)  PTY(*HIGH)

Cette commande envoie les distributions figurant dans 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.