CHGNTWVOL (Change NetWare Volume)

CHGNTWVOL Command syntax diagram

 

Purpose

The Change NetWare Volume (CHGNTWVOL) command changes a volume on the specified network server. This command can be used to increase the size of the volume (by adding a new volume segment), enable compression, mount or dismount the volume, or change the text description. The network server must be active at the time this command is run.

Restriction: You must have *IOSYSCFG special authority to use this command.

 

Required Parameters

VOL

The name of the volume to be changed.

SERVER

The name of the network server where the volume resides. This network server must be active when this command is executed.

 

Optional Parameters

DEVNBR

The device number from which the storage for the new volume segment is allocated. The DEVNBR or NWSSTG parameter is required if SIZE is specified and is otherwise ignored. Both DEVNBR and NWSSTG parameter cannot be specified at the same time. Use the DSPNTWVOL command to see the device (drive) on which this volume currently resides.

*SAME: The value does not change.

device-number: The number of the device from which the storage for the new volume segment is allocated.

NWSSTG

The name of the network server storage space from which the storage for the new volume segment is allocated for a local server. The NWSSTG or DEVNBR parameter is required if SIZE is specified and is otherwise ignored. Both DEVNBR and NWSSTG parameter cannot be specified at the same time. Use the DSPNTWVOL command to see the storage spaces on which this volume currently resides. This storage space must be linked to the specified network server at the time this command is run.

*SAME: The value does not change.

network-server-storage-space: The name of the network server storage space from which the storage for the new volume segment is allocated.

SEGNBR

The segment number that the volume will be created on, or extended to.

*ANY: The first available segment is used.

segment-number: The number of the segment to be used.

SIZE

The new size of the volume, specified in megabytes. A new volume segment will be created to increase the volume size by the desired amount. If SIZE is specified, NWSSTG or DEVNBR must also be specified. Use the DSPNTWVOL command to see the device (drive) on which this volume currently resides.

If the size specified requires more space than is currently available on the storage space as one contiguous area of free space, the request will fail. For a server on the local system, use the Display Network Server Storage Space (DSPNWSSTG) command to determine the largest area of contiguous free space on a storage space.

*SAME: The value does not change.

*MAXAVAIL: The new size of the volume will be the current size plus the size of the largest area of contiguous free space on the specified network server storage space (NWSSTG parameter) or device (DEVNBR parameter). For a server on the local system, use the Display Network Server Storage Space (DSPNWSSTG) command to determine the largest area of contiguous free space on a storage space.

volume-size-in-megabytes: This is the new size of the volume, in megabytes. The value specified must be larger than the current size of the volume; the size of a volume can not be decreased.

DTACPR

Specifies whether or not to enable data compression for this volume. Note that once compression is turned on for a volume, it can not be turned off.

*SAME: The value does not change.

*YES: Compression is enabled for this volume.

MOUNT

Specifies whether or not to mount this volume. Don't mount volumes that are rarely used because each mounted volume uses some server memory. Volumes can be mounted and dismounted while the server is active.

*SAME: The value does not change.

*YES: Mount the volume.

*NO: Dismount the volume.

TEXT

Specifies the text that briefly describes the volume. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Examples for CHGNTWVOL

Example 1: Enabling Commpression on a Network Server

CHGNTWVOL VOL(APPS) SERVER(MKTING) DTACPR(*YES)

This command enables compression for volume APPS which resides on network server MKTING.

Example 2: Increasing Volume Size on a Local Server

CHGNTWVOL  VOL(APPS) SERVER(MKTING)
           SIZE(500) NWSSTG(STGSPACE1)

This command increases the size of the APPS volume to 500 megabytes. This volume is on server MKTING which needs to be local server because NWSSTG is specified. Storage for the new volume segment is allocated from storage space STGSPACE1.

Error messages for CHGNTWVOL

*ESCAPE Messages

FPE010D

Volume &1 not changed.