CHGDSTRTE

Modifier route de distribution

En bref

La commande CHGDSTRTE (Modifier une route de distribution) vous permet de modifier un poste de la table de routage des services de distribution.

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

Syntaxe minimale

CHGDSTRTE SYSNAME(…)

Paramètres

SYSNAME Nom de système obligatoire
FAST Niveau service messages
STATUS Niveau service état réseau
DATAHIGH Niveau service prioritaire
DATALOW Niveau service non prioritaire
TEXT Texte

Astuce : dans une session 5250, tapez CHGDSTRTE 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 CHGDSTRTE (Modifier une route de distribution) vous permet de modifier un poste de la table de routage des services de distribution. Vous devez indiquer au moins un niveau de service pour chaque poste de la table de routage.

Le support d'affichage interactif est fourni par la commande CFGDSTSRV (Configurer services de distribution). Pour plus de détails sur la configuration d'un réseau de distribution, reportez-vous au manuel SNA Distribution Services, SC41-5410.

Les noms de systèmes, de groupes et 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.

Vous devez indiquer une valeur pour l'un au moins des paramètres suivants : FAST, STATUS, DATAHIGH ou DATALOW. Vous ne pouvez pas indiquer la valeur *NONE pour ces quatre paramètres.
Une erreur se produit si une route de distribution pour laquelle une file d'attente de distribution de type SVDS (SystemView) a été indiquée est modifiée de sorte qu'elle comporte un autre type de file d'attente de distribution (par exemple SNADS (Services de distribution SNA) ou RPDS (pont VM/MVS)).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SYSNAME	Nom de système	Liste d'éléments	Obligatoire, positionnel 1
	Élément 1: Nom de système	Valeur caractère, *ANY
	Élément 2: Groupe de système	Valeur caractère, *ANY
FAST	Niveau service messages	Valeurs uniques: SAME, NONE Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Nom de la file de distribution	Valeur caractère
	Élément 2: Maximum d'étapes	1-255, *NETATR
STATUS	Niveau service état réseau	Valeurs uniques: SAME, NONE Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Nom de la file de distribution	Valeur caractère
	Élément 2: Maximum d'étapes	1-255, *NETATR
DATAHIGH	Niveau service prioritaire	Valeurs uniques: SAME, NONE Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Nom de la file de distribution	Valeur caractère
	Élément 2: Maximum d'étapes	1-255, *NETATR
DATALOW	Niveau service non prioritaire	Valeurs uniques: SAME, NONE Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Nom de la file de distribution	Valeur caractère
	Élément 2: Maximum d'étapes	1-255, *NETATR
TEXT	Texte	Valeur caractère, SAME, BLANK	Facultatif

Nom de système (SYSNAME)

Indique le nom de système et le nom de groupe du système éloigné pour lequel vous souhaitez modifier un poste de la table de routage.

Indique le nombre maximal d'étapes constituant le trajet d'une distribution entre les différents systèmes d'un réseau associé au routage SNADS. Ce nombre comprend la dernière étape permettant d'atteindre le système destinataire, mais pas les étapes effectuées par le routage APPN (Gestion de réseau paritaire). Si ce nombre est dépassé, la distribution s'arrête et un message d'erreur est envoyé à l'émetteur. Le nombre maximal d'étapes permet d'éviter qu'une distribution s'engage dans une boucle entre les systèmes.

Vous pouvez indiquer un nom de système et un nom de groupe comportant respectivement 8 caractères au maximum.

Vous pouvez utiliser la valeur *ANY pour le nom de système. Si vous indiquez SYSNAME(*ANY groupe), vous modifiez le poste de la table de routage utilisé pour désigner une destination de distribution qui ne correspond à aucun nom de système spécifique, mais seulement à un nom de groupe. Vous ne pouvez indiquer qu'une seule valeur *ANY pour chaque groupe dans la table de routage.

Vous ne pouvez utiliser la valeur *ANY pour le nom de groupe que si vous avez également indiqué cette valeur pour le nom de système. Si vous indiquez SYSNAME(*ANY *ANY), vous modifiez le poste de la table de routage utilisé pour désigner une destination de distribution qui ne correspond à aucun autre poste de cette table. Vous ne pouvez indiquer qu'un seul poste SYSNAME(*ANY *ANY) dans la table de routage.

Ce paramètre est obligatoire.

Niveau service messages (FAST)

Indique la file d'attente de distribution et le nombre maximal d'étapes jusqu'au système destinataire pour les distributions ayant le niveau de service messages. Il s'agit du niveau de priorité de service le plus élevé.

Les valeurs possibles pour la file d'attente de distribution sont les suivantes :

*SAME: La file d'attente de distribution et le nombre maximal d'étapes ne sont pas modifiés.

*NONE: Aucune file d'attente n'est indiquée pour les distributions nécessitant le niveau de service messages. Ces dernières ne peuvent pas être dirigées à l'aide de ce poste de table de routage.

nom-file-attente-distribution: Indiquez le nom de la file d'attente de distribution à laquelle sont envoyées les distributions utilisant le niveau de service et le poste de routage en cours. Il doit s'agir d'une file d'attente de distribution existante de type autre que DLS (services de bibliothèque de documents).

Les valeurs de nombre maximal d'étapes sont les suivantes :

*NETATR: C'est le nombre maximal d'étapes figurant dans les attributs de réseau du système. Vous pouvez afficher la valeur en cours à l'aide de la commande DSPNETA (Afficher les attributs du réseau).
nombre-étapes: Indiquez le nombre maximal d'étapes. Les valeurs correctes sont comprises entre 1 et 255.

Niveau service état réseau (STATUS)

Indique la file d'attente de distribution et le nombre maximal d'étapes jusqu'au système destinataire pour les distributions ayant un niveau de service état du réseau.

Les valeurs possibles pour la file d'attente de distribution sont les suivantes :

*SAME: La file d'attente de distribution et le nombre maximal d'étapes ne sont pas modifiés.

*NONE: Aucune file d'attente n'est indiquée pour les distributions nécessitant un niveau de service état du réseau. Ces dernières ne peuvent pas être dirigées à l'aide de ce poste de table de routage.

nom-file-attente-distribution: Indiquez le nom de la file d'attente de distribution à laquelle sont envoyées les distributions utilisant le niveau de service et le poste de routage en cours. Il doit s'agir d'une file d'attente de distribution existante de type autre que DLS (services de bibliothèque de documents).

Les valeurs de nombre maximal d'étapes sont les suivantes :

*NETATR: C'est le nombre maximal d'étapes figurant dans les attributs de réseau du système. Vous pouvez afficher la valeur en cours à l'aide de la commande DSPNETA (Afficher les attributs du réseau).
nombre-étapes: Indiquez le nombre maximal d'étapes. Les valeurs correctes sont comprises entre 1 et 255.

Niveau service prioritaire (DATAHIGH)

Indique la file d'attente de distribution et le nombre maximal d'étapes jusqu'au système destinataire pour les distributions ayant un niveau de service données prioritaires.

Les valeurs possibles pour la file d'attente de distribution sont les suivantes :

*SAME: La file d'attente de distribution et le nombre maximal d'étapes ne sont pas modifiés.

*NONE: Aucune file d'attente n'est indiquée pour les distributions nécessitant un niveau de service données prioritaires. Ces dernières ne peuvent pas être dirigées à l'aide de ce poste de table de routage.

nom-file-attente-distribution: Indiquez le nom de la file d'attente de distribution à laquelle sont envoyées les distributions utilisant le niveau de service et le poste de routage en cours. Il doit s'agir d'une file d'attente de distribution existante de type autre que DLS (services de bibliothèque de documents).

Les valeurs de nombre maximal d'étapes sont les suivantes :

*NETATR: C'est le nombre maximal d'étapes figurant dans les attributs de réseau du système. Vous pouvez afficher la valeur en cours à l'aide de la commande DSPNETA (Afficher les attributs du réseau).
nombre-étapes: Indiquez le nombre maximal d'étapes. Les valeurs correctes sont comprises entre 1 et 255.

Niveau service non prioritaire (DATALOW)

Indique la file d'attente de distribution et le nombre maximal d'étapes jusqu'au système destinataire pour les distributions ayant un niveau de service données non prioritaires. Ce niveau de service est utilisé pour la majorité des données.

Les valeurs possibles pour la file d'attente de distribution sont les suivantes :

*SAME: La file d'attente de distribution et le nombre maximal d'étapes ne sont pas modifiés.

*NONE: Aucune file d'attente n'est indiquée pour les distributions nécessitant un niveau de service données non prioritaires. Ces dernières ne peuvent pas être dirigées à l'aide de ce poste de table de routage.

nom-file-attente-distribution: Indiquez le nom de la file d'attente de distribution à laquelle sont envoyées les distributions utilisant le niveau de service et le poste de routage en cours. Il doit s'agir d'une file d'attente de distribution existante de type autre que DLS (services de bibliothèque de documents).

Les valeurs de nombre maximal d'étapes sont les suivantes :

*NETATR: C'est le nombre maximal d'étapes figurant dans les attributs de réseau du système. Vous pouvez afficher la valeur en cours à l'aide de la commande DSPNETA (Afficher les attributs du réseau).
nombre-étapes: Indiquez le nombre maximal d'étapes. Les valeurs correctes sont comprises entre 1 et 255.

Texte (TEXT)

Texte décrivant brièvement l'objet.

Les valeurs possibles sont les suivantes :

*SAME: Le texte reste inchangé.
*BLANK: Le texte est remplacé par des blancs.
'descriptif': Indiquez un texte (50 caractères maximum) entre apostrophes.

Exemples

CHGDSTRTE   SYSNAME(SYSTEMA)  DATAHIGH(SYSTEMAFAST 2)

Cette commande modifie, dans la file d'attente de distribution, les distributions envoyées à SYSTEMA avec un niveau de service prioritaire. La nouvelle file d'attente de distribution devient SYSTEMAFAST avec un maximum d'étapes de 2.

Messages d'erreur

Messages *ESCAPE

CPF8801: File d'attente *DLS &1 non admise dans la table de routage.
CPF8802: File d'attente de distribution &1 non trouvée.
CPF8807: Une erreur s'est produite lors de l'utilisation du journal QSNADS.
CPF881E: La route de distribution contient des files de distribution incompatibles
CPF8815: Poste &1 &2 non trouvé dans la table de routage.
CPF8831: Le poste &1 &2 existe déjà dans la table de routage.
CPF8837: Nom système/groupe &1 &2 utilisé par une autre fonction des services 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.
CPF9847: Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
CPF9899: Erreur lors du traitement de la commande.