UPDATE SPACETRIGGER (Update the space triggers)
Use this command to update settings for triggers that determine when and how the server resolves space shortages in storage pools that use sequential-access FILE and random-access DISK device classes.
For storage pools with a parameter RECLAMATIONTYPE=SNAPLOCK, space triggers are not enabled.
See the DEFINE SPACETRIGGER command for more information.
Privilege class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
>>-UPDate SPACETrigger--STG--+---------------------+------------> '-Fullpct--=--percent-' >--+----------------------------+-------------------------------> '-SPACEexpansion--=--percent-' >--+----------------------------+-------------------------------> '-EXPansionprefix--=--prefix-' >--+-------------------------------+--------------------------->< '-STGPOOL--=--storage_pool_name-'
Parameters
- STG (Required)
- Specifies a storage pool space trigger
- Fullpct
- This parameter specifies the utilization percentage
of the storage
pool.
When this value is exceeded, the space trigger creates new volumes.
You can determine storage pool utilization by issuing the QUERY STGPOOL command with FORMAT=DETAILED. The percentage of storage pool utilization for the storage pool is displayed in the field "Space Trigger Util." The calculation for this percentage does not include potential scratch volumes. The calculation for the percentage utilization used for migration and reclamation, however, does include potential scratch volumes.
- SPACEexpansion
For space triggers for sequential-access FILE-type storage pools, this parameter is used in determining the number of additional volumes that are created in the storage pool. Volumes are created using the MAXCAPACITY value from the storage pool's device class. For space triggers for random-access DISK storage pools, the space trigger creates a single volume using the EXPANSIONPREFIX.
- EXPansionprefix
- This specifies the prefix that the server uses to create
new storage
pool files. This parameter is optional and applies only to random-access
DISK device classes. The default prefix is the server installation
path.The prefix can include one or more directory separator characters, for example:
/opt/tivoli/tsm/server/bin/
c:\program files\tivoli\tsm\
You can specify up to 250 characters. If you specify a prefix that is not valid, automatic expansion can fail.
You can specify up to 200 characters. If the server is running as a Windows service, the default prefix is the c:\wnnt\system32 directory. If you specify a prefix that is not valid, automatic expansion can fail.
This parameter is not valid for space triggers for sequential-access FILE storage pools. Prefixes are obtained from the directories specified with the associated device class.
- STGPOOL
- Specifies the storage pool associated
with this space trigger.
If the STGPOOL parameter is not specified, the default storage pool
space trigger is updated.
This parameter does not apply to storage pools with the parameter RECLAMATIONTYPE=SNAPLOCK.
Example: Increase the amount of space for a storage pool
Increase the amount of space in a storage pool by 50 percent when it is filled to 80 percent utilization of existing volumes. Space will be created in the directories associated with the device class.
update spacetrigger stg spaceexpansion=50 stgpool=file
Related commands
Command | Description |
---|---|
DEFINE SPACETRIGGER | Defines a space trigger to expand the space for a storage pool. |
DELETE SPACETRIGGER | Deletes the storage pool space trigger. |
QUERY SPACETRIGGER | Displays information about a storage pool space trigger. |