Introduction to gbscmd

During the last few weeks, we have been publishing some sample code to acknowledge or close situations, list running situations etc. Now, here is a Perl program that integrates all these features under one program, gbscmd. The syntax of gbscmd is similar to ITM's tacmd but gbscmd provides the functionalities that are not provided by tacmd by using SOAP method calls.

Pre-requisites

gbscmd requires the TEMS.pm and GBSSoap.pm modules. If you do not have these modules installed, please download it from here. It also requires Getopt::Long module for parsing command line arguments. Getopt::Long module is a built-in module for most of the Perl distributions.

What you can do with gbscmd

At this point, you can do the following operations using gbscmd. However, as we find more SOAP calls, we can easily add more features to this program.

Start a situation

Stop a situation

Acknowledge a situation

Reset (Close) a situation

List running situations

Send message to Universal Message Log

Examples

To start a situation using default userid, password and port settings.

perl gbscmd startsit --server localhost --situation

To stop a situation using default userid and password on a TEMS running on Port 3661

perl gbscmd stopsit --server localhost --port 3661 --situation

To acknowledge a situation using default userid, password and port settings with a default message "Auto-acknowledged".

perl gbscmd acksit --server localhost --situation --source

To close a situation.

perl gbscmd resetSit --server localhost --situation --source

To show currently running situations,

perl gbscmd sitStatusHistory --server localhost

To send a message to Universal Message log or console with severity "low".

perl gbscmd sendMessage --server localhost --message --severity Low

Tips and Notes

You can abbreviate the command line options as long as they are unique, for example, --ser can be used instead of --server.

Options are NOT case sensitive

Unlike tacmd, the credential information is NOT cached anywhere, so if you are using non-default settings, then you have to pass
the authentication information everytime using --user and --password options

Download

gbscmd is available for registered users. Are you a registered user? If so, please contact Tony Delgross by email at tony_delgross@gulfsoft.com or by phone at 919-206-4466. We apologize for the inconvenience. At GulfBreeze, We are fully committed to contributing to Tivoli community and to our customers, but some of our competitors exploit our good intentions deliberately. We are working on making this process as painless as possible for genuine users but please bear with us until then. Thank you very much for your understanding.

Not a registered user? Registration is easy. Please click here to signup.