CHGDSTQ

Modifier file de distribution

En bref

La commande CHGDSTQ (Modifier une file d'attente de distribution) permet de modifier un poste de la table des files d'attente des services de distribution.

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

Syntaxe minimale

CHGDSTQ DSTQ(…)

Paramètres

DSTQ File d'attente de distribution obligatoire
RMTLOCNAME Emplacement distant Remote location
MODE Mode
RMTNETID ID éloigné réseau
LCLLOCNAME Emplacement local Local location
NRMPTY Priorité normale
HIGHPTY Priorité élevée
RTYNBR Nombre d'essais
RTYITV Intervalle entre essais
SNDQ Envoi dès réception

Astuce : dans une session 5250, tapez CHGDSTQ 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 CHGDSTQ (Modifier une file d'attente de distribution) permet de modifier un poste de la table des files d'attente des services de distribution. Ces files sont utilisées pour stocker des distributions avant leur envoi ou leur diffusion vers d'autres systèmes.

La commande CHGDSTQ ne fournit pas de support d'affichage interactif. Celui-ci est fourni par la commande CFGDSTSRV (Configurer services de distribution). Pour plus de détails sur la configuration d'un réseau de distribution, consultez le manuel SNA Distribution Services, SC41-5410.

Lorsque les informations relatives à la connexion (nom du lieu éloigné, mode, identificateur éloigné du réseau et nom du lieu local) sont modifiées et qu'un travail émetteur SNADS (Services de distribution SNA) est actif (mais non en cours d'envoi), celui-ci est arrêté et un nouveau travail est démarré de sorte que le nom du travail reflète toujours le nom du lieu éloigné.

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.

La combinaison du nom du lieu éloigné, du mode, de l'identificateur éloigné du réseau et du nom du lieu local doit être unique pour chaque type de file d'attente de distribution. Cette combinaison ne doit pas nécessairement être unique au sein du système, pour les files d'attente de distribution SNADS de la table de files d'attente de services de distribution et pour les files d'attente de distribution SVDS (SystemView). La valeur par défaut *LOC, pouvant être précisée aux paramètres RMTNETID et LCLLOCNAME, et la valeur par défaut *NETATR, pouvant être indiquée au paramètre MODE, représentent certaines des valeurs possibles non déterminées par le système comme étant déjà configurées pour une autre file d'attente de distribution SNADS ou SVDS de même type.
Vous devez indiquer un nom de lieu éloigné unique pour chacune des files d'attente de distribution RPDS de la table des files d'attente. Les files d'attente RPDS n'ont pas recours aux modes, aux identificateurs éloignés de réseau ou aux noms de lieux locaux.
La configuration de la table de routage n'est pas nécessaire pour les files d'attente de distribution de type SVDS. Cependant, le courrier SNADS normal ne peut pas être acheminé vers les files d'attente de gestion de modifications ni être reçu via des connexions de ce type. Ces dernières ne peuvent pas être acheminées vers des files d'attente SNADS ni être reçues via des connexions de ce type.
Les files d'attente de distribution de type SVDS ne peuvent accepter qu'une seule vue de la file d'attente (la file d'attente n'est pas divisée en deux parties, l'une étant normale et l'autre, prioritaire). A des fins de configuration et d'exploitation, seule la file d'attente normale est indiquée.

Les informations relatives à la connexion ne peuvent pas être modifiées lorsque l'état de la file d'attente est "Envoi" ou que celui des postes de cette file d'attente est "Interrupt" ou "Instance". Attendez que l'état de la file d'attente ou du poste de cette file d'attente ne soit plus actif ou bien restaurez cette condition à l'aide de la commande INZDSTQ (Initialiser file d'attente de distribution).
Les files d'attente de distribution de type SVDS ne peuvent pas être modifiées lorsqu'un récepteur est actif ou lorsque des distributions ont été reçues sans accusé de réception de la part de l'émetteur. Attendez la fin de l'envoi par le système éloigné, ou bien restaurez cette condition à l'aide de la commande INZDSTQ (Initialiser file d'attente de distribution).

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
RMTLOCNAME	Remote location	Nom de communication, *SAME	Facultatif
MODE	Mode	Nom de communication, SAME, NETATR	Facultatif
RMTNETID	ID éloigné réseau	Nom de communication, SAME, LOC, *NONE	Facultatif
LCLLOCNAME	Local location	Nom de communication, SAME, LOC	Facultatif
NRMPTY	Priorité normale	Liste d'éléments	Facultatif
	Élément 1: Heure d'envoi	Valeurs uniques: SAME, ALWAYS Autres valeurs: Liste d'éléments
	Élément 1: Heure de début (HHMM)	0000-2359, ' '
	Élément 2: Heure de fin (HHMM)	0000-2359, ' '
	Élément 2: Heure d'envoi forcé (HHMM)	0000-2359, SAME, NONE
	Élément 3: Seuil d'envoi	1-999, SAME, MANUAL
HIGHPTY	Priorité élevée	Liste d'éléments	Facultatif
	Élément 1: Heure d'envoi	Valeurs uniques: SAME, ALWAYS Autres valeurs: Liste d'éléments
	Élément 1: Heure de début (HHMM)	0000-2359, ' '
	Élément 2: Heure de fin (HHMM)	0000-2359, ' '
	Élément 2: Heure d'envoi forcé (HHMM)	0000-2359, SAME, NONE
	Élément 3: Seuil d'envoi	1-999, SAME, MANUAL
RTYNBR	Nombre d'essais	0-9999, *SAME	Facultatif
RTYITV	Intervalle entre essais	0-9999, *SAME	Facultatif
SNDQ	Envoi dès réception	SAME, NO, *YES	Facultatif

File d'attente de distribution (DSTQ)

Indique le nom du poste de file d'attente de distribution qui à modifier.

Ce paramètre est obligatoire.

Remote location (RMTLOCNAME)

Indique le nom du lieu éloigné auquel sont envoyées les distributions de cette file d'attente. Ce nom doit être identique à celui du lieu éloigné défini dans la description d'unité utilisée pour l'envoi des distributions de cette file d'attente à un autre système.

Les valeurs possibles sont les suivantes :

*SAME: Le nom de lieu éloigné n'est pas modifié.
lieu-éloigné: Indiquez le nom de lieu éloigné (8 caractères maximum).

Mode (MODE)

Indique le nom du mode qui définit les sessions sur l'unité utilisée par la file d'attente de distribution. Ce paramètre est sans objet si vous modifiez un poste de file d'attente de distribution de type RPDS.

Les valeurs possibles sont les suivantes :

*SAME: Le nom de mode n'est pas modifié.

*NETATR: Le mode défini dans les attributs du réseau est utilisé.

nom-mode: Indiquez un nom de mode de 8 caractères au plus. N'utilisez pas CPSVCMG ou SNASVCMG ; ces noms de mode sont réservés au système.

ID éloigné réseau (RMTNETID)

Indique l'identificateur éloigné du réseau auquel la file d'attente envoie des distributions. Ce paramètre est sans objet si vous modifiez un poste de file d'attente de distribution de type RPDS.

Les valeurs possibles sont les suivantes :

*SAME: L'identificateur éloigné du réseau n'est pas modifié.
*LOC: L'identificateur éloigné de réseau défini dans la description d'unité utilisée par cette file d'attente de distribution est pris en compte.
*NONE: Aucun identificateur éloigné de réseau n'est utilisé.
ID-éloigné-réseau: Indiquez l'identificateur éloigné du réseau.

Local location (LCLLOCNAME)

Indique le nom utilisé par les systèmes éloignés pour identifier votre système dans le réseau. Indiquez de préférence un nom identique à celui de votre système.

Les valeurs possibles sont les suivantes :

*SAME: Le nom de lieu local n'est pas modifié.
*LOC: Le nom de lieu local est le nom défini dans la description d'unité utilisée par cette file d'attente de distribution.
nom-lieu-local: Indiquez un nom de lieu local (8 caractères maximum).

Priorité normale (NRMPTY)

Indique les conditions d'envoi de la file d'attente pour les distributions dont le niveau de service est : données non prioritaires. Ce paramètre se compose des trois éléments suivants :

Heure d'envoi: Intervalle de temps durant lequel les distributions de ce niveau de priorité seront envoyées. Si vous n'indiquez aucun intervalle, les transmissions sont effectuées en fonction du seuil d'envoi et non en fonction de l'heure.
Heure d'envoi forcé: Heure précise à laquelle les distributions de ce niveau de priorité sont envoyées sans qu'il soit tenu compte du seuil de la file d'attente. Si *ALWAYS a été indiqué pour l'heure d'envoi, l'envoi forcé peut être défini pour n'importe quelle heure de la journée. Si vous indiquez une heure de début et une heure de fin, l'envoi forcé doit intervenir durant cette période.
Seuil d'envoi: Nombre de distributions de ce niveau de priorité devant être placées en file d'attente pour que le système commence à les envoyer.

Les valeurs possibles pour l'heure d'envoi sont les suivantes :

*SAME: L'heure d'envoi n'est pas modifiée.
*ALWAYS: Les distributions ayant ce niveau de priorité sont envoyées depuis cette file d'attente quelle que soit l'heure.
De-A: Indiquez l'heure à laquelle les distributions ayant ce niveau de priorité peuvent être envoyées depuis la file d'attente de distribution en cours. Vous devez indiquer à la fois une heure de début et une heure de fin selon un format sur 24 heures hhmm dans lequel h = heures et m = minutes.

Les valeurs possibles pour l'heure d'envoi forcé sont les suivantes :

*SAME: L'heure d'envoi forcé n'est pas modifiée.
*NONE: Aucune heure d'envoi forcé n'est indiquée.
heure d'envoi forcé: Indiquez l'heure d'envoi forcé sur 24 heures hhmm dans lequel h = heures et m = minutes.

Les valeurs de seuil d'envoi sont les suivantes :

*SAME: Le seuil d'envoi n'est pas modifié.
*MANUAL: Les distributions ne sont envoyées que si un opérateur effectue manuellement l'opération d'envoi à l'aide de la commande WRKDSTQ (Gérer les files d'attente de distribution) ou SNDDSTQ (Envoyer une file d'attente de distribution).
seuil d'envoi: Indiquez le nombre de distributions avec ce niveau de priorité devant se trouver dans la file d'attente pour que l'envoi soit effectué. Les valeurs correctes sont comprises entre 1 et 999.

Priorité élevée (HIGHPTY)

Indique les conditions d'envoi de la file d'attente pour les distributions dont le niveau de service est : messages, état réseau ou données prioritaires. Ce paramètre se compose des trois éléments suivants :

Heure d'envoi: Intervalle de temps durant lequel les distributions de ce niveau de priorité seront envoyées. Si vous n'indiquez aucun intervalle, les transmissions sont effectuées en fonction du seuil d'envoi et non en fonction de l'heure.
Heure d'envoi forcé: Heure précise à laquelle les distributions de ce niveau de priorité sont envoyées sans qu'il soit tenu compte du seuil de la file d'attente. Si *ALWAYS a été indiqué pour l'heure d'envoi, l'envoi forcé peut être défini pour n'importe quelle heure de la journée. Si vous indiquez une heure de début et une heure de fin, l'envoi forcé doit intervenir durant cette période.
Seuil d'envoi: Nombre de distributions de ce niveau de priorité devant être placées en file d'attente pour que le système commence à les envoyer.

Les valeurs possibles pour l'heure d'envoi sont les suivantes :

*SAME: L'heure d'envoi n'est pas modifiée.
*ALWAYS: Les distributions ayant ce niveau de priorité sont envoyées depuis cette file d'attente quelle que soit l'heure.
De-A: Indiquez l'heure à laquelle les distributions ayant ce niveau de priorité peuvent être envoyées depuis la file d'attente de distribution en cours. Vous devez indiquer à la fois une heure de début et une heure de fin selon un format sur 24 heures hhmm dans lequel h = heures et m = minutes.

Les valeurs possibles pour l'heure d'envoi forcé sont les suivantes :

*SAME: L'heure d'envoi forcé n'est pas modifiée.
*NONE: Aucune heure d'envoi forcé n'est indiquée.
heure d'envoi forcé: Indiquez l'heure d'envoi forcé sur 24 heures hhmm dans lequel h = heures et m = minutes.

Les valeurs de seuil d'envoi sont les suivantes :

*SAME: Le seuil d'envoi n'est pas modifié.
*MANUAL: Les distributions ne sont envoyées que si un opérateur effectue manuellement l'opération d'envoi à l'aide de la commande WRKDSTQ (Gérer les files d'attente de distribution) ou SNDDSTQ (Envoyer une file d'attente de distribution).
seuil d'envoi: Indiquez le nombre de distributions avec ce niveau de priorité devant se trouver dans la file d'attente pour que l'envoi soit effectué. Les valeurs correctes sont comprises entre 1 et 999.

Nombre d'essais (RTYNBR)

Indique le nombre maximal de tentatives effectuées par le système pour renvoyer des distributions de cette file d'attente après un incident. Ce paramètre s'applique aux défaillances de ligne de communications ainsi qu'aux incidents de distribution sur des systèmes éloignés offrant des possibilités de reprise. Le travail SNADS servant cette file d'attente de distribution s'arrête fin dès lors que le nombre de tentatives a été dépassé.

Les valeurs possibles sont les suivantes :

*SAME: Le nombre maximal de tentatives n'est pas modifié.
nombre: Indiquez le nombre maximal de nouvelles tentatives d'envoi de distributions après un échec. Les valeurs correctes sont comprises entre 0 et 9999.

Intervalle entre essais (RTYITV)

Indique le nombre de minutes séparant chaque nouvelle tentative.

Les valeurs possibles sont les suivantes :

*SAME: Le nombre de minutes s'écoulant entre chaque tentative n'est pas modifié.
minutes: Indiquez le nombre de minutes devant s'écouler entre deux nouvelles tentatives. Les valeurs correctes sont comprises entre 0 et 9999.

Envoi dès réception (SNDQ)

Indique si cette file d'attente de distribution ignore l'heure d'envoi et les valeurs de seuil indiquées en regard des invites Priorité normale (paramètre NRMPTY) et Priorité élevée (paramètre HIGHPTY) et commence l'envoi dès réception d'une distribution provenant du système SNADS auquel la file d'attente envoie ses distributions.

Ce paramètre n'est correct que si vous modifiez un poste d'une file d'attente de distribution de type SNADS.

Les valeurs possibles sont les suivantes :

*SAME: La valeur d'envoi de la file d'attente n'est pas modifiée.
*NO: Les distributions ne sont envoyées depuis cette file d'attente que si les conditions d'envoi sont remplies ou si la commande SNDDSTQ (Envoyer une file d'attente de distribution) ou WRKDSTQ (Gérer les files d'attente de distribution) est utilisée pour envoyer les distributions.
*YES: Cette file d'attente de distribution commence l'envoi dès réception des distributions provenant du système SNADS auquel la file d'attente envoie ses distributions, quelles que soient les conditions d'envoi de la file d'attente. Les distributions sont automatiquement envoyées pour les files d'attente manuelles (files d'attente pour lesquelles aucune variable de seuil d'envoi n'a été indiquée).

Exemples

CHGDSTQ   DSTQ(CHICAGO)  RMTLOCNAME(NEWLU)  MODE(*NETATR)

Cette commande modifie la file d'attente de distribution nommée CHICAGO. Le nom du site distant est modifié en NEWLU et son mode modifié conformément à celui spécifié dans les attributs réseau du système.

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.
CPF881A: Impossible de modifier connexion pour file de distribution &1 actuellement.
CPF881B: Distributions en cours de réception pour la file d'attente &1
CPF881D: Données prioritaires non admises pour les files de distribution *SVDS
CPF8826: La file d'attente de distribution &1 n'est pas vide.
CPF8827: Des postes de table de routage existent pour la file d'attente &1.
CPF8828: Des postes de biblio de doc éloignée existent pour la file *DLS &1.
CPF8833: La file d'attente de distribution &1 existe déjà.
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.
CPF9847: Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
CPF9899: Erreur lors du traitement de la commande.