CHGLINETH

Modifier une ligne Ethernet

En bref

La commande CHGLINETH permet de modifier une description de ligne Ethernet.

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

Syntaxe minimale

CHGLINETH LIND(…)

Paramètres

LIND Description de ligne obligatoire
RSRCNAME Nom de ressource
BRIDGE Identificateur de pont
ONLINE En ligne à l'IPL
VRYWAIT Attente de mise en fonction
AGGPCY Stratégie d'agrégat
AGGRSCL Ressources d'agrégation
ASSOCPORT Nom ressource de port associé
ADPTADR Adresse adaptateur local
GRPADR Adresse de groupe
SSAP Liste SSAP
LINESPEED Vitesse de la ligne
DUPLEX Bidirectionnel
SRVOPT Options de maintenabilité
MAXFRAME Longueur maximale de trame
CMNRCYLMT Limites de rétablissement
MSGQ File attente messages
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGLINETH 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 CHGLINETH permet de modifier une description de ligne Ethernet. Pour plus d'informations sur cette commande, reportez-vous au manuel Communications Configuration, SC41-5401.

Remarques :

Paramètres qui ne sont plus pris en charge à compter de la V2R3M0 : THRESHOLD
Paramètres qui ne sont plus pris en charge à compter de la V5R3M0 : EMLLANNAME, LECDSCTIMO, LESATMADR, PVCID, USELECSADR
Paramètres qui ne sont plus pris en charge à compter de la V7R4M0 : AUTOCRTCTL, AUTODLTCTL, COSTBYTE, COSTCNN, GENTSTFRM, LINKSPEED, MAXCTL, PRPDLY, SECURITY, USRDFN1, USRDFN2, USRDFN3

Restriction : Pour utiliser cette commande, vous devez disposer du droit spécial *IOSYSCFG (configuration de système d'entrée-sortie).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
LIND	Description de ligne	Nom	Obligatoire, clé, positionnel 1
RSRCNAME	Nom de ressource	Nom, SAME, AGG, *NWSD	Facultatif
BRIDGE	Identificateur de pont	Nom, SAME, NONE	Facultatif
ONLINE	En ligne à l'IPL	SAME, YES, *NO	Facultatif
VRYWAIT	Attente de mise en fonction	15-180, NOWAIT, SAME	Facultatif
AGGPCY	Stratégie d'agrégat	Valeurs uniques: SAME Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Standard	ETHCHL, LNKAGG
	Élément 2: Type de stratégie	DFT, SRCPORT, DESTPORT, SRCDESTP, *RNDRBN
AGGRSCL	Ressources d'agrégation	Values (jusqu'à 8 répétitions): Nom, *SAME	Facultatif
ASSOCPORT	Nom ressource de port associé	Nom, SAME, NONE	Facultatif
ADPTADR	Adresse adaptateur local	Valeur caractère, SAME, ADPT	Facultatif
GRPADR	Adresse de groupe	Valeurs uniques: SAME, NONE Autres valeurs (jusqu'à 12 répétitions): 010000000000-FDFFFFFFFFFF	Facultatif
SSAP	Liste SSAP	Valeurs uniques: SAME, SYSGEN Autres valeurs (jusqu'à 24 répétitions): Liste d'éléments	Facultatif
	Élément 1: Point accès au service source	02-FE
	Élément 2: Trame maximale SSAP	265-8996, *MAXFRAME, 265, 521, 1033, 1466, 1493, 1496, 8996
	Élément 3: Type de SSAP	CALC, NONSNA, SNA, HPR
LINESPEED	Vitesse de la ligne	SAME, 10M, 100M, 1G, 10G, 25G, 100G, AUTO	Facultatif
DUPLEX	Bidirectionnel	Valeur caractère, SAME, HALF, FULL, AUTO	Facultatif
SRVOPT	Options de maintenabilité	Valeur caractère, SAME, NONE	Facultatif
MAXFRAME	Longueur maximale de trame	1496-8996, *SAME, 1496, 8996	Facultatif
CMNRCYLMT	Limites de rétablissement	Valeurs uniques: SAME, SYSVAL Autres valeurs: Liste d'éléments	Facultatif
	Élément 1: Nombre maximal d'essais	0-99, 2
	Élément 2: Intervalle	0-120, 5
MSGQ	File attente messages	Valeurs uniques: SAME, SYSVAL, SYSOPR Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: File attente messages	Nom
	Qualificatif 2: Biblio	Nom
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Description de ligne (LIND)

Indique le nom de la description de ligne.

Ce paramètre est obligatoire.

Nom de ressource (RSRCNAME)

Indique le nom de ressource identifiant le port de communications.

Remarque :Pour déterminer le nom de ressource, utilisez la commande WRKHDWRSC (Gérer les ressources matériel) en indiquant *CMN au paramètre TYPE. Ce nom figure sur le port. Par exemple, le nom de ressource peut être CMN01 sur un port Ethernet.

Remarque :Lorsque la valeur *NWSD est indiquée au paramètre RSRCNAME, cette valeur ne peut être remplacée par une autre valeur et inversement.

Remarque :Lorsque la valeur *AGG est indiquée au paramètre RSRCNAME, cette valeur ne peut être remplacée par une autre valeur et inversement.

*SAME: La valeur reste inchangée.

*AGG: Le nom de ressource indiqué identifie une ligne d'agrégation. Ce nom représente une ou plusieurs ressources physiques.

*NWSD: Le nom de ressource est déterminé par le serveur de réseau utilisé.

nom: Indiquez le nom de ressource du port de communications.

Ce paramètre est obligatoire.

Identificateur de pont (BRIDGE)

Indique l'identificateur de pont auquel cette description de ligne Ethernet est associée.

Un identificateur de pont permet à une partition serveur de partager une carte Ethernet virtuelle physique avec plusieurs partitions client, chacune d'elles ayant une seule carte Ethernet virtuelle. Le pontage n'est pas pris en charge par toutes les descriptions de ligne Ethernet.

*SAME: La valeur reste inchangée.
*NONE: Cette description de ligne n'est associée à aucun pont.
nom: Indiquez le nom de l'identificateur de pont auquel cette description de ligne Ethernet est associée.

En ligne à l'IPL (ONLINE)

Indique si cet objet est mis en fonction automatiquement à l'IPL.

*SAME: La valeur reste inchangée.

*YES: La ligne est automatiquement mise en fonction au moment de l'IPL.
*NO: La ligne n'est pas automatiquement mise en fonction au moment de l'IPL.

Attente de mise en fonction (VRYWAIT)

Indique si la ligne est mise en fonction en mode asynchrone ou synchrone. Pour une mise en fonction synchrone, ce paramètre indique un délai d'attente.

*SAME: La valeur reste inchangée.

*NOWAIT: Le système n'attend pas la fin de la mise en fonction. Cette opération s'effectue en mode asynchrone.
attente-mise-en-fonction: Indiquez le délai d'attente (en secondes). Les valeurs admises sont comprises entre 15 et 180. Le système attend que la ligne soit mise en fonction ou que le temps indiqué soit écoulé avant d'exécuter la commande VRYCFG (Changer l'état d'une configuration).

Remarques :

Si vous indiquez un délai d'attente dans la description de ligne alors que le paramètre ONLINE(*YES) est défini, le temps imparti à l'IPL est modifié, c'est-à-dire qu'il varie en fonction du temps requis pour la mise en fonction synchrone de la ligne ou du délai d'attente.
Le délai nécessaire à la mise en fonction de la ligne comprend les opérations suivantes :
- la mise en place des tâches de gestion de la ligne
- l'activation du processeur d'E-S de communication, y compris le déchargement du microcode sous licence spécifique au modèle d'IOP
- la définition des tâches et des processus de communication.

Le délai normal de mise en fonction est compris entre 5 et 45 secondes, mais peut être plus long selon le système, le protocole de ligne, etc.

Stratégie d'agrégat (AGGPCY)

Indique d'une part la norme utilisée pour configurer les noms de ressource d'agrégation, et d'autre part la stratégie appliquée pour équilibrer la charge des trames Ethernet sortantes.

Remarque :Ce paramètre est admis uniquement lorsque le paramètre CNNTYPE (Nom de ressource) prend la valeur *AGG pour la configuration d'une ligne d'agrégation.

Valeurs uniques

*SAME: La valeur reste inchangée.

Elément 1 : Standard

*ETHCHL: Indique que la technologie Etherchannel doit être utilisée pour permettre l'agrégation de plusieurs adaptateurs Ethernet qui vont ainsi constituer une unité pseudo Ethernet unique.
*LNKAGG: Indique que la technologie IEEE 802.3ad Link Aggregation doit être utilisée pour permettre l'agrégation de plusieurs adaptateurs Ethernet qui vont ainsi constituer une unité pseudo Ethernet unique.

Elément 2 : Type de stratégie

*DFT: L'algorithme de sélection de l'adaptateur utilise le dernier octet de l'adresse IP de destination (pour le trafic TCP/IP) ou l'adresse MAC (pour le trafic ARP et les autres trafics non-IP). D'une façon générale, ce mode constitue le meilleur choix initial pour un serveur avec un grand nombre de clients.
*SRCPORT: L'algorithme de sélection de l'adaptateur utilise la valeur de port TCP/IP ou UDP source.
*DESTPORT: Le chemin de l'adaptateur sortant est sélectionné via un algorithme utilisant la valeur de port TCP/IP ou UDP cible.
*SRCDESTP: Le chemin de l'adaptateur sortant est sélectionné via un algorithme utilisant les valeurs de port TCP ou UDP source et cible combinées.
*RNDRBN: Le trafic sortant est réparti de façon égale entre les différents ports de l'adaptateur Etherchannel. Ce mode constitue l'option type pour deux hôtes connectés dos à dos (c'est-à-dire sans commutateur).

Ressources d'agrégation (AGGRSCL)

Indique les noms de ressource d'agrégation associés aux ports de communication qui composent une ligne d'agrégation (description de ligne utilisant Etherchannel ou IEEE802.3ad Link Aggregation). Il est possible d'indiquer jusqu'à 8 noms de ressource.

Remarque :Pour déterminer le nom de la ressource, utilisez la commande WRKHDWRSC (Gérer les ressources matériel) avec le paramètre TYPE(*CMN). Le nom de ressource est le nom associé au port Ethernet.

Remarque :Ce paramètre est admis uniquement lorsque le paramètre CNNTYPE (Nom de ressource) prend la valeur *AGG pour la configuration d'une ligne d'agrégation.

ressource-agrégation: Indiquez les noms des ressources d'agrégation à utiliser.

*SAME: La valeur reste inchangée.

Nom ressource de port associé (ASSOCPORT)

Indique le nom de ressource qui décrit le port servant à établir une connexion entre un serveur de réseau Windows et le réseau.

Remarque :Le paramètre ASSOCPORT n'est admis que lorsque RSRCNAME(*NWSD) est indiqué.

*SAME: La valeur reste inchangée.

*NONE: Aucun nom de ressource de port n'est pas associé à la ligne.

nom: Indiquez le nom de ressource.

Adresse adaptateur local (ADPTADR)

Indique l'adresse hexadécimale (12 caractères) de l'adaptateur.

*SAME: La valeur reste inchangée.

*ADPT: L'adresse définie par défaut pour la carte adaptateur Ethernet est utilisée.
Remarque :*ADPT doit être spécifié lorsque le paramètre NWS indique un numéro de port Ethernet virtuel, *VRTETHPTP ou *VRTETHn (n compris entre 0 et 9).
adresse-adaptateur-local: Indiquez une adresse de votre choix pour décrire ce système dans le réseau Ethernet. Il doit s'agir d'une adresse individuelle administrée localement. Les valeurs hexadécimales admises sont *ADPT ou sont comprises entre 020000000000 et FEFFFFFFFFFF. Le second chiffre de l'adresse (à partir de la gauche) doit être 2, 6, A ou E.

Adresse de groupe (GRPADR)

Une adresse de groupe est une adresse à laquelle un sous-ensemble de noeuds de la ligne Ethernet répond, en plus des adresses de leur adaptateur local.

*SAME: La valeur reste inchangée.

*NONE: Aucune adresse de groupe définie.
adresse-groupe: Indiquez une adresse de groupe. Les valeurs hexadécimales admises sont comprises entre 010000000000 et FDFFFFFFFFFF. le deuxième chiffre doit être 1, 3, 5, 7, 9, B, D ou F. Jusqu'à adresses peuvent être indiquées.

Liste SSAP (SSAP)

Précise les informations relatives au point d'accès au service source (SSAP) (valeur de SSAP, longueur maximale de trame, type de SSAP, etc.)

Ce paramètre admet des valeurs multiples.

Les valeurs possibles pour le point d'accès au service source sont les suivantes :

*SAME: La valeur reste inchangée.

*SYSGEN

Les points d'accès au service source sont déterminés par le système.

Lorsque ETHSTD(*ALL) ou ETHSTD(*IEEE8023) est indiqué, le système crée les valeurs SSAP 04, 12, AA et C8.
Lorsque ETHSTD(*ETHV2) est indiqué, le système crée les valeurs SSAP 04 et 08.

point-accès-service-source

Indiquez un point d'accès au service source pour la réception et l'émission de données. Vous devrez entrer la valeur SSAP hexadécimale 06 ou AA pour les applications TCP/IP si ETHSTD est égal à *ALL ou *IEEE8023 (les valeurs SSAP 06 et AA ne sont pas admises lorsque ETHSTD est égal à *ETHV2 ; toutefois, le protocole TCP/IP peut encore s'exécuter). Pour les applications SNA, indiquez une valeur SSAP multiple de quatre comprise entre 04 et 9C. Par exemple, 7C est une valeur possible. Pour les applications non SNA, indiquez une valeur multiple de deux comprise entre 02 et FE.

La valeur SSAP possible est la suivante :

point-accès-service-source

Indiquez un point d'accès au service source pour la réception et l'émission de données. Le nombre maximal de valeurs SSAP pouvant être définies est de 24.

Le SSAP correspondant aux applications TCP/IP doit avoir la valeur hexadécimale AA.
Remarque :Bien que la valeur AA soit incompatible avec ETHSTD(*ETHV2), le protocole TCP/IP peut s'exécuter.

Le SSAP correspondant aux applications SNA doit avoir une valeur hexadécimale multiple de 4 comprise entre 04 et 9C (04, 08, 0C, etc).
Le SSAP correspondant aux applications HPR doit avoir la valeur hexadécimale C8.
Le SSAP correspondant aux applications non SNA doit avoir une valeur hexadécimale multiple de 2 comprise entre 02 et FE (02, 04, 06, etc).
Pour les applications de réseau local, associez la valeur 12 au type de SSAP *NONSNA.

Les valeurs possibles pour la taille maximale de trame SSAP sont les suivantes :

*MAXFRAME: Le système détermine la taille de trame maximale (taille de la zone de données) pouvant être transmise ou reçue. Si ETHSTD(*ALL ou *IEEE8023) est précisé, la valeur *CALC génère la taille de trame 1496 pour les SSAP TCP/IP et SNA. Si ETHSTD(*ETHV2) est indiqué, *CALC génère la taille de trame 1493 pour les SSAP SNA.
trame-maximale-SSAP: Indiquez une taille maximale de trame pour ce SSAP. Les valeurs admises sont comprises entre 265 et 8996 (entre 265 et 1493 pour les SSAP SNA lorsque *ETHV2 est indiqué pour le paramètre Norme Ethernet (ETHSTD)).

Les valeurs possibles pour le type de SSAP sont les suivantes :

*CALC: Le système détermine le type de SSAP en fonction de la valeur indiquée.
*SNA: Le système utilise les communications SNA. Les seules valeurs de SSAP admises sont les multiples de 4 compris entre 04 et 9C.
*NONSNA: Le système n'utilise pas les communications SNA. Les seules valeurs de SSAP admises sont les multiples de 2 compris entre 02 et FE.
*HPR: Le SSAP est utilisé pour les communications HPR, et éventuellement pour les applications SNA. Le SSAP doit avoir la valeur hexadécimale C8.

Vitesse de la ligne (LINESPEED)

Indique la vitesse de la ligne en bits/s.

*SAME: La valeur reste inchangée.

*AUTO: La valeur de vitesse de ligne est déterminée par le matériel à l'aide d'une procédure de sélection automatique de traitement.

débit de ligne: Une valeur de débit de ligne se terminant par 'M' spécifie des millions de bits par seconde. Une valeur de débit de ligne se terminant par 'G' spécifie des milliards de bits par seconde.

Remarques :

1G ou 10G doivent être spécifiés lorsque le paramètre NWS indique un numéro de port Ethernet virtuel *VRTETHPTP ou *VRTETHn, où n est compris entre 0 et 9.
Lorsque le paramètre Nom de ressource (RSRCNAME) prend la valeur *AGG pour la configuration d'une ligne d'agrégation, toutes les ressources agrégées doivent pouvoir s'exécuter à la vitesse indiquée.

Bidirectionnel (DUPLEX)

Indique si le matériel peut envoyer et recevoir des données simultanément. En mode semi-duplex, le matériel doit alterner envoi et réception. En mode duplex intégral, les données peuvent être envoyées et reçues simultanément.

Remarque :Pour optimiser les performances, ce paramètre doit correspondre à celui du commutateur ou du concentrateur auquel cette ligne est connectée. Pour plus de détails, reportez-vous à l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*SAME: La valeur reste inchangée.

*AUTO: La valeur de duplex est déterminée par le matériel à l'aide d'une procédure de sélection automatique de traitement.

*HALF

La ligne utilise le mode de communication semi-duplex.

*FULL

La ligne utilise le mode de communication duplex.

Remarque :*FULL doit être spécifié lorsque le paramètre NWS indique un numéro de port Ethernet virtuel, *VRTETHPTP ou *VRTETHn (n compris entre 0 et 9).

Remarque :*HALF ne peut pas être spécifié lorsque la valeur *AGG est indiquée pour le paramètre Nom de ressource (RSRCNAME) pour configurer une ligne d'agrégation.

Options de maintenabilité (SRVOPT)

Indique les options de maintenabilité. Ce paramètre permet de fournir des options de maintenabilité et doit être utilisé sous la direction d'un fournisseur de services.

*SAME: La valeur reste inchangée.

*NONE: Aucune option de maintenabilité fournie.
valeur-alphanumérique: Indiquez la valeur spécifiée par votre fournisseur de services.

Longueur maximale de trame (MAXFRAME)

Indique la taille maximale de trame pouvant être transmise ou reçue sur cette description de ligne.

*SAME: La valeur reste inchangée.

1496: La taille maximale de trame est de 1496 octets.
taille-maximale-trame: Indiquez la taille maximale de trame à utiliser. Les valeurs admises (en octets) sont comprises entre 1496 et 8996.

Remarque :8996 est recommandé lorsque le paramètre NWS indique un numéro de port Ethernet virtuel, *VRTETHPTP ou *VRTETHn (n étant compris entre 0 et 9).

Limites de rétablissement (CMNRCYLMT)

Indique le nombre maximal de tentatives de rétablissement de communications de second niveau pour cette description de ligne.

Pour le nombre-maximal, les valeurs possibles sont les suivantes :

*SAME: La valeur reste inchangée.

*SYSVAL: La valeur système QCMNRCYLMT utilisée.

nombre-maximal-essais: Indiquez le nombre de tentatives de rétablissement à effectuer par le système. Les valeurs admises sont comprises entre 0 et 99.

Pour l'intervalle-temps, les valeurs possibles sont les suivantes :

*SAME: La valeur reste inchangée.

intervalle: Indiquez la période durant laquelle les tentatives de rétablissement sont effectuées. Les valeurs possibles sont comprises entre 0 et 120 par intervalles d'une minute.

File attente messages (MSGQ)

Indique le nom de la file d'attente de messages vers laquelle sont envoyés les messages d'exploitation.

*SAME: La valeur reste inchangée.

*SYSVAL: Les messages sont envoyés dans la file d'attente de messages définie dans la valeur système QCFGMSGQ.

*SYSOPR: Les messages sont envoyés dans la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR).

Qualificatif 1 : File attente messages

nom: Indiquez le nom de la file d'attente de messages dans laquelle sont envoyés les messages d'exploitation.

Qualificatif 2 : Biblio

nom: Indiquez le nom de la bibliothèque contenant la file d'attente de messages.

Texte 'descriptif' (TEXT)

Présente brièvement la description de ligne.

*SAME: La valeur reste inchangée.

*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

Exemple 1 : Modification d'une description de ligne Ethernet

CHGLINETH   LIND(BOSTON)  RSRCNAME(LIN041)

Cette commande permet de modifier en LIN041 le nom de ressource d'une description de ligne Ethernet appelée BOSTON.

Exemple 2 : Modification d'une description de ligne Ethernet

CHGLINETH   LIND(LINETH)  MAXFRAME(1496)

Cette commande permet de modifier en 1496 octets la taille de trame maximale de la description de ligne Ethernet.

Messages d'erreur

Messages *ESCAPE

CPF261E: Description de ligne &1 non modifiée.