CRTNTWVOL (Create NetWare Volume)

CRTNTWVOL Command syntax diagram

 

Purpose

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 (or a network server storage space can optionally be specified on a local system). If the server is on the local system, the storage space must be linked to the network server description at the time this command is run.

Use the WRKNWSSTG (Work with Network Server Storage Spaces) command to find out which server a storage space is linked to and what device numbers (drives) are assigned to the network server storage spaces.

This command causes the following to happen:

1. A physical volume is created for the network server on the specified storage space.
   
2. A volume object, which represents the physical volume, is automatically placed into the NDS (NetWare Directory Services) tree. The volume object is put into the same container as the server object which represents the network server.
   
3. The volume is mounted if specified.

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

 

Required Parameters

VOL

The name of 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.

SERVER

The name of the server for which the volume is being created. This network server must be active when this command is executed.

 

Optional Parameters

DEVNBR

The device number from which the storage for the volume is allocated.

For local systems, either the DEVNBR or NWSSTG parameter can be specified. If DEVNBR is specified, this is the 'drive' number associated with the network server storage space when using the Work with Network Server Storage Spaces (WRKNWSSTG) command.

For remote servers, DEVNBR must be specified.

NWSSTG

The name of the network server storage space from which the storage for the volume is allocated. This storage space must be linked to the server specified by the NWSD parameter. This parameter can only be specified for the local system as this value is not known for remote servers. Either DEVNBR or NWSSTG parameter must be specified but not both.

SIZE

The size of the volume to be created, specified in megabytes.

*MAXAVAIL: Use the size of the largest area of contiguous free space on the specified device or network server storage space. Use the DSPNWSSTG (Display Network Server Storage Space) command to determine the largest area of contiguous free space on a storage space for a local server.

volume-size: Specify the size of the volume in megabytes. The size specified must be no larger than the largest area of contiguous free space on the specified storage space.

DTACPR

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

*NO: Data compression is not enabled for this volume.

*YES: Data compression is enabled for this volume.

MOUNT

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.

*YES: The volume is created and then mounted.

*NO: The volume is created but not mounted.

TEXT

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

*BLANK: Text is not specified.

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

Examples for CRTNTWVOL

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.

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.

Error messages for CRTNTWVOL

*ESCAPE Messages

FPE0107

Volume &1 not created.