Aller au contenu

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

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

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 :

  1. Si *VRT est indiqué pour le paramètre Nom de ressource (RSRCNAME), la valeur *NO est prise en compte.
  2. 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.

Messages d'erreur

Messages *ESCAPE

CPF261A
Description d'unité &1 non créée à la suite d'erreurs.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.