Change NWS Storage Space (CHGNWSSTG)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Network Server Storage Space (CHGNWSSTG) command changes a storage space used by a network server. The network storage space must be linked to a network server description before it can be used. For more information see the Add Network Server Storage Link (ADDNWSSTGL) command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| NWSSTG | Network server storage space | Name | Required, Key, Positional 1 |
| NWSSIZE | Size | Integer, *SAME | Optional |
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| RSCALCPTY | Resource allocation priority | 1-9, *SAME | Optional |
| Top |
Network server storage space (NWSSTG)
Specifies the name of the network server storage space to be changed.
| Top |
Size (NWSSIZE)
Specifies the new size for the network server storage space. The specified size must be larger than the current size of the network server storage space.
Note: Size expansion should not be done against storage spaces that are used by IBM i clients. Doing so will cause the guest IBM i to fail and will require a restore of the original NWSSTG.
- *SAME
- The size will not be changed.
- 1-1024000
- Specify the new size for the network server storage space, in megabytes.
- The range for FORMAT types *NTFS and *REFS is from 2 to 1024000 megabytes.
- The range for FORMAT types *FAT, *FAT32, and *OPEN is from 1 to 1024000 megabytes.
| Top |
Text 'description' (TEXT)
Specifies text describing the storage space.
- *SAME
- The text will not be changed.
- *BLANK
- Text is not specified.
- 'description'
- Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Resource allocation priority (RSCALCPTY)
Specifies the relative resource allocation priority to be used by the hosting system to initialize the disk to zeros when the client operating system formats this storage space.
- *SAME
- The resource allocation priority setting will not be changed.
- 1-9
- Specifies a relative resource allocation priority to be used. 1 is the lowest resource allocation priority, 9 is the highest resource allocation priority.
| Top |
Examples
Example 1: Changing the Network Server Storage Space Size
CHGNWSSTG NWSSTG(STGSPACE3) NWSSIZE(200)
This command will increase the network server storage space STGSPACE3 to a size of 200 megabytes. If the current maximum size of STGSPACE3 is greater than 200 megabytes, the command will fail.
Example 2: Changing the Resource Allocation Priority
CHGNWSSTG NWSSTG(STGSPACE5) RSCALCPTY(1)
This command will modify the resource allocation priority to the lowest value. When this storage space is formatted by the client, the hosting operating system will use the least amount of resources to zero out this storage space.
| Top |
Error messages
*ESCAPE Messages
- CPFA489
- Storage space &2 not changed.
- CPFA48A
- Incorrect NWSSIZE value specified for storage space &2.
| Top |