The Add Network Server Storage Link (ADDNWSSTGL) command is used to add a network storage space link to a network server description.

When *IXSVR is specified for the Network server type (TYPE) parameter in CRTNWSD command:

1. A maximum of 16 network server storage spaces can be linked to a network server description when using standard linking (DYNAMIC *NO specified).

   An additional 32 storage spaces may be dynamically linked to a Windows 2000 server or later with 16 of the 32 links being linked with *UPDATE access ( read/write to only one server ). The remaining 16 links are available for *SHRUPD access ( read/write to multiple clustered Windows Server 2000 or later servers ). The first of these *SHRUPD access links must be to a quorum resource disk ( format *NTFSQR ) at DRVSEQNBR *QR.

   This is only valid when *WIN32 is specified for the Network server type (TYPE) parameter.

2. A maximum of 64 network server storage spaces can be linked to a network server description when using dynamic linking (DYNAMIC *YES specified). The first two storage spaces (1 and 2) must be linked with *UPDATE access (read/write). This is only valid when *LINUX32 is specified for the Network server type (TYPE) parameter.

When *ISCSI is specified for the Network server type (TYPE) parameter in CRTNWSD command:

A maximum of 64 network server storage spaces can be linked to a network server description when using dynamic linking. The first two storage spaces (1 and 2) must be linked with *UPDATE access (read/write).

1. Storage spaces 3-63 can be linked with *UPDATE or *SHRUPD access mode. The last of the 64 storage spaces (64th) must be *SHRUPD access to a quorum resource ( format *NTFSQR ) at DRVSEQNBR *QR when *WIN32 is specified for the Network server type (TYPE) parameter.
2. Storage spaces 3-64 can be linked with *UPDATE or *SHRUPD access mode when *LINUX32 is specified for the Network server type (TYPE) parameter.

When *GUEST is specified for the Network server type (TYPE) parameter in CRTNWSD command:

1. A maximum of 64 network server storage spaces can be linked in any access mode to a network server description when using dynamic linking.

For more information about adding a link to a specific server type, see the following:

• For Server connection specified *IXSVR or *ISCSI for the Network server type (TYPE) parameter in NWSD object - Windows environment on iSeries information in iSeries Information Center at http://www.iseries.ibm.com/infocenter book.

Parameters

Keyword	Description	Choices	Notes
NWSSTG	Network server storage space	Name	Required, Positional 1
NWSD	Network server description	Communications name	Required, Positional 2
DYNAMIC	Dynamic storage link	*NO, *YES	Optional, Positional 3
TYPE	Network server type	Character value, *NWSD	Optional
ACCESS	Access	*UPDATE, *READ, *SHRUPD	Optional
DRVSEQNBR	Drive sequence number	1-64, *CALC, *QR	Optional
STGPTHNBR	Storage path number	1-4, *DFTSTGPTH, *MLTPTHGRP	Optional

Top

Network server storage space (NWSSTG)

Specifies the name of the network server storage space.

This is a required parameter.

Network server description (NWSD)

Specifies the name of the network server description to which this link is to be added.

This is a required parameter.

Dynamic storage link (DYNAMIC)

Specifies whether this storage is to be linked as dynamic storage using the next available location, or linked as static storage using the drive sequence number specified by the DRVSEQNBR parameter.

*NO

The storage space is linked in the standard linking method using the DRVSEQNBR parameter. The NWSD must be in a VARIED OFF state to perform this operation.

*YES

The storage space is linked using dynamic linking. It will use the next available sequence number.

Note: If the Network server description (NWSD) was created with *IXSVR or *ISCSI specified for the Network server type (TYPE) parameter, DYNAMIC parameter will be ignored and considered *YES when the server is installed with Windows 2000 or later, or Linux. If the NWSD was created with *GUEST specified for the Network server type (TYPE) parameter, DYNAMIC parameter will be ignored and considered *YES.

Network server type (TYPE)

Describes the type of network server description to which this link is added.

Note: This parameter is present only for compatibility with previous releases. The value specified is not syntax checked and no verification is done to ensure that the network server description matches the specified TYPE value.

Access (ACCESS)

Specifies the server's access method to the storage space.

*UPDATE

The storage space is accessed in READ/WRITE mode. The storage space can be written to by the server.

*READ

The storage space is accessed in READ-only mode. Write requests to the storage space are not allowed from this server. Multiple servers may be linked to this storage space.

*SHRUPD

The storage space is accessed in shared update mode. The storage space can be written to by the server. Multiple servers may be linked to this storage space. Disks linked to servers in a Windows cluster must be linked as *SHRUPD.

Note: DYNAMIC(*YES) must be specified when ACCESS(*SHRUPD) is specified.

Drive sequence number (DRVSEQNBR)

Specifies the order in which the network storage spaces are presented to the server. Each storage space must be given a unique sequence number.

*CALC

The system will assign the lowest available sequence number.

*QR

The special value used for linking the quorum disk for a Windows cluster.

This value must be used when linking a *NTFSQR format disk as the quorum disk for a Windows cluster. The quorum disk must be linked with ACCESS(*SHRUPD) and it must be the first *SHRUPD link when *IXSVR is specified for the Network server type (TYPE) parameter, or must be the last (64th) when *ISCSI is specified for the Network server type (TYPE) parameter in the CRTNWSD command. Each server in a Windows cluster must be linked to one and only one quorum resource disk. The quorum must also be linked to each server with DYNAMIC(*YES) specified.

1-64

When network server created with Server connection *IXSVR and Server operating system *WIN32:

1. When DYNAMIC(*YES) and ACCESS(*SHRUPD) is specified, a value between 1 and 15 must be specified.
2. When DYNAMIC(*YES) and ACCESS is *UPDATE, a value between 1 and 16 must be specified.
3. When DYNAMIC(*NO) is specified, a value between 3 and 18 must be specified.

When network server created with Server connection *ISCSI and Server operating system *WIN32:

1. Only ACCESS(*UPDATE) is valid for DRVSEQNBR values 1 and 2.
2. When ACCESS *UPDATE or *SHRUPD is specified, a value between 3 and 63 must be specified.

When network server created with Server connection *IXSVR or *ISCSI and Server operating system *LINUX32:

1. Only ACCESS(*UPDATE) is valid for DRVSEQNBR values 1 and 2.
2. When ACCESS *UPDATE or *SHRUPD is specified, a value between 3 and 64 must be specified.

When network server created with Server connection *GUEST:

1. Any access mode can be specified for a value between 1 and 64.

Note: If a non-sequential number is specified for a Network server description (NWSD) created with Server connection specified *IXSVR or *ISCSI for the Network server type (TYPE) parameter, the number may not match the logical unit number on Windows or Linux and unexpected results may occur on drive assignments and applications.

Storage path number (STGPTHNBR)

Specifies the storage path number in the network server description (NWSD) that is used by this storage space.

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

See Storage path (STGPTH) parameter of the network server description on the CRTNWSD or CHGNWSD commands.

*DFTSTGPTH

The storage space is linked to the relative storage path of the file server defined in the Default storage path (DFTSTGPTH) parameter of the network server description.

*MLTPTHGRP

The storage space is linked using a multiple path group as defined on the Multi-path group (MLTPTHGRP) parameter of the network server description.

1-4

The storage space is linked using a specific file server storage path number. Use the DSPNWSD command with OPTION(*STGPTH) to see which storage paths are valid.

Examples

Example 1:Linking Storage Spaces to a Network Server

ADDNWSSTGL   NWSSTG(PARTS)  NWSD(WNTSVR)  DRVSEQNBR(3)
ADDNWSSTGL   NWSSTG(DATA)  NWSD(WNTSVR)  DRVSEQNBR(*CALC)

These commands link storage space PARTS to the Windows server at drive sequence 3, and storage space DATA at the next available sequence number.

Example 2:Linking a Dynamic Storage Space

ADDNWSSTGL  NWSSTG(DATAUPD)  NWSD(W2KSVR)  DYNAMIC(*YES)

This command dynamically links the storage to the Windows server to the next available dynamic storage sequence.

Example 3: Linking Quorum and Shared Storage Spaces

ADDNWSSTGL   NWSSTG(QUORUM)  NWSD(DNETSVR1)  DYNAMIC(*YES)
             ACCESS(*SHRUPD)  DRVSEQNBR(*QR)
ADDNWSSTGL   NWSSTG(QUORUM)  NWSD(DNETSVR2)  DYNAMIC(*YES)
             ACCESS(*SHRUPD)  DRVSEQNBR(*QR)
ADDNWSSTGL   NWSSTG(DATASHR)  NWSD(DNETSVR1)  DYNAMIC(*YES)
             ACCESS(*SHRUPD)  DRVSEQNBR(*CALC)
ADDNWSSTGL   NWSSTG(DATASHR)  NWSD(DNETSVR2)  DYNAMIC(*YES)
             ACCESS(*SHRUPD)  DRVSEQNBR(*CALC)

These commands allow two Windows servers DNETSVR1 and DNETSVR2 to share storage space DATASHR with read/write access.

Example 4: Linking a Storage Path

ADDNWSSTGL  NWSSTG(DATAUPD)  NWSD(W2KSVR)
            STGPTHNBR(*DFTSTGPTH)

This command links the storage to the Windows server using the default storage path identified in the NWSD.

Error messages

*ESCAPE Messages

CPF26BA

Add network server storage link command failed.