Create Network Server Desc (CRTNWSD)

The Create Network Server Description (CRTNWSD) command creates a description for a network server. The description includes server software parameters, network protocol descriptions and definition of attached communications equipment (for example, line descriptions).

This command should be run from the Configure Network Server (CFGNWS) menu, which includes all of the steps needed to create an initial server configuration.

More information about using this command can be found in the Blade and System x category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Restrictions:

Parameters

Keyword Description Choices Notes
NWSD Network server description Communications name Required, Positional 1
RSRCNAME Resource name Name, *NONE, *AUTO Required, Positional 2
TYPE Network server type Element list Optional, Positional 3
Element 1: Server connection *IXSVR, *ISCSI, *GUEST, *WINDOWSNT
Element 2: Server operating system *WIN32, *AIXPPC, *AUX, *ESX, *ESXE, *LINUX32, *LINUX64, *LINUXPPC, *OPSYS, *WIN64
STGPTH Storage path Values (up to 4 repetitions): Element list Optional
Element 1: Network server host adapter Name, *NONE
Element 2: IP security rules Element list
Element 1: Remote interface 1 rule 1-16, *DFTSECRULE, *NONE
Element 2: Remote interface 2 rule 1-16, *DFTSECRULE, *NONE
Element 3: Remote interface 3 rule 1-16, *DFTSECRULE, *NONE
Element 4: Remote interface 4 rule 1-16, *DFTSECRULE, *NONE
DFTSECRULE Default IP security rule 1-16, *NONE Optional
MLTPTHGRP Multi-path group Single values: *NONE
Other values (up to 4 repetitions): 1-4		 Optional
DFTSTGPTH Default storage path 1-4, 1, *MLTPTHGRP Optional
RMVMEDPTH Removable media path 1-4, 1 Optional
ACTTMR Activation timer 30-1800, 120 Optional
ONLINE Online at IPL *YES, *NO Optional
VRYWAIT Vary on wait 1-15, *NOWAIT Optional
SHUTDTIMO Shutdown timeout 2-45, *TYPE Optional
PARTITION Partition Character value, *NONE Optional
PTNNBR Partition number 1-65535, *NONE Optional
DMNROLE Domain role *DMNCTL, *BKUCTL, *SERVER Optional
PRPDMNUSR Propagate domain users *YES, *NO Optional
LNGVER Language version Integer, *PRIMARY Optional
CODEPAGE Code page Integer, *LNGVER Optional
MSGQ Server message queue Single values: *JOBLOG, *NONE
Other values: Qualified object name		 Optional
Qualifier 1: Server message queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
EVTLOG Event log Single values: *ALL, *NONE
Other values (up to 3 repetitions): *SYS, *SEC, *APP		 Optional
CMNMSGQ Communications message queue Single values: *SYSOPR
Other values: Qualified object name		 Optional
Qualifier 1: Communications message queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
CFGFILE Configuration file Single values: *NONE
Other values: Qualified object name		 Optional
Qualifier 1: Configuration file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
SVRSTGSIZE Server storage space sizes Element list Optional
Element 1: Install source size Integer, *DFT
Element 2: System size Integer, *DFT
SVRSTGASP Server storage space ASP Element list Optional
Element 1: Install source ASP 1-255, 1
Element 2: System ASP 1-255, 1
STGASPDEV Server storage ASP device Element list Optional
Element 1: Install source ASP device Name
Element 2: System ASP device Name
POOL Pool identifier *BASE, *SHRPOOL1, *SHRPOOL2, *SHRPOOL3, *SHRPOOL4, *SHRPOOL5, *SHRPOOL6, *SHRPOOL7, *SHRPOOL8, *SHRPOOL9, *SHRPOOL10, *SHRPOOL11, *SHRPOOL12, *SHRPOOL13, *SHRPOOL14, *SHRPOOL15, *SHRPOOL16, *SHRPOOL17, *SHRPOOL18, *SHRPOOL19, *SHRPOOL20, *SHRPOOL21, *SHRPOOL22, *SHRPOOL23, *SHRPOOL24, *SHRPOOL25, *SHRPOOL26, *SHRPOOL27, *SHRPOOL28, *SHRPOOL29, *SHRPOOL30, *SHRPOOL31, *SHRPOOL32, *SHRPOOL33, *SHRPOOL34, *SHRPOOL35, *SHRPOOL36, *SHRPOOL37, *SHRPOOL38, *SHRPOOL39, *SHRPOOL40, *SHRPOOL41, *SHRPOOL42, *SHRPOOL43, *SHRPOOL44, *SHRPOOL45, *SHRPOOL46, *SHRPOOL47, *SHRPOOL48, *SHRPOOL49, *SHRPOOL50, *SHRPOOL51, *SHRPOOL52, *SHRPOOL53, *SHRPOOL54, *SHRPOOL55, *SHRPOOL56, *SHRPOOL57, *SHRPOOL58, *SHRPOOL59, *SHRPOOL60 Optional
TCPPORTCFG TCP/IP port configuration Single values: *NONE
Other values (up to 9 repetitions): Element list		 Optional
Element 1: Port 1, 2, 3, 4, *INTERNAL, *VRTETHPTP, *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9
Element 2: Internet address Character value
Element 3: Subnet mask Character value
Element 4: Maximum transmission unit Integer, 1500
Element 5: Gateway address Character value, *NONE
TCPRTE TCP/IP route configuration Single values: *NONE
Other values (up to 24 repetitions): Element list		 Optional
Element 1: Route destination Character value, *DFTROUTE
Element 2: Subnet mask Character value, *NONE, *HOST
Element 3: Next hop Character value
TCPHOSTNAM TCP/IP local host name Character value, *NWSD Optional
TCPDMNNAME TCP/IP local domain name Character value, *SYS Optional
TCPNAMSVR TCP/IP name server system Single values: *SYS, *NONE
Other values (up to 3 repetitions): Character value		 Optional
PORTS Ports Single values: *NONE
Other values (up to 5 repetitions): Element list		 Optional
Element 1: Port number 1-2, *INTERNAL, *VRTETHPTP, *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9
Element 2: Line description Name
VRTETHPTH Virtual Ethernet path Single values: *NONE
Other values (up to 5 repetitions): Element list		 Optional
Element 1: Port number *VRTETHPTP, *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9
Element 2: Network server host adapter Name, *DFTSTGPTH
Element 3: IP security rules Element list
Element 1: Remote interface 1 rule 1-16, *DFTSECRULE, *NONE
Element 2: Remote interface 2 rule 1-16, *DFTSECRULE, *NONE
Element 3: Remote interface 3 rule 1-16, *DFTSECRULE, *NONE
Element 4: Remote interface 4 rule 1-16, *DFTSECRULE, *NONE
ALWDEVRSC Allowed device resources Single values: *UNRSTD
Other values (up to 16 repetitions): Name, *ALLTAPE, *ALLOPT		 Optional
RSTDDEVRSC Restricted device resources Single values: *NONE, *ALL
Other values (up to 16 repetitions): Name, *ALLTAPE, *ALLOPT		 Optional
NWSCFG Network server configuration Element list Optional
Element 1: Remote system name Name, *DFT
Element 2: Connection security name Name, *DFT
VRTETHCTLP Virtual Ethernet control port 1024-65535, 8800 Optional
SYNCTIME Synchronize date and time *TYPE, *YES, *NO, *NONE Optional
DSBUSRPRF Disable user profiles *AUTO, *NO Optional
IPLSRC IPL source *NWSSTG, *PANEL, *STMF, A, B, D Optional
IPLSTMF IPL stream file Path name, *NONE Optional
IPLPARM IPL parameters Character value, *NONE Optional
PWRCTL Power control *YES, *NO Optional
SRVOPT Serviceability options Character value, *NONE Optional
AUT Authority Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT Optional
TEXT Text 'description' Character value, *BLANK Optional

Network server description (NWSD)

Specifies the network server description to be created.

Note: The name cannot end with the character at code point X'5B'. That character is converted to a dollar sign ($) character in the ASCII character set. A name cannot end in a dollar sign ($).

This is a required parameter.

communications-name
Specify the name of the network server description.

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware that the description represents.

This is a required parameter.

Notes:

  1. *NONE is valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.
  2. *NONE is valid when Server connection specified *GUEST for the Network server type (TYPE) parameter and the hardware is prior to POWER 5.
  3. *NONE is not valid when Server connection specified *GUEST and Server operating system specified *OPSYS
  4. *AUTO is only valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.
  5. *NONE must be specified when Server connection specified *IXSVR and Server operating system specified *AUX.
*NONE
A hardware resource is not associated with the network server description.
*AUTO
A hardware resource will be determined based on the partition.
name
Specify the File Server IOA resource name.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.

Network server type (TYPE)

Specifies the type of network server description to create. This information consists of two parts including the Server connection and the Server operating system.

Element 1: Server connection

Specifies how the integrated server is connected to the system.

*IXSVR
Create an integrated network server description. The Server operating system value is required for *IXSVR.
*ISCSI
Create a network server description that uses an iSCSI connection. The Server operating system value is required for *ISCSI.
*GUEST
Create a network server description for a guest operating system running in a logical partition. The Server operating system value is optional for *GUEST.

Note: Specifying *GUEST is equivalent to specifying *GUEST with *LINUXPPC for the server operating system.

*WINDOWSNT
Create a Windows network server description. The Server operating system value is ignored for *WINDOWSNT.

Note: Specifying *WINDOWSNT is equivalent to specifying *IXSVR with *WIN32 for the server operating system.

Element 2: Server operating system

Specifies the type of operating system installed on the integrated server.

Note: This element is ignored when *WINDOWSNT is specified on the first element.

*WIN32
Windows x86-32 operating system.

Note: This value is not valid when Server connection specified *GUEST.

*AIXPPC
AIX on POWER operating system.

Note: This value is only valid when Server connection specified *GUEST.

*AUX
An auxiliary server operating system.

Note: This value is only valid when Server connection specified *IXSVR.

*ESX
VMware ESX server.

Note: This value is only valid when Server connection specified *ISCSI.

*ESXE
VMware ESX embedded server.

Note: This value is only valid when Server connection specified *ISCSI.

*LINUX32
Linux x86-32 operating system.

Note: This value is not valid when Server connection specified *GUEST.

*LINUX64
Linux x86-64 operating system.

Note: This value is only valid when Server connection specified *ISCSI.

*LINUXPPC
Linux on POWER operating system.

Note: This value is only valid when Server connection specified *GUEST.

*OPSYS
IBM i on POWER operating system.

Note: This value is only valid when Server connection specified *GUEST.

Note: *OPSYS is only valid on POWER 5 and later hardware.

*WIN64
Windows x86-64 operating system.

Note: This value is only valid when Server connection specified *ISCSI.

Storage path (STGPTH)

Specifies the storage paths the network server description can use.

This information consists of two parts including the Network server host adapter description and the IP security rules for this path.

Note: This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

Values (up to 4 repetitions)

Element 1: Network server host adapter

Note: The network server host adapter name must be unique for each value entered for the Storage path (STGPTH) parameter.

*NONE
This storage path is not configured by this network server description.
name
Specify the name of the network server host adapter (NWSH) device description.

Element 2: IP security rules

Specifies the relative entry of an existing IP security rules (IPSECRULE) parameter, defined in the existing connection security network server configuration that will be used as the initial IP security setting between the hosting and remote system.

Element 1: Remote interface 1 rule

*DFTSECRULE
Remote interface 1 will use IP security rule specified on the Default IP security rule (DFTSECRULE) parameter.
*NONE
Remote interface 1 will not use IP security rule.
1-16
Remote interface 1 will use IP security rule specified.

Element 2: Remote interface 2 rule

*DFTSECRULE
Remote interface 2 will use IP security rule specified on the DFTSECRULE parameter.
*NONE
Remote interface 2 will not use IP security rule.
1-16
Remote interface 2 will use IP security rule specified.

Element 3: Remote interface 3 rule

*DFTSECRULE
Remote interface 3 will use IP security rule specified on the DFTSECRULE parameter.
*NONE
Remote interface 3 will not use IP security rule.
1-16
Remote interface 3 will use IP security rule specified.

Element 4: Remote interface 4 rule

*DFTSECRULE
Remote interface 4 will use IP security rule specified on the DFTSECRULE parameter.
*NONE
Remote interface 4 will not use IP security rule.
1-16
Remote interface 4 will use IP security rule specified.

Default IP security rule (DFTSECRULE)

Specifies the relative entry of the IP security rules (IPSECRULE) parameter, defined in Network server configuration (NWSCFG) of type connection security (*CNNSEC), that will be used for storage and virtual Ethernet connections that are configured to use the default security rule.

Note: This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

*NONE
Remote interfaces will not use IP security rules.
1-16
Remote interfaces will use IP security rule specified.

Multi-path group (MLTPTHGRP)

Specifies the storage paths defined in the Storage path (STGPTH) parameter to use for the multi-path group of storage paths.

Notes:

  1. See the Storage path (STGPTH) parameter to determine what storage paths are valid.
  2. This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

Single values

*NONE
No multi-path group is defined.

Other values (up to 4 repetitions)

1-4
Specify the relative storage path.

Default storage path (DFTSTGPTH)

Specifies the relative default storage path defined in the Storage path (STGPTH) parameter or the multi-path group defined by the Multi-path group (MLTPTHGRP) parameter.

Notes:

  1. See the Storage path (STGPTH) parameter to determine what storage paths are valid.
  2. This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.
1
Specify the first relative storage path.
2-4
Specify the relative storage path.
*MLTPTHGRP
Default storage path will be the multi-path group of storage paths defined in the Multi-path group (MLTPTHGRP) parameter.

Removable media path (RMVMEDPTH)

Specifies the relative storage path defined in the Storage path (STGPTH) parameter to use for removable media.

Notes:

  1. See the Storage path (STGPTH) parameter to determine what storage paths are valid.
  2. This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.
1
Specify the first relative storage path.
2-4
Specify the relative storage path.

Activation timer (ACTTMR)

Specifies the amount of time (in seconds) the system will wait for the connection to be established to the remote server service processor and to power on the remote server.

Note: This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

120
The activate time of 120 seconds is used.
30-1800
Specify the number of seconds to wait.

Online at IPL (ONLINE)

Specifies whether this object is automatically varied on at initial program load (IPL).

Notes:

  1. This parameter is ignored when Server connection specified *IXSVR or *ISCSI for the Network server type (TYPE) parameter. To have the integrated server vary on, use the Change TCP/IP Interface (CHGTCPIFC) command and set the AUTOSTART parameter to *YES for the private LAN line description for the server or a startup program could be called to vary on the servers after IPL processing has completed.
  2. When Server connection specified *GUEST for the Network server type (TYPE) parameter, it is recommended that *NO is specified. A startup program should then be called to vary on the servers after IPL processing has completed.
  3. If more than one network server description is created for a file server resource, only one network server description should specify ONLINE(*YES). If more than one network server description specifies ONLINE(*YES), only the first description, in alphabetical order, is varied on during the IPL.
*YES
The network server description is automatically varied on during the initial program load (IPL).
*NO
The network server description is not automatically varied on during the IPL.

Vary on wait (VRYWAIT)

Specifies the number of minutes to wait for the network server description to vary on synchronously or to vary on asynchronously.

*NOWAIT
The operating system does not wait for the vary on to complete. The network server description is varied on asynchronously.
1-15
Specify the number of minutes to wait. The operating system waits until the network server description is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.

Shutdown timeout (SHUTDTIMO)

Specifies the shutdown timeout value in minutes. This is used to limit the amount of time to allow the asynchronous vary off processing to complete before the network server description is varied off. This processing includes the shutdown of the integrated server operating system.

*TYPE
The shutdown time-out value is based on the network server description type.

Note: The shutdown timeout value is 31 when Server connection specified *GUEST and Server operating system specified *OPSYS for the Network server type (TYPE) parameter. Shutdown timeout value is 15 for all other NWSDs.

2-45
Specify the number of minutes to wait. IBM i waits until the integrated server operating system has shutdown successfully, or until the specified time passes before varying the network server description off.

Note: When Server connection specified *GUEST and Server operating system specified *OPSYS for the Network server type (TYPE) parameter the range is 31 to 45 minutes.

Partition (PARTITION)

Specifies the name of the logical partition to be used by this integrated server.

Notes:

  1. When Server connection specified *GUEST for the Network server type (TYPE) parameter either the Partition (PARTITION) or Partition number (PTNNBR) parameter can be specified but both parameters cannot be specified.
  2. When Server connection specified *GUEST for the Network server type (TYPE) parameter and RSRCNAME is specified, the Partition (PARTITION) and Partition number (PTNNBR) parameter can be set to *NONE.
*NONE
A partition name is not used by this integrated server.
name
Specify the name of the partition to be used by this integrated server. The partition name PRIMARY cannot be specified. Up to 48 characters may be specified.

Partition number (PTNNBR)

Specifies the number of the logical partition to be used by this integrated server.

Notes:

  1. When Server connection specified *GUEST for the Network server type (TYPE) parameter either the Partition (PARTITION) or Partition number (PTNNBR) parameter can be specified but both parameters cannot be specified.
  2. When Server connection specified *GUEST for the Network server type (TYPE) parameter and RSRCNAME is specified, the Partition (PARTITION) and Partition number (PTNNBR) parameter can be set to *NONE.
*NONE
A partition number is not used by this integrated server.
1-65535
Specify the number of the partition to be used by this integrated server.

Domain role (DMNROLE)

Specifies the domain controller role performed by this integrated server.

Note: This parameter is only valid when Server connection specified *WINDOWSNT or Server operating system specified *WIN32, *WIN64, or *AUX for the Network server type (TYPE) parameter.

*DMNCTL
This integrated server is a domain controller within its domain.
*BKUCTL
This integrated server is a backup controller within its domain.
*SERVER
This integrated server is a stand alone server.

Propagate domain users (PRPDMNUSR)

Specifies whether domain user enrollment should be allowed or not for this network server description.

Note: This parameter is only valid when Server connection specified *WINDOWSNT or Server operating system specified *WIN32, *WIN64, or *AUX for the Network server type (TYPE) parameter.

*YES
Propagation of domain user enrollment is allowed for this network server description.
*NO
Propagation of domain user enrollment is not allowed for this network server description.

Language version (LNGVER)

Specifies the national language version used by the integrated server.

Note: This parameter is not valid when Server connection specified *GUEST for Network server type (TYPE) parameter.

*PRIMARY
The language version for the currently installed primary national language is used.
integer
Specify the language version of the integrated server product to be used. The language must be one of the installed versions of the integrated server product. Use the Work with Licensed Programs (LICPGM) menu to determine the installed languages. Language versions are entered in the command as an integer value.

Supported language version values include:

2902
Estonia
2903
Lithuanian
2904
Latvian
2905
Vietnamese
2906
Laotian
2909
English Belgium
2911
Slovenian
2912
Croatian
2914
Serbian
2922
Portuguese
2923
Dutch Netherlands
2924
English
2925
Finnish
2926
Danish
2928
French
2929
German
2930
Japanese Universal
2931
Spanish
2932
Italian
2933
Norwegian
2937
Swedish
2938
English Uppercase DBCS
2939
German Multinational Character Set
2940
French Multinational Character Set
2942
Italian Multinational Character Set
2950
English Uppercase
2954
Arabic
2956
Turkish
2957
Greek
2958
Icelandic
2961
Hebrew
2962
Japanese Kanji
2963
Belgian Dutch Multinational Character Set
2966
Belgian French Multinational Character Set
2972
Thai
2974
Bulgarian
2975
Czech
2976
Hungarian
2978
Polish
2979
Russian
2980
Brazilian Portuguese
2981
Canadian French Multinational Character Set
2984
English DBCS
2986
Korean
2987
Traditional Chinese
2989
Simplified Chinese
2992
Romanian
2994
Slovakian
2995
Albanian
2996
Portuguese Multinational Character Set
2998
Farsi

See the i5/OS globalization topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for more information.

Code page (CODEPAGE)

Specifies the ASCII code page representing the character set to be used by this integrated server. Only certain code pages can be used for a given country or region code.

*LNGVER
Specifies to use the default code page corresponding to the language version (LNGVER) selected.

Note: When Server connection specified *GUEST value 437 will be used.

integer
Specify the ASCII code page which represents the character set used by the integrated server. The code page values that can be used with each country or region code are:
437
United States
850
Multilingual
852
Latin 2 (Czechoslovakia, Hungary, Poland, countries of the former Yugoslavia)
857
Turkish
860
Portuguese
861
Iceland
862
Hebrew-speaking
863
Canada (French-speaking)
864
Arabic-speaking
865
Nordic
866
Russian
932
Japanese
934
Korean
938
Chinese
942
Japanese SAA
944
Korean SAA
948
Chinese SAA
950
Traditional Chinese (DBCS)
1381
Simplified Chinese (DBCS)

Server message queue (MSGQ)

Specifies the message queue to receive integrated server messages.

For details on the type of messages that are sent to this message queue, see the appropriate documentation that is associated with the type of integrated server.

Note: When a value other than *NONE is specified, all integrated server activity will be logged to either the monitor job log or the specified message queue. You should take the appropriate steps to secure this information on IBM i.

One method of restricting access to the integrated server information on IBM i is to create a message queue to contain the server activity. This message queue should be created with AUT(*EXCLUDE) and then any users that are to have access to the integrated server activity can be granted explicit authority to the message queue using the GRTOBJAUT command. Specify this message queue for this parameter.

Single values

*JOBLOG
Messages are placed on the joblog of the monitor job.
*NONE
Messages are not placed on any message queue.

Qualifier 1: Server message queue

name
Specify the name of the message queue to receive messages issued by the integrated server.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Event log (EVTLOG)

Specifies whether or not messages from the event logs are received from the server.

Event log messages are placed in the message queue that is specified for the Server message queue (MSGQ) parameter. The MSGQ value cannot be *NONE if a value other than *NONE is specified for this parameter. See the MSGQ parameter description for more information.

Note: This parameter is only valid when Server connection specified *WINDOWSNT or Server operating system specified *WIN32, *WIN64, or *AUX for the Network server type (TYPE) parameter.

Single values

*ALL
All the event log messages are received.
*NONE
No event log messages are received.

Other values (up to 3 repetitions)

Note: Each value can only be specified once.

*SYS
The system event log messages are received.
*SEC
The security event log messages are received.
*APP
The application event log messages are received.

Communications message queue (CMNMSGQ)

Specifies the name of a message queue to receive network server host adapter communications status messages.

Note: This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

Single values

*SYSOPR
Network server host adapter communications status messages are placed in the system operator message queue.

Qualifier 1: Communications message queue

name
Specify the name of a message queue to receive network server host adapter communications status messages.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Configuration file (CFGFILE)

Specifies the source file containing configuration data to be used in activating or further defining the integrated server.

Note: This parameter is not valid when Server connection specified *GUEST or Server operating system specified *ESX, *ESXE, or *AUX for the Network server type (TYPE) parameter.

Single values

*NONE
No configuration file is specified.

Qualifier 1: Configuration file

name
Specify the name of the source file containing the configuration data members for the server. At the time the server is activated, all members in the file are processed. The file must exist on the system by the time the server is activated.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Server storage space sizes (SVRSTGSIZE)

Specifies the size (in megabytes) of the storage spaces.

Notes:

  1. This parameter is not valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.
  2. This parameter is not valid when Server operating system specified *ESXE for the Network server type (TYPE) parameter.
  3. This parameter is not valid when Server operating system specified *AUX for the Network server type (TYPE) parameter.

Element 1: Install source size

Specifies the size of the storage space used to install the server.

Note: This value is ignored when Server operating system specified *ESX for the Network server type (TYPE) parameter.

*DFT
The default storage space size is to be used.
200-2047
Specifies the number of megabytes to use for the install source storage space size.

Element 2: System size

Specifies the size of the storage space that the integrated server's operating system is installed on.

*DFT
The default storage space size is to be used.
500-1024000
Specifies the number of megabytes to use for the system storage space size.

Server storage space ASP (SVRSTGASP)

Specifies the auxiliary storage pool (ASP) identifiers for the network server storage spaces.

Notes:

  1. This parameter is not valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.
  2. This parameter is not valid when Server operating system specified *ESXE for the Network server type (TYPE) parameter.
  3. This parameter is not valid when Server operating system specified *AUX for the Network server type (TYPE) parameter.
  4. You cannot specify both a SVRSTGASP and STGASPDEV parameter value for the same element.

Element 1: Install source ASP

Specifies the auxiliary storage pool for the network server storage space that holds the files that are used to install the integrated server.

Note: This value is ignored when Server operating system specified *ESX for the Network server type (TYPE) parameter.

1
The network server storage space is created in auxiliary storage pool 1, the system auxiliary storage pool.
2-255
Specify the number of the ASP to be used. Valid values depend on what ASPs are defined on the system.

Element 2: System ASP

Specifies the auxiliary storage pool for the network server storage space that holds the integrated server's operating system.

1
The network server storage space is created in auxiliary storage pool 1, the system auxiliary storage pool.
2-255
Specify the number of the ASP to be used. Valid values depend on what ASPs are defined on the system.

Server storage ASP device (STGASPDEV)

Specifies the auxiliary storage pool (ASP) device names for the network server storage spaces.

Notes:

  1. This parameter is not valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.
  2. This parameter is not valid when Server operating system specified *ESXE for the Network server type (TYPE) parameter.
  3. This parameter is not valid when Server connection specified *IXSVR and Server operating system specified *AUX for the Network server type (TYPE) parameter.
  4. The ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.
  5. You cannot specify both a SVRSTGASP and STGASPDEV parameter value for the same element.

Element 1: Install source ASP device

Specifies the auxiliary storage pool device name for the network server storage space that holds the files that are used to install the integrated server.

Note: This value is ignored when Server operating system specified *ESX for the Network server type (TYPE) parameter.

name
Specify the device name of the ASP to use for the network server storage space.

Element 2: System ASP device

Specifies the auxiliary storage pool (ASP) device for the network server storage space that holds the integrated server's operating system.

name
Specify the device name of the ASP to use for the network server storage space.

Pool identifier (POOL)

Specifies the shared data storage pool this integrated server should use.

Note: This parameter is not valid when Server connection specified *IXSVR or *WINDOWSNT for the Network server type (TYPE) parameter.

*BASE
The base pool is to be used by this integrated server.
*SHRPOOLnn
Specifies the shared pool to be used by this integrated server. There are sixty general-purpose shared pools, identified by special values *SHRPOOL1 to *SHRPOOL60.

TCP/IP port configuration (TCPPORTCFG)

Specifies the TCP/IP configuration values that are specific to a port on the integrated server.

This information consists of five parts including the identification of the integrated server port, the internet address, the subnet mask, MTU and the default gateway assigned to the port.

Note: *NONE cannot be specified when Server connection specified *WINDOWSNT or Server operating system specified *WIN32, *WIN64, *LINUX32 or *LINUX64 for the Network server type (TYPE) parameter.

Single values

*NONE
There is no TCP/IP port configuration.

Other values (up to 9 repetitions)

Element 1: Port

Note: Each value can only be specified once.

1
Integrated server port number 1 is configured.
2
Integrated server port number 2 is configured.
3
Integrated server port number 3 is configured.
4
Integrated server port number 4 is configured.
*INTERNAL
The integrated server internal token ring port is configured.
*VRTETHPTP
The integrated server virtual Ethernet point to point port is configured.
*VRTETHn
Virtual Ethernet port 'n' is configured, where 'n' is a number from 0 to 9.

Element 2: Internet address

character-value
Specify the internet address associated with the integrated server port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

An internet address that has a binary value of all ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the internet address is not valid.

Note: The internet address selected must be unique across all network server descriptions and the IBM i TCP/IP configuration.

Element 3: Subnet mask

character-value
Specify the subnet mask associated with the integrated server port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Element 4: Maximum transmission unit

1500
The maximum transmission unit (MTU) default value is 1500 bytes.
68-65535
Specifies the maximum transmission unit (MTU) value for the interface.

Element 5: Gateway address

*NONE
There is no gateway address.
character-value
Specify the gateway address associated with the integrated server port.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

TCP/IP route configuration (TCPRTE)

Specifies routes to remote destination systems or networks to the Transmission Control Protocol/Internet Protocol (TCP/IP) configuration for the integrated server.

A route specification has three elements: the route destination, the subnet mask, and the next hop internet address.

Two values uniquely define a route. They are the route destination field and the subnet mask. For *DFTROUTE values, the next hop element uniquely defines the route.

Notes:

  1. This parameter is only valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.
  2. *NONE must be specified when TCPPORTCFG(*NONE) is specified.

Single values

*NONE
There is no routing specification needed for the integrated server.

Other values (up to 24 repetitions)

Element 1: Route destination

Specifies the remote network or host that is being added. The user must specify all four bytes that make up an internet address though some of the bytes may be equal to 0.

For example, a route to all the hosts on the 9.5.11 subnet is identified by entering 9.5.11.0 for the route destination. Used in combination with a subnet mask, the route destination will identify a route to a network or system.

*DFTROUTE
A TCP/IP default route is being added. A default route entry is used by the system to route data that is being sent to an undefined network or system. Multiple *DFTROUTE entries may be specified. The *DFTROUTE entries are used in the order specified. If a particular next hop gateway on a *DFTROUTE entry is not available, then the subsequent *DFTROUTE entry's next hop gateway specified will be used. This will continue until a *DFTROUTE entry's gateway is found that is active or the list of next hop gateway values is exhausted.
character-value
Specify the route destination being added. The route destination can be specified in the form, nnn.0.0.0 for Class A, nnn.nnn.0.0 for Class B, and nnn.nnn.nnn.0 for Class C, or nnn.nnn.nnn.nnn for any combination thereof, where nnn is a decimal number ranging from 0 through 255.

Note: Any combination thereof means that you may specify a route, such as 9.5.0.0 to the hosts on the 9.5 subnet even though all 9.5.x.x addresses are class A network addresses.

Exceptions:

  • The first byte (octet) must be greater than 0 and less than 255
  • The last byte (octet) may not equal 255.
  • The last byte (octet) may not equal 0 if *HOST is specified for the subnet mask value.
  • Routes to a broadcast address are not allowed.

Element 2: Subnet mask

A subnet mask value must be specified if *DFTROUTE or a route destination is entered for the route destination element. Subnet mask specifies a bit mask that identifies to TCP/IP which bits of the value specified for the route destination compose the network and subnet portions of the internet address. The subnet is identified by combining the route destination internet address and the subnet mask.

*NONE
There is no subnet mask. If *DFTROUTE is specified in the route destination element, then *NONE must be specified. *NONE is valid only for the *DFTROUTE route destination value.
*HOST
The internet address value specified in the route destination field is a host address. The subnet mask value is calculated to be 255.255.255.255.
character-value
Specify the mask of the subnet field.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

For example, a destination route's internet address value of 129.35.11.0 is a Class B subnet. The network ID part of its address is 129.35. The upper 2 bytes must designate 255 in the subnet mask, for example, the subnet mask must appear like 255.255.x.x, where x is determined by the user. The portion of the subnet mask which is associated with the network portion of a particular class of address must equal 255.

Element 3: Next hop

The next hop value specifies the internet address of the next system (gateway) on the route. A route cannot be added unless the internet address specified by the next hop element is directly reachable through a network associated with one of the integrated server ports.

See the Fastpath for TCP/IP book for general information about internet addresses.

character-value
Specify the internet address of the next system on the route.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

The host ID portion and the network ID portion of the internet address may not be all 0 bits or all 1 bits. An internet address that has all binary ones or all binary zeros for the network ID portion or the host ID portion of the internet address is not valid.

TCP/IP local host name (TCPHOSTNAM)

Specifies the short form of the host name associated with the integrated server.

Notes:

  1. *NWSD must be specified if *NONE is specified for the TCP/IP port configuration (TCPPORTCFG) parameter except when *AUX is specified on the Server operating system element of the Network server type (TYPE) parameter.
  2. This parameter is not valid when when Server operating system specified *ESX or *ESXE for the Network server type (TYPE) parameter.
*NWSD
Specifies that the host name for the integrated server is the same as the name of the network server description.
name
Specify a host name to be associated with the integrated server.

The host name can be a text string having 1 through 63 characters.

The following characters are allowed in host names:

  • Alphabetical characters A through Z
  • Digits 0 through 9
  • Minus sign (-)
  • Period (.)
  • Underscore (_)

TCP/IP local domain name (TCPDMNNAME)

Specifies the local domain name associated with the integrated server.

Notes:

  1. *SYS must be specified if *NONE is specified for the TCP/IP port configuration (TCPPORTCFG) parameter except when *AUX is specified on the Server operating system element of the Network server type (TYPE) parameter.
  2. This parameter is not valid when Server operating system specified *ESX or *ESXE for the Network server type (TYPE) parameter.
*SYS
Specifies that the local domain name for the integrated server should be the same value as is configured for IBM i.
character-value
Specify a TCP domain name to be associated with the integrated server.

A domain name can be a text string having 1 to 255 characters. Domain names consist of one or more labels separated by periods. Each label can contain up to 63 characters. The following characters are allowed in domain names:

  • Alphabetical characters A through Z
  • Digits 0 through 9
  • Minus sign (-)
  • Underscore (_)
  • Period (.). Periods are only allowed when they separate labels of domain style name (refer to RFC 1034).

Uppercase and lowercase characters are allowed, but no significance attached to the case. The case is maintained as entered. The first and last character of the host name must be an alphabetic character or a digit.

TCP/IP name server system (TCPNAMSVR)

Specifies the internet address of the name server system that is used by the integrated server.

Notes:

  1. *SYS must be specified if *NONE is specified for the TCP/IP port configuration (TCPPORTCFG) parameter except when *AUX is specified on the Server operating system element of the Network server type (TYPE) parameter.
  2. This parameter is not valid when Server operating system specified *ESX, *ESXE, or *AUX for the Network server type (TYPE) parameter.

Single values

*SYS
The name server systems used by the integrated server should be the same as for IBM i.
*NONE
There is no name server to be used by the integrated server.

Other values (up to 3 repetitions)

character-value
Specify an internet address for the name server system to be used by the integrated server. Up to three remote name server systems can be specified. The name server systems are used in the order they are specified.

The value is specified in the form nnn.nnn.nnn.nnn , where nnn is a decimal number ranging from 0 through 255.

Ports (PORTS)

Specifies the names of the line descriptions attached to the ports of the integrated server.

Note: This parameter is not valid when Server connection specified *GUEST or Server operating system specified *AUX for the Network server type (TYPE) parameter.

Single values

*NONE
No lines are attached to this server. Lines may be attached later by specifying this server description in the line descriptions when they are created.

Other values (up to 5 repetitions)

Element 1: Port number

Note: Each value can only be specified once.

*INTERNAL
The integrated server internal token ring port is configured.

Notes:

  1. *INTERNAL is only valid when Server connection specified *WINDOWSNT for the Network server type (TYPE) parameter.
  2. When *INTERNAL is specified, then the line description must be the name of a token ring network (TRN).
*VRTETHPTP
The integrated server virtual Ethernet point to point port is configured.
*VRTETHn
Virtual Ethernet port 'n' is configured, where 'n' is a number from 0 to 9.
1
Integrated server port number 1 is configured.

Note: This value is not valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

2
Integrated server port number 2 is configured.

Note: This value is not valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

Element 2: Line description

name
Specify the name of an existing line description. The name of a token ring network (TRN) or an Ethernet (ETH) line description can be specified. The line must have been created specifying RSRCNAME(*NWSD), and must not be currently attached to another server. The name of a token ring network (TRN) line description is not valid for server connection type *ISCSI.

Virtual Ethernet path (VRTETHPTH)

Specifies the virtual Ethernet paths the Ethernet line descriptions can use.

This information consists of three parts including the virtual Ethernet port, the Network server host adapter description and the IP security rules for this path.

Note: This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

Single values

*NONE
No virtual Ethernet paths are defined.

Note: This value is only valid when Server operating system specified *ESX or *ESXE for the Network server type (TYPE) parameter.

Other values (up to 5 repetitions)

Element 1: Port number

Note: Each value can only be specified once.

*VRTETHPTP
The integrated server virtual Ethernet point to point port is configured.
*VRTETHn
Virtual Ethernet port 'n' is configured, where 'n' is a number from 0 to 9.

Element 2: Network server host adapter

Note: The network server host adapter name does not need to be unique for each value entered for the Virtual Ethernet path (VRTETHPTH) parameter.

*DFTSTGPTH
Use the Network server host adapter description value specified for the Default storage path (DFTSTGPTH) parameter.

Note: *MLTPTHGRP cannot be specified for the Default storage path (DFTSTGPTH) parameter when *DFTSTGPTH is used.

name
Specify the name of the network server host adapter (NWSH) device description.

Element 3: IP security rules

Specifies the relative entry of an existing IP security rules (IPSECRULE) parameter, defined in the existing connection security network server configuration that will be used as the initial IP security setting between the hosting and remote system.

Element 1: Remote interface 1 rule

*DFTSECRULE
Remote interface 1 will use IP security rule specified on the Default IP security rule (DFTSECRULE) parameter.
*NONE
Remote interface 1 will not use IP security rule.
1-16
Remote interface 1 will use IP security rule specified.

Element 2: Remote interface 2 rule

*DFTSECRULE
Remote interface 2 will use IP security rule specified on the DFTSECRULE parameter.
*NONE
Remote interface 2 will not use IP security rule.
1-16
Remote interface 2 will use IP security rule specified.

Element 3: Remote interface 3 rule

*DFTSECRULE
Remote interface 3 will use IP security rule specified on the DFTSECRULE parameter.
*NONE
Remote interface 3 will not use IP security rule.
1-16
Remote interface 3 will use IP security rule specified.

Element 4: Remote interface 4 rule

*DFTSECRULE
Remote interface 4 will use IP security rule specified on the DFTSECRULE parameter.
*NONE
Remote interface 4 will not use IP security rule.
1-16
Remote interface 4 will use IP security rule specified.

Allowed device resources (ALWDEVRSC)

Specifies the tape and optical device resource names that are allowed and can be used by the integrated server.

The resource is used when the integrated server is active and a request is issued from a client that is running an application. The device resource cannot be used by the client application and IBM i based application at the same time. If the device resource is intended to be used by an application, it will need to be available when the application is ready to use it.

Notes:

  1. This parameter is mutually exclusive with the RSTDDEVRSC parameter. If a value other than *UNRSTD is specified, *NONE must be specified on the RSTDDEVRSC parameter.
  2. Only tape and optical device resources can be allowed.
  3. If other device resources are specified that are not valid or are not detected, they will not allow the network server description to vary on.
  4. This parameter can be changed only while the network server description is varied off.
  5. This parameter is not valid when Server operating system specified *AUX for the Network server type (TYPE) parameter.

Single values

*UNRSTD
All tape and optical device resources not specified on the RSTDDEVRSC parameter are allowed from the integrated server.

Other values (up to 16 repetitions)

Note: Each value can only be specified once.

*ALLOPT
All optical device resources are allowed from the integrated server.
*ALLTAPE
All tape device resources are allowed from the integrated server.
name
Specify the resource name of an allowed device resource that can be used by the integrated server.

Restricted device resources (RSTDDEVRSC)

Specifies the tape and optical device resource names that are restricted and cannot be used by the integrated server.

The resource is used when the integrated server is active and a request is issued from a client that is running an application. The device resource cannot be used by the client application and IBM i based application at the same time. If the device resource is intended to be used by an application, it will need to be available when the application is ready to use it.

Notes:

  1. This parameter is mutually exclusive with the ALWDEVRSC parameter. If a value other than *NONE is specified, *UNRSTD must be specified on the ALWDEVRSC parameter.
  2. Only tape and optical device resources can be restricted.
  3. If other device resources are specified that are not valid or are not detected, they will not allow the network server description to vary on.
  4. This parameter can be changed only while the network server description is varied off.
  5. This parameter is not valid when Server operating system specified *AUX for the Network server type (TYPE) parameter.

Single values

*NONE
No tape and optical device resources are restricted from the integrated server.
*ALL
All tape and optical device resources are restricted from the integrated server.

Other values (up to 16 repetitions)

Note: Each value can only be specified once.

*ALLOPT
All optical device resources are restricted from the integrated server.
*ALLTAPE
All tape device resources are restricted from the integrated server.
name
Specify the resource name of a restricted device that cannot be used by the integrated server.

Network server configuration (NWSCFG)

Specifies the network server configuration descriptions (NWSCFG) to use with this NWSD.

Note: This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

Element 1: Remote system name

*DFT
Use the system generated default remote system network server configuration name of 'nwsdnameRM' where nwsdname is the name of this network server description.
name
Specify the name of an existing remote system network server configuration description.

Element 2: Connection security name

*DFT
Use the system generated default connection security network server configuration name of 'nwsdnameCN' where nwsdname is the name of this network server description.
name
Specify the name of an existing connection security network server configuration description.

Virtual Ethernet control port (VRTETHCTLP)

Specifies the TCP port to use for virtual Ethernet control.

This port listens through the local area network (LAN) interface configured for any network server host adapter (NWSH) device associated with the network server description (NWSD) object on the Virtual Ethernet path (VRTETHPTH) parameter.

Note: This parameter is only valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter.

8800
Use the default TCP port number of 8800.
1024-65535
Specifies the port number identifying the port that is to be used for virtual Ethernet control.

Synchronize date and time (SYNCTIME)

Specifies whether IBM i should synchronize the integrated server date and time with IBM i date and time.

The QTIMZON system value must be set to the correct value for time synchronization to work correctly.

Note: This parameter is not valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.

*TYPE
IBM i will perform synchronization based on the network server description type.

If Server connection specified *IXSVR, *ISCSI or *WINDOWSNT for the Network server type (TYPE) parameter, synchronization will be done as if SYNCTIME(*YES) was specified.

If Server operating system specified *ESX or *ESXE for the for the Network server type (TYPE) parameter, synchronization will be done as if SYNCTIME(*NONE) was specified.

*YES
IBM i will synchronize integrated server date and time with IBM i date and time.

The following occurs when Server connection specified *IXSVR or *ISCSI for the Network server type (TYPE) parameter:

  • If the network server description is varied on, this reset will occur immediately and at least every 30 minutes thereafter.
  • If the network server description is varied off, this reset will occur when the network server description is varied on and at least every 30 minutes thereafter.
*NO
IBM i only synchronizes the integrated server date and time with IBM i date and time once when the network server description is varied on.
*NONE
IBM i will never synchronize the integrated server date and time with the IBM i date and time when the network server description is varied on.

Disable user profiles (DSBUSRPRF)

Specifies whether to disable the integrated servers user profiles if the corresponding IBM i user profiles are disabled.

Note: This parameter is only valid when Server connection specified *WINDOWSNT or Server operating system specified *WIN32, *WIN64, or *AUX for the Network server type (TYPE) parameter.

*AUTO
Integrated server user profiles are disabled if corresponding IBM i user profiles are disabled.
*NO
Integrated server user profiles are not disabled if corresponding IBM i user profiles are disabled.

IPL source (IPLSRC)

Specifies the source of the load image that the partition is started from.

Note: This parameter is only valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.

*NWSSTG
The partition is started using the load image in the first network server storage space attached to this network server description.
*STMF
The partition is started using the load image in the stream file specified by the IPL stream file (IPLSTMF) parameter.

Note: This value is not valid when Server operating system specified *OPSYS for the Network server type (TYPE) parameter.

*PANEL
The partition is started from the source indicated on the operator's panel.
A
The partition is started from the A-source.
B
The partition is started from the B-source.
D
The partition is started from the D-source.

IPL stream file (IPLSTMF)

Specifies the path of the stream file containing the image that the partition should be loaded from.

Note: This parameter is only valid when Server connection specified *GUEST for the Network server type (TYPE) parameter, and *STMF is specified for the IPL source (IPLSRC) parameter.

*NONE
A stream file is not specified.
path-name
Specify the path of the stream file containing the load image. Up to 5000 characters may be specified.

IPL parameters (IPLPARM)

Specifies a string of characters that will be passed to the load image at IPL time. It consists of commands or configuration information for the guest operating system.

Note: This parameter is only valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.

*NONE
IPL parameters are not passed to the load image.

Note: *NONE is only valid value when Server operating system specified *OPSYS for the Network server type (TYPE) parameter.

character-value
Specify a string of up to 256 characters containing the IPL parameters to be passed to the load image.

Power control (PWRCTL)

Specifies whether the integrated server partition will be powered down when the network server description is varied offline or powered up when the network server description is varied online.

Note: This parameter is only valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.

*YES
The integrated server partition will be powered down when the network server description is varied offline or powered up when the network server description is varied online.
*NO
The integrated server partition will not be powered down when the network server description is varied offline and the partition will not be powered up when the network server description is varied online.

Serviceability options (SRVOPT)

Specifies serviceability options. This parameter allows serviceability options to be provided and is intended to be used under the direction of a service provider.

*NONE
No serviceability options provided.
character-value
Specify a value as directed by your service provider.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*CHANGE
The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
*ALL
The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
*USE
The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
*EXCLUDE
The user cannot access the object.
*LIBCRTAUT
The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
name
Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Text 'description' (TEXT)

Specifies the text that briefly describes the network server description.

*BLANK
Text is not specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

Note: The Install Windows Server (INSWNTSVR) or Install Integrated Server (INSINTSVR) command should be used when a Server connection of *ISCSI, *IXSVR or *WINDOWSNT for the Network server type (TYPE) parameter is to be created. More information about using network server descriptions CRTNWSD command can be found in the Blade and System x category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Example 1: Creating a *GUEST NWSD 

CRTNWSD   NWSD(LINUX1) RSRCNAME(*NONE) TYPE(*GUEST *LINUXPPC)
          PARTITION(TEST)
          VRYWAIT(*NOWAIT) CODEPAGE(437) POOL(*SHRPOOL5)
          TCPPORTCFG((1 '9.5.3.2' '255.255.255.0' 2048))
          TCPHOSTNAM(*NWSD)  TCPDMNNAME(*SYS)  TCPNAMSVR(*SYS)

This command creates a network server description named LINUX1. LINUX1 has no associated resource name. LINUX1 is a network server description associated with a guest operating system running in the logical partition named TEST. The TCP/IP protocol stack will be activated when LINUX1 is varied on. Code page 437 (United States) will be used. Port 1 will have TCP/IP internet addresses assigned. Shared storage pool 5 will be used by this NWSD. The TCP/IP local host name is the same as the network server description name. The TCP/IP local domain name is the same as IBM i and the same TCP/IP name server system will be used.

Example 2: Creating a *GUEST NWSD 

CRTNWSD NWSD(MYNWSD) RSRCNAME(CMN04) TYPE(*GUEST *OPSYS)
        PARTITION(TEST) VRYWAIT(*NOWAIT)  CODEPAGE(437)

This command creates a network server description named MYNWSD with a resource name of CMN04. MYNWSD is a network server description associated with a guest operating system running in the logical partition named TEST. The logical partitions operating system is IBM i. Code page 437 (United States) will be used.

Example 3: Creating an *IXSVR NWSD with Server Operating System *AUX 

CRTNWSD NWSD(MYNWSD) RSRCNAME(*NONE) TYPE(*IXSVR *AUX)
        TCPHOSTHAM(MY_HOST)

This command creates a network server description named MYNWSD with a resource name of *NONE. MYNWSD is a network server description associated with an auxiliary integrated server operating system.

Error messages

*ESCAPE Messages

CPF26AC
Network server description &1 not created due to errors.