CRTDEVNWSH
Créer une unité NWSH
En bref
La commande CRTDEVNWSH permet de créer une description d'unité NWSH (adaptateur hôte de serveur de réseau).
CRTDEVNWSH se lit CRT
(Créer) + DEVNWSH.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CRTDEVNWSH DEVD(…) RSRCNAME(…) LCLIFC(…)
Paramètres
-
DEVDDescription d'unité obligatoire -
RSRCNAMENom de ressource obligatoire -
LCLIFCInterface (cible) locale obligatoire -
ONLINEEn ligne à l'IPL -
MSGQFile attente messages -
CMNRCYLMTLimites de rétablissement -
TEXTTexte 'descriptif' -
AUTDroits
Astuce : dans une session 5250, tapez CRTDEVNWSH 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 CRTDEVNWSH permet de créer 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, *VRT | Obligatoire, clé, positionnel 2 |
| LCLIFC | Interface (cible) locale | Liste d'éléments | Obligatoire, positionnel 3 |
| É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, 3260, 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, 8801 | ||
| Élément 6: Connexion de câble | *NETWORK, *DIRECT | ||
| ONLINE | En ligne à l'IPL | *NO, *YES | Facultatif |
| MSGQ | File attente messages | Valeurs uniques: *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: *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 | ||
| TEXT | Texte 'descriptif' | Valeur caractère, *BLANK | Facultatif |
| AUT | Droits | Nom, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT | 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).
Ce paramètre est obligatoire.
- *VRT
-
Ce nom représente le matériel virtuel (non physique).
- 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.
Ce paramètre est obligatoire.
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.
- 3260
Le port 3260 est utilisé comme port TCP SCSI local.
- 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
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 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
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 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é.
- 8801
Le port 8801 est utilisé comme port UDP base Ethernet virtuel.
- 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.
- *NO
L'unité n'est pas mise en fonction automatiquement lors de l'IPL.
- *YES
L'unité est 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
- *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
- *SYSVAL
Les limites de rétablissement indiquées par la valeur système QCMNRCYLMT sont utilisées.
Elément 1 : Nombre maximal d'essais
- 2
Deux tentatives de rétablissement sont effectuées dans l'intervalle indiqué.
- 0-99
Indiquez le nombre de tentatives de rétablissement à effectuer par le système.
Elément 2 : Intervalle
- 5
Le nombre de tentatives de rétablissement indiqué est effectué durant une période de cinq minutes.
- 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.
- *BLANK
- Aucun texte n'est spécifié.
- valeur-alphanumérique
- Indiquez, entre apostrophes, un texte de 50 caractères au maximum.
Droits (AUT)
Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.
- *CHANGE
- L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.
- *ALL
- L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.
- *USE
- L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).
- *EXCLUDE
- L'utilisateur n'a pas accès à l'objet.
- *LIBCRTAUT
- Le système détermine les droits sur l'objet à l'aide de la valeur précisée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.
- nom
- Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.
Exemples
Exemple 1 : Création d'une description d'adaptateur hôte de serveur de réseau
CRTDEVNWSH DEVD(DEVNWSH) RSRCNAME(CMN03)
LCLIFC('255.255.255.128' *AUTO *AUTO
('9.5.149.241' '9.5.149.129' 3260)
('9.5.149.245' '9.5.149.122' 8801)
*DIRECT)
Cette commande permet de créer une description d'adaptateur hôte de serveur de réseau nommée DEVNWSH. Une ressource nommée CMN03 est associée à cette description. Les adresses Internet TCP/IP indiquées seront affectées à l'interface SCSI locale et à l'interface LAN locale. L'interface SCSI locale utilisera la valeur du port TCP par défaut, c'est-à-dire le numéro de port TCP utilisateur largement utilisé pour les connexions iSCSI attribuées par l'IANA. L'interface LAN locale utilisera la valeur de port UDP de base Ethernet virtuel par défaut. Le matériel déterminera la vitesse de port et la valeur de duplex. Le câble de cette interface SCSI locale est connecté directement à une interface du système éloigné.
Exemple 2 : Création d'une description d'adaptateur hôte de serveur de réseau virtuel
CRTDEVNWSH DEVD(VRTNWSH) RSRCNAME(*VRT)
LCLIFC(*NONE *AUTO *AUTO
('9.5.149.241' *NONE 3260)
(*IPSCSI *NONE 8801)
*NETWORK)
Cette commande permet de créer une description d'adaptateur hôte de serveur de réseau virtuel nommée VRTNWSH. La ressource représente le matériel virtuel (et non physique). L'adresse Internet TCP/IP indiquée sera affectée à l'interface SCSI locale. L'adresse Internet LAN locale sera identique à l'adresse SCSI locale. L'interface SCSI locale utilisera la valeur du port TCP par défaut, c'est-à-dire le numéro de port TCP utilisateur largement utilisé pour les connexions iSCSI attribuées par l'IANA. L'interface LAN locale utilisera la valeur de port UDP de base Ethernet virtuel par défaut.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.