| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create NetWare Volume (CRTNTWVOL) command creates a volume for the specified network server. The network server must be active at the time this command is run. The space is allocated from the device number.
This command causes the following to happen:
The following restrictions apply for NetWare volumes:
Restrictions: You must have *IOSYSCFG special authority to use this command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| VOL | Volume | Character value | Required, Positional 1 |
| SERVER | Server | Character value | Required, Positional 2 |
| SIZE | Size of volume | 1-8000, *MAXAVAIL | Optional |
| DEVNBR | Device number | Character value | Optional |
| SEGNBR | Segment number | 0-14, *ANY | Optional |
| BLKSIZE | Block size | *DFT, 4, 8, 16, 32, 64 | Optional |
| DTACPR | Data compression | *YES, *NO | Optional |
| BLKSUBALC | Block suballocation | *YES, *NO | Optional |
| MOUNT | Mount | *YES, *NO | Optional |
| TEXT | Text | Character value, *VOL | Optional |
| Top |
Specifies the physical volume to be created. By default, the name of the volume object placed into the NDS tree is servername_volumename. The volume name must be 2 - 15 characters long and must be unique within the directory tree.
| Top |
Specifies the server for which the volume is being created. This network server must be active when this command is executed.
| Top |
Specifies the size of the volume to be created, in megabytes.
| Top |
Specifies the device number from which the storage for the volume is allocated. A value of 0 to 99 is allowed to be specified. Use Work with Netware Volumes (WRKNTWVOL) command to find an available device number.
| Top |
Specifies the number of the segment which the new volume is allocated.
| Top |
Specifies the block size of the data in the volume. This value cannot be changed once the volume is created. Volume blocks are the smallest piece of data the server can access in a volume. The larger the block size, the greater the potential for wasted memory. However, if the majority of files are very large, a large block size may be more efficient. Turning on block suballocation will aid in minimizing waste. Block suballocation is controlled by the Block suballocation (BLKSUBALC) parameter.
| Top |
Specifies whether or not to enable data compression for this volume. Note that once data compression is turned on for a volume, it cannot be turned off.
| Top |
Specifies whether or not to enable block suballocation for this volume. Note that once block suballocation is turned on for a volume, it cannot be turned off.
| Top |
Specifies whether or not to mount this volume as soon as it's created. 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.
| Top |
Specifies the text that briefly describes the volume.
| Top |
Example 1: Creating a Physical Volume
CRTNTWVOL VOL(APPS) SERVER(SERVER1) NWSSTG(STGSPACE1)
This command creates physical volume APPS for network server SERVER1 with the size of the largest contiguous free space available on the network server storage space. SERVER1 is a local server (a NWSD of type *NETWARE defined on the local system). The storage is allocated from storage space STGSPACE1. A volume object called SERVER1_APPS is placed into the NDS tree. The volume is mounted by default.
Example 2: Creating a Volume with Specific Size
CRTNTWVOL VOL(VOL1) SERVER(SERVER2) DEVNBR(9)
SIZE(50) DTACPR(*YES) MOUNT(*NO)
This command creates physical volume VOL1 for network server SERVER2 with a size of 50 megabytes. This server may be local or remote. The storage is allocated from device number 9. A volume object called SERVER2_VOL1 is placed into the NDS tree. Data compression is enabled for this volume and the volume is not mounted.
| Top |
| Top |