TWS command line environment variables
The TWS command line environment (e.g. composer, conman, etc.) uses environment variables to determine the format of the output. The example shown below was performed using the default settings with no environment variables set and as can be seen results in truncated names indicated by a “+” sign.
[ orb@ardbeg TWA]$ conman sc
Tivoli Workload Scheduler (UNIX)/CONMAN 8.5.1 (20100527)
Licensed Materials – Property of IBM*
5698-WSH
(C) Copyright IBM Corp. 1998, 2009 All rights reserved.
* Trademark of International Business Machines
Installed for user “twsuser”.
Locale LANG set to the following: “en”
Scheduled for (Exp) 11/06/28 (#518) on ARDBEG. Batchman LIVES. Limit: 10,
Fence: 0, Audit Level: 1
%sc
- RUN NODE LIMIT FENCE DATE TIME STATE DOMAIN
- 518 *UNIX MASTER 10 0 11/06/28 07:18 I J MDEA MASTERDM
ARDBEG_+ 518 OTHR BROKER 0 0 11/06/28 07:18 LTI JW MASTERDM
LAPHROA+ 518 UNIX FTA 10 0 11/06/28 07:18 LTI JW MD MASTERDM
Set the environment variables listed below to change the default behaviour
|
Variable name |
Value |
Description |
|
MAESTRO_OUTPUT_STYLE |
LONG |
Display long/short (truncated) names |
|
MAESTROLINES |
0 |
Do not pause at end of each screen/page |
|
MAESTROCOLUMNS |
>120 |
Set to 120 or more to produce full details |
Reissuing the same command after specifying the above variables provides the output shown below
[orb@ardbeg TWA]$ conman sc
Tivoli Workload Scheduler (UNIX)/CONMAN 8.5.1 (20100527)
Licensed Materials – Property of IBM*
5698-WSH
(C) Copyright IBM Corp. 1998, 2009 All rights reserved.
* Trademark of International Business Machines
Installed for user “twsuser”.
Locale LANG set to the following: “en”
Scheduled for (Exp) 11/06/28 (#519) on ARDBEG. Batchman LIVES. Limit: 10,
Fence: 0, Audit Level: 1
%sc
- RUN NODE LIMIT FENCE DATE TIME STATE DOMAIN
- 519 *UNIX MASTER 10 0 11/06/28 07:20 I J MDEA MASTERDM
- 519 OTHR BROKER 0 0 11/06/28 07:20 LTI JW MASTERDM
- 519 UNIX FTA 10 0 11/06/28 07:20 LTI JW MD MASTERDM
The names are now displayed with full names making the output more usable.
Setting the TWS environment variables
The TWS environment settings can be set in the user profile for UNIX/Linux systems and in the User Environment variables for Windows.
Sample UNIX/Linux settings
Add the following lines to the user profile (e.g. ~/.bash_profile)
# Setup the TWS 8.5.1 environment
. /opt/ibm/TWA/twa_env.sh # Note: dot space slash at start!
# Set TWS output format for command line
export MAESTRO_OUTPUT_STYLE=LONG
export MAESTROCOLUMNS=0
export MAESTROLINES=0
cd $TWS_TISDIR # Change to TWS install dir
Sample Windows settings
Use the following script to add the TWS environment variables the currently logged on user profile. This works for Windows XP with SP3 and above, Windows 2003/2008 server. You must restart the command windows for these changes to become active.
@echo off
@rem Set up the TWS 8.5.1 env – assumes default install path
“C:Program FilesIBMTWA\twa_env.cmd”
@rem Set TWS output format for command line
setx MAESTRO_OUTPUT_STYLE “LONG”
setx MAESTROCOLUMNS ”0”
setx MAESTROLINES “0”
Visits: 904