Change NetWare Volume (CHGNTWVOL)

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 data compression, enable block suballocation, mount or dismount the volume, or change the text description. The following restrictions apply for NetWare volumes:

A maximum of 8 segments per device is allowed. A device can have a maximum of 8 segments from the same volume or combination of different volumes.
A maximum of 32 segments per volume is allowed. The Create NetWare Volume (CRTNTWVOL) command will create the first segment, CHGNTWVOL can be used up to 31 times to add additional segments.
A maximum of 64 mounted volumes per server is allowed.

The network server must be active at the time this command is run.

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

Parameters

Keyword	Description	Choices	Notes
VOL	Volume	Character value	Required, Key, Positional 1
SERVER	Server	Character value	Required, Key, Positional 2
SIZE	Size of volume	1-8000, SAME, MAXAVAIL	Optional
DEVNBR	Device number	Character value	Optional
SEGNBR	Segment number	0-14, *ANY	Optional
DTACPR	Data compression	SAME, YES, *NO	Optional
BLKSUBALC	Block suballocation	SAME, YES, *NO	Optional
MOUNT	Mount	SAME, YES, *NO	Optional
TEXT	Text	Character value, SAME, VOL	Optional

Top

Size of volume (SIZE)

Specifies the new size of the volume, in megabytes. A new volume segment will be created to increase the volume size by the desired amount. Use the Display NetWare Volume (DSPNTWVOL) command to see the device (drive) on which this volume currently resides.

*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 device (DEBNBR parameter)
1-8000: Specify 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 cannot be decreased.

Device number (DEVNBR)

The device number from which the storage for the new volume segment is allocated. Use the Display NetWare Volume (DSPNTWVOL) command to see the device (drive) on which this volume currently resides.

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

Segment number (SEGNBR)

The number of the segment which the storage for the new volume is allocated.

*ANY: Use the first segment which has the available size requested.
0-14: Specify the number of the segment from which the storage for the volume is to be allocated. Use the Work with NetWare Volumes (WRKNTWVOL) command (F10=Show Segments) to determine which segments are free and available for use.

Data compression (DTACPR)

Specifies whether or not to enable data compression for this volume.

*SAME: The value does not change.
*YES: Compression is enabled for this volume. Note that once compression is turned on for a volume, it cannot be turned off.
*NO: Compression is not enabled for this volume.

Block suballocation (BLKSUBALC)

Specifies whether or not to enable block suballocation for this volume.

*SAME: The value does not change.
*YES: Block suballocation is enabled for this volume. Note that once block suballocation is enabled for a volume, it cannot be turned off.
*NO: Block suballocation is not enabled for this volume.

Mount (MOUNT)

Specifies whether to mount or dismount 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 (TEXT)

Specifies the text that briefly describes the volume.

*SAME: The value does not change.
*VOL: Change the text to the volume name.
character-value: Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

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.