QUERY SPACETRIGGER (Query the space triggers)

Use this command to display the settings for storage pool space triggers.

Privilege class

Any administrator can issue this command.

Syntax

Parameters

STG

Specifies a storage pool space trigger.

STGPOOL

Specifies one or more storage pools (using a wildcard) for which storage pool trigger information will be displayed. If STG is specified but STGPOOL is not, the default storage pool space trigger, if any, is displayed.

Tip: Space triggers are enabled for storage pools that use FILE and DISK device classes only.

Restriction: Space triggers are not enabled for storage pools with a parameter RECLAMATIONTYPE=SNAPLOCK or for retention storage pools.

Format

Specifies how the information is displayed. This parameter is optional. The default is STANDARD. Possible values are:

Standard: Specifies that partial information is displayed.
Detailed: Specifies that complete information is displayed.

Example: Display detailed settings for a storage pool space trigger

Issue this command:

query spacetrigger stg stgpool=archivepool format=detailed

         STGPOOL Full Percentage:   50
    STGPOOL Expansion Percentage:   20
        STGPOOL Expansion prefix:   /usr/tivoli/tsm/server/filevol/
                         STGPOOL:   ARCHIVEPOOL
  Last Update by (administrator):   SERVER_CONSOLE
           Last Update Date/Time:   05/10/2004 11:59:59

         STGPOOL Full Percentage:   50
    STGPOOL Expansion Percentage:   20
        STGPOOL Expansion prefix:   /opt/tivoli/tsm/server/filevol/
                         STGPOOL:   ARCHIVEPOOL
  Last Update by (administrator):   SERVER_CONSOLE
           Last Update Date/Time:   05/10/2004 11:59:59

         STGPOOL Full Percentage:   50
    STGPOOL Expansion Percentage:   20
        STGPOOL Expansion prefix:   c:\program files\tivoli\filevol\
                         STGPOOL:   ARCHIVEPOOL
  Last Update by (administrator):   SERVER_CONSOLE
           Last Update Date/Time:   05/10/2004 11:59:59

Field descriptions

STGPOOL Full Percentage: The trigger utilization percentage at which IBM Spectrum® Protect allocates more space for the storage pool.
STGPOOL Expansion Percentage: The percentage of space by which the storage pool should be expanded.
STGPOOL Expansion prefix: The prefix associated with the space trigger.
STGPOOL: The storage pool name associated with the query.
Last Update by (administrator): The administrator who last updated the storage pool space trigger.
Last Update Date/Time: The date and time when the administrator last updated the storage pool space trigger.

Related commands

Table 1. Commands related to QUERY SPACETRIGGER
Command	Description
DEFINE SPACETRIGGER	Defines a space trigger to expand the space for a storage pool.
DELETE SPACETRIGGER	Deletes the storage pool space trigger.
UPDATE SPACETRIGGER	Changes attributes of storage pool space trigger.