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 is in the Communications Configuration book, SC41-5401

More information about using this command when Server connection specified *IXSVR and Server operating system specified *WIN32 for the Network server type (TYPE) parameter can be found in the Windows environment on iSeries information in iSeries Information Center at http://www.iseries.ibm.com/infocenter.

Restrictions:

• You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

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, *LINUX32, *LINUXPPC, *AIXPPC
STGPTH	Storage path	Values (up to 4 repetitions): Element list	Optional
	Element 1: Network server host adapter	Communications 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, *MLTPTHGRP	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, 15	Optional
PARTITION	Partition	Character value, *NONE	Optional
PTNNBR	Partition number	Integer, *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
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
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	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	Communications name
	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
RSTDDEVRSC	Restricted device resources	Single values: *NONE, *ALL Other values (up to 10 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
SHUTDPORT	Shutdown TCP port	1024-65535, 8700	Optional
VRTETHCTLP	Virtual Ethernet control port	1024-65535, 8800	Optional
SYNCTIME	Synchronize date and time	*TYPE, *YES, *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
AUT	Authority	Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional

Top

Network server description (NWSD)

Specifies the network server description to be created.

This is a required parameter.

communications-name

Specify the name of the network server description. The name must be a valid communications name. 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, and network servers cannot have names ending in a dollar sign ($).

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware that the description represents. This is a required parameter.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. Specify the resource name of the input/output processor (IOP) or the input/output adapter (IOA) for the file server.

*NONE

A hardware resource is not associated with the network server. This value is only valid when Server connection specified *GUEST or *ISCSI for the Network server type (TYPE) parameter. *NONE is the only valid value when *ISCSI is specified for Server connection on the Network server type (TYPE) parameter.

*AUTO

A hardware resource will be determined based on the partition. This value is only valid when Server connection specified *GUEST for the Network server type (TYPE) parameter.

name

Specify a 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

*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

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

*WIN32

Create a network server description for a 32 bit Windows operating system.

*LINUX32

Create a network server description for a 32 bit Linux operating system.

*LINUXPPC

Create a network server description for a Linux Power PC operating system.

*AIXPPC

Create a network server description for an AIX Power PC operating system.

Storage path (STGPTH)

Specifies the storage paths the storage spaces can use. This information consists of two parts including the Network server host adapter description and the IP security rules for this path. You can enter up to four values for this parameter. You must enter at least one storage path.

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

Element 1: Network server host adapter

name

Specify a name of network server host adapter (NWSH) description. The network server host adapter name must be unique for each STGPTH parameter on this NWSD.

*NONE

This storage path is not used by this network server.

Element 2: IP security rules

Specify any relative entry of the IP security rule (IPSECRULE) parameter, defined in NWS Configuration(NWSCFG) of type *CNNSEC, that will be used for each remote port's security.

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)

Specify any defined 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)

Specify storage paths as defined in the Storage path (STGPTH) parameter.

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 defined.

Other values (up to 4 repetitions)

1-4

Specify at least two relative storage paths.

Default storage path (DFTSTGPTH)

Specify a storage path as defined in the Storage path (STGPTH) parameter or specify the multi-path group as defined in the Multi-path group (MLTPTHGRP) parameter.

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

Default storage path will be storage path 1.

2-4

Default storage path will be storage path 2, 3 or 4.

*MLTPTHGRP

Default storage path will be the multi-path group storage path.

Removable media path (RMVMEDPTH)

Specify a storage path as defined in the Storage path (STGPTH) parameter or specify the multi-path group as defined in the Multi-path group (MLTPTHGRP) parameter.

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

Removable media will use storage path 1.

2-4

Removable media will use storage path 2, 3 or 4.

*MLTPTHGRP

Removable media will use the multi-path group 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's 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.

activation-timer

Specify, in seconds, a value ranging from 30 through 1800.

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 Windows 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 is automatically varied on at IPL. All configuration objects attached to the network server will also be varied on.

*NO

This network server is not automatically varied on at IPL.

Vary on wait (VRYWAIT)

Specifies whether the network server is varied on asynchronously or synchronously. For synchronous vary on, specifies how long the system waits for the vary on to complete.

Note: Vary on of a network server resets the IOP. The vary on wait time specifies time in addition to the reset time.

*NOWAIT

The system does not wait for the vary on to complete. The network server is varied on asynchronously.

1-15

Specify the number of minutes to wait. The system waits until the network server is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.

Shutdown timeout (SHUTDTIMO)

Specifies the network server shutdown timeout value in minutes. This is used to limit the amount of time that the network servers operating system is allowed to shutdown before the network server is varied offline.

15

A shutdown timeout value of 15 minutes is used.

2-45

Specify the number of minutes to wait. The system waits until the network servers operating system has shutdown successfully, or until the specified time passes before varying the network server offline.

Partition (PARTITION)

Specifies the name of the logical partition to be used by this network server. Up to 48 characters can be specified.

Note: 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. 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 network server.

name

Specify the name of the partition to be used by this network server. The partition name PRIMARY cannot be specified.

Partition number (PTNNBR)

Specifies the number of the logical partition to be used by this network 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 network server.

integer

Specify the number of the partition to be used by this network server.

Domain role (DMNROLE)

Specifies the domain controller role performed by this network server.

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

*DMNCTL

This network server is a domain controller within its domain.

*BKUCTL

This network server is a backup controller within its domain.

*SERVER

This network 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 ignored when Server connection specified *GUEST or Server operating system specified *LINUX32 for Network server type (TYPE) parameter.

*YES

Propagation of domain user enrollment is allowed.

*NO

Propagation of domain user enrollment is not allowed.

Language version (LNGVER)

Specifies the language version of the network server product. To change the language version, a new network server description must be created specifying the desired language.

Note: This parameter is not valid when Server connection specified *GUEST or Server operating system specified *LINUX32 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 network server product to be used. The language must be one of the installed versions of the network 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

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 Globalization topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more information.

Code page (CODEPAGE)

Specifies the ASCII code page representing the character set to be used by this network 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. When Server connection specified *GUEST or Server operating system specified *LINUX32 for Network server type (TYPE) parameter, value 437 will be used.

integer

Specify the ASCII code page which represents the character set used by the network 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 server messages.

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

Note: When a value other than *NONE is specified, all 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 the iSeries.

One method of restricting access to the server information on the iSeries 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 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

Causes messages from the server to be placed on the joblog of the monitor job.

*NONE

Causes messages to not be placed on any message queue.

Qualifier 1: Server message queue

name

Specify the name of a message queue to receive messages issued by the 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.

Notes:

1. Event log messages are placed in the message queue that is identified by 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.
2. This parameter is not valid when Server connection specified *GUEST or Server operating system specified *LINUX32 for 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)

*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 communications status messages. This parameter is only valid for server connection type *ISCSI.

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

Single values

*SYSOPR

Causes messages from the server to be placed in the system operator message queue.

Qualifier 1: Communications message queue

name

Specify the name of a message queue to receive status messages issued by the 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.

Configuration file (CFGFILE)

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

Note: This parameter is not valid when Server connection specified *GUEST for 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 of the storage spaces, in megabytes.

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

Element 1: Install source size

Specifies the size of the drive that holds the files that are used to install the server.

*DFT

The default drive size is to be used.

integer

Specifies the number of megabytes to use for the install source drive size. Valid values range from 200 to 2047 megabytes.

Element 2: System size

Specifies the size of the drive that the Windows server is installed on.

*DFT

The default drive size is to be used.

integer

Specifies the number of megabytes to use for the system drive size. Valid values range from 500 to 1024000 megabytes.

Server storage space ASP (SVRSTGASP)

Specifies the auxiliary storage pool (ASP) identifiers for the storage space that will contain the files used to install the Windows server and the storage space that will contain the Windows server operating system.

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

Note: 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 storage space object that holds the files that are used to install the Windows server.

1

The 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 storage space object that holds the Windows server operating system.

1

The 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 for the storage space that will contain the files used to install the Windows server and the storage space that will contain the Windows server operating system.

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

Note: The ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.

Note: 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 storage space object that holds the files that are used to install the Windows server.

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 storage space object that holds the Windows server operating system.

name

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

TCP/IP port configuration (TCPPORTCFG)

Specifies the TCP/IP configuration values that are specific to a port on the network server. This information consists of four parts including the identification of the network server port, the internet address assigned to the port and the subnet mask of the port. You can enter up to nine values for this parameter.

Single values

*NONE

There is no TCP/IP port configuration. *NONE cannot be specified when Server connection specified *IXSVR or *ISCSI for the Network server type (TYPE) parameter.

Element 1: Port

1

Network server port number 1 is configured.

2

Network server port number 2 is configured.

3

Network server port number 3 is configured.

4

Network server port number 4 is configured.

*INTERNAL

The network server internal token ring port is configured.

Note: *INTERNAL is not valid when Server connection specified *ISCSI or *GUEST for the Network server type (TYPE) parameter in the corresponding CRTNWSD command.

*VRTETHPTP

The network server virtual Ethernet point to point port is configured.

*VRTETHn

Virtual Ethernet port 'n' is configured, where 'n' is a number from 1 to 9.

Element 2: Internet address

character-value

Specify the local internet address which the network server responds to when Server connection specified *IXSVR or *ISCSI for the Network server type (TYPE) parameter. The internet address 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. The internet address selected must be unique across all network server descriptions and the i5/OS TCP/IP configuration.

Element 3: Subnet mask

character-value

Specify the subnet mask associated with the network server port. See the TCP/IP Fastpath Setup book for general information about subnets.

Subnetting provides the capability to partition an internet domain. Specify the mask for the network subnet and host address fields of the internet address that defines a subnet. The subnet mask is in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. The subnet mask must mask off all bits of the network class's network ID portion of the internet address. For example, a subnet mask of 255.255.255.0 defines a Class B subnet consisting of all bits in the network portion of the internet address (this is a given) and consisting of all bits in the third byte of an internet address.

Element 4: Maximum transmission unit

1500

The maximum transmission unit (MTU) value is 1500 bytes.

integer

Specifies the MTU value for the interface.

Element 5: Gateway address

character-value

Specify the default gateway address for the internet address 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 network server. A route specification has three elements: the route destination, the subnet mask, and the next hop internet address. A maximum of 24 route specifications can be specified.

Note: This parameter will be ignored when Server connection specified *IXSVR or *ISCSI for the Network server type (TYPE) parameter.

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.

Single values

*NONE

There is no routing specification needed for the network server. *NONE must be specified when TCPPORTCFG(*NONE) is specified. *NONE may be specified if there is no need for route specifications.

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 SUBNETMASK 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 subnetmask value is calculated to be 255.255.255.255.

character-value

Specify the mask of the subnet field. The internet address is 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 network 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 in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255 except that 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 to be associated with the network server.

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

The following characters are allowed in host names:

• Alphabetical characters A through Z
• Digits 0 through 9
• Minus sign (-)

*NWSD

Specifies that the host name for the network server is the same as the name of the network server decsription. *NWSD must be specified if *NONE is specified for the TCP/IP port configuration (TCPPORTCFG) parameter.

name

Specify a host name to be associated with the network server.

TCP/IP local domain name (TCPDMNNAME)

Specifies the local domain name associated with the network server.

A domain name can be a text string having 2 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 (-)
• Period (.). Periods are only allowed when they separate labels of domain style name (refer to RFC 1034).

Other domain name conventions include the following:

• 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.
• Try to limit your domain name labels to 12 characters because shorter labels are easier to remember.
• It is a common practice to use hierarchical names that allow predictable extensions for change and growth. Domain names normally reflect the delegation of authority or hierarchy used to assign them.

For example, the name SYS1.MFG.ABC.COM can be broken down into the following:

COM

All commercial networks.

ABC.COM

All systems in the ABC company's commercial network.

MFG.ABC.COM

All manufacturing systems in the ABC company's commercial network.

SYS1.MFG.ABC.COM

A host named SYS1 in the manufacturing area of the company's commercial network.

In the above example, MFG.ABC.COM is the domain name and SYS1 is the short form of the host name.

The COM designation is one of several domain names used when connecting the Internet. Some of the other domain names are as follows:

COM

Commercial organizations

EDU

Educational institutions

GOV

Government institutions

MIL

Military groups

NET

Major network support centers

ORG

Organizations other than those listed above

Country code

Countries or regions other than USA

*SYS

Specifies that the local domain name for the network server should be the same value as is configured for the iSeries system. *SYS must be specified if TCPPORTCFG(*NONE) is specified. Also, *SYS must be specified if only an *INTERNAL port is specified on the TCPPORTCFG parameter.

character-value

Specify a host name to be associated with the network server.

TCP/IP name server system (TCPNAMSVR)

Specifies the internet address of the name server system that is used by the network server. Typically, this is the same value as it is for the iSeries.

Single values

*SYS

The name server system used by the network server should be the same as for the iSeries. *SYS must be specified if TCPPORTCFG(*NONE) is specified.

*NONE

There is no name server to be used by the network server.

Other values (up to 3 repetitions)

character-value

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

Ports (PORTS)

Specifies the names of the lines attached to the *INTERNAL port, *VRTETH port or to the two line ports on the network server.

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

*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.

Element 1: Port number

*INTERNAL

If *INTERNAL is specified, then the line description must be the name of a token ring network (TRN). Also, *INTERNAL can only be specified for one token ring line description. This value is not valid when Server connection specified *ISCSI for the Network server type (TYPE) parameter in the corresponding CRTNWSD command.

*VRTETHPTP

The network server virtual Ethernet point to point port is configured.

*VRTETHn

Virtual Ethernet port 'n' is configured, where 'n' is a number from 1 to 9.

1

Network server port number 1 is configured. This value is not valid for server connection type *ISCSI.

2

Network server port number 2 is configured. This value is not valid for server connection type *ISCSI.

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. You can enter up to five values for this parameter. You must enter at least one virtual Ethernet path which is the path to be used by the *VRTETHPTP line description.

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

Element 1: Port number

*VRTETHPTP

The network server virtual Ethernet point to point port is configured.

*VRTETHn

Virtual Ethernet port 'n' is configured, where 'n' is a number from 1 to 9.

Element 2: Network server host adapter

name

Specify the name of an existing network server host adapter (NWSH) description. The network server host adapter name does not need to be unique for each VRTETHPTH parameter on this NWSD.

Element 3: IP security rules

Specify any relative entry of the IP security rule (IPSECRULES) parameter, defined in NWS Configuration(NWSCFG) of type *CNNSEC, that will be used for each remote port's security.

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.

Restricted device resources (RSTDDEVRSC)

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

The resource is used when the network server is active and a request is issued from a client application running on the network server. The device resource cannot be used by the application and the i5/OS at the same time. If the device resource is in use by the i5/OS, the network server application will not use this resource. If the device resource is intended to be used by the network server application, it will need to be available when the network server application is ready to use it.

Notes:

1. Only tape and optical device resources can be restricted.
2. If other device resources are specified that are not valid or are not detected, they will not allow the network server to vary on.

Single values

*NONE

No device resources are restricted from the network server. Therefore, any tape or optical device resources that exist on the system can be used.

*ALL

All tape and optical device resources are restricted from being used by the network server.

Other values (up to 10 repetitions)

*ALLOPT

All optical device resources are restricted from being used by the network server.

Note: This value can only be specified once.

*ALLTAPE

All tape resources are restricted from being used by the network server.

Note: This value can only be specified once.

name

Specify the resource name of a restricted device that cannot be used by the network server. Up to 10 restricted device resource names can be specified.

Network server configuration (NWSCFG)

Specifies the network server configuration descriptions to use with this NWSD. This information consists of two parts including the Remote system name and Connection security name

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.

Shutdown TCP port (SHUTDPORT)

Specifies the TCP port to use for shutdown.

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.

8700

Use the TCP port number of 8700.

integer

Specifies the port number identifying the port that is to be used for shutdown. Valid values range from 1024 through 65,535.

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 TCP port number of 8800.

integer

Specifies the port number identifying the port that is to be used for virtual Ethernet control. Valid values range from 1024 through 65,535.

Synchronize date and time (SYNCTIME)

Specifies whether the iSeries should synchronize the network server date and time with the iSeries system date and time.

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

*TYPE

The iSeries will perform synchronization based on the network server type. If Server operating system specified *WIN32 for the Network server type (TYPE) parameter ,synchronization will be done as if SYNCTIME(*YES) was specified.

*YES

The iSeries system will synchronize the network server date and time with the iSeries system date and time.

The following occurs if Server operating system specified *WIN32 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.

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

*NO

The iSeries synchronizes the network server date and time with the iSeries system date and time when the network server description is varied on, but will not keep the date and time synchronized while the network server description is varied on. If the network server description is varied on when this parameter is set to this value, the date and time will no longer be synchronized while the network server description is varied on.

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 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.

*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 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 Network server type (TYPE) parameter.

*NONE

IPL parameters are not passed to the load image.

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 partition associated with the network server description 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 partition associated with the network server description 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 partition associated with the network server description 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.

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

Example 1: Creating a *GUEST NWSD

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

This command creates a 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. The TCP/IP local host name is the same as the server description name. The TCP/IP local domain name is the same as the i5/OS system and the same name server will be used.

Example 2: Creating a Windows *ISCSI NWSD

CRTNWSD NWSD(WINISCSI) RSRCNAME(*NONE) TYPE(*ISCSI *WIN32)
        STGPTH((NWSH1) (NWSH2 (1 1 1 1))) DFTSECRULE(3)
        MLTPTHGRP(1 2) DFTSTGPTH(1) RMVMEDPTH(2) ACTTMR(120)
        CMNMSGQ(MYLIB/MYMSGQ)
        TCPPORTCFG((*VRTETHPTP '9.5.5.5' '255.255.255.0'))
        VRTETHPTH((*VRTETHPTP NWSH1) (*VRTETH5 NWSH2))
        NWSCFG(MYREMOTE MYSECURITY)
        SHUTDPORT(8750) VRTETHCTLP(8850)

This command creates a server description named WINISCSI. WINISCSI has no resource name. WINISCSI is a network server description which has NWSH1 and NWSH2 network server host adapters and asociated IP security rules as its Storage paths, Default IP security rule 3, Multi-path group 1 and 2, Default storage path 1, Removable media path 2, Activation timer 120 seconds, Communications message queue MYMSGQ in MYLIB, Virtual Ethernet paths NWSH1 and NWSH2, Network server configuration MYREMOTE for Remote system name and MYSECURITY for Connection security name, Shutdown TCP port 8750, and Virtual Ethernet control TCP port 8850.

Error messages

*ESCAPE Messages

CPF26AC

Network server description &1 not created due to errors.