ADDDSTRTE

Ajouter route de distribution

En bref

La commande ADDDSTRTE (Ajouter une route de distribution) vous permet d'ajouter un poste à la table de routage des services de distribution.

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

Syntaxe minimale

ADDDSTRTE 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 ADDDSTRTE 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 ADDDSTRTE (Ajouter une route de distribution) vous permet d'ajouter un poste à la table de routage des services de distribution. La table de routage détermine quelle est la file d'attente qui reçoit une distribution pour une destination spécifique.

Les distributions sont dirigées vers des files d'attente de distribution en fonction de leur niveau de service. Vous devez indiquer au moins un niveau de service pour chaque poste de la table de routage. Votre système ne procède pas au routage des distributions dont le niveau de service n'a pas été configuré. En général, tous les niveaux de service acheminés vers la même destination utilisent la même file d'attente de distribution. Cependant, en fonction des niveaux de service de distribution, l'utilisateur peut configurer plusieurs files d'attente de distribution pour une seule destination.

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.

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 comprend un autre type de file d'attente de distribution (par exemple SNADS 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: 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: 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: 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: 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, *BLANK	Facultatif

Nom de système (SYSNAME)

Indique le nom de système et le nom de groupe du système éloigné constituant la destination pour ce poste de table de routage.

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), tout système du groupe peut constituer la destination pour ce poste de table de routage. Vous ne pouvez indiquer qu'une seule valeur *ANY pour chaque groupe dans la table de routage afin de désigner une destination de distribution ne correspondant à aucun nom de système spécifique, mais seulement à un nom de groupe.

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. Vous ne pouvez définir qu'un seul poste SYSNAME(*ANY *ANY) dans la table de routage afin de désigner une destination de distribution qui ne correspond à aucun autre poste de cette table.

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

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.

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

*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 :

*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 :

*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 :

*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 :

*BLANK: Aucun texte n'est indiqué.
'descriptif': Indiquez un texte (50 caractères maximum) entre apostrophes.

Exemples

Exemple 1 : Ajout d'un poste pour un système adjacent

ADDDSTRTE   SYSNAME(SYSTEMA GROUPA)  FAST(SYSTEMA)
            STATUS(SYSTEMA)
            DATAHIGH(SYSTEMA)  DATALOW(SYSTEMA)

Cette commande ajoute un poste de table de routage pour un système connecté directement à ce système (via une connexion physique APPC ou une connexion logique APPN). Le nom attribué à la file d'attente de distribution est identique à celui du système de destination. Le nombre d'étapes par défaut est la valeur par défaut du système.

Exemple 2 : Ajout d'un poste de table de routage générique

ADDDSTRTE   SYSNAME(*ANY GROUPNM1)  FAST(SYSTEMA)
            STATUS(SYSTEMA)
            DATAHIGH(SYSTEMA)  DATALOW(SYSTEMA)

Cette commande ajoute un poste de table de routage pour tous les systèmes du groupe de systèmes GROUPNM1. La file d'attente de distribution SYSTEMA est utilisée pour router les distributions vers tous les systèmes du groupe.

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
CPF881F: Le nom du groupe de système doit être indiqué pour la route de distribution
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.