| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Network Server Storage Space (CRTNWSSTG) command creates a storage space used by a network server. The network storage space must be linked to a network server description before it can be used. For more information see the Add Network Server Storage Link (ADDNWSSTGL) command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| NWSSTG | Network server storage space | Name | Required, Positional 1 |
| NWSSIZE | Size | Integer, *CALC | Optional, Positional 2 |
| FROMNWSSTG | From storage space | Name, *NONE | Optional |
| FORMAT | Format | *NTFS, *FAT, *FAT32, *OPEN, *NTFSQR | Optional |
| OFFSET | Data offset | *FORMAT, *ALIGNLGLPTN, *ALIGNLGLDSK, *NONE | Optional |
| ASP | Auxiliary storage pool ID | 1-255, 1 | Optional |
| ASPDEV | ASP device | Name | Optional |
| CLUDMN | Cluster domain name | Character value | Optional |
| CLUPORTCFG | Cluster port configuration | Element list | Optional |
| Element 1: Connection port | *VRTETH0, *VRTETH1, *VRTETH2, *VRTETH3, *VRTETH4, *VRTETH5, *VRTETH6, *VRTETH7, *VRTETH8, *VRTETH9 | ||
| Element 2: Cluster internet address | Character value | ||
| Element 3: Cluster subnet mask | Character value | ||
| TEXT | Text 'description' | Character value, *BLANK | Optional |
| Top |
Specify the name of the network server storage space to be created.
| Top |
Specifies the size of the network server storage space to be created.
If a valid network server storage space name has been specified in the FROMNWSSTG parameter, the new storage space will be created with the same size as the storage space specified in the FROMNWSSTG parameter.
When a FROMNWSSTG network server storage space is specified, the NWSSIZE parameter must be set equal to or greater than the size of the network server storage space specified in the FROMNWSSTG parameter.
| Top |
Specifies the name of an existing network server storage space that will be copied to the new network server storage space.
| Top |
When a storage space is initially created, it is not formatted by the system. The storage space will need to be linked to a network server description and formatted by the hosted operating system.
The storage space should be formatted using Windows NT File System when linked to Windows network server descriptions.
This storage space format offers the greatest benefit for use by integrated servers used by network server descriptions with a connection type of *GUEST as well as connection types *IXSVR or *ISCSI using some Linux distributions. Refer to specific product documentation for additional guidelines.
The storage space should be formatted using Windows NT File System when linked to Windows network server descriptions.
| Top |
Specifies the data offset sector alignment to use by the system to align the underlying network server storage space with the hosting system pages.
Note: This is an advanced configuration function. Incorrectly setting this parameter may adversely affect actual virtual disk performance.
Network server storage space virtual disk access may realize a performance improvement by specifying a data offset value other than the default value. Many factors influence the actual performance impact. Some factors affecting network server storage space performance include the following:
When a format type of *OPEN is specified, the first sector of the disk image is aligned with the hosting system page by default. This is equivalent to specifying OFFSET(*ALIGNLGLDSK). Refer to the documentation for the specific network server type this will be used with to determine if this is the appropriate type for server type that this will be used with.
For all other format types, the default is to page align the first logical partition.
When a format type of *NTFS, *FAT, *FAT32 or *NTFSQR is specified, the first sector of the logical partition is aligned with the hosting system page by default. This is equivalent to specifying OFFSET(*ALIGNLGLPTN). Secondary partitions may also be aligned when partition sizes are a multiple listed below based on the total size of the network server storage space.
| Top |
Specifies the auxiliary storage pool (ASP) that will contain the new network server storage space.
Note: You cannot specify a value for both the ASP and ASPDEV parameters.
| Top |
Specifies the name of the auxiliary storage pool (ASP) device where storage is allocated for the network server storage space.
Note: The ASP must have been activated (by varying on the ASP device) and have a status of 'Available'.
Note: You cannot specify a value for both the ASP and ASPDEV parameters.
| Top |
Specifies the domain name of the cluster. This is the domain where the cluster service account will be created.
Note: This parameter is required when FORMAT(*NTFSQR) is specified.
| Top |
Specifies the TCP/IP configuration values that are specific to the cluster service. This information consists of three parts including the identification of the cluster connection port, the cluster internet address, and the cluster subnet mask.
Note: This parameter is required when FORMAT(*NTFSQR) is specified.
Element 1: Connection port
Specifies the virtual ethernet port to be configured for this cluster. This connection will be used as a private cluster connection between each cluster node.
Element 2: Cluster internet address
Specifies the internet address of this cluster. 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 zeros for the network identifier (ID) portion or the host ID portion of the internet address is not valid.
Element 3: Cluster subnet mask
Specifies the subnet mask associated with cluster internet address. 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.
| Top |
Specifies text describing the storage space.
| Top |
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.
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 (ASP) 3.
Example 3: Copy and Extend Existing Storage Space
CRTNWSSTG NWSSTG(OPENWEB3) NWSSIZE(10000)
FROMNWSSTG(WEBDATA) OFFSET(*ALIGNFST)
This command creates a network server storage space called OPENWEB3 with a new size of 10000 MB and copies the contents from WEBDATA. The new storage space OPENWEB3 has its data offset alignment sector set to optimize for sector zero page alignment.
| Top |
| Top |