Remove Server Storage Link (RMVNWSSTGL)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Remove Network Server Storage Link (RMVNWSSTGL) command is used to remove an existing client storage space link from a network server description.

Notes:

  1. Removing a client storage space link requires updating items such as network aliases that refer to the drive letter at which the storage space is linked.
  2. Removing a client storage space that is linked to a network server description created with Server connection specified *IXSVR or *ISCSI for the Network server type (TYPE) parameter need to take the consideration that if any applications are installed on these drives, the drive may change causing the application to fail.
Top

Parameters

Keyword Description Choices Notes
NWSSTG Network server storage space Name Required, Positional 1
NWSD Network server description Name Required, Positional 2
RENUMBER Renumber link *NO, *YES Optional
Top

Network server storage space (NWSSTG)

Specifies the name of the Network server storage space to be removed from the network server's link list.

This is a required parameter.

Top

Network server description (NWSD)

Specifies the name of the network server description which contains the link to be removed.

This is a required parameter.

Top

Renumber link (RENUMBER)

Specifies whether or not the network storage space links are renumbered.

*NO
After removing the link of the storage space from the Network server description (NWSD) parameter, the sequence numbers will NOT be renumbered sequentially. Gaps may be present in the sequence.
*YES
After removing the link of the storage space from the network server specified (NWSD parameter), the sequence numbers will be renumbered sequentially so that no gaps occur in the sequence.
Top

Examples

Example 1: Removing a Client Storage Space Link

RMVNWSSTGL   NWSSTG(PAINTS)  NWSD(REMODEL)

This command removes the client storage space PAINTS link from the network server REMODEL.

Example 2: Removing and Renumbering a Client Storage Space Link

RMVNWSSTGL   NWSSTG(MAIL)  NWSD(NTSERVER)  RENUMBER(*YES)

This command removes the client storage space MAIL link from the network server NTSERVER and renumbers the sequence number of the remaining linked storage spaces to eliminate any gaps in the sequence.

Note: For more detail on the affect of renumbering client storage spaces that are linked to a network server description that was created with TYPE(*IXSVR *WIN32) or TYPE(*ISCSI *WIN32) or TYPE(*WINDOWSNT) , see the Windows server on iSeries topic in the Information Center.

Top

Error messages

*ESCAPE Messages

CPF26B9
Remove network server storage link command failed.
Top