Reference Guide › Command Reference › MODIFY Command

MODIFY Command

Use the MODIFY command to change user space allocation in any SFS file pool in which the user ID is already enrolled.

MODIFY userid [blocks [filepool]] [("Options"]

Options:

[FILE [filename]]
[MSG | NOMSG]
[STACK [FIFO | LIFO]]
[FIFO]
[LIFO]

Note: Options can be entered in any order.

Authorizations

You must be the SFS manager for the user ID and you must be authorized to allocate space in the affected file pools, or you must be an SFS administrator.

Definitions

userid

Specifies the user ID whose allocation limits to modify.

[blocks [filepool]]

Specifies the number of 4K blocks to allocate to the user ID in the indicated file pool. (A user ID can be allocated space from only one user storage group in a file pool. CA VM:Director allocates the space from the correct user storage group.)

The number of blocks can be either an absolute value (no leading sign) or a value that is relative to the current allocation (a leading + to increase the current allocation; a leading ‑ to decrease the current allocation). An absolute value (for example, 800) changes the user allocation to that number of blocks. A relative value (for example, +500 or ‑500) increases or decreases the current allocation by that number of blocks.

The default for filepool is your default file pool as defined in CA VM:Director.

[FILE [filename]]

[MSG | NOMSG]

[STACK [FIFO | LIFO]]

[FIFO]

[LIFO]

These options are explained in Common API Command Options.

Description

If you increase a user allocation, CA VM:Director checks that the allocation does not exceed your allocation limit in the affected user storage group, and that it does not exceed the user storage group’s own allocation limit. If it does, the request fails. For instance, if a particular SFS manager can only allocate 200 more blocks in a certain user storage group and you try to increase an allocation of 500 blocks to 800 blocks, your request will fail. Similarly, if there are only 150 blocks remaining to be allocated in a user storage group and you try to increase an allocation of 500 blocks to 800 blocks, your request will fail.

If you decrease a user allocation, CA VM:Director checks that the user still has enough space for the current data. If not, the request fails. For instance, suppose a user allocation is 800 blocks and 650 of those blocks are in use. If you try to decrease the allocation to 600 blocks, the request will fail.

You cannot enroll a user ID in a file pool through this command. If you want to enroll a user ID in a file pool, use the ENROLL command.

Return Codes and Error Messages

The following table lists return codes and error messages for the MODIFY command.

MODIFY Command: Return Codes and Error Messages

The following table describes the return code:

Examples

• User ID PMASON has only 30 blocks of space available in file pool VMXA. To increase PMASON’s allocation by 500 blocks, enter:

  vmdirect modify pmason +500 vmxa
  

• To decrease user ID PDRAKE’s allocation in file pool PRODB by 350 blocks, enter:

  vmdirect modify pdrake ‑350 prodb
  

• To change user ID MARYR’s allocation in file pool FINA to 2,000 blocks, regardless of her current allocation, enter:

  vmdirect modify maryr 2000 fina
  

Note:

• For explanations of the message routing and disconnect options, see Common API Command Options.
• For complete descriptions of all messages listed in this section, see the Message Reference Guide