CHGDEVNWSH

Modifier descr unité NWSH

En bref

La commande CHGDEVNWSH permet de modifier une description d'unité NWSH (adaptateur hôte de serveur de réseau).

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

Syntaxe minimale

CHGDEVNWSH DEVD(…)

Paramètres

DEVD Description d'unité obligatoire
RSRCNAME Nom de ressource
LCLIFC Interface (cible) locale
ONLINE En ligne à l'IPL
MSGQ File attente messages
CMNRCYLMT Limites de rétablissement
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGDEVNWSH 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 CHGDEVNWSH permet de modifier une description d'unité NWSH (adaptateur hôte de serveur de réseau).

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
DEVD	Description d'unité	Nom	Obligatoire, clé, positionnel 1
RSRCNAME	Nom de ressource	Nom, SAME, VRT	Facultatif
LCLIFC	Interface (cible) locale	Valeurs uniques: SAME Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Masque sous-réseau	Valeur caractère, *NONE
	Élément 2: Vitesse du port	*AUTO
	Élément 3: Bidirectionnel	*AUTO
	Élément 4: Interface locale SCSI	Liste d'éléments
	Élément 1: Adresse Internet	Valeur caractère
	Élément 2: Adresse de passerelle	Valeur caractère, *NONE
	Élément 3: Port TCP SCSI	1024-65535, 860
	Élément 5: Interface réseau LAN local	Liste d'éléments
	Élément 1: Adresse Internet	Valeur caractère, *IPSCSI
	Élément 2: Adresse de passerelle	Valeur caractère, *NONE
	Élément 3: Port UDP base Ethernet virtuel	1024-65471
	Élément 6: Connexion de câble	NETWORK, DIRECT
ONLINE	En ligne à l'IPL	SAME, NO, *YES	Facultatif
MSGQ	File attente messages	Valeurs uniques: SAME, SYSOPR Autres valeurs: Nom d'objet qualifié	Facultatif
	Qualificatif 1: File attente messages	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
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
	Élément 2: Intervalle	0-120
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Description d'unité (DEVD)

Indique le nom de la description d'unité.

Ce paramètre est obligatoire.

Nom de ressource (RSRCNAME)

Indique le nom de ressource permettant d'identifier le matériel représenté par la description.

Pour déterminer le nom de ressource, utilisez la commande WRKHDWRSC (Gérer les ressources matériel) en indiquant TYPE(*CMN).

*SAME: La valeur ne change pas.

*VRT: Ce nom représente le matériel virtuel (non physique).

Remarque :La valeur indiquée pour le nom de ressource ne peut pas être passée de *VRT (ressource virtuelle) à une autre valeur et inversement, si une valeur autre que *VRT est indiquée, cette valeur ne peut pas être remplacée par *VRT.

nom

Indiquez le nom de ressource Port de l'hôte du serveur de réseau.

Interface (cible) locale (LCLIFC)

Indique la configuration de l'interface locale (cible) pour un adaptateur hôte de serveur de réseau.

Valeurs uniques

*SAME: La valeur ne change pas.

Elément 1 : Masque sous-réseau

Indique le masque de sous-réseau associé à l'interface locale. La fonction de sous-réseau permet de partitionner un domaine Internet.

Remarque :Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), la valeur *NONE doit être indiquée.

*NONE

Il n'existe aucun masque de sous-réseau.

Remarque :*NONE est admis uniquement si RSRCNAME(*VRT) est indiqué.

valeur-alphanumérique

Indiquez le masque pour les zones de sous-réseau et d'adresse hôte de l'adresse Internet qui définit un sous-réseau. Le format du masque de sous-réseau est le suivant : nnn.nnn.nnn.nnn où nnn est un nombre décimal compris entre 0 et 255. Le masque de sous-réseau masque tous les bits de la partie ID réseau de la classe de réseau contenue dans l'adresse Internet. Par exemple, un masque de sous-réseau 255.255.255.0 définit un sous-réseau de classe B composé de tous les bits de la partie réseau de l'adresse Internet et de tous les bits du troisième octet d'une adresse Internet. Si le masque de sous-réseau est tapé à partir d'une ligne de commande, il doit figurer entre apostrophes.

Elément 2 : Vitesse du port

Indique la vitesse du port décrit par l'interface locale.

Remarque :Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), cet élément n'est pas utilisé.

*AUTO

Le matériel détermine automatiquement la vitesse du port.

Elément 3 : Bidirectionnel

Indique le mode duplex utilisé par le port décrit par l'interface locale.

Remarque :Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), cet élément n'est pas utilisé.

*AUTO

Le matériel détermine automatiquement le mode duplex.

Elément 4 : Interface locale SCSI

Indique la configuration SCSI (Small Computer System Interface) locale.

Elément 1 : Adresse Internet

Indique l'adresse Internet locale à laquelle répond l'interface SCSI sur l'adaptateur hôte de serveur de réseau.

valeur-alphanumérique

L'adresse Internet est indiquée au format suivant : nnn.nnn.nnn.nnn où nnn est un nombre décimal compris entre 0 et 255. Une adresse Internet dont la partie ID réseau ou ID hôte a une valeur binaire composée uniquement de 1 ou de 0 n'est pas admise. L'adresse Internet choisie doit être unique au sein du réseau. Si l'adresse Internet locale est entrée à partir d'une ligne de commande, elle doit être placée entre apostrophes.

Elément 2 : Adresse de passerelle

Indique l'adresse de la passerelle pour l'adresse Internet associé à l'interface SCSI.

Remarque :Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), la valeur *NONE doit être indiquée.

*NONE

Il n'existe aucune adresse de passerelle.

valeur-alphanumérique

L'adresse de la passerelle se présente au format ddd.ddd.ddd.ddd (ddd étant un nombre décimal compris entre 0 et 255). Si cette adresse de entrée à partir d'une ligne de commande, elle doit être placée entre apostrophes.

Elément 3 : Port TCP SCSI

Indique le port TCP SCSI local utilisé par l'interface SCSI locale pour écouter le trafic iSCSI. L'adresse Internet de l'interface SCSI locale et le port TCP définissent un portail cible.

numéro-port

Le numéro de port TCP des connexions iSCSI attribué par l'Internet Assigned Numbers Authority (IANA) est 3260. C'est le numéro de port iSCSI par défaut. Le port TCP attribué par l'IANA comme port système iSCSI est 860. Les valeurs admises sont 860 et les valeurs comprises entre 1024 et 65535.

Elément 5 : Interface réseau LAN local

Indique une configuration d'interface LAN (Local Area Network) locale.

Elément 1 : Adresse Internet

Indique l'adresse Internet locale à laquelle répond l'interface LAN sur l'adaptateur hôte de serveur de réseau.

Remarque :Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), la valeur *IPSCSI doit être indiquée.

*IPSCSI

L'adresse Internet LAN locale est identique à l'adresse Internet SCSI locale.

Remarque :*IPSCSI est admis uniquement si RSRCNAME(*VRT) est indiqué.

valeur-alphanumérique

Elément 2 : Adresse de passerelle

Indique l'adresse de la passerelle pour l'adresse Internet associé à l'interface LAN.

Remarque :Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), la valeur *NONE doit être indiquée.

*NONE

Il n'existe aucune adresse de passerelle.

valeur-alphanumérique

Elément 3 : Port UDP base Ethernet virtuel

Indique le plus petit numéro de port UDP (User Datagram Protocol) pouvant être utilisé par l'interface LAN locale pour la communication Ethernet virtuel avec le serveur éloigné.

1024-65471

La communication Ethernet virtuel est encapsulée dans des paquets UDP. Un port UDP est automatiquement affecté à chaque adaptateur Ethernet virtuel ; la valeur de ce port commence par le numéro de port de base indiqué et se termine à ce numéro de port suivi du numéro des adaptateurs Ethernet virtuel configurées. Les valeurs admises sont comprises entre 1024 et 65471.

Elément 6 : Connexion de câble

Indique le type de connexion par câble utilisé par l'interface locale.

*NETWORK: Le câble de l'interface locale est connecté à un réseau.
*DIRECT: Le câble de cette interface locale est connecté directement à une interface du système éloigné.

En ligne à l'IPL (ONLINE)

Indique si cet objet est mis en fonction automatiquement lors de la procédure de chargement initial (IPL).

Remarques :

Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), la valeur *NO est prise en compte.
Une unité d'adaptateur hôte de serveur de réseau (NWSH) paramétrée à RSRCNAME(*VRT) ne peut pas être mise hors fonction tant que les interfaces TCP/IP ne sont pas lancées.

*SAME: La valeur ne change pas.

*YES

L'unité est mise en fonction automatiquement lors de l'IPL.

*NO

L'unité n'est pas mise en fonction automatiquement lors de l'IPL.

File attente messages (MSGQ)

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

Valeurs uniques

*SAME

La valeur reste inchangée.

*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

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Limites de rétablissement (CMNRCYLMT)

Indique les limites applicables à cette description d'unité pour le rétablissement des communications.

Remarque :Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), ce paramètre est ignoré.

Valeurs uniques

*SAME: La valeur ne change pas.

*SYSVAL

Les limites de rétablissement indiquées par la valeur système QCMNRCYLMT sont utilisées.

Elément 1 : Nombre maximal d'essais

0-99

Indiquez le nombre de tentatives de rétablissement à effectuer par le système.

Elément 2 : Intervalle

0-120

Indiquez la période durant laquelle les tentatives de rétablissement sont effectuées.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: Le texte, s'il existe, ne change pas.
*BLANK: Aucun texte n'est spécifié.

valeur-alphanumérique: Tapez un texte d'au plus 50 caractères, entre apostrophes.

Exemples

Exemple 1 : Modification d'une description d'adaptateur hôte de serveur de réseau

CHGDEVNWSH   DEVD(DEVNWSH)  MSGQ(NWSHLIB/NWSHMSGQ)

Cette commande modifie la description de l'adaptateur hôte de serveur de réseau DEVNWSH telle sorte que les messages opérationnels pour cet adaptateur soient dirigés vers la file d'attente de messages NWSHMSGQ dans la bibliothèque NWSHLIB.

Exemple 2 : Modification d'une description d'adaptateur hôte de serveur de réseau virtuel

CHGDEVNWSH   DEVD(VRTNWSH)  RSRCNAME(*SAME)
             LCLIFC(*NONE *AUTO *AUTO
                    ('9.5.149.240' *NONE 3260)
                    (*IPSCSI *NONE 8801)
                     *NETWORK)

Cette commande modifie la description d'une unité d'adaptateur hôte de serveur de réseau nommée VRTNWSH de telle sorte que cette unité ait une adresse Internet SCSI locale différente.

Messages d'erreur

Messages *ESCAPE

CPF2618: Description d'unité &1 non modifiée.