the authors and publisher have taken care in the preparation of

The authors and publisher have taken care in the preparation of this book, but make no expressed orimplied warranty of any kind and assume no responsibility for errors or omissions. No liability is assumedfor incidental or consequential damages in connection with or arising out of the use of the information orprograms contained herein.

© Copyright 2010 by International Business Machines Corporation. All rights reserved.

Note to U.S. Government Users: Documentation related to restricted right. Use, duplication, or disclosureis subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.

IBM Press Program Managers: Steven M. Stansel, Ellice Uffer

Cover design: IBM Corporation

Associate Publisher: Greg WiegandMarketing Manager: Kourtnaye SturgeonAcquisitions Editor: Katherine Bull Publicist: Heather FoxDevelopment Editor: Kendell LumsdenManaging Editor: Kristy HartDesigner: Alan ClementsProject Editor: Anne GoebelCopy Editor: Language Logistics, LLCIndexer: WordWise Publishing Services, LLCCompositor: Jake McFarlandProofreader: Water Crest PublishingManufacturing Buyer: Dan Uhrig

Published by Pearson plc

Publishing as IBM Press

IBM Press offers excellent discounts on this book when ordered in quantity for bulk purchases or specialsales, which may include electronic versions and/or custom covers and content particular to your business,training goals, marketing focus, and branding interests. For more information, please contact:

U.S. Corporate and Government [email protected].

For sales outside the U.S., please contact:

International [email protected].

The following terms are trademarks or registered trademarks of International Business MachinesCorporation in the United States, other countries, or both: IBM, the IBM logo, IBM Press, AIX,Cloudscape, DB2, developerWorks, Rational, Redbooks, WebSphere, and z/OS. Microsoft, Windows, andC# are trademarks of Microsoft Corporation in the United States, other countries, or both. Java, J2EE, EJB,JDBC, and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, othercountries, or both. UNIX is a registered trademark of The Open Group in the United States and othercountries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.Other company, product, or service names may be trademarks or service marks of others.

Library of Congress Cataloging-in-Publication Data

Gibson, Robert A., 1954–WebSphere application server administration using Jython / Robert A. Gibson, Arthur Kevin McGrath,

Noel J. Bergman.p. cm.

ISBN 978-0-13-700952-7

1. WebSphere. 2. Web servers. 3. Application software—Development. 4. Jython (Computer programlanguage) I. McGrath, Arthur Kevin. II. Bergman, Noel. III. Title.

TK5105.8885.W43.G53 2009

005.1'17—dc22

2009030406

All rights reserved. This publication is protected by copyright, and permission must be obtained from thepublisher prior to any prohibited reproduction, storage in a retrieval system, or transmission in any form orby any means, electronic, mechanical, photocopying, recording, or likewise. For information regardingpermissions, write to:

Pearson Education, Inc.Rights and Contracts Department501 Boylston Street, Suite 900Boston, MA 02116Fax (617) 671-3447

ISBN-13: 978-0137009526

ISBN-10: 0137009526

Text printed in the United States on recycled paper at R.R. Donnelley in Crawfordsville,Indiana. First printing October 2009

1

Why Is This Book Necessary?For years we have been enthusiastically pounding the table, so to speak, saying that scripting is“where it’s at!” for WebSphere® administrators. All the while, we (along with our students) havewished for a book that would enable more people to use Jython1 for their scripting needs. Wefinally got together and set out to write one, and we hope this book addresses not only our owndesires and demands but yours as well.

Websphere’s robust and versatile scripting facility differentiates the IBM® WebSphereApplication Server product from competitors in the Java™ EE server marketplace. As convenientand friendly as the Integrated Console can be, the true power for administrators is in scripting.This is probably evident to anyone who has had to configure something on multiple machines orperform the same configuration numerous times.

IBM’s support for scripting that is built into the WebSphere platform is staggering. As youdelve into it, you discover all sorts of hidden capabilities and ease-of-use features and quicklydevelop a greater understanding of how WebSphere fits together. Were we to deliver a book con-taining but a single page on each aspect of the available script objects, you’d need a forklift totake it home. Instead, we’ve hopefully provided you with a book that helps prepare you for a jour-ney of discovery. We have documented and explained the scripting concepts, the core objects, andmany of our favorite techniques, while demonstrating some new ones of our own.

C H A P T E R 1

Introduction

1 Jython is an implementation of the Python programming language that executes on a Java VirtualMachine.

2 Chapter 1 Introduction

If you will, think of WebSphere as a healthy, bio-diverse, coral reef, rich in wildlife. In thisbook, we teach you to master the core concepts necessary to explore the reef and introduce you tomany of our favorite reef denizens. Afterward you will be prepared to explore more of the reef onyour own, discovering for yourself more of the richness that IBM has built into WebSphere. Onceyou’ve mastered the core concepts, self-discovery becomes important; each new product layeredon WebSphere (for example, WebSphere Enterprise Service Bus and WebSphere Process Server)and each new version adds more and more scripting capabilities. So in the way of the ancientparable, we will not only give you some fish, but also teach you to fish.

We hope that you enjoy the book...and the journey.—Bob, Kevin, and Noel

About the WebSphere Application Server ProductThe WebSphere Application Server is a large and complex product. As such, it is function-richand can be configured and used in numerous ways. But you probably know that already. Thekind of person likely to pick up this book and consider buying it is someone who has an under-standing of what the WebSphere Application Server is and just how challenging its administra-tion can be. It is also likely that you have either tried administering the product or might bewondering how to administer it using scripting. If you’ve gone down this road on your own,you have probably had some challenging moments (alright, hours) attempting to get yourscripts to “behave.” That is what this book is all about.

This book is not for the novice WebSphere Application Server administrator. It doesn’tdefine or explain J2EE™ or an application server. Definitions and explanations of foundationaltopics are available elsewhere (see the online documentation2). This book is focused on the topicof scripting for the WebSphere Application Server environment.

In writing this book, we spent a great deal of time trying to understand this beast and whatis required to administer a WebSphere Application Server using the examples that exist in theavailable documentation. As a WebSphere Application Server technical support analyst and teamlead, and as instructors, we have also spent a great deal of time sharing our knowledge of thistopic with others. That, too, is what this book is about—sharing some of what we have learnedwith those who are interested in learning.

This Book and Its OrganizationWe tried to organize this book in an easy-to-understand manner. To begin, we discuss Jython.3

Chapters 2 through 5 describe Jython with enough detail that those unfamiliar with it should beable to readily “pick up” the language and use it effectively.

2 http://www.IBM.com/software/webservers/appserv/was/library/.

3 Python is a programming language, and Jython is an implementation of that language. We won’t worry aboutthis distinction and will continue to refer to it as the Jython programming language for simplicity’s sake.

http://www.IBM.com/software/webservers/appserv/was/library/

This Book and Its Organization 3

It should be noted that this book is not meant to be an introduction to programming oreven an introduction to the Jython programming language. We could easily fill hundreds morepages on just the topic of “Programming with Jython.” There are lots of books, papers, and web-sites that discuss the syntax and semantics of Python and therefore the Jython programminglanguage.4 This book is not intended to replace nor duplicate the information available else-where. If you already feel comfortable with Jython (or more precisely Python) as a program-ming language, you might be able to skip the chapters that describe Jython and begin withChapter 6.

For those readers who might be less familiar with Jython as a programming language, thisbook attempts to present the rules, characteristics, and properties of Jython in a logical order, so as tobuild a solid foundation of information. A little is presented at time and then revisited and expandedupon, providing reinforcement through repetition. Additionally, each chapter is filled with workingexamples to help you better understand not only the Jython code, but the wsadmin scripting objectsas well. Almost all of the examples described are available from the IBM Press website for thisbook5 and are provided to minimize the need to search other sources for useful examples.

Chapter 6, “wsadmin,” explores the wsadmin command in detail and explains the com-mand and its parameters thoroughly. A number of the parameters don’t seem to get a lot of use.That may be because when you first start using wsadmin, you can quickly get to a subset of theparameters that you use “all the time.” For many tasks, this is a reasonable approach to getting thejob done. However, in so doing, you might have forgotten or not even realize that some wsadminparameter exists that might make your life easier. This chapter will help broaden your understand-ing of this command. You never know, you may even find something that you can use right away.

Chapter 7, “Introduction to Admin Objects,” is a must-read because it explains how to configure wsadmin in order to use many of the examples shown later in the book. The wsadminproperties that are shown in this chapter (specifically the changing of the profiles directive) pro-vide an environment upon which many of the later examples depend.

Chapter 8, “The AdminConfig Object,” is the beginning of the explanation of the wsadminscripting objects. Specifically, it explains the AdminConfig scripting object in great detail.Many administrative scripts deal primarily with the AppServer configuration use and dependupon this scripting object for the vast majority of these manipulations. A number of usefulexamples are provided to demonstrate just how helpful this scripting object can be.

Chapter 9, “The AdminControl Object,” describes the AdminConfig scripting object insimilar detail. This object is used by scripts that need to manipulate active AppServer objects(MBeans). So this chapter is full of useful information for those types of scripts.

4 Please note, however, that the version of Jython that is provided and supported by the wsadmin utilitydoes not include all of the features and facilities available in the “latest and greatest” version of Python. So,keep this in mind as you are writing your wsadmin scripts.

5 http://www.IBMPressBooks.com/title/9780137009527.

http://www.IBMPressBooks.com/title/9780137009527

4 Chapter 1 Introduction

Chapter 10, “The AdminApp Object,” covers the AdminApp scripting object in detail. Thisobject is used to list, view, install, uninstall, and modify AppServer applications. As such, thischapter explains how to perform these operations using the AdminApp object methods.

Chapter 11, “The AdminTask Object—Server Management,” is where we begin thedescription of some of the AdminTask scripting object methods. The AdminTask object is enor-mous. Additionally, as is explained in this chapter, the methods included vary based upon a num-ber of factors. The scope (as in breadth and depth) of this object is huge. It includes hundreds and hundreds of methods. As such, there is no way for it to be adequately covered in a single chapter.In fact, Chapters 12 through 15 largely deal with AdminTask object methods. That’s not all theycover, but it is at the core of each of these chapters.

Chapter 12, “Scripting and Security,” deals with scripting and security. As such, itaddresses a number of security-related items. Anyone who needs to administer an enterpriseapplication server should be familiar with the topics described in this chapter.

Chapter 13, “Databases and Authorization,” covers databases and authorization. Eventhough the configuration and administration of database-related resources can seem overwhelm-ing, this chapter presents these topics in a simple fashion. You discover the easy way to configurethe database-related resources (“the plumbing,” if you will) required for interactions with a data-base. These explanations include descriptions about the properties you can control and those thatare automatically configured for you. The chapter then moves into exploring and manipulatingthe more complicated aspects and properties of database-related resources and then finishes witha detailed explanation of commonly used database and authorization AdminTask methods.

Chapter 14, “Messaging,” is all about messaging. This complicated topic is explored indetail but explained simply. The chapter starts by discussing messaging basics and then adds adiscussion of security. It ends by explaining the more commonly used messaging AdminTaskmethods in great detail.

Chapter 15, “Administering Web Services,” is all about Web services. So what exactly areWeb services? The IBM online documentation has this to say about Web services:

Web services are self-contained, modular applications that can be described, published,located, and invoked over a network. They implement a services-oriented architecture(SOA), which supports the connecting or sharing of resources and data in a very flex-ible and standardized manner. Services are described and organized to support theirdynamic, automated discovery and reuse.

This chapter describes Web services and explains how they should be managed. It also discussespolicies, policy sets, bindings and even the use of keystores for the security-related aspects ofWeb services.

Lastly, Chapter 16, “Version 7.0 Scripting Libraries,” is about the scripting object librariesthat are included in version 7 of the AppServer product. These Jython libraries demonstrate sometechniques for the management and manipulation of AppServer entities. Some people find theprogramming interface provided by some of the wsadmin scripting objects difficult to under-stand and even harder to work with. These libraries present another approach and provide meth-ods that use simpler parameter lists to some of these scripting object methods.

449

Index

addPartialAppToAnApp-WithUpdateCommand()method, 406

addPolicyType command,382

addSIBusMember method,318-320

addSIBWSInboundPortmethod, 376

addSIBWSOutboundPortmethod, 376

addUpdateSingleModuleFile-ToAnAppWithUpdate-Command() method, 405

addUserToBusConnectorRolemethod, 338

addUserToDefaultRolemethod, 338

addUserToDestinationRolemethod, 339

addUserToTopicRole method, 340

addUserToTopicSpaceRoot-Role method, 340

AdminApp command, 355AdminApp object, 199

application installationmethods, 204-208

editing, 208-210methods, 199-212updating, 208-210

AdminApp.getDeployStatus()method, 204

AdminApp.isAppReady()method, 200

AdminApp.updateInteractive() method, 208

AdminApplication objectsAdminAuthorizations

modules, 428-430AdminClusterManagemen

t modules, 430-432AdminJ2C modules,

412-414AdminJDBC modules,

414-416AdminJMS modules,

416-423

Aabs( x ) method, 77accessing

dictionaries, 14sequence elements, 12-13

addGroupToBusConnector-Role method, 338

addGroupToDefaultRolemethod, 338

addGroupToDestinationRolemethod, 338

addGroupToTopicRolemethod, 339

addGroupToTopicSpaceRoot-Role method, 340

addingcontent, 209hosts, 258libraries, 395resources to security

domains, 262addNodeGroupMember

command, 224

450 Index

AdminNodeGroupManage-ment modules, 445-446

AdminNodeManagementmodules, 446-447

AdminResources modules,423-427

AdminServerManagementmodules, 432-445

business-levelapplications, 409-412

scripting libraries, 399-409

AdminApplication.getApp-DeploymentTarget() method, 404

AdminAuthorizationsmodules, 428-430

AdminBLA scripting libraryfiles, 409-412

AdminClusterManagementmodules, 430-432

AdminConfig object, 149config ID, 150-155configuration types,

152-153containment paths, 151create/modify methods,

160-162document manipulation

methods, 164methods, 164-165overview of, 149-150show/tell methods,

155-159verification, 162-163

AdminConfig.create()method, 211

AdminConfig.getid()method, 151

AdminConfig.hasChanges()method, 162

AdminConfig.list()method, 152

AdminConfig.parents()method, 160

AdminConfig.remove()method, 162

AdminConfig.reset()method, 352

AdminConfig.save() method, 352

AdminConfig.show() method, 153

AdminConfig.showall()method, 156

AdminConfig.types()method, 160

AdminConfig.validate()method, 163

AdminControl object, 167attributes, 174-181environment information,

167-172MBean support methods,

172-173methods, 181-182methods*_imx, 183-184names, 173-174

AdminControl.startServer()method, 168

administrationobjects, 129-134

documentation,145-147

Help, 134-145security, enabling,

249-250Web services, 352

exporting WSDL, 355KeyManager

commands, 377KeySet commands,

381-382KeyStore commands,

378-381listing, 353-354

navigating, 353-355overview, 346-350policy sets, 355-365,

367-371PolicySetManagement

group, 382-390references, 373-376runtimes, 351-352SIBWebServices group,

374-377SOAP, 347topics, 371-372WebServicesAdmin

group, 390-392WS-I profiles, 346-347WSDL, 347

wsadmin program, 113-115

commands, 126-128connecting, 120defining scripting

languages, 122environment

initialization, 116-120JVM initialization, 116options, 115profile script files,

123-126tracing, 122usage information, 116

AdminJ2C modules, 412-414AdminJDBC modules,

414-416AdminJMS modules,

416-423AdminLibHelp module, 447AdminNodeGroupManage-

ment modules, 445-446AdminNodeManagement

modules, 446-447AdminReports Command

Group command, 226

Index 451

AdminResources modules,423-427

AdminServerManagementmodules, 432-445

AdminTask methods, 145databases. See databasessecurity, 264server management,

199-200command, 209-212creating clusters,

205-209examples, 201-202JVM methods,

216-217JVM properties,

218-219JVM system properties,

217-218methods, 202-205references, 223-239template-related

commands, 214-216z/OS methods,

220-223AdminTask.listPolicySets()

method, 356AdminTask.listServerTypes()

method, 203AdminTask.listWebServices-

Operations command, 354AdminTask.modifySIB*

methods, 312AdminUtilities module, 447advanced settings, databases,

284-291aliases, J2C, 242-249AllAuthenticated group, 311append( item ) method, 67applications

AdminApp object, 199application installation

methods, 204-208

editing, 208-210methods, 199-204,

210-212updating, 208-210

business-level, 409-412deploying, 407-408exporting, 406Federated registries,

260-261messaging, 301-302

creating buses, 303-308deleting buses, 308-310references, 317-327security, 310-317terminology, 303

names, 203policy sets, 356security, 241-242

configuring, 249-253enabling, 249-250J2C, 242-249Java, 253-255

servers, 2starting, 408-409stopping, 408-409updating, 404-406wsadmin program,

113-115commands, 126-128connecting, 120defining scripting




applying config IDs, 153-155arbitrary function parameters,

55-58

archive files, 116arithmetic operators, 18assert statements, 35-36assignment statements, 16,

28-30augmented, 32packing/unpacking, 30-31slices, 34

attachments, policy sets, 361-371

attributesAdminControl object,

174-181MBean Help object,

138-140missing, 155policy, 360RW, 177

augmented assignmentstatements, 32

authenticationdata entry, creating, 244LDAP failover, 255-260

authorizationAdminAuthorizations

library module, 428-430buses, 313databases, 277

advanced settings, 284-291

overview of, 277-280references, 291-300troubleshooting,

280-284autoloading scriptLibraries,

395availability of objects, 133

Bbackslash (\) character, 9beanDescriptions.py, 143beanInformation.py, 144

452 Index

bindingsassignment statements, 30deleting, 365policy sets, 362-371slices, 32-33

bitwise operators, 21Boolean operators, 21break statements, 36Browser security role, 311built-in

constants, 66data types, 67exceptions, 93-94functions, 77-86

busescreating, 303, 306-308deleting, 308-310, 326messaging, 303modifying, 329security, 263, 311-314, 337viewing, 334

business-level applications,409-412

busMembers element, 305

Ccallable( object ) method, 78capabilities, 1capitalize() method, 71CellStatus.py, 171center( width ) method, 71chains, 315changeClusterShortName()

method, 220changeServerGenericShort-

Name() method, 220changeServerSpecificShort-

Name() method, 220characters, escape sequences, 9chr( i ) method, 78classes

hierarchies, 93statements, 63-66

ClassNotFoundException,282

clear() method, 69client-side policy

attachments, 368cloning security domains, 261clusters

AdminClusterManagementlibrary module, 430-432

creating, 205-209code conventions, 26commands

AdminApp, 355AdminTask.listWeb-

ServicesOperations, 354command line options, 117configureSingleSignon,

269copySecurityDomain, 271copySecurityDomainFrom

GlobalSecurity, 270create, 210createAuthDataEntry, 265createGroup, 273createSecurityDomain, 270createUser, 273deleteAuthDataEntry, 265deleteGroup, 274deleteSecurityDomain, 271deleteUser, 273dir(), 395duplicateMembershipOf-

Group, 274duplicateMembershipOf-

User, 274getActiveSecuritySettings,

266getSingleSignon, 269getUserRegistryInfo, 269IdMgrRepositoryConfig

group, 275-276isAppSecurityEnabled, 275isJACCEnabled, 275

isSingleSecurityDomain,275

JACCUtilityCommandsgroup, 275

KeyManager, 377KeySet, 381-382KeyStore, 378-381listAuthDataEntries,

265-266listInterceptors, 270listRegistryGroups, 272listSecurityDomains, 271listSecurityRealms, 273manageprofiles, 203SecurityConfiguration-

Commands group, 264-270

SecurityDomain-Commands group, 270-271

SecurityRealmInfo-Commands group, 272-273

servers, 209-216serverStatus, 172setAdminActiveSecurity-

Settings, 266-267setAppActiveSecurity-

Settings, 267-268setGlobalSecurity, 274unsetAppActiveSecurity-

Settings, 268-269WIMManagement-


WizardCommands group,274-275

wsadmin programs, 126-128

comments, 26, 116comparison operators, 22compile( patternString

[, flags ] ) method, 109

Index 453

compile( string, filename,kind ) method, 78

complex( real[, imag ] )method, 78

components, busesdeleting, 326modifying, 329viewing, 334

compound statements, 41for, 44-46if, 42loop, 42try, 47-48while, 42-43

config ID, 150-155configureSessionManagement

ForAnApplication() method, 408

configureSingleSignoncommand, 269

configuringAdminConfig objects,

149-150config ID, 150-155configuration types,



methods, 164methods, 164-165show/tell methods, 155-

159verification, 162-163

applicationsJava 2 security,

253-255security, 249-253

databases, 277-280advanced settings,

284-291

references, 291-300troubleshooting,

280-284hosts, 258-259IdMgrRepositoryConfig

group, 275-276J2C (JAAS) aliases),

243-244JACCUtilityCommands

group, 275messaging, 301-302

creating buses, 303-308deleting buses, 308-310references, 317-327security, 310-317terminology, 303

permissions, 314policy set bindings, 365SecurityConfiguration-


SecurityRealmInfo-Commands group, 272-273

servers, 205-209commands, 209-212JVM methods, 216-217JVM properties,


217-218references, 223-239template-related

commands, 214-216z/OS methods, 220-223

SIBs, 307strings, 74-77WIMManagement-


WizardCommands group,274-275

ConnectionPool, 283connections

leaks, tracing, 284messages, 121wsadmin program, 120

Connector security role, 311connectSIBWSEndpoint-

Listener method, 375constants, built-in, 66. See

also literals, 8-15constructors, finding,

142-143constructs, OOP, 63

built-in constants, 66data types, 67functions, 77-86

class statements, 63-66dictionary methods, 69-71instantiation, 66list methods, 67-68string methods, 71-77

containers, EJB, 351containment paths, 151content, adding, 209continue statements, 36control flow, 39-41conventions, code, 26convertToCluster.py, 164copy() method, 69copyBinding command, 389copying

bindings, 363slices, 32-33

copyPolicySet command, 388copySecurityDomain

command, 271copySecurityDomainFrom-

GlobalSecurity command,270

count( item ) method, 67count( substring[, start

[, end ] ] ) method, 71

454 Index

create commands, 210create() method, 160-162createApplicationServe

command, 234createApplicationServer()

method, 209createApplicationServer-

Template command, 235createApplicationServer-

Template() method, 214createAuthDataEntry

command, 265createCluster command, 226createClusterMember

command, 228createCoreGroup

command, 224createDataSource, 292createGenericServer()

method, 209createGenericServerTemplate

() method, 214createGroup command, 273createJDBCProvider, 291createKeyManager

command, 378createKeySet command, 381createKeyStore command, 379createNodeGroup

command, 224createPolicySet

command, 383createPolicySetAttachment

command, 383createProxyServer() method,

204, 209createProxyServerTemplate()

method, 214createSecurityDomain

command, 270createServerType

command, 238createServerType() method,

202-203

createSIBDestinationmethod, 320-322

createSIBEngine method,322-323

createSIBJMSActivationSpecmethod, 325-326

createSIBJMSConnection-Factory method, 323-324

createSIBJMSQueue method,324-325

createSIBJMSTopic method,325

createSIBus method, 317-318createSIBWSEndpoint-

Listener method, 375createSIBWSInboundService

method, 374createSIBWSOutbound-

Service method, 374createUser command, 273createWebServer() method,

209createWebServerTemplate()

method, 214Creator security role, 311customizing

databases, 284-291J2C (JAAS) aliases, 245references, 291-300wsadmin programs, 115

environmentinitialization, 116-120

JVM initialization, 116usage information, 116

Ddata definition language

(DDL), 406data types, 6-7

built-in, 67dictionaries, 14lists, 12numbers, 7

sequences, accessingelements, 12-13

strings, 8-11tuples, 11

databasesauthorization, 277



280-284overview of, 277-280

DataSources, 278-280, 296-298

security, 263DCS (Distribution and

Consistency Services), 315DDL (data definition

language), 406default failure actions,

scripting libraries, 398default function parameters,

53-62defining scripting

languages, 122definitions

classes, 66functions, 49-50

del statements, 36deleteAuthDataEntry

command, 265deleteCluster command, 230deleteClusterMember

command, 230deleteCoreGroup

command, 226deleteGroup command, 274deletePartialAppToAnApp-

WithUpdateCommand()method, 406

deleteSecurityDomaincommand, 271

deleteServer command, 236

Index 455

deleteServer() method, 210deleteServerTemplate()

method, 214deleteSIBDestination

method, 328-329deleteSIBJMSActivationSpec

method, 327deleteSIBJMSConnection-

Factory method, 327deleteSIBJMSQueue

method, 327deleteSIBJMSTopic

method, 327deleteSIBus method, 327deleteSingleModuleFileTo-

AnAppWithUpdate-Command() method, 405

deleteUser command, 273deleteUserAndGroupEntries()

method, 210deleteWebServer() method,

210deleting

bindings, 365buses, 308-310, 326hosts, 259-260J2C (JAAS) aliases,

246-249servers, 207

deploying applications, 407-408

destinations, 303dictionaries, 14

methods, 69-71parameters, unpacking, 57

dir( [object] ) method, 78dir() command, 395directories

importing, 395structures, 150

disabling security, 249-250Distribution and Consistency

Services (DCS), 315divmod( a, b ) method, 78

documentsadmin objects, 145-147function strings, 61manipulation methods, 164

domainsmultiple security, 261-262security, adding resources

to, 262SecurityDomain-


duplicateMembershipOf-Group command, 274

duplicateMembershipOfUsercommand, 274

Eease-of-use features, 1editing AdminApp methods,

208-210EJB (Enterprise Java

Bean), 351elements

busMembers, 305sequences, accessing,

12-13email, messaging, 302. See

also messagingenabling

bus security, 311-314Java 2 security, 253-255security, 249-250transport security, 314-317

end( [group] ) method, 110endpoints, Web services, 354endswith( suffix[, start

[, end ] ] ) method, 71Enterprise Java Bean

(EJB), 351environments

AdminControl object,167-172

initialization, 116-120

errors, 92-94OOM, 86

escape sequences, 9escape( string ) method, 109eval( expression[, globals[,

locals] ] ) method, 79Everyone group, 311exceptions, 92

built-in, 93-94ClassNotFoundException,

282IndexError, 68NameError, 132scripting libraries, 399

exchangeSigners command, 380

exec statements, 38execfile( filename[, globals[,

locals ] ] ) method, 79expandtabs( [tabsize] )

method, 71export() method, 210exportAllApplicationsToDir()

method, 406exportAnAppToFile()

method, 406exportBinding command, 389exportDDL() method, 210exporting

applications, 406policy sets, 359WSDL, 355

exportPolicySet command, 387

exportServer command, 231expressions

overview of, 18regular *RegExp,

107-112statements, 27-28

extend( item ) method, 67extracting methods,

names, 135

456 Index

Ffailonerror parameters, 399failover, LDAP, 255-260Federated registries, 260-261filenames, 203, 206files

archive, 116help, 114modules, 87

errors, 92-94import statements,

88-90nested_scopes, 90-92packages, 92

profile script, 123-126script, 126-128script library, 394wsadmin.properties, 133

filter( function, sequence )method, 79

find( substring[, start[, end ] ] )method, 71

findall( pattern, string )method, 109

findall(string [, startPos [,endPos ] ] ) method, 110

finding constructors, 142-143fixFileName() method, 207float( x ) method, 79flow, control, 39-41for statements, 44-46formatting. See also

configuringdatabases, 277-280



280-284indentation, 40J2C (JAAS) aliases,

243-244JVM properties, 218

messaging, 301-302creating buses, 303-308deleting buses, 308-310references, 317-327security, 310-317terminology, 303

servers, 205-209commands, 209-212JVM methods, 216-217JVM properties,


217-218references, 223-239template-related

commands, 214-216z/OS methods,

220-223strings, 74-77

functional programming, 94functions, 49

built-in, 77-86definitions, 49-50global statements, 51-52MBattrAsDict() utility, 179namespaces, 51parameters, 52

arbitrary, 55-58default, 53-62named, 54-55

return statements, 58-59showAsDict, 154

GgenerateKeyForKeySet

command, 381generateSecConfigReport

command, 232get( key [, defaultValue ] )

method, 70getActiveSecuritySettings

command, 266

getattr( object, name[, default ] ) method, 80

getAttribute() method, 175, 179

getAttributes() method, 175getAttributes_jmx()

method, 183getBinding command, 386getDefaultBindings

command, 387getDeployStatus()

method, 204getDmgrProperties()

method, 220getid() method, 152getJavaHome() method, 220getKeyStoreInfo

command, 380getMBeanCount()

method, 172getObjectName() method, 165getopt() library routine,

100-102getPolicySet command, 385getPolicySetAttachments

command, 386getPolicyType command, 385getRequiredBindingVersion

command, 387getServerType command, 233getServerType() method, 202getSingleSignon

command, 269getters, 140getUserRegistryInfo

command, 269getWebService method, 392global security, 249, 311. See

also securityglobal statements, 51-52globals() method, 80group( [group] ) method, 110groupdict() method, 110

Index 457

groupsAdminNodeGroup

Management librarymodule, 445-446

IdMgrRepositoryConfig,275-276

JACCUtilityCommands,275

JDBCProviderManage-ment, 291-293

mapping, 251-253PolicySetManagement,

382-390SecurityConfiguration-

Commands, 264-270SecurityDomain-

Commands, 270-271SecurityRealmInfo-

Commands, 272-273ServerManagement, 209SIBWebServices, 374-377VariableConfiguration,

294-296WebServicesAdmin,

390-392WIMManagement-

Commands, 273-274WizardCommands,

274-275groups() method, 110

Hhasattr( object, name )

method, 80hash( object ) method, 80has_key( key ) method, 70help files, 114Help object, 134-144help() method, scripting

libraries, 397-399Help.constructors()

method, 142

Help.descriptions()method, 143

hex( x ) method, 80hierarchies, classes, 93hosts

adding, 258configuring, 258-259deleting, 259-260viewing, 257

Iid( object ) method, 80identifiers, 15-16identity operators, 24IdMgrRepositoryConfig

group, 275-276IEEE Standard for

Binary Floating-PointArithmetic (ANSI/IEEE Std 754-1985), 7

if statements, 42import statements, 39, 88-90importBinding command, 388importing directories, 395importPolicySet command,

387importServer command, 231*_imx methods, 183-184indentation, 40index( item ) method, 68index( substring[, start

[, end ] ] ) method, 71IndexError exceptions, 68indexing sequence

elements, 13infinite loops, 42information types, 15

expressions, 18identifiers, 15-16literals, 15statement separators, 25string operators, 19-24variables, 16-18

initializationenvironments, 116-120JVM, 116

input( [prompt] ) method, 80insert( index, item )

method, 68installing applications,

400-402installInteractive()

method, 207installResourceAdapter()

method, 165instances, AdminControl

objects, 173-174instantiation, 66int( x[, radix ] ) method, 81Integrated Solutions

Console, 251integrating SIBs, 307interactive wsadmin

sessions, 43interfaces, JNDI, 211invoke() method, 181isalnum() method, 71isalpha() method, 72isAppReady() method, 201isAppSecurityEnabled

command, 275isdigit() method, 72isFederated() method, 220isinstance( object, classinfo )

method, 81isJACCEnabled

command, 275islower() method, 72isSingleSecurityDomain

command, 275isspace() method, 72issubclass( class, classinfo )

method, 81istitle() method, 72isupper() method, 72items() method, 70

458 Index

JJ2C (J2EE Connector

Architecture), 242-249authentication aliases, 278library modules, 412-414

JAASAuthData objects, 243, 313

JACCUtilityCommandsgroup, 275

Java, 95-103roles, mapping, 250security, enabling,

253-255Java 2 Connector

Architecture. See J2CJava Messaging Service

(JMS), 307Java Naming and Directory

Interface (JNDI), 211Java Virtual Machine. See

JVMJDBC (Java Database

Connector)AdminJDBC library

modules, 414-416providers, 278

JDBCProvider,troubleshooting, 281

JDBCProviderManagementGroup methods, 291-293

JMS (Java MessagingService), 307

AdminJMS librarymodules, 416-423

JNDI (Java Naming andDirectory Interface), 211

join( sequence ) method, 72JVM (Java Virtual

Machine), 6initialization, 116methods, 216-217properties, 218-219system properties,

217-218

Jythoncoding conventions, 26comments, 26data types, 6-7

accessing sequenceelements, 12-13

dictionaries, 14lists, 12numbers, 7strings, 8-11tuples, 11

information types, 15expressions, 18identifiers, 15-16literals, 15statement separators, 25string operators, 19-24variables, 16-18

overview of, 6

KKeyManager commands, 377keys

policy sets, 362-363properties, 117

keys() method, 70KeySet commands, Web

services, 381-382KeyStore commands, Web

services, 378-381keytools, 363keywords, 16, 58

Llanguages

Jython. See Jythonscripting, defining, 122

lastgroup, 111lastindex, 111LDAP failover, 255-260LDAPUserRegistry, 256leaks, tracing connection, 284

len( s ) method, 81libraries

Java, 95-105scripting

AdminApplicationobjects, 399-409


AdminClusterManage-ment modules, 430-432

AdminJ2C modules,412-414

AdminJDBC modules,414-416

AdminJMS modules,416-423

AdminNodeGroup-Managementmodules, 445-446

AdminNodeManage-ment modules, 446-447

AdminResourcesmodules, 423-427

AdminServerManage-ment modules, 432-445


navigating, 393-397troubleshooting,

397-399list( sequence ) method, 81listAllDestinationsWithRoles

method, 341listAllForeignBusesWith-

Roles method, 341listAllRolesForGroup

method, 341listAllRolesForUser

method, 341listAllTopicsWithRoles

method, 341

Index 459

listApplicationPortscommand, 232

listAssetsAttachedToPolicy-Set command, 385

listAttachmentsForPolicySetcommand, 384

listAuthDataEntriescommand, 265-266

listDataSources, 294listGroupsInBusConnector-

Role method, 341listGroupsInDefaultRole

method, 342listGroupsInDestinationRole

method, 342listGroupsInTopicRole

method, 342listGroupsInTopicSpaceRoot

Role method, 342, 344listInterceptors command, 270listJDBCProviders, 293listKeyFileAliases

command, 380listKeyManagers

command, 377listKeyStores command, 378listKeyStoreTypes

command, 378listModules() method, 201listPolicySets command, 384listPolicyTypes

command, 384ListPorts.py, 159listRegistryGroups

command, 272lists, 12

methods, 67-68Web services, 352-354

listSecurityDomainscommand, 271

listSecurityRealmscommand, 273

listServer command, 233

listServerPorts command, 232

listServers() method, 210listServerTemplates()

method, 214listServerTypes

command, 233listServerTypes() method,

202listServices method, 392listSIBEngines method, 335listSIBJMSQueues

method, 336listSIBJMSTopics

method, 336listSIBMediations

method, 337listSIBuses method, 334listSIBusMembers

method, 334listUsersInBusConnectorRole

method, 343listUsersInDefaultRole

method, 343listUsersInDestinationRole

method, 343listUsersInTopicRole

method, 343listWebServiceEndpoints

method, 391listWebServiceOperations

method, 391listWebServices method, 391literals, 8-15ljust( width ) method, 73local mode, 120local precedence, 51locals() method, 81long strings, 8long( x[, radix ] ) method, 81loop statements, 42lower() method, 73lstrip() method, 73

Mmanagement. See also

administrationAdminClusterManagement

library module, 430-432

AdminNodeGroupManage-ment library module,445-446

AdminNodeManagementlibrary module, 446-447

AdminServerManagementlibrary module, 432-445

databases, 277-280advanced settings,

284-291references, 291-300troubleshooting,

280-284servers, 199-200

commands, 209-212creating clusters,

205-209examples, 201-202JVM methods, 216-217JVM properties,




Web services, 352exporting WSDL, 355KeyManager

commands, 377KeySet commands,

381-382KeyStore commands,

378-381listing, 353-354

460 Index

navigating, 353-355overview, 346-350policy sets, 355-371PolicySetManagement

group, 382-390references, 373-376runtimes, 351-352SIBWebServices group,

374-377SOAP, 347topics, 371-372WebServicesAdmin

group, 390-392WS-I profiles, 346-347WSDL, 347

wsadmin program, 113-115





manageprofiles command, 203map( function, sequence, ... )

method, 82mapping

Java EE roles, 250reviewing, 251users, 251-253

match( pattern, string [, flags ] ) method, 109

match( string [, startPos [,endPos ] ] method, 110

max( sequence ) method, 82MBattrAsDict() utility

function, 179

MBeans, 296AdminControl object

support methods, 172-173

DataSource, 296-298Help object, 136-144TraceService, 298-300

MDBs (Message-DrivenBeans), 352

members, bus, 303membership operators, 24memory, OOM errors, 86Message-Driven Beans

(MDBs), 352messaging

busescreating, 303-308deleting, 308-310

connections, 121Help object, 145overview, 301-302references, 317-344security, 310-317terminology, 303

methodsaddGroupToBusConnector

Role, 338addGroupToDefaultRole,

338addGroupToDestination-

Role, 338addGroupToTopicRole,

339addGroupToTopicSpace-

RootRole, 340addUserToBusConnector-

Role, 338addUserToDefaultRole,

338addUserToDestination-

Role, 339addUserToTopicRole, 340addUserToTopicSpace-

RootRole, 340

AdminApp object, 200-212


editing, 208-210updating, 208-210

AdminApp.getDeploy-Status(), 204

AdminApp.isAppReady(),200

AdminApp.updateInter-active(), 208

AdminApplication.getAppDeploymentTarget(), 404

AdminConfig object, 164-165

AdminConfig.create(), 211AdminConfig.getid(), 151AdminConfig.list(), 152AdminConfig.parents(),

160AdminConfig.remove(),

162AdminConfig.reset(), 352AdminConfig.save(), 352AdminConfig.show, 153AdminConfig.showall(),

156AdminConfig.types(), 160AdminConfig.validate(),

163AdminControl objects,

181-182*_imx, 183-184MBean, 172-173

AdminControl.start-Server(), 168

AdminTask, 264AdminTask.listPolicy-

Sets(), 356create(), 160-162createSIBDestination,

320-322createSIBEngine, 322-323

Index 461

createSIBJMSActivation-Spec, 325-326

createSIBJMSConnectionFactory, 323-324

createSIBJMSQueue,324-325

createSIBJMSTopic, 325createSIBus, 317-318deleteSIBDestination,

328-329deleteSIBJMSActivation-

Spec, 327deleteSIBJMSConnection

Factory, 327deleteSIBJMSQueue, 327deleteSIBJMSTopic, 327deleteSIBus, 327deleteUserAndGroup-

Entries(), 210dictionary, 69-71export(), 210exportDDL(), 210fixFileName(), 207getAttribute(), 175-179getAttributes(), 175getAttributes_jmx(), 183getDeployStatus(), 204getid(), 152getMBeanCount(), 172getObjectName(), 165Help object, 136help(), scripting libraries,

397-399Help.constructors(), 142Help.descriptions(), 143installInteractive(), 207installResourceAdapter(),

165invoke(), 181isAppReady(), 201JDBCProviderManage-

ment Group, 291-293JVM, 216-217

listAllDestinationsWith-Roles, 341

listAllForeignBusesWith-Roles, 341

listAllRolesForGroup, 341listAllRolesForUser, 341listAllTopicsWithRoles,

341listGroupsInBusConnector

Role, 341listGroupsInDefaultRole,

342listGroupsInDestination-

Role, 342listGroupsInTopicRole,

342listGroupsInTopicSpace-

RootRole, 342-344listModules(), 201lists, 67-68listSIBEngines, 335listSIBJMSQueues, 336listSIBJMSTopics, 336listSIBMediations, 337listSIBuses, 334listSIBusMembers, 334listUsersInBusConnector-

Role, 343listUsersInDefaultRole,

343listUsersInDestination-

Role, 343listUsersInTopicRole, 343modify(), 160-162modifySIBDestination,

330-331modifySIBEngine, 330modifySIBJMSQueue, 332modifySIBJMSTopic, 333modifySIBus, 329names, extracting, 135options(), 203publishWSDL(), 211

queryNames(), 174removeDefaultRoles, 337removeGroupFromAll-

Roles, 337removeSIBusMember, 328removeUserFromAllRoles,

337removeVariable, 296restart(), 182searchJNDIReferences(),

211servers, 202-205setAttributes(), 179-180setAttributes_jmx(), 184setVariable, 295show(), 155-159showAsDict(), 157showSIBEngine, 336showSIBJMSConnection-

Factory, 336showSIBJMSQueue, 336showSIBJMSTopic, 336showSIBMediation, 337showSIBus, 334showSIBusMember, 335showVariables, 294startServer(), 169stopServer(), 169strings, 71-77tell(), 155-159uninstall(), 208uninstallResource-

Adapter(), 165updateAccessIDs(), 212updateInteractive(), 209VariableConfiguration

Group, 294-296view(), 203z/OS, 220-223

min( sequence ) method, 82missing attributes, 155modes, local, 120modify() method, 160-162

462 Index

modifyingAdminControl objects,

167-172buses, 329configuration, 150J2C (JAAS) aliases, 245runtime behavior, 283security domains, 261

modifyKeySet command, 382modifySIBDestination

method, 330-331modifySIBEngine method,

330modifySIBJMSQueue

method, 332modifySIBJMSTopic

method, 333modifySIBus method, 329modules

AdminApplication scriptlibrary, 399-409

AdminAuthorizations,428-430

AdminClusterManage-ment, 430-432

AdminJ2C, 412-414AdminJDBC, 414-416AdminJMS, 416-423AdminLibHelp, 447AdminNodeGroupManage-

ment, 445-446AdminNodeManagement,

446-447AdminResources, 423-427AdminServerManagement

, 432-445AdminUtilities, 447errors, 92-94import statements, 88-90names, 203namespaces, 124nested_scopes, 90-92overview, 87

packages, 92simple, 129sys, 98-99

moduleTest.py, 131moveClusterToCoreGroup

command, 225moveServerToCoreGroup

command, 225multiple security domains,

261-262

Nnamed function parameters,

54-55NameError exception, 132names

AdminControl object,173-174

applications, 203filenames, 203JNDI, 211methods, extracting, 135modules, 203variables, 15-16

namespaces, 51modules, 124wsadmin, 123

navigatingJ2C (JAAS) aliases,

244-245LDAPUserRegistry, 256scripting libraries,

393-397Web services, 353-355

negative indexes, 13nested_scopes, 90-92nodes

AdminNodeGroupManage-ment library module,445-446

AdminNodeManagementlibrary module, 446-447

numbers, 7

Oobject-oriented programming.

See OOPobjects

AdminApp, 199application installation

methods, 204-208editing, 208-210methods, 199-212updating, 208-210

AdminApplication,399-409

AdminConfig, 149config ID, 150-155configuration types,



methods, 164methods, 164-165overview of, 149-150show/tell methods, 155-


AdminControl, 167attributes, 174-181environment

information, 167-172*_imx methods,

183-184MBean support

methods, 172-173methods, 181-182names, 173-174

administration, 129-134documentation,

145-147Help, 134-145

availability, 133dictionary, 69-71instantiation, 66

Index 463

Java, 95-105lists, 67-68modules, 87

errors, 92-94import statements,

88-90nested_scopes, 90-92packages, 92

Security, 278strings, 71-77target, 210

OOM (out of memory) errors, 86

OOP (object-orientedprogramming), 63

built-inconstants, 66data types, 67functions, 77-86

class statements, 63-66dictionary methods, 69-71instantiation, 66list methods, 67-68string methods, 71-77

open( filename[, mode[,bufsize ] ] ) method, 82

operationsAdminApp object, 199


editing, 208-210methods, 199-212updating, 208-210

AdminConfig object, 149-150

config ID, 150-155configuration types,



methods, 164

methods, 164-165show/tell methods, 155-


filenames, 203MBean Help objects,

140-141Web services, 355

operatorsarithmetic, 18augmented assignment

statements, 32bitwise, 21Boolean, 21comparison, 22identity, 24membership, 24relationships, 22strings, 19-24unary, 21

optionscommand line, 117,

284-294wsadmin program, 115



options() method, 203ord( c ) method, 82out of memory (OOM)

errors, 86

Ppackages, 92packing assignment

statements, 30-31parameters

failon error, 399functions, 52

arbitrary, 55-58default, 53-62named, 54-55

scripts, 127sequences, unpacking, 56

ParentTypes.py, 161parmTest() method, 103-104parseOpt() method, 104-106pass statements, 39passing filenames to

scripts, 206paths, containment, 151period (.), 63permissions, configuring, 314ping, 348-350PingServiceJAXRPCApplica-

tion, 353POJO (Plain Old Java

Object), 351policy sets, Web services,

355-365, 367-371PolicySetManagement group,

382-390pop( [ index ] ) method, 68pos, 111pow( x, y[, z ] ) method, 82precedence

local, 51operators, 20, 24

print statement, 27-28processing command line

options, 100-102profiles

script files, 123-126WS-I, 346-347

programmingfunctional, 94Jython


coding conventions, 26comments, 26data types, 6-7dictionaries, 14expressions, 18identifiers, 15-16

464 Index

information types, 15lists, 12literals, 15numbers, 7operators, 19-24overview of, 6statement separators, 25strings, 8-11tuples, 11variables, 16-18

OOP, 63built-in constants, 66built-in data types, 67built-in functions,

77-86class statements, 63-66dictionary methods,

69-71instantiation, 66list methods, 67-68string methods, 71-77

programswsadmin, 113-115





properties, 121JVM, 217-223keys, 117

propfileToDict() method, 95publishSIBWSInboundSer-

vice method, 377publishWSDL() method, 211

QQOS (Qualities of

Service), 355query application

configurations, 403-404queryNames() method, 174queues, messaging

creating buses, 303-308deleting buses, 308-310security, 310-317

RRAD (Rational Application

Developer) tool, 361raise statements, 39range( [start,] stop[, step ] )

method, 82Rational Application

Developer (RAD) tool, 361raw strings, 11raw_input( [prompt] )

method, 83re (regular repression)

function, 111Receiver security role, 311reduce( function, sequence[,

initialValue ] ) method, 83references

databases, 291-300messaging, 317-344servers, 223-239Web services, 373-376

registries, Federated, 260-261regular expressions (RegExp),

107-112, 135, 157relationship operators, 22reload( module ) method, 84remove( index ) method, 68removeDefaultRoles

method, 337

removeGroupFromAllRolesmethod, 337

removeNodeGroup command, 225

removeNodeGroupMembercommand, 224

removeSIBusMembermethod, 328

removeUserFromAllRolesmethod, 337

removeVariable method, 296replace( old, new[, count ] )

method, 73reportConfigInconsistencies

command, 226ReportConfiguredPorts

command, 226repr( object ) method, 84resources, AdminResources

library module, 423-427restart() method, 182return statement, 58-59reverse() method, 68reviewing mappings, 251rfind( substring[,start [,end ] ]

) method, 73rindex( substring[, start[, end

] ] ) method, 73rjust( width ) method, 73RMI/IIOP connections, 121roles

Java, 250mapping, 251-253security, 311

round( x[, digits ] ) method,84

rstrip() method, 73runtimes

behavior, modifying, 283Web services, 351-352

RW attributes, 177

Index 465

Sscope, nested_scopes, 90-92scripting

administration objects,129-134

documentation,145-147

Help, 134-145functional programming,

94languages, defining, 122libraries

AdminApplicationobjects, 399-409


AdminClusterManage-ment modules, 430-432

AdminJ2C modules,412-414

AdminJDBC modules,414-416

AdminJMS modules,416-423

AdminNodeGroup-Managementmodules, 445-446

AdminNodeManage-ment modules, 446-447

AdminResourcesmodules, 423-427

AdminServerManage-ment modules, 432-445


navigating, 393-397troubleshooting,

397-399profile script files, 123-126

support for, 1troubleshooting, 92-94wsadmin program

commands, 126-128scripts

filenames, passing, 206Jython, 6. See also Jython

search( pattern, string [, flags ] ) method, 109

search( string [, startPos [,endPos ] ] ) method, 110

searching chains, 315searchJNDIReferences()

method, 211SecureConversation policy

set, 357security

AdminTasks methods, 264applications, configuring,

249-253bus, 263buses, 337datasources, 263Federated registries,

260-261J2C, 242-249Java, enabling, 253-255LDAP failover, 255-260messaging, 310-317

multiple domains, 261-262overview of, 241-242Web services, 264

Security object, 278SecurityConfiguration-

Commands group, 264-270SecurityDomainCommands

group, 270-271SecurityRealmInfo-

Commands group, 272-273Sender security role, 311separator statements, 25

sequenceselements, accessing, 12-13escape, 9parameters, unpacking, 56slices, 32-33tuples, 11unpacking, 31

server-side policyattachments, 368

ServerManagement group, 209servers

AdminServerManagementlibrary module, 432-445

applications, 2deleting, 207LDAP failover, 255-260management

commands, 209-212creating clusters,

205-209examples, 201-202JVM methods, 216-217JVM properties,




management, 199-200security, 241-242

applications, 249-253J2C, 242-249Java, 253-255

serverStatus command, 172ServerTypes methods,

202-205service integration buses

(SIBs), 307services, Web. See Web

services

466 Index

sessions, wsadmin programs, 128

setAdminActiveSecuritySet-tings command, 266-267

setAppActiveSecuritySettingscommand, 267-268

setattr( object, name, value )method, 85

setAttributes() method, 179-180

setAttributes_jmx() method, 184

setBinding command, 390setdefault( key [,

defaultValue ] ) method, 70setGlobalSecurity

command, 274setJVMProperties

command, 236setJVMProperties()

method, 219setJVMSystemProperties

command, 237setProcessDefinition

command, 237setProcessDefinition()

method, 220-222setServerInstance()

method, 220setters, 140setTraceSpecification()

method, 220setVariable method, 295show() method, 155-159showAsDict function, 154showAsDict() method, 157showJVMProperties()

method, 219showProcessDefinition()

method, 220-222showServerInfo

command, 234showServerInfo() method, 210

showServerInstance() method, 210

showServerTypeInfocommand, 234

showServerTypeInfo()method, 202

showSIBEngine method, 336showSIBJMSConnection-

Factory method, 336showSIBJMSQueue

method, 336showSIBJMSTopic

method, 336showSIBMediation

method, 337showSIBus method, 334showSIBusMember

method, 335showTemplateInfo() method,

214-215showVariables method, 294SIBs (service integration

buses), 307SIBWebServices group,

374-377simple modules, 129simple statements, 35

assert, 35-36break, 36continue, 36control flow, 39-41del, 36exec, 38import, 39pass, 39raise, 39return, 58-59

SmartCellStop.py, 170SOAP, 121, 347span( [group] ) method, 111specifying multiple

commands, 126split( pattern, string [,

maxsplit ] ) method, 109

split( string [, maxsplit ] )method, 110

split( [ separator [,maxsplit ] ] )method, 73

splitlines( [keepends] )method, 73

square brackets ([ ]), 153, 157start( [group] ) method, 110startApplicationOnSingle-

Server() method, 408starting applications, 408-409startServer() method, 169startswith( prefix[, start[,

end ] ] ) method, 73Stateless Session Beans, 352statements

assignment, 16, 28-30augmented, 32packing/unpacking,

30-31slices, 34

class, 63-66comments, 116compound, 41

for, 44-46if, 42loop, 42try, 47-48while, 42-43

expressions, 27-28global, 51-52import, 88-90return, 58-59separators, 25simple, 35

assert, 35-36break, 36continue, 36control flow, 39-41del, 36exec, 38import, 39pass, 39raise, 39

Index 467

StopCell.py, 170stopping applications,

408-409stopServer() method, 169__str__() method, 93str ( object ) method, 85strings, 8-11

functions, 111long, 8methods, 71-77operators, 19-24raw, 11triple-quoted, 8

strip() method, 74sub( pattern, replacement,

string [, count ] ) method,110

sub( replacement, string [,count ] ) method, 110

subn( pattern, replacement,string [, count ] ) method,110

subn( replacement, string [, count ] ) method, 110

swapcase() method, 74syntax errors, 92-94sys module, 98-99

dictionary, 131sys.path variable, 394

Ttarget objects, 210tell() method, 155-159TemplateInfo.py, 215template servers, 214-216testing, 169title() method, 74tools

keytools, 363RAD, 361

topics, policy, 371-372TraceService, MBeans,

298-300

tracingconnection leaks, 284wsadmin programs, 122

transport security, enabling,314-317

triple-quoted strings, 8troubleshooting, 92-94

databases, 280-284OOM errors, 86scripting libraries,

397-399try statements, 47-48tuples, 11, 31type( object ) method, 85types

configuration, 152-153data, 6-7


dictionaries, 14lists, 12numbers, 7strings, 8-11tuples, 11

information, 15expressions, 18identifiers, 15-16literals, 15statement separators, 25string operators, 19-24variables, 16-18

policy, 359

Uunary operators, 21unichr( i ) method, 85unicode( object[, encoding

[, errors ] ] ) method, 85uninstall() method, 208uninstalling applications,

400-402uninstallResourceAdapter()

method, 165

unpackingassignment statements, 30-

31sequence parameters, 56

unsetAppActiveSecurity-Settings command, 268-269

update( dict ) method, 71updateAccessIDs()

method, 212updateEntireAppToAnApp-

WithUpdateCommand()method, 406

updateInteractive() method, 209

updatingAdminApp methods,

208-210applications, 404-406

upper() method, 74usage information, wsadmin

programs, 116usage() method, 102-103users, mappings, 251-253

VvalidatePolicySet

command, 388validation, configuring,

162-163values, 59values() method, 71van Rossum, Guido, 61VariableConfiguration

command group, 282VariableConfiguration Group

methods, 294-296variables

names, 15-16overview of, 16-18slices, 32-33sys.path, 394

VariableSubstitutionEntry,281

468 Index

vars( [object] ) method, 86verifying configurations,

162-163view() method, 203viewing

buses, 334hosts, 257J2C (JAAS) aliases,

244-245

WWAuJ.py, 133Web services

KeyManager commands,377

KeySet commands, 381-382

KeyStore commands, 378-381

listing, 353-354managing, 352navigating, 353-355overview, 346-350policy sets, 355-371PolicySetManagement

group, 382-390references, 373-376runtimes, 351-352security, 264SIBWebServices group,

374-377SOAP, 347topics, 371-372WebServicesAdmin group,

390-392WS-I profiles, 346-347WSDL, 347, 355

Web Services DefinitionLanguage. See WSDL

WebServicesAdmin group,390-392

Websphere ApplicationServer, overview of, 2

WebSphere Control Program(WSCP), 6

while statements, 42-43WIMManagementCommands

group, 273-274WizardCommands group,

274-275WS-I profiles, 346-347wsadmin program, 113-115.

See also administrationcommands, 126-128connecting, 120options, 115



profile script files, 123-126

scripting language, 122sessions, 43tracing, 122

wsadmin.properties file, 133WSASobjects.py, 131-132WSCP (WebSphere Control

Program), 6WSDL (Web Services

Definition Language), 211, 347

exporting, 355WSSecurity policy set, 358

X–Zxrange( [start,] stop[, step] )

method, 86

z/OS methods, 220-223zfill ( width ) method, 74

the authors and publisher have taken care in the preparation of

Documents