Create NWS Storage Space (CRTNWSSTG)

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

Parameters

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

Network server storage space (NWSSTG)

Specify the name of the network server storage space to be created.

Top

Size (NWSSIZE)

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

*CALC
If the FROMNWSSTG parameter is *NONE, then the size calculated is based on the FORMAT type specified:
  • *NTFS will set the storage space size to '2' MB.
  • *FAT or *OPEN will set the storage space size to '1' MB.
  • *FAT32 will set the storage space size to '512' MB.
  • *NTFSQR will set the storage space size to '500' MB.

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.

1-1024000
Specify the size for the network server storage space, in megabytes.
  • The range for FORMAT(*NTFS) is from 2 to 1024000 megabytes.
  • The range for FORMAT types *FAT, *FAT32, and *OPEN is from 1 to 1024000 megabytes.
  • The range for FORMAT(*NTFSQR) is from 500 to 1024000 megabytes.

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

From storage space (FROMNWSSTG)

Specifies the name of an existing network server storage space that will be copied to the new network server storage space.

*NONE
A copy operation from an existing network server storage space will not be performed.
'name'
An existing network server storage space name used to copy to the new network server storage space being created.
Top

Format (FORMAT)

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.

*NTFS
This storage space format offers the greatest benefit for use by integrated servers using the Master Boot Record (MBR) partitioning scheme used by network server descriptions with a connection type of *WINDOWSNT, *IXSVR or *ISCSI.

The storage space should be formatted using Windows NT File System when linked to Windows network server descriptions.

*FAT
The storage space should be formatted using the File Allocation Table file system.
*FAT32
The storage space should be formatted using the 32-bit File Allocation Table file system.
*OPEN
The storage space should be formatted with an open source file system.

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.

*NTFSQR
The storage space created with this format will contain special attributes which make it linkable as a quorum resource disk used for integrated server clustering.

The storage space should be formatted using Windows NT File System when linked to Windows network server descriptions.

Top

Data offset (OFFSET)

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:

*FORMAT
The data offset sector alignment used will be determined by the network server storage space format type selected.

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.

  • For storage spaces that are 1024 MB or less, the partition should be a multiple of 1 MB.
  • For storage spaces that are 1025 MB to 511000 MB, the partition should be a multiple of 63 MB.
  • For storage spaces that are 511000 MB or greater, the partition should be a multiple of 252 MB.
*NONE
No data offset sector alignment will be used.
*ALIGNLGLPTN
The data offset sector alignment used will align the first logical partition sector. This is the value used by default for when the format type is *NTFS, *FAT, *FAT32 or *NTFSQR. This is appropriate for most PC Server network server description types (*WINDOWSNT, *IXSVR, *ISCSI) which utilize a PC BIOS master boot record to partition disks.
*ALIGNLGLDSK
The data offset sector alignment used will align the first logical disk sector. This is the value used by default for when the format type is *OPEN. This is appropriate for most *GUEST and some network server types that need to access raw disk images.
Top

Auxiliary storage pool ID (ASP)

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.

'1'
The network server storage space is created in the system auxiliary pool ASP 1.
ASP-number
The network server storage space is created in user auxiliary storage pool 2-32 or in independent auxiliary storage pools 33-255.
Top

ASP device (ASPDEV)

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.

ASP-device-name
The device name of the ASP to use for the network server storage space.
Top

Cluster domain name(CLUDMN)

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

Cluster port configuration(CLUPORTCFG)

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

Text 'description' (TEXT)

Specifies text describing the storage space.

*BLANK
Text is not specified.
'description'
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Examples

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

Error messages

*ESCAPE Messages

CPFA42D
Storage space &1 not created.
Top