Using TSM Macros, Scripts and

SQL
(Implementation and Practical Use)
Laura Buckley

Automating Daily Tasks

Macros
Automate simple repetitive server operations

TSM SQL interface

Provides access to more database information than
QUERY

TSM server scripts

Provide a more robust method for automating
repetitive server operations

Creating Macros
Enter the administrative commands in a text file
- A hyphen or slash continues a line
- Blank lines are ignored
- 256 characters per line without continuation
- 1500 characters with continuation

Substitution variables are allowed

Substitution variables are represented by a % and a
number (i.e. %1, %2)

Comments are preceded and followed by /*

and */

Sample Macro
/*
/*
/*
/*

e x t e n d d b .m a c */
This macro will add a volume to and extend the - */
TSM server database. */
The variables are : %1 = new volume name */

/ * %2 = new volume size */

define dbvol % 1 formatsize=%2 wait=yes
extend db %2

Executing Macros
At the Admin Command Line
macro filename variable
tsm > macro extendb
extendb..mac f:\db3.
f:\db3.dsm
dsm 2000

In batch mode, at the OS prompt

dsmadmc id=admin password=pwd
password=pwd macro
filename variables
dsmadmc id=
id=laura
laura password=snail macro
extenddb..mac f:\db3.
extenddb
f:\db3.dsm
dsm 2000

Commit and Rollback

COMMIT command controls when items
are committed to the db
If an error while processing a macro, the
server rolls back uncommitted changes
Run admin client (dsmadmc
(dsmadmc)) with
ITEMCOMMIT option to commit all changes
Use ROLLBACK as last command to test
macro (with no COMMITs
COMMITs))

Using the TSM SQL Interface

Three system catalog tables
SYSCAT.TABLES = tables that are available
for queries
SYSCAT.COLUMNS = columns that reside in
each table
SYSCAT.ENUM = legal values for
enumerated data types and orders of types

Displaying the System

Catalogs
TSM> select tabschema
tabschema,, tabname
tabname,,
unique_index from syscat
syscat_tables
_tables
TSM>select tabname
tabname,, colname
colname,, typename
from syscat
syscat.columns
.columns
TSM>select typename
typename,, values from
syscat..enumtypes
syscat

Using the TSM SQL Interface

Basic SQL Select structure
SELECT field FROM column
i.e SELECT NODE FROM SESSIONS

Use WHERE clause to specify only

specific criteria to be met
select node_name from nodes where
locked='YES'

Configuring and Using the

ODBC Driver

Works with WinX Operating Systems

Use a spreadsheet or database app to access

information

Select ODBC driver during setup

Update or copy the default TSM ODBC Data Source

Select Data source administrator from control panel

Click once on TSM ODBC Sample User DSN
Click on Configure button
Change name of DSN to the name of the TSM Server
Change server address to your TSM Server IP address
Click OK

Using the ODBC Driver with

MS Query and MS Excel

Open an MS Excel Window

Pull down the Data menu

Select Get external data

Select the TSM Server data source you created or

modified earlier

Click OK

Enter a TSM Administrator/Password combination

The Query Wizard will now be open

Select the tables you want to query

Creating TSM Server Scripts

TSM Server scipts are stored in the TSM
Server database (not text files)
Can be processed interactively or in
batch
Good examples are in the scripts.smp
scripts.smp file
(older versions of TSM)

Creating TSM Server Scripts

Continued
TSM Scripts can include:
Command parameter substitution
SQL SELECT statements
Conditional logical flow statements using the IF
clause and return code values
The EXIT statement to end processing
The GOTO statement to direct logic flow to continue
with the line starting with the specified
Comment lines

Defining and Executing Server

Scripts CLI and File
TSM>define script q_admin_owner select
schedule_name,chg_admin from
admin_schedules description=Display Admin
schedule current owners
TSM>updated script q_admin_owner q event * *
type=admin
Or From a File
TSM>define script q_admin_owner ile
ile=
= qadmin
qadmin.txt
.txt

Defining a Server Script Using

the Web Interface

Expand Object View and Automation

Click Server Command Scripts

Pull Down Operation Define a new command

script

Enter the Script Name

Enter a description

Enter the command lines for the script

Substitution & Logic Flow in

Scripts
Substitution Variables
Represented with $ followed by number
Select $1 from nodes where platform_name=$2

Logic Flow Statements

Test for return code values (rc
(rc_ok,
_ok, warning, error)
See other return code values in Appendix C of
Administrators Reference

Example Script (from

scripts. smp)
'/* ---------------------------------------------*/'
'/* Script Name: Q_NO_ASSOC
*/'
'/* Description: Display nodes in a policy
*/'
'/*
domain that are not associated */'
'/*
with a specific schedule.
*/'
'/* Parameter 1: domain name
*/'
'/* Parameter 2: schedule name
*/'
'/* Example:
run q_no_assoc POLICY SCHEDULE */'
'/* ---------------------------------------------*/'
"select node_name from nodes where -"
" domain_name=upper('$1') and node_name not in -"
" (select node_name from associations where -"
" domain_name=upper('$1') and -"
" schedule_name=upper('$2')) "

Getting Started
Be sure to check out scripts.smp
scripts.smp (server
directory in older versions)
Ask for help from the listserv
Check SQL reference materials
Dig in!