Tivoli Workload Scheduler: User s Guide and Reference

[Pages:836]IBM Tivoli Workload Scheduler

User's Guide and Reference

Version 9 Release 2

IBM

SC32-1274-15

IBM Tivoli Workload Scheduler

User's Guide and Reference

Version 9 Release 2

IBM

SC32-1274-15

Note Before using this information and the product it supports, read the information in "Notices" on page 799.

This edition applies to version 9, release 2, modification level 0 of Tivoli Workload Scheduler (program number 5698-WSH) and to all subsequent releases and modifications until otherwise indicated in new editions. ? Copyright IBM Corporation 1999, 2014. US Government Users Restricted Rights ? Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Figures . . . . . . . . . . . . . . . ix Customizing job processing on a Windows

workstation - jobmanrc.cmd . . . . . . . . . 49

Tables . . . . . . . . . . . . . . . xi

Running complex commands on Windows FTAs 49 Customizing the MAIL_ON_ABEND section of

About this publication . . . . . . . . xiii

What is new in this release . . . . . . . . . xiii What is new in this publication . . . . . . . xiii Who should read this publication. . . . . . . xiii

jobmanrc.cmd . . . . . . . . . . . . 50 Customizing job processing on a Windows workstation - djobmanrc.cmd . . . . . . . . 51 Setting up options for using the user interfaces . . 53

Publications . . . . . . . . . . . . . . xiii Accessibility . . . . . . . . . . . . . . xiii Tivoli technical training . . . . . . . . . . xiv Support information . . . . . . . . . . . xiv Conventions used in this publication . . . . . xiv

Typeface conventions . . . . . . . . . . xiv Operating system-dependent variables and paths xv Command syntax . . . . . . . . . . . xv

Chapter 4. Managing the production cycle . . . . . . . . . . . . . . . 55

Plan management basic concepts . . . . . . . 55 Preproduction plan . . . . . . . . . . . . 56

Identifying job stream instances in the plan. . . 58 Managing external follows dependencies for jobs and job streams . . . . . . . . . . . . 58 Production plan . . . . . . . . . . . . . 68

Chapter 1. Tivoli Workload Scheduler overview . . . . . . . . . . . . . . 1

Understanding carry forward options. . . . . 69 Trial plan . . . . . . . . . . . . . . . 70 Forecast plan . . . . . . . . . . . . . . 71

Understanding basic concepts . . . . . . . . 1

Customizing plan management using global options 72

Tivoli Workload Scheduler database objects . . . 1

Creating and extending the production plan . . . 76

The Tivoli Workload Scheduler network . . . . 18 |

JnextPlan . . . . . . . . . . . . . . 78

Configuring your Tivoli Workload Scheduler

Planman command line . . . . . . . . . . 79

runtime environment . . . . . . . . . . 19

Creating an intermediate production plan . . . 80

Defining scheduling activities using Tivoli

Creating an intermediate plan for a plan

Workload Scheduler . . . . . . . . . . 19

extension . . . . . . . . . . . . . . 82

Controlling job and job stream processing . . . 20

Retrieving the production plan information. . . 82

Managing production scheduling activities with

Creating a trial plan . . . . . . . . . . 83

Tivoli Workload Scheduler . . . . . . . . 23

Creating a trial plan of a production plan

Automating workload using event rules . . . . 24

extension . . . . . . . . . . . . . . 84

Tivoli Workload Scheduler user interfaces . . . . 24

Creating a forecast plan . . . . . . . . . 85

Starting production . . . . . . . . . . . . 26

Deploying rules . . . . . . . . . . . . 86

Chapter 2. Understanding basic

Unlocking the production plan . . . . . . . 87 Resetting the production plan . . . . . . . 88

processes and commands . . . . . . 29

Removing the preproduction plan . . . . . . 89

Issuing commands on Windows operating systems 29 Tivoli Workload Scheduler workstation processes. . 29 Starting and stopping processes on a workstation . 34

Replicating plan data in the database . . . . . 89 Monitoring the replication of plan data in the database . . . . . . . . . . . . . . 91

Starting and stopping the agent . . . . . . 36 Workstation inter-process communication . . . . 36

The stageman command . . . . . . . . . . 91 Managing concurrent accesses to the Symphony file 93

Tivoli Workload Scheduler network communication 37 Support for Internet Protocol version 6 . . . . 39

Scenario 1: Access to Symphony file locked by other Tivoli Workload Scheduler processes . . . 93

Scenario 2: Access to Symphony file locked by

Chapter 3. Configuring the job environment . . . . . . . . . . . . 41

Job environment overview . . . . . . . . . 41 Environment variables exported by jobman. . . . 42

Customizing date formatting in the stdlist . . . 44 Customizing job processing on a UNIX workstation

stageman . . . . . . . . . . . . . . 93 Managing follows dependencies using carry forward prompt . . . . . . . . . . . . . 93 The logman command . . . . . . . . . . . 94 Starting production plan processing . . . . . . 96 Automating production plan processing . . . . . 97

- jobmanrc . . . . . . . . . . . . . . . 45 Customizing the MAIL_ON_ABEND section of jobmanrc . . . . . . . . . . . . . . 46

Customizing job processing for a user on UNIX

Chapter 5. Using workload service assurance . . . . . . . . . . . . . 99

Enabling and configuring workload service

workstations - .jobmanrc . . . . . . . . . . 47

assurance. . . . . . . . . . . . . . . 100

? Copyright IBM Corp. 1999, 2014

iii

Planning critical jobs . . . . . . . . . . . 103 Processing and monitoring critical jobs . . . . . 105 Workload service assurance scenario . . . . . 107

Chapter 6. Customizing your workload using variable tables . . . . . . . . 109

Migrating global parameters from previous versions . . . . . . . . . . . . . . . 109 The default variable table . . . . . . . . . 110 Data integrity for variable tables . . . . . . . 111 Locking mechanism for variable tables . . . . . 111 Variable table security . . . . . . . . . . 111 Variable resolution. . . . . . . . . . . . 112

Chapter 7. Running event-driven workload automation . . . . . . . . 115

The event rule management process . . . . . . 118 Using the involved interfaces and commands 120

Defining event rules . . . . . . . . . . . 122 Event rule examples . . . . . . . . . . 124 Rule operation notes . . . . . . . . . . 130

Triggered rule elements . . . . . . . . . . 132 Defining custom events . . . . . . . . . . 132

Chapter 8. Defining objects in the database . . . . . . . . . . . . . 135

Defining scheduling objects . . . . . . . . 135 Workstation definition . . . . . . . . . 137 Workstation class definition . . . . . . . 153 Domain definition . . . . . . . . . . . 154 Job definition . . . . . . . . . . . . 155 User definition . . . . . . . . . . . . 195 Calendar definition . . . . . . . . . . 200 Variable and parameter definition . . . . . 201 Variable table definition . . . . . . . . . 205 Prompt definition . . . . . . . . . . . 207 Resource definition . . . . . . . . . . 208 Run cycle group definition . . . . . . . . 210 Job stream definition . . . . . . . . . . 219 Job stream definition keyword details . . . . 224 Event rule definition . . . . . . . . . . 264

Defining workload applications . . . . . . . 276 Creating a workload application template . . . 277

Chapter 9. Managing objects in the database - composer . . . . . . . . 281

Setting up the composer command-line program 281 Setting up the composer environment . . . . 281 Running the composer program . . . . . . 283

Running commands from composer . . . . . . 285 Filters and wildcards . . . . . . . . . . 285 Delimeters and special characters. . . . . . 288 Composer return codes . . . . . . . . . 288

Composer commands . . . . . . . . . . 289 Referential integrity check . . . . . . . . 290 add. . . . . . . . . . . . . . . . 294 authenticate . . . . . . . . . . . . . 296 continue . . . . . . . . . . . . . . 297 delete . . . . . . . . . . . . . . . 297

iv Tivoli Workload Scheduler: User's Guide and Reference

display . . . . . . . . . . . . . . 301 edit. . . . . . . . . . . . . . . . 305 exit . . . . . . . . . . . . . . . . 306 extract. . . . . . . . . . . . . . . 306 help . . . . . . . . . . . . . . . 310 list . . . . . . . . . . . . . . . . 311 lock . . . . . . . . . . . . . . . 317 modify . . . . . . . . . . . . . . 320 new . . . . . . . . . . . . . . . 324 print . . . . . . . . . . . . . . . 326 redo . . . . . . . . . . . . . . . 326 rename . . . . . . . . . . . . . . 327 replace . . . . . . . . . . . . . . 330 system command . . . . . . . . . . . 331 unlock. . . . . . . . . . . . . . . 331 validate . . . . . . . . . . . . . . 334 version . . . . . . . . . . . . . . 335

Chapter 10. Managing workload applications . . . . . . . . . . . . 337

Resolving the mapping file . . . . . . . . . 337 Deploying a workload application . . . . . . 342 wappman command . . . . . . . . . . . 343

Chapter 11. Managing objects in the plan - conman . . . . . . . . . . . 347

Setting up the conman command line program . . 347 Setting up the conman environment . . . . . 347 Running conman . . . . . . . . . . . 348

Running commands from conman . . . . . . 350 Wildcards . . . . . . . . . . . . . 351 Delimiters and special characters . . . . . . 351 Conman commands processing . . . . . . 352

Selecting jobs in commands . . . . . . . . 352 Syntax. . . . . . . . . . . . . . . 353 Arguments . . . . . . . . . . . . . 353

Selecting job streams in commands . . . . . . 361 Syntax. . . . . . . . . . . . . . . 361 Arguments . . . . . . . . . . . . . 361

Managing jobs and job streams from back-level agents . . . . . . . . . . . . . . . . 367 Conman commands . . . . . . . . . . . 368

adddep job . . . . . . . . . . . . . 370 adddep sched . . . . . . . . . . . . 372 altpass. . . . . . . . . . . . . . . 374 altpri . . . . . . . . . . . . . . . 375 bulk_discovery . . . . . . . . . . . . 376 cancel job. . . . . . . . . . . . . . 376 cancel sched . . . . . . . . . . . . . 378 checkhealthstatus . . . . . . . . . . . 379 confirm . . . . . . . . . . . . . . 379 console . . . . . . . . . . . . . . 381 continue . . . . . . . . . . . . . . 382 deldep job . . . . . . . . . . . . . 382 deldep sched . . . . . . . . . . . . 384 deployconf . . . . . . . . . . . . . 385 display . . . . . . . . . . . . . . 385 exit . . . . . . . . . . . . . . . . 388 fence . . . . . . . . . . . . . . . 388 help . . . . . . . . . . . . . . . 389

kill . . . . . . . . . . . . . . . . 390

Promoting jobs scheduled on dynamic pools . . . 493

limit cpu . . . . . . . . . . . . . . 391

Adding dynamic capabilities to existing Tivoli

limit sched . . . . . . . . . . . . . 392

Workload Scheduler jobs . . . . . . . . . 494

link. . . . . . . . . . . . . . . . 393

A business scenario on dynamic capability . . . 495

listsym . . . . . . . . . . . . . . 396

Scenario: Creating a job definition and submitting

recall . . . . . . . . . . . . . . . 397

to a dynamic pool . . . . . . . . . . . . 496

redo . . . . . . . . . . . . . . . 398

Scenario: Creating a job definition and submitting

release job . . . . . . . . . . . . . 399

to a pool . . . . . . . . . . . . . . . 497

release sched . . . . . . . . . . . . 401

Limitations for jobs in USERJOBS job stream in

reply . . . . . . . . . . . . . . . 402

dynamic scheduling . . . . . . . . . . . 497

rerun . . . . . . . . . . . . . . . 403

resetFTA . . . . . . . . . . . . . . 406 Chapter 13. Using utility commands 499

resource . . . . . . . . . . . . . . 407

Command descriptions . . . . . . . . . . 499

setsym . . . . . . . . . . . . . . 407

at and batch . . . . . . . . . . . . . 501

showcpus . . . . . . . . . . . . . 408

cpuinfo . . . . . . . . . . . . . . 503

showdomain . . . . . . . . . . . . 414

datecalc . . . . . . . . . . . . . . 506

showfiles . . . . . . . . . . . . . . 416 |

datamigrate . . . . . . . . . . . . . 510

showjobs . . . . . . . . . . . . . . 418

delete . . . . . . . . . . . . . . . 512

showprompts . . . . . . . . . . . . 434

evtdef . . . . . . . . . . . . . . . 513

showresources . . . . . . . . . . . . 436

evtsize. . . . . . . . . . . . . . . 517

showschedules . . . . . . . . . . . . 438

jobinfo. . . . . . . . . . . . . . . 519

shutdown . . . . . . . . . . . . . 443

jobstdl . . . . . . . . . . . . . . . 520

start . . . . . . . . . . . . . . . 444

maestro . . . . . . . . . . . . . . 523

startappserver . . . . . . . . . . . . 446

makecal . . . . . . . . . . . . . . 523

startbrokerapp . . . . . . . . . . . . 447

metronome . . . . . . . . . . . . . 525

starteventprocessor . . . . . . . . . . 448

morestdl . . . . . . . . . . . . . . 525

startmon . . . . . . . . . . . . . . 448

parms . . . . . . . . . . . . . . . 527

status . . . . . . . . . . . . . . . 449

release. . . . . . . . . . . . . . . 529

stop . . . . . . . . . . . . . . . 449

rmstdlist . . . . . . . . . . . . . . 531

stop ;progressive . . . . . . . . . . . 451

sendevent . . . . . . . . . . . . . 532

stopappserver . . . . . . . . . . . . 452

showexec . . . . . . . . . . . . . . 533

stopbrokerapp . . . . . . . . . . . . 454

shutdown . . . . . . . . . . . . . 534

stopeventprocessor . . . . . . . . . . 454

ShutDownLwa . . . . . . . . . . . . 534

stopmon . . . . . . . . . . . . . . 455

StartUp . . . . . . . . . . . . . . 535

submit docommand . . . . . . . . . . 456

StartUpLwa . . . . . . . . . . . . . 535

submit file . . . . . . . . . . . . . 459

tws_inst_pull_info . . . . . . . . . . . 536

submit job . . . . . . . . . . . . . 462

version . . . . . . . . . . . . . . 536

submit sched . . . . . . . . . . . . 465

Unsupported commands . . . . . . . . 538

switcheventprocessor . . . . . . . . . . 469

switchmgr . . . . . . . . . . . . . 470 system command . . . . . . . . . . . 471 tellop . . . . . . . . . . . . . . . 472

| |

Chapter 14. Using utility commands in the dynamic environment . . . . . . 539

unlink . . . . . . . . . . . . . . . 472 | Command-line configuration file . . . . . . . 540

version . . . . . . . . . . . . . . 475 | exportserverdata . . . . . . . . . . . . 543

| importserverdata . . . . . . . . . . . . 545

Chapter 12. Enabling dynamic scheduling capabilities in your

| jobprop . . . . . . . . . . . . . . . 546 | movehistorydata . . . . . . . . . . . . 547 | param . . . . . . . . . . . . . . . . 549

environment . . . . . . . . . . . . 477 | resource . . . . . . . . . . . . . . . 552

Advantages of job types with advanced options 478 | Using the resource command from an agent . . 560

Creating job types with advanced options . . . . 480 | sendevent . . . . . . . . . . . . . . 562

Return codes . . . . . . . . . . . . . 481 | twstrace . . . . . . . . . . . . . . . 563

Defining variables and passwords for local

resolution on dynamic agents . . . . . . . . 482 Specifying local variables and passwords in the job definitions . . . . . . . . . . . . 483 Using variables in dynamic workload broker jobs . . . . . . . . . . . . . . . 485

| Passing variables between jobs in the same job | stream instance . . . . . . . . . . . . 487

Defining affinity relationships . . . . . . . . 493

Chapter 15. Getting reports and statistics . . . . . . . . . . . . . 565

Setup for using report commands . . . . . . 565 Changing the date format . . . . . . . . 566

Command descriptions . . . . . . . . . . 566 rep1 - rep4b . . . . . . . . . . . . . 566 rep7 . . . . . . . . . . . . . . . 568 rep8 . . . . . . . . . . . . . . . 569

Contents v

rep11 . . . . . . . . . . . . . . . 570 reptr . . . . . . . . . . . . . . . 571 xref. . . . . . . . . . . . . . . . 572 Sample report outputs . . . . . . . . . . 573 Report 01 - Job Details Listing: . . . . . . 573 Report 02 - Prompt Listing:. . . . . . . . 576 Report 03 - Calendar Listing: . . . . . . . 576 Report 04A - Parameter Listing: . . . . . . 577 Report 04B - Resource Listing: . . . . . . . 577 Report 07 - Job History Listing: . . . . . . 577 Report 08 - Job Histogram: . . . . . . . . 578 Report 9B - Planned Production Detail: . . . . 578 Report 10B - Actual Production Detail: . . . . 579 Report 11 - Planned Production Schedule: . . . 580 Report 12 - Cross Reference Report: . . . . . 581 Report extract programs . . . . . . . . . . 583 jbxtract . . . . . . . . . . . . . . 584 prxtract . . . . . . . . . . . . . . 585 caxtract . . . . . . . . . . . . . . 586 paxtract . . . . . . . . . . . . . . 586 rextract . . . . . . . . . . . . . . 587 r11xtr . . . . . . . . . . . . . . . 588 xrxtrct . . . . . . . . . . . . . . . 589 Running Dynamic Workload Console reports and batch reports . . . . . . . . . . . . . 594 Historical reports . . . . . . . . . . . 596 Production reports. . . . . . . . . . . 599 Running batch reports from the command line interface . . . . . . . . . . . . . . 599

Chapter 16. Managing time zones. . . 605

Enabling time zone management . . . . . . . 605 How Tivoli Workload Scheduler manages time zones . . . . . . . . . . . . . . . . 606 Moving to daylight saving time on . . . . . . 608 Moving to daylight saving time off . . . . . . 608 General rules . . . . . . . . . . . . . 608

Chapter 17. Defining access methods for agents . . . . . . . . . . . . . 611

Access method interface . . . . . . . . . . 612 Method command line syntax . . . . . . . 612 Method response messages . . . . . . . . 614 Method options file . . . . . . . . . . 615

Running methods . . . . . . . . . . . . 617 Launch job task (LJ) . . . . . . . . . . 617 Manage job task (MJ) . . . . . . . . . . 618 Check file task (CF) extended agents only . . . 618 Get status task (GS) extended agents only . . . 619 Cpuinfo command for extended agents only . . 620

Troubleshooting . . . . . . . . . . . . 620 Job standard list error messages . . . . . . 620 Method not executable . . . . . . . . . 620 Console Manager messages for extended agents only . . . . . . . . . . . . . . . 620 Composer and compiler messages for extended agents only . . . . . . . . . . . . . 620 Jobman messages for extended agents only . . 621

vi Tivoli Workload Scheduler: User's Guide and Reference

Chapter 18. Managing internetwork dependencies . . . . . . . . . . . 623

Internetwork dependencies overview . . . . . 623 Understanding how an internetwork dependency is shown . . . . . . . . . 624

Configuring a network agent . . . . . . . . 625 A sample network agent definition . . . . . 626

Defining an internetwork dependency . . . . . 627 Managing internetwork dependencies in the plan 627

States of jobs defined in the EXTERNAL job stream. . . . . . . . . . . . . . . 628 Working with jobs defined in the EXTERNAL job stream . . . . . . . . . . . . . 628 Sample internetwork dependency management scenarios . . . . . . . . . . . . . . 629 Internetwork dependencies in a mixed environment. . . . . . . . . . . . . . 630

Chapter 19. Defining and managing cross dependencies . . . . . . . . 633

An introduction to cross dependencies . . . . . 633 Processing flow across the distributed scheduling environment. . . . . . . . . . . . . . 635 Defining a cross dependency . . . . . . . . 637 Monitoring a cross dependency resolution in the production plan . . . . . . . . . . . . 639

How the shadow job status changes until a bind is established . . . . . . . . . . . . 639 How the shadow job status changes after the bind is established. . . . . . . . . . . 645 How to see why the shadow job status is FAIL 646 Shadow job status during the remote job recovery or rerun . . . . . . . . . . . 647 How carry forward applies to cross dependencies . . . . . . . . . . . . 647 Managing shadow jobs in the production plan . . 647

Chapter 20. Managing an IBM i dynamic environment . . . . . . . . 649

Defining agents on IBM i systems . . . . . . 649 Defining jobs on IBM i systems . . . . . . . 649 Managing agents on IBM i systems . . . . . . 650

Starting and stopping agents on IBM i systems 650 Using utility commands for agents on IBM i systems . . . . . . . . . . . . . . 650 Scheduling jobs on IBM i systems . . . . . . 651 The agent joblog and TWSASPOOLS environment variable . . . . . . . . . . 651 Child job monitoring on IBM i agents . . . . 651 The agent return code retrieval . . . . . . 655 Controlling the job environment with the user return code . . . . . . . . . . . . . 655 Alternative method to set the user return code 656

Appendix A. Event-driven workload automation event and action definitions. . . . . . . . . . . . . 659

Event providers and definitions . . . . . . . 659 TWSObjectsMonitor events . . . . . . . . 659

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download