stefortws_cli

IBM Software Services for Tivoli

IBM Tivoli Support Technical Exchange Web Seminar:TWS Command Line Interface (CLI) Reference

Tuesday, 12 December, 2006

2IBM Software Services for Tivoli

Agenda:

This session will present command-line calls and features, focusing on uses for the built in features of TWS Command Line Interface.Included in this presentation will be:

• Objectives• Where to Find More Information• Command Line Interface• Operating Systems

• Unix• Windows

• TWS Command Line Interface• “conman”• “composer”• Reports• Utilities

• Real world CLI use Scenario• TWS 8.3 Differences• Q&A


Introduction:

This Tivoli Support Technical Exchange web seminar is intended to give the participant a brief insight into the benefits and usefulness of simple operating system, Tivoli Workload Scheduler Command-Line Interface (CLI) components; conman, composer, reports, and utility commands.


Objectives:

Upon completion of this Tivoli Support Technical Exchange web seminar, you will be able to recognize CLI functions and know where to find additional information concerning these functions:

1. operating system command-line utilities

2. TWS CLI tools• conman functions• composer functions• report commands• utilities

3. What’s new in TWS 8.3 Command-Line user Interface


Where to Find More Information:• Product Guides

– http://www-3.ibm.com/software/tivoli/solutions/co/job/ – http://publib.boulder.ibm.com/tividd/td/WorkloadScheduler8.2.html

• Problem Determination Guides http://publib.boulder.ibm.com/tividd/td/WorkloadScheduler8.2.html

• RedBookshttp://www.redbooks.ibm.com/

• Tivoli Support Web Pageshttp://www-306.ibm.com/software/sysmgmt/products/support/

• Training http://www-3.ibm.com/services/learning/us/services/

• Where to go to open a PMR if necessaryhttp://www-306.ibm.com/software/support/probsub.html

• Use Online Help

http://www-950.ibm.com/search/SupportSearchWeb/SupportSearch?pageCode=SPS


Agenda:

This session will present command-line calls and features, focusing on uses for the built in features of TWS Command Line Interface.Included in this presentation will be:

• Objectives• Where to Find More Information• Command Line Interface• Operating Systems

• Unix• Windows

• TWS Command Line Interface• “conman”• “composer”• Reports• Utilities

• Real world CLI use Scenario• TWS 8.3 Differences• Q&A


Operating System Commands


Some operating system tools:

List of Commands

Command Options DescriptionOperating

System

ifconfig Ipconfig ? | /all | … IP settings for the system.

UNIX, Windows

netstat ? | /a | … Network status of the system.UNIX,

Windows

nslookup …Returns name server or any system specified by name or ip address.

UNIX, Windows

ping … Checks for network access to know systemUNIX,

Windows

telnet … Establishes connection to another computerUNIX,

Windows

more … Allows viewing of file contents UNIX

--- --- --- ---


Operating System: ipconfig

C:\>ipconfig

Windows IP Configuration

Ethernet adapter Wireless Network Connection:

Media State . . . . . . . . . . . : Media disconnected

Ethernet adapter Local Area Connection:

Connection-specific DNS Suffix . : austin.ibm.com

IP Address. . . . . . . . . . . . : 9.128.###.###

Subnet Mask . . . . . . . . . . . : 255.255.255.0

Default Gateway . . . . . . . . . : 9.128.###.1


Operating System: netstat (two views)

C:\>netstat

Active Connections

Proto Local Address Foreign Address State

TCP JamesRay:1531 ###10.boulder.ibm.com:1533 ESTABLISHED

TCP JamesRay:1536 #####127.boulder.ibm.com:1352 ESTABLISHED

TCP JamesRay:1097 localhost:1098 ESTABLISHED

***************************************************************************

C:\>netstat

Active Connections

Proto Local Address Foreign Address State

TCP JamesRay:1531 ###10.boulder.ibm.com:1533 ESTABLISHED

TCP JamesRay:1536 #####127.boulder.ibm.com:1352 ESTABLISHED

TCP JamesRay:1569 unknown.Level3.net:https ESTABLISHEDTCP JamesRay:1097 localhost:1098 ESTABLISHED

TCP JamesRay:1098 localhost:1097 ESTABLISHED


Operating System: nslookup (two views)

C:\>nslookup utah.###.ibm.com

Server: blddns01.srv.ibm.com

Address: 9.0.8.1

DNS request timed out.

timeout was 2 seconds.

Non-authoritative answer:

Name: utah.###.ibm.com

Address: 9.48.###.###

**********************************************

C:\>nslookup 9.48.###.###

Server: blddns01.srv.ibm.com

Address: 9.0.8.1

Name: utah.###.ibm.com

Address: 9.48.###.###


Operating System: ping (two views)

C:\>ping 9.48.###.###

Pinging 9.48.###.### with 32 bytes of data:

Reply from 9.48.###.###: bytes=32 time=73ms TTL=115


Ping statistics for 9.48.###.###:

Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),

Approximate round trip times in milli-seconds:

Minimum = 67ms, Maximum = 74ms, Average = 70ms

**********************************************C:\>ping utah.###.ibm.com

Pinging utah.##.##.ibm.com [9.48.###.###] with 32 bytes of data:

Request timed out.


Ping statistics for 9.48.###.###:

Packets: Sent = 4, Received = 3, Lost = 1 (25% loss),

Approximate round trip times in milli-seconds:

Minimum = 63ms, Maximum = 65ms, Average = 63ms


Tivoli Workload Scheduler Command Line Interface (CLI)


conman


conman commands:

List of Commands

Command Short Form DescriptionCPU

Type1

adddep adj | ads Adds job or job stream dependencies. M, F

altpass Alters a User object definition password. M, F

altpri ap Alters job or job stream priorities. M, F

cancel cj | cs Cancels a job or a job stream. M, F

display df | dj |ds Display files, jobs, and job streams M, F, A2

link lk Open CPU links. M, F, A

--- --- --- ---

A complete listing of conman commands can be found in the reference guide.


Special Characters:

+ - Qualifier delimiter used to add qualification criteria.

Example:

% ss @+carryforward

~ - (tilde) Qualifier delimiter used to delete qualification criteria.

Example:

% sj @~state=exec, hold

& - Command delimiter. Useful when entering multiple commands on one line. Example:

% sf &sp&sc


commonly used conman

#> conman

• %altpass• %link• %stop;wait• %shut;wait• %switchmgr (The user issuing switchmgr must have stop and start access to the

cpu being designated as the new domain manager.)

• %unlink @!@;noask (all domains and cpus)


conman “sc” showcpus

#> conman

%sc m82mCPUID RUN NODE LIMIT FENCE DATE TIME STATE METHOD DOMAIN

M82M 0 *UNIX MASTER 0 0 10/17 0605 LTIJW MASTERDM

%showcpuCPUID RUN NODE LIMIT FENCE DATE TIME STATE METHOD DOMAIN

M82M 0 *UNIX MASTER 0 0 10/17 0605 LTIJW MASTERDM

KONG 0 WINT WINNT 10 0 10/17 0605 LX Oracle MASTERDM


conman “altpass”

[m82@gingerman ~]$ conman altpass cpu#user_name;password

If the password is not entered, conman will prompt for the password

NOTE:

The new password will then be relevant only until the next cycle of JnextDay.


conman “ss” showschedule

[m82@gingerman ~]$ conman ss @#@

TWS for UNIX/CONMAN 8.2 (1.36.2.25)

Licensed Materials Property of IBM

5698-WKB

(C) Copyright IBM Corp 1998,2001

US Government User Restricted Rights

Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Installed for user 'm82'.

Locale LANG set to "en_US.UTF-8"

Schedule (Exp) 10/17/06 (#44) on M82M. Batchman down. Limit: 0, Fence: 0, Audit Level: 1

ss @#@

(Est) (Est) Jobs Sch

CPU Schedule State Pr Start Elapse # OK Lim

M82M #LSTEST READY 10 1 0 <10/17

M82M #FINAL READY 10 1 0 [Carry]

[m82@gingerman ~]$


conman “listsym” (list symphony log files)

listsym - Lists the previous Symphony files for previous production runs%listsym

Schedule Actual Start Log Run LogDate Date Time Date Num Size Num Filename03/21/05 03/21/05 05:59 03/22/05 10 15 1 M200503220559 03/20/05 03/20/05 05:59 03/21/05 9 6 2 M200503210559 03/19/05 03/19/05 05:59 03/20/05 8 6 3 M200503200559

setsym - Used to switch to previous production run%setsym 2

%setsym 2Schedule (Exp) 03/20/05 (#9) on MAE82. Symphony switched., Audit Level: 0 (2)%

Note: This lists and switches Symphony to previous production Symphony file.


composer


composer commands:


composer “create”

Example:

composer create cpu_list from @#@

[m82@gingerman tws82m]$ composer create cpus.info from cpu=kong

Locale LANG set to "en_US.UTF-8"

-create cpus.info from cpu=kong

AWSBIA039I Found 1 CPU's in KONG.

*****

[m82@gingerman tws82m]$ more cpus.infocpuname KONG

os OTHER

node kong.tivlab.austin.ibm.com

tcpaddr 31111

domain MASTERDM

for maestro

type FTA

autolink on

fullstatus off

resolvedep off

behindfirewall off

end


composer “dumpsec” name>composer dumpsec > jimsec...

# @(#) 5.1 $Id: Security.conf,v 7.8 1998/11/04 22:52:47 sfoster Exp $## This is a security file that grants every thing to maestro and nothing# to every body else.## note that this permits documentation of root jobs. The actual execution# of root jobs is dependent on local opts jmnoroot and NOROOT environment# variable being unset.#user maestro cpu = @ + logon = m83, rootbegin# anything on any cpu userobj cpu = @ access = @ job cpu = @ access = @ schedule cpu = @ access = @ resource cpu = @ access = @ prompt access = @ file name= @ access = @ cpu cpu = @ access = @ parameter cpu = @ access = @ calendar access = @end


composer “makesec”

makesec jimsec

Compile the user definitions from the file set “jimsec”, and replaces the operational security file.


Reports


Getting Reports and Statistics

These commands are run from the operating system command prompt on the master domain manager.

The output of the report commands is controlled by the following environment variables:

MAESTROLP Specifies the destination of the output of a command. The default is stdout. You can set it to any of the following: filename Writes the output to a file. > filename UNIX only. Redirects output to a file, overwriting the contents of the

file. If the file does not exist it is created. >> filename UNIX only. Redirects output to a file, appending to the end of the

file. If the file does not exist it is created. | command UNIX only. Pipes output to a system command or process. The

system command is always run. || command UNIX only. Pipes output to a system command or process. The

system command is not run if there is no output.


List of report commands


report “xref” (prints report 12-crossreference)

xref – cpu @-depends -schedules

Prints a report for all workstations. Include cross-reference information about all successor dependencies.

TWS for UNIX (AIX)/CROSSREF 8.3 (1.7) ibm Page 10

Report 12 Cross Reference Report for Job Dependencies. 03/08/06

Job Name: Dependencies

CPU: MASTER8+

MYSKED1#MYJOB1 MYSKED1.MYJOB2, MYSKED1.MYJOB3

APAY#APJOB1 APAY.APKOB2

AREC#ARJOB1 AREC.ARJOB2

Used by the following: /root/MY_FILE.sh FTAWIN8+#SCHED1 , TMP

* * * E n d o f R e p o r t * * * *

The output of Report 12 shows different information according to the flag used whenissuing the xref command.


Utility commands


utility commands (more are listed in the ref guide)


CLI use Scenario(Installation/Upgrade Issues)


Scenario of TWS CLI uses

A customer has tried multiple times and in different ways to install or upgrade the TWS environment to the latest version or fixpack. After ensuring the user has permissions and all other possible reasons for installation/upgrade error we proceed…

Look at the software distribution registry.

# cd ~twsuser/uninstcli

# . ./swd_env.sh

# wdlssp > wdlssp.out

In this case, there will be entries for the TWS4APPS_TWS4APPS instances.

For example:

DISSE0164I Name : TWS4APPS_TWS4APPS_R3BATCH

DISSE0165I Version : 8.2.0.05 DISSE0166I State : ICU--

DISSE0164I Name : TWS4APPS_TWS4APPS_OPTED

DISSE0165I Version : 8.2.0.05 DISSE0166I State : ICU--


Scenario of TWS CLI uses (cont…)

# wdrmvsp -f TWS4APPS_TWS4APPS_R3BATCH.8.2.0.05

DISSE0168W Directory '/central/twsuser/catalog/C' is not empty.

Operation could not be completed.

DISSE0003W Operation may not succeed. Check the SWD message log for any

other messages.

# wdrmvsp -f TWS4APPS_TWS4APPS_OPTED.8.2.0.05

The two commands above will remove the registry entries for all of the

R3BATCH and OPTED for the intended instance. To prove that the registry

is clean perform the following two commands

# wdlssp | grep R3BATCH

# wdlssp | grep OPTED


Clean up the operating system's software product registry.

# swlist -l product | grep TWS4APPS TWS4APPS 8.2.000 TWS for Applications

# swremove TWS4APPS @ `hostname`

Look for output to match the following: .......................... * Beginning Selection * Target connection succeeded for "hostname.domain.com:/". * Software selections: ... TWS4APPS.OPTED_COMPONENT,l=/central/twsuser,r=8.2.000,v=IBMTivoliSystems TWS4APPS.R3BATCH_HP_COMPONENT,l=/central/twsuser,r=8.2.000,v=IBMTivoliSystems

* Selection succeeded. ... * Beginning Execution * The execution phase succeeded for ... * Execution succeeded.


NOTE: More information may be found in the agent logfile using the command "swjob -a log hostname.domain.com-

0064 @ hostname.domain.com:/".



To prove that the instance has been removed from the OS:

# swlist -l product | grep TWS4APPS

Clean up leftover files and directories in user's methods directory:

# cd ~twsuser/methods

# ls | grep -v netmth | grep -v unixlocl | grep -v unixrsh | xargs rm -rf

Install TWS4APPS 8.3 instance:

Make sure the DISPLAY variable is set to run the ISMP installer.

To launch the ISMP install run the setup.bin binary from the TWS4APPS

image.

# cd <tws83apps_image>/HP/INSTALLER

# ./setup.bin



Verify the installed version of r3batch:

# cd ~twsuser/methods

# ./r3batch -v

bash-2.03# cd ~twsuser/methods/

bash-2.03# ./r3batch -v

IBM Tivoli Workload Scheduler for Applications for R/3

R3BATCH 8.3.0 for UNIX

Program patch revision: GA (12:45:40 Jul 24 2006)

(C) Copyright IBM Corp 1998,2006

US Government User Restricted Rights - Use, duplication or disclosure

restricted by GSA ADP Schedule Contract with IBM Corp

Conclusion – Installation methods should remain the same.


What’s NewTWS 8.3 Command-Line User Interface


What’s New

Setting up command-line authentication and user authorizations

• What is new in configuring user access• Setting up options for using the command-line user interface• Security management overview• Updating the security file• Configuring the security file


Setting up options for the CL user interface

Setting up options for using the command-line user interface

Each user definition can be divided into the following three parts:

1. Defining the users the definitions applies to.

2. Describing the objects involved in the definition the users specified can operate with.

3. Specifying, for each object definition, how the specified users can access the selected objects.


Where to Find More Information:• Product Guides

http://www-3.ibm.com/software/tivoli/solutions/co/job/http://publib.boulder.ibm.com/tividd/td/WorkloadScheduler8.2.html

Problem Determination Guides http://publib.boulder.ibm.com/tividd/td/WorkloadScheduler8.2.html

RedBookshttp://www.redbooks.ibm.com/

• Tivoli Support Web Pageshttp://www.ibm.com/software/supporthttp://www-306.ibm.com/software/sysmgmt/products/support/

• Training http://www-3.ibm.com/services/learning/us/services/

• Where to go to open a PMR if necessaryhttp://www-306.ibm.com/software/support/probsub.html

• Use Online Helphttp://www-950.ibm.com/search/SupportSearchWeb/SupportSearch?pageCode=SPS


Q&A:

The operator will instruct you on how to ask your questions of the

presenters.

stefortws_cli

Documents