NAME

gtmmaint - Resources are placed into Maintenance mode via the gtmmaint command. A target resource is specified, and options are provided to only place the target resource into maintenance, the target resource and all its children in the physical tree, the target resource only if it exists in a LOB, or the target resource and it's children in the physical tree only if they exist (individually) in a LOB.

Syntax

gtmmaint -a action -d duration -e effect [-g gmttime -l localtime] [-z delimiter] [-p parentCID -n parentname] -c CID -o name | -c CID -h tivoliostname [-t tcphostname] | -c CID -t tcphostname [-h tivolihostname] | -c CID -i instanceID

Description

The gtmmaint command sets up and deletes maintenance window settings for resources.

Options

-a On-Off-Indicator: (required field) will contain the value of '0' (off) or '1' (on). 'ON" indicates the outage notification will occur immediately if GMT-Start-Time is not specified, or will start at the specified GMT-Start-Time . 'OFF' is an optional means for exiting the outage condition if an exit is required before the scheduled duration has expired or if there was duration equal to 0. If 'OFF' is specified, the Duration-of-Maintenance and GMT-Start-Time fields are ignored (may be blank). -c Target-Object-Type: The TBSM resource type (CID) of the root resource targeted for maintenance. If paired with the -i, -t, or -h flags this can be the cid, cname, or "product;version". If paired with the -o flag, only the cid may be used. -d Duration-of-Maintenance: (required field) in minutes. The maintenance window begins at the time specified by the Object Server timestamp unless the optional GMT Start Time (last field) is specified, and is cleared automatically by TBSM when the duration has expired. The value of zero (0) in this field indicates the duration should be in effect until further notice. Maximum value is 2147483647 . -e Indicates the scope of resources to be placed into maintenance mode Value of '0': Only the resource specified by the Target-Object-Name will be placed into maintenance mode (in both the physical tree and in any LOB which has a view of this resource). Value of '1': The resource specified by the Target-Object-Name, and all of its children in the physical tree, will be placed into maintenance mode (in both the physical tree and in any LOB which has a view of the resource being placed into maintenance mode). Value of '2': If and only if the resource specified by the Target-Object-Name appears in a LOB, then only the resource specified by the Target-Object-Name will be placed into maintenance mode (in both the physical tree and in any LOB which has a view of this resource). Value of '3': The resource specified by the Target-Object-Name, and any of its children in the physical tree, will be placed into maintenance mode (in both the physical tree and in any LOB which has a view of the resource being placed into maintenance mode) if they also appear in any LOB. -g GMT-Start-Time: Optional field indicating the desired start time in GMT (Greenwich Mean Time) format YYYYMMDDHHMMSS -h The Tivoli hostname of the DM resource. This is the value that would appear in the hostname slot of a TEC event. This field is used for distributed resources that were created from DM events. -i The instance identifier associated with a distributed resource that was created with the generic TEC interface ihstttec. -l Local-Start-Time: Optional field indicating the desired start time that will be converted to GMT (Greenwich Mean Time) format YYYYMMDDHHMMSS and sent to the SQL server. -n Unique-Parent-Object-Name: The name of a resource in the parent hierarchy of the resource targeted for maintenance, this resource will be used to uniquely identify the target resource (may be blank if no parent is needed to uniquely identify the target resource). Up to nine names can be specified if paired with the -p flag. -o Target-Object-Name: The name of the root resource targeted for maintenance. This field may be equal to the unique parent resource name. This is not the resource identifer, but the resource name. -p Unique-Parent-Object-Type: The TBSM resource type (Class Identifier (CID)) of a resource in the parent hierarchy (may be blank if no parent is needed to uniquely identify the target resource). Up to nine CIDs can be specified if paired with the -n flag. -t The TCP hostname of the DM resource, short or fully qualified as seen on the parent node's icon label in the physical tree. This is for a distributed resource that was created from a DM TEC event. -z Multiple parent resource names and parent resource types can be specified. When specifying more than one, they should be separated with the delimiter specified by the -z flag. If a delimiter is not specified then the dollar sign ($) is assumed. If resource names can contain a dollar sign, then a different value must be specified.

Notes

This is a shell script. On Windows platforms, specify sh gtmmaint or tserver gtmmaint.