ADDNWSSTGL (Add Network Server Storage Link)

ADDNWSSTGL Command syntax diagram

 

Purpose

The Add Network Server Storage Link (ADDNWSSTGL) command is used to add a network storage space link to a network server description. Up to 16 network server storage spaces can be linked to a *WINDOWSNT network server description using standard static linking. When linking to a *WINDOWSNT server with Windows 2000 or later installed, an additional 32 network storage spaces can be linked. 16 of the dynamic links are reserved for shared storage spaces ( ACCESS *SHRUPD) used for clustering Windows servers. When linking shared storage spaces to a Windows server in a Windows cluster, a special quorum resource disk ( FORMAT *NTFSQR ) must be linked before linking other shared storage spaces. When linking to a *GUEST server 64 storage links of any type are allowed. End of change

More information about using this command is in Communications Configuration

book.

 

Required Parameters

NWSSTG
Specifies the name of the network server storage space.

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

 

Optional Parameters

DYNAMIC
Specifies if 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 in the DRVSEQNBR parameter.

*NO: The storage space is linked in the standard linking method using the DRVSEQNBR parameter as the value to link the storage. The NWSD must be varied off to perform this link.

*YES: The storage space is linked using dynamic linking and will be linked in the next available sequence number of the dynamic linking area of the NWSD.

Note: This parameter is valid only if the network server description (NWSD parameter) was created as TYPE(*WINDOWSNT). *YES can only be specified when Windows 2000 Start of changeor later is installed on the network server.End of change

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

Note: This parameter is valid only if the network server description (NWSD parameter) was created as TYPE(*WINDOWSNT).

*CALC: The system will assign the sequence number for network servers that were created as TYPE(*WINDOWSNT). The system assigns the lowest available sequence number.

*QR: The storage space is linked as the quorum resource for the clustered Windows network server description.

Note: Only one storage space may be linked as the quorum resource for any server, but the storage space may be linked to multiple servers joined together as a cluster. This value can be specified only if the network server description (NWSD parameter) was created as TYPE(*WINDOWSNT) and when Windows 2000 or later is installed.

sequence-number: Specify a number in the range 1 through 64. If a non-sequential number is specified, the number may not match the logical unit number on Windows and unexpected results may occur on drive assignments and applications. For static links ( DYNAMIC(*NO) ) to Windows servers the valid sequence range is 3 through 18. For non-cluster dynamic links ( DYNAMIC(*YES) ) to Windows servers the valid sequence range is 1 through 16. For cluster links ( DYNAMIC(*YES) ACCESS(*SHRUPD) ) the valid range is 1 through 15. For any link to a *GUEST server the valid range is 1 through 64.

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

Note: This parameter is valid only if the network server description (NWSD parameter) was created as TYPE(*WINDOWSNT) and Start of changeis installed with Windows 2000 or later installed>. Access modes of *UPDATE, *READ, or *SHRUPD can be linked as either static storage or dynamic storage. Windows NT 4.0 servers can only link storage as static storage using *UPDATE access mode.

*UPDATE: The storage space is being linked to allow an NWSD to have an exclusive read/write lock to this storage space. No other NWSDs can link to this storage space while the storage is linked as *UPDATE.

*READ: The storage space is being linked to allow an NWSD to have a read only lock to this storage space. Write requests to the storage space will not be allowed from this server. Other NWSDs have the option to link to this same storage space as *READ.

Note: This value is valid for *WINDOWSNT servers when Windows .NET (*WIN2002) or later is installed and the disk is not linked to a *GUEST server. All servers linking the storage space must have *SHRRD as their ACCESS.

*SHRUPD: The storage space is being linked to allow an NWSD to have a shared read/write lock to this storage space.

Note: This value is valid for *WINDOWSNT servers when DRVSEQNBR is *CALC or *QR and DYNAMIC is *YES and the disk is not linked to a *GUEST server. This value is valid for *GUEST servers at any DRVSEQNBR as long as the disk is not linked to a *WINDOWSNT server.>

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.

Examples for ADDNWSSTGL

Example 1: 

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

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

Example 2: 

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

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

Example 3: 

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 2002 (Dot Net) servers DNETSVR1 and DNETSVR2 to share storage space DATASHR with read/write access.

Example 4: 

ADDNWSSTGL NWSSTG(DATASRC) NWSD(DNETSVR) DYNAMIC(*YES) ACCESS(*SHRUPD)
DRVSEQNBR(*CALC)
ADDNWSSTGL NWSSTG(DATASRC) NWSD(LINUX1) DYNAMIC(*YES) ACCESS(*SHRUPD)
DRVSEQNBR(1)
ADDNWSSTGL NWSSTG(DATASRC) NWSD(LINUX2) DYNAMIC(*YES) ACCESS(*SHRUPD)
DRVSEQNBR(*CALC)

These commands allow two LINUX servers, LINUX1 and LINUX2, and a Windows server, DNETSVR, to share storage space DATASRC with read access.>

Error messages for ADDNWSSTGL

*ESCAPE Messages

CPF26BA
Add network server storage link command failed.