INZDSTQ

La commande INZDSTQ (Initialiser une file de distribution) permet de restaurer l'état d'une file d'attente de distribution ainsi que les postes qu'elle contient. Le cas échéant, elle permet également d'effacer toutes les distributions de la file d'attente. Cette commande s'applique aux sections normales ou prioritaires de la file d'attente indiquée.

Attention : L'initialisation d'une file d'attente de distribution peut provoquer la perte ou la duplication de distributions dans le réseau, en fonction de l'état des distributions se trouvant en transit au moment de l'exécution de cette commande.

L'initialisation d'une file d'attente de distribution réalise les opérations suivantes :

• Si un travail émetteur SNADS (Services distribution SNA) est actif pour la file d'attente, le travail est arrêté. L'annulation du travail prend effet immédiatement. L'envoi en cours des files d'attente de distribution est interrompu.
• Lorsque la file d'attente est de type SVDS (SystemView) et qu'un travail récepteur est actif pour cette connexion, le travail est arrêté. L'annulation du travail prend effet immédiatement. Toutes les distributions partiellement reçues sont supprimées.
• Si la file d'attente de distribution doit être mise à blanc, toutes les distributions qu'elle contient sont supprimées conformément à ce qui est indiqué à l'invite Mise à blanc des postes (paramètre CLEAR).
• Si la file d'attente n'est pas mise à blanc, les distributions qu'elle contient dont l'état n'est pas "Suspendu" sont mises à l'état "Prêt". Les distributions dont l'état est "Suspendu" demeurent suspendues.
• La file d'attente est mise à l'état "Prêt" si elle n'est pas à l'état "Suspendu".
• Si le sous-système QSNADS est actif, un travail émetteur SNADS est soumis pour la file d'attente, à l'aide des mêmes règles que celles utilisées pour le démarrage du sous-système QSNADS.

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

File d'attente de distribution (DSTQ)

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

Mise à blanc des postes (CLEAR)

Indique si les distributions de la file d'attente sont supprimées.

Attention : L'utilisation de la valeur *PURGE provoque la perte définitive des distributions.

Les valeurs possibles sont les suivantes :

*NO

Les distributions de la file d'attente ne sont pas supprimées.

*YES

Les distributions de la file d'attente sont supprimées. Chaque distribution supprimée est consignée ; un avis est envoyé à l'émetteur de la distribution ou à la destination de rapport précisée dans la distribution si l'émetteur en a fait la demande.

Remarque :Les distributions d'état SNADS et les rapports de distribution sont utilisés pour communiquer des informations sur une distribution à son émetteur. Une distribution de rapport d'état ne fait jamais l'objet d'une autre distribution de rapport d'état. Si une distribution de rapport d'état est supprimée, aucun avis n'est envoyé.

*PURGE

Les distributions de la file d'attente sont supprimées. Les distributions supprimées ne sont pas consignées et aucun avis n'est envoyé à l'émetteur ni à la destination de rapport indiquée dans la distribution.

Exemples

Exemple 1 : Initialisation d'une file d'attente de distribution

INZDSTQ   DSTQ('SYSTEMA APPN')

Les informations de connexion concernant le système 'SYSTEMA APPN' vont être modifiées par un administrateur de site central. Cette commande initialise la file d'attente pour éviter les erreurs que la commande CHGDSTQ (Modifier file de distribution) est susceptible de rencontrer. Les distributions de la file d'attente ne sont pas supprimées.

Exemple 2 : Initialisation et libération d'une file d'attente de distribution

INZDSTQ   DSTQ('ERRORQ')  CLEAR(*YES)

Cette commande libère la file d'attente de distribution ERRORQ utilisée comme référentiel pour des distributions qui auraient entraîné des erreurs de routage. Les distributions supprimées sont consignées et les initiateurs des distributions sont avertis.

Exemple 3 : Initialisation et purge d'une file d'attente de distribution

INZDSTQ   DSTQ('TESTQ')  CLEAR(*PURGE)

Cette commande libère la file d'attente de distribution TESTQ utilisée pour tester une nouvelle application de traitement par lots. Les distributions sont supprimées sans être consignées, et les initiateurs ne sont pas avertis.

Messages d'erreur

Messages *ESCAPE

CPF8802

File d'attente de distribution &1 non trouvée.

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.

CPF8849

File &1 utilisée par une autre fonction des services de distribution.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.