CRTNWSSTG (Create Network Server Storage Space)

CRTNWSSTG Command syntax diagram

 

Purpose

The Create Network Server Storage (CRTNWSSTG) command creates a storage space to be used by a network server.

Restriction: You must have *IOSYSCFG special authority to use this command.

 

Required Parameters

NWSSTG
Specifies the name of the network server storage space to be created.

 

Optional Parameters

NWSSIZE
Specifies the size of the network server storage space to be created.

*CALC: Specifies that the size of the storage space will be calculated based on values specified for other parameters.

  • If a FROMNWSSTG parameter value other than *NONE is specified, the size will be set equal to the size of the specified network server storage space.

  • If FROMNWSSTG(*NONE) is specified, the size is based on the value specified for the FORMAT parameter.

    • For FORMAT(*NTFS) a size of 2 megabytes is used.

    • For FORMAT(*FAT32), a size of 512 megabytes is used.

    • For FORMAT(*NTFSQR), a size of 500 megabytes is used. >

    • For all other FORMAT values, a size of 1 megabyte is used.

network-server-storage-space-size: Specify a size (in megabytes) to create the network server storage space.

  • If a FROMNWSSTG parameter value other than *NONE is specified, the specified size must be greater than or equal to the size of the network server storage space being copied.

  • If the FROMNWSSTG network storage space has a size of 1024 megabytes or less, the NWSSTG network storage space size must also have a size of 1024 megabytes or less.

  • For FORMAT(*FAT), the valid size values range from 1 to 2048 megabytes.

  • For FORMAT(*NTFS), the valid size values range from 2 to 64000 megabytes.

  • For FORMAT(*FAT32), the valid size values range from 512 to 32000 megabytes.

  • For FORMAT(*OPEN), the valid size values range from 1 to 64000 megabytes.

  • For FORMAT(*NTFSQR), the valid size values range from 500 to 64000 megabytes. End of change


FROMNWSSTG
Specifies the name of the network server storage space that is to be copied to the newly created storage space.

*NONE: No existing network server storage space is to be copied to the new network server storage space.

from-network-server-storage-space-name: Specify an existing network server storage space that will be copied into the new network server storage space. When copying an existing network storage space, you cannot specify a value for the FORMAT parameter. The format is determined by the format of the existing network server storage space.

FORMAT
Specifies the format to be used for the storage space. This parameter cannot be specified if a network server storage space name is specified for the FROMNWSSTG parameter.

*NTFS: When created, the storage space is not formatted by the system. Instead, the storage space will need to be formatted by the Windows server.

This option offers the greatest benefit for Windows server because of its better performance and integrated support of long filenames, larger disks, extended file attributes, file-security and recoverability features. The size (NWSSIZE) parameter for a NTFS storage space must be at least 2 megabytes.

*FAT: The storage space will be formatted using the File Allocation Table file system. When this value is specified the NWSSIZE parameter must be less than or equal to 2048.

In most cases, better performance, reliability and compatibility are achieved using the *NTFS format.

Note: When the storage space is initially created and linked to a network server of TYPE(*WINDOWSNT), it is not formatted by the iSeries 400 and must be formatted by the Windows server.

*FAT32: The storage space will be formatted using the File Allocation Table 32 bit file system. When this value is specified the NWSSIZE parameter must be greater than or equal to 512 and less than or equal to 32000.

The primary advantage to this file system is support for partitions larger than those supported by *FAT, while maintaining the greatest level of compatibility with *FAT applications.

In most cases, however, better performance, reliability and compatibility are achieved using the *NTFS format.

Note: When the storage space is initially created and linked to a network server of TYPE(*WINDOWSNT), it is not formatted by the iSeries 400 and must be formatted by the Windows server.

*OPEN: The storage space will not be formatted by the system. The guest operating system using the storage space should perform whatever format operation is required. Storage spaces created with *OPEN can be linked only to network server descriptions of TYPE(*GUEST).

*NTFSQR: When created, the storage space is not formatted by the system. Instead, the storage space will need to be formatted by the Windows server.

This format is used to identify the quorum resource storage space used by a Windows server with the Windows Cluster Service installed. The CLUDMN and CLUPORTCFG parameters must be specified for this format type.

Note: When the storage space is initially created and linked to a network server of TYPE(*WINDOWSNT), it is not formatted by the iSeries 400 and must be formatted by the Windows server.



ASP
Specifies the auxiliary storage pool (ASP) that the network server storage space will be created in.

1: The network server storage space is allocated from the system auxiliary storage pool.

auxiliary-storage-pool-identifier: Specify a value ranging from 1 through 255End of changefor the ASP identifier. Valid values depend on how ASPs are defined on the system.

CLUDMN
Specifies the Windows domain to which the cluster belongs.

cluster-domain-name: Specify the domain name to which the cluster belongs when forming a new cluster.

CLUPORTCFG
Specifies the parameters required to define a Windows Cluster port configuration.

Element 1: Cluster port

Specifies the connection port used for the Cluster service communication.

*VRTETHn: The network server virtual ethernet port 'n' is configured, where 'n' has a value of 0 through 9.

Element 2: Cluster Internet Address

Specifies the internet address for the cluster.

internet-address: Specify the cluster internet address in the form, xxx.yyy.zzz.nnn, where xxx, yyy, zzz, and nnn are decimal numbers ranging from 0 through 255. The internet address selected must be unique across all NWSD objects and the OS/400 TCP/IP configuration.

Note: The internet address selected must be unique across all NWSD objects and the OS/400 TCP/IP configuration.

Element 3: Subnet Mask

subnet-mask: Specifies the subnet mask for the cluster in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255.>

TEXT
Specifies text describing the storage space. If the FROMNWSSTG is specified, the text field is only duplicated when this has been invoked via WRKNWSSTG option 3, otherwise, it will default to blank.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Examples for CRTNWSSTG

Example 1: Create NTFS-format Storage Space 

CRTNWSSTG NWSSTG(STGSPACE3) NWSSIZE(200)
   FORMAT(*NTFS)

This command creates a network server storage space called STGSPACE3 with a size of 200 megabytes. The storage space will not be formatted and must be linked to a NWSD of TYPE(*WINDOWSNT).

Example 2: Copy Existing Storage Space 

CRTNWSSTG NWSSTG(STGSPACE4) NWSSIZE(*CALC)
   FROMNWSSTG(FROMSTG) ASP(3)

This command creates a network server storage space called STGSPACE4 with a size and format the same as FROMSTG and copies the contents into STGSPACE4. It will be created in user auxiliary storage pool 3.

Error messages for CRTNWSSTG

*ESCAPE Messages

CPFA42D
Storage space &1 not created.