Rapid Portlet Development with WebSphere Portlet FactoryStep-by-Step Guide for Building Your Own Portletsby David BowleyISBN: 0-13-713446-0

Expert developer David Bowley walks you through several of today’s most common portlet development scenarios, demonstrating how to create powerful, robust portlets quickly and cost-effectively. Each walkthrough contains all the step-by-step instructions, detailed guidance, fast answers, and working sample code you need to get tangible results immediately.

As the best resource available on WebSphere Portlet Factory, this book refl ects Bowley’s unsur-passed experience constructing large enterprise portals. Bowley covers everything from back-end integration to user interface and AJAX techniques, helping you choose the right builder tool for each task and defi ne high-level instructions that gener-ate superior code artifacts. His example projects are simple enough to understand easily, but sophisticated enough to be valuable in real-world development.

WebSphere Business Integration Primer Process Server, BPEL, SCA, and SOAby Ashok Iyengar, Vinod Jessani, and Michele ChilantiISBN: 0-13-224831-X

Using WebSphere® Business Integration (WBI) technology, you can build an enterprise-wide Business Integration (BI) infrastructure that makes it easier to connect any business resources and functions, so you can adapt more quickly to the demands of customers and partners. Now there’s an introductory guide to creating standards-based process and data integration solutions with WBI.

WebSphere Business Integration Primerthoroughly explains Service Component Architecture (SCA), basic business processes, and complex long-running business fl ows, and guides you to choose the right process integration architecture for your requirements. Next, it intro-duces the key components of a WBI solution and shows how to make them work together rapidly and effi ciently. This book will help developers, technical professionals, or managers understand today’s key BI issues and technologies, and streamline business processes by combining BI with Service Oriented Architecture (SOA).

Related Books of Interest

Sign up for the monthly IBM Press newsletter at ibmpressbooks/newsletters

ii ContentsRelated Books of Interest

Visit ibmpressbooks.com for all product information

IBM WebSphere DataPower SOA Appliance Handbookby Bill Hines, John Rasmussen, Jaime Ryan, Simon Kapadia, Jim BrennanISBN: 0-13-714819-4

IBM WebSphere DataPower SOA Appliance Handbook begins by introducing the rationale for SOA appliances and explaining how DataPower appliances work from network, security, and Enterprise Service Bus perspectives. Next, the authors walk through DataPower installation and confi guration; then they present deep detail on DataPower’s role and use as a network device.

Using many real-world examples, the authors systematically introduce the services available on DataPower devices, especially the “big three”: XML Firewall, Web Service Proxy, and Multi-Protocol Gateway. They also present thorough and practical guidance on day-to-day DataPower management, including monitoring, confi guration, build, and deploy techniques.

WebSphere EngineeringA Practical Guide for WebSphere Support Managers and Senior Consultantsby Ying DingISBN: 0-13-714225-0

In WebSphere Engineering, author Ying Ding shows how to maximize the WebSphere platform’s reliability, stability, scalability, and per-formance for large enterprise systems. You’ll fi nd insightful discussions of each option and strategy for managing WebSphere, including practical guidance on making the right tradeoffs for your environment.

Coverage includes• Planning, hiring, training, funding, and building

a world-class WebSphere engineering support organization

• Implementing tight standards and consistent, comprehensive processes for managing the entire WebSphere engineering life cycle

• Creating optimal testing environments, administering parallel testing pipelines, and managing testing workloads

• Empowering production support teams with knowledge, system privileges, and the right tools

Contents iiiRelated Books of Interest

Sign up for the monthly IBM Press newsletter at ibmpressbooks/newsletters

The New Language of BusinessCarterISBN: 0-13-195654-X

SOA GovernanceBrown, Laird, Gee, MitraISBN: 0-13-714746-5

Dynamic SOA and BPMFiammanteISBN: 0-13-701891-6

The Greening of ITLambISBN: 0-13-7155083-0

Enterprise Master Data ManagementDreibelbis, Hechler, Milman, Oberhofer, van Run, Wolfson ISBN: 0-13-236625-8

Enterprise Java Programming with IBM WebSphere, Second EditionBrown, Craig, Hester, Pitt, Stinehour, Weitzel, Amsden, Jakab, BergISBN: 0-321-18579-X

Executing SOAA Practical Guide for the Service-Oriented Architectby Norbert Bieberstein, Robert G. Laird, Dr. Keith Jones, and Tilak MitraISBN: 0-13-235374-1

In Executing SOA, four experienced SOA implementers share realistic, proven, “from-the-trenches” guidance for successfully delivering the largest and most complex SOA initiative.

This book follows up where the authors’ bestsell-ing Service-Oriented Architecture Compass left off, showing how to overcome key obstacles to successful SOA implementation and identifying best practices for all facets of execution—technical, organizational, and human. Among the issues it addresses include introducing a services discipline that supports collaboration and information process sharing; integrating services with preexisting technology assets and strategies; choosing the right roles for new tools; shift-ing culture, governance, and architecture; and bringing greater agility to the entire organizational lifecycle, not just isolated projects.

Listen to the author’s podcast at:ibmpressbooks.com/podcasts

This page intentionally left blank

WebSphereApplicationServerAdministrationUsing Jython

This page intentionally left blank

IBM WebSphere

[SUBTITLE ]

Deployment and AdvancedConfiguration

Roland Barcia, Bill Hines, Tom Alcott, and Keys Botzum

WebSphere ApplicationServerAdministrationUsing Jython

Robert A. Gibson, Arthur Kevin McGrath, Noel J. Bergman

IBM PressPearson plcUpper Saddle River, NJ • Boston • Indianapolis • San FranciscoNew York • Toronto • Montreal • London • Munich • Paris • MadridCape Town • Sydney • Tokyo • Singapore • Mexico City

Ibmpressbooks.com

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 Sales1-800-382-3419corpsales@pearsontechgroup.com.

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

International Salesinternational@pearson.com.

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

From the authorsSpeaking with one voice, we wish to dedicate this book to the Gibson family.

From Bob GibsonI thank God for his countless gifts and blessings and dedicate this work

to my bride of 30 years, Linda, and our children. I’m sorry for all the time that this has required, but I have thought of you all throughout its development.

I also thank everyone who helped make this book a reality. I could not have done this without your assistance, nor would it have been anywhere as

good as you have helped make it.

From Arthur Kevin McGrathI dedicate this book to Bob Gibson’s children and to my niece, Katie Scalzo.

Katie and the Gibson kids have a love for life and a dedication to their families that commands the respect and admiration of all of us.

From Noel J. BergmanI thank my friends and family for putting up with my lack of social time while working on two books, a day job, and involvement with

The Apache Software Foundation.

xi

Contents at a Glance

Acknowledgments xxi

About the Authors xxiii

Chapter 1 Introduction 1

Chapter 2 Jython Fundamentals 5

Chapter 3 Jython Statements 27

Chapter 4 Jython Classes 63

Chapter 5 Jython Modules 87

Chapter 6 wsadmin 113

Chapter 7 Introduction to Admin Objects 129

Chapter 8 The AdminConfig Object 149

Chapter 9 The AdminControl Object 167

Chapter 10 The AdminApp Object 185

Chapter 11 The AdminTask Object—Server Management 199

Chapter 12 Scripting and Security 241

Chapter 13 Databases and Authorization 277

Chapter 14 Messaging 301

Chapter 15 Administering Web Services 345

Chapter 16 Version 7.0 Scripting Libraries 393

Index 449

This page intentionally left blank

Contents

Acknowledgments xxi

About the Authors xxiii

Chapter 1 Introduction 1Why Is This Book Necessary? 1About the Websphere Application Server Product 2This Book and Its Organization 2

Chapter 2 Jython Fundamentals 5Introduction 6Data Types 6

Numbers 7Strings 8Tuples 11Lists 12Accessing Sequence Elements 12Dictionaries 14

Additional Information Types 15Literals (Constants) 15Variables Names (Identifiers) 15Variables 16Expressions 18String Operators 19Statement Separator 25

Comments 26Coding Conventions 26Summary 26

xiii

Chapter 3 Jython Statements 27Expression Statements 27

The print Statement 27Assignment Statements 28

Packing and Unpacking 30Augmented Assignment 32

Slices 32Simple Statements 35

The assert Statement 35The break Statement 36The continue Statement 36The del Statement 36The exec Statement 38The import Statement 39The pass Statement 39The raise Statement 39Control Flow 39

Compound Statements 42The if Statement 42loop Statements 42The while Statement 43The for Statement 44The try Statement 47

Functions 49Function Definitions 50Namespaces 51The global Statement 51Function Parameters 53The return Statement 58Default Parameter Evaluation 60

Summary 62

Chapter 4 Jython Classes 63Class Statement 63

Example class Definition 64Object Instantiation 66Built-in Constants 66Built-in Data Types 67

List Methods 67Dictionary Methods 69String Methods 71

String Formatting 74Built-in Functions 77Summary 86

xiv Contents

Chapter 5 Jython Modules 87Jython Module Basics 87

The import Statement 88nested_scopes 90

Packages 92Errors and Exceptions 92

Built-in Exceptions 93Functional Programming 94Using Java Objects and Libraries 95

Jython Standard Library 97getopt() Module 100Regular Expressions (RegExp) 107

Summary 112

Chapter 6 wsadmin 113wsadmin Options 115

Usage Information 116The Java Virtual Machine Initialization Phase 116The wsadmin Environment Initialization Phase 116

The Connection Phase 120Defining the Scripting Language 122Trace-Related Options 122wsadmin Profile Script Files 123Commands and Script Files 126

Interactive/Interpretive wsadmin Session 128Summary 128

Chapter 7 Introduction to Admin Objects 129The Administrative Scripting Objects 129Help for the Help Object 134Help for MBeans 136

Help for MBean Attributes 138Help for MBean Operations 140Help for Additional MBean Information 142

Help for Other Administrative Objects 144Help for WebSphere Messages 145

Useful Information 145Summary 147

Chapter 8 The AdminConfig Object 149AdminConfig Overview 149

Configuration Identifier (config ID) 150Containment Path 151Configuration Types 152

Using a config ID 153

Contents xv

Show and Tell Methods 155Create and Modify Methods 160Configuration Verification/Validation 162Document Manipulation Methods 164Miscellaneous Methods 164Summary 165

Chapter 9 The AdminControl Object 167Environment Information and Manipulation 167MBean Support Methods 172Objects, Names, and Instances 173Attribute-Related Methods 174Miscellaneous Methods 181*_jmx Methods 183Summary 184

Chapter 10 The AdminApp Object 185Application Informational Methods 185Application Installation Methods 190Edit, Update, and Uninstall 194Miscellaneous AdminApp Methods 196Summary 198

Chapter 11 The AdminTask Object—Server Management 199Introduction 199Simple One-Line Examples 201ServerType-Related Methods 202Creating Servers and Clusters 205Server-Related Commands 209

create*Server Optional and Required Steps 212Server Template-Related Commands 214JVM-Related Methods 216JVM System Properties 217JVM Properties 218z/OS-Specific Methods 220

Miscellaneous ServerManagement Methods 220Reference Section 223

Node Group Command Group and Core Group Command Group 224createCoreGroup 224createNodeGroup 224addNodeGroupMember 224removeNodeGroupMember 224removeNodeGroup 225moveClusterToCoreGroup 225moveServerToCoreGroup 225deleteCoreGroup 226

xvi Contents

AdminReports Command Group 226reportConfigInconsistencies 226ReportConfiguredPorts 226ClusterConfigCommands Command Group 226createCluster 226createClusterMember 228deleteClusterMember 230deleteCluster 230ConfigArchiveOperations Command Group 231exportServer 231importServer 231GenerateSecurityConfigCommand Command Group 232generateSecConfigReport 232PortManagement Command Group 232listApplicationPorts 232listServerPorts 232ServerManagement Command Group 233listServer 233getServerType 233listServerTypes 233showServerInfo 234showServerTypeInfo 234createApplicationServer 234createApplicationServerTemplate 235deleteServer 236setJVMProperties 236setJVMSystemProperties 237setProcessDefinition 237Server Management Methods that Do Not Belong to Any Command Group 238createServerType 238

Summary 239

Chapter 12 Scripting and Security 241WebSphere Security Basics 241JAAS (J2C) Aliases 242

Create a J2C (JAAS) Alias 242Viewing JAAS Aliases 244Modify a JAAS Alias 245Delete a JAAS Alias 246

Configuring Application Security 249Enabling/Disabling Administrative and Application Security 249Mapping Java EE Roles 250

Contents xvii

Review the Current and Available Mappings 251Mapping Roles to Users and/or Groups 251

Enable/Disable Java 2 Security 253LDAP Failover 255

Viewing the Hosts 257Adding Additional LDAP Hosts 258Setting the Host List 258Removing LDAP Hosts 259

Federated Registries (and Other Essentially Undocumented Scripting Areas) 260Multiple Security Domains (WebSphere V7) 261Additional Security Topics 263

Bus Security 263Datasources 263Web Services 264

AdminTask Security Reference 264SecurityConfigurationCommands Group 264SecurityDomainCommands Group 270SecurityRealmInfoCommands 272WIMManagementCommands 273WizardCommands 274JACCUtilityCommands 275IdMgrRepositoryConfig 275

Chapter 13 Databases and Authorization 277Database Basics 277

Terminology 278A Simple Example 278

Troubleshooting Configuration Problems 280Advanced Settings 284Databases Reference Section 291

JDBCProviderManagement Group 291VariableConfiguration Group 294Useful MBeans 296

Summary 300

Chapter 14 Messaging 301An Introduction to Messaging 301Messaging Basics 302Terminology 303Example: Creating a Bus 303Example: Deleting a Bus 308

xviii Contents

Security 310Enabling Bus Security 311Example: Enabling Bus Access Security 312Example: Enabling Transport Security 314

Reference Section 317Creating Message Buses 317Deleting a Bus and Bus Components 326Modifying a Bus and Bus Components 329Displaying Buses and Bus Components 334Bus Security 337

Summary 344

Chapter 15 Administering Web Services 345Web Services Basics 346

WS-I Profiles 346WSDL and SOAP 347A Web Service Example 348Web Services Runtimes 351Managing Web Services 352

Exploring Web Services 353Listing Web Services 353Listing Web Services Information 354Exporting the WSDL for a Web Service 355

Web Service Policy Sets 355Policy Set Bindings 362Policy Set Attachment 368

Policy Topics Summary 371Additional Topics 371

Enable/Disable Endpoints 371WS-Notification 371Web Services and the Service Integration Bus 372Mediations 372Web Services Gateway 372Online References 372

AdminTask Web Services Reference 373SIBWebServices Group 374KeyManagerCommands 377KeyStoreCommands 378KeySetCommands 381PolicySetManagement Group 382WebServicesAdmin Group 390

Contents xix

Chapter 16 Version 7.0 Scripting Libraries 393Library Organization 393Scripting Library Help 397

Default Failure Action 398AdminApplication Script Library Module 399

AdminApplication Group 1—Install and Uninstall Applications 400AdminApplication Group 2—Query Application Configurations 403AdminApplication Group 3—Update Applications 404AdminApplication Group 4—Export Applications 406AdminApplication Group 5—Configure Application Deployment 407AdminApplication Group 6—Start/Stop Applications 408

Business-Level Applications (AdminBLA) 409Java 2 Connector (AdminJ2C) Library Module 412AdminJDBC Library Module 414AdminJMS Library Module 416AdminResources Library Module 423AdminAuthorizations Library Module 428AdminClusterManagement Library Module 430AdminServerManagement Library Module 432

AdminServerManagement: Group 1—Server Configuration 433AdminServerManagement: Group 2—ServerTracingAndLogging Configuration 437AdminServerManagement: Group 3—OtherServicesConfiguration 439

AdminNodeGroupManagement Library Module 445AdminNodeManagement Library Module 446AdminLibHelp and AdminUtilities Library Modules 447Summary 447

Index 449

xx Contents

xxi

Acknowledgments

Although it has been stated before, it bears repeating: Books do not come together without a greatdeal of time and effort. It is probably a good thing that we don’t realize just how much time andeffort we are committing to when we first sign up for a task of this size. Nor does a book make itthrough the process without help and support from an entire community. It is an enormous under-taking, and we could not have done it without a great deal of assistance.

First, we would like to thank IBM for providing its amazing WebSphere Application Serverproduct. It is function-rich and contains so many features that it is difficult for any one person toknow all of its capabilities. If it were not an important and valuable product, there would be littleneed for a book like this.

We would also like to thank our colleagues for their continued support during the timerequired to pull all of this information together. We would especially like to thank our reviewerswho made time in their busy schedules to help make this a better book: Ty Shrake, BillHoltzhauser, Mike Shenhouse, Rich Montjoy, Peter Neergaard, Peter Jakab, Preston Law, andGale Botwick.

Bob would also like to thank the management at IBM, especially Wayne Sholtes, for pro-viding the kind of environment that allows and encourages excellence and outstanding teamwork.Thank you also for making this such a wonderful place to work.

And last, but not least, we want to be sure to thank the IBM Press team that helped usthrough the challenge of driving this book to completion. Thank you to Katherine Bull, Pearson’sacquisition editor, Steven Stansel, IBM’s program manager for IBM Press, and most of all,Kendell Lumsden, our development editor. Your perseverance, dedication, professionalism,encouragement, and gentle guidance helped us immensely.

This page intentionally left blank

xxiii

About the Authors

Bob Gibson is an Advisory Software Engineer who has more than 30 years of experience innumerous software-related roles at IBM, including Architect, Developer, Tester, Instructor, andTechnical Support. For the last 10+ years, he has been working with IBM’s WebSphere Applica-tion Server and is currently a team leader for the technical support group responsible for thisamazing product. He holds both a Bachelor of Science degree in Engineering Science and a Mas-ter of Science degree in Computer Science from the University of Virginia.

Arthur Kevin McGrath has worked for Contract Engineers in a variety of positions since 1983.Kevin has lectured internationally on programming languages, management, and quality assur-ance subjects. He has authored and co-authored courses on programming, management, andquality topics and trained new instructors. Kevin received a BA in History in 1970 from DowlingCollege.

Noel J. Bergman is a Consultant and Contact Instructor. He has over 25 years of experience, 20of which are with enterprise class distributed computing systems. Noel’s areas of expertiseinclude Java, JavaEE, SOA, WebSphere Application Server, Enterprise Service Bus, ProcessServer, and Portal, including both development and administration. Noel is a member of TheApache Software Foundation and vice president of the Apache Incubator. In his spare time, Noelenjoys hanging out on coral reefs with old friends.

This page intentionally left blank

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.

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.

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.

This page intentionally left blank

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

languages, 122environment

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

123-126tracing, 122usage information, 116

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-

Commands group, 273-274

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,

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

160-162document manipulation

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-

Commands group, 264-270

SecurityRealmInfo-Commands group, 272-273

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

218-219JVM system properties,

217-218references, 223-239template-related

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

SIBs, 307strings, 74-77WIMManagement-

Commands group, 273-274

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

advanced settings, 284-291

references, 291-300troubleshooting,

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-

Commands group, 270-271

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

advanced settings, 284-291

references, 291-300troubleshooting,

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,

218-219JVM system 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

AdminAuthorizationsmodules, 428-430

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

business-levelapplications, 409-412

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,

218-219JVM system properties,

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

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

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

commands, 126-128connecting, 120defining scripting

languages, 122environment

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

123-126tracing, 122usage information, 116

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

application installationmethods, 204-208

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,

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

160-162document manipulation

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

159verification, 162-163

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

application installationmethods, 204-208

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

AdminConfig object, 149-150

config ID, 150-155configuration types,

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

160-162document manipulation

methods, 164

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

159verification, 162-163

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

environmentinitialization, 116-120

JVM initialization, 116usage information, 116

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

accessing sequenceelements, 12-13

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

commands, 126-128connecting, 120defining scripting

languages, 122environment

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

123-126tracing, 122usage information, 116

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

AdminAuthorizationsmodules, 428-430

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

business-levelapplications, 409-412

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,

218-219JVM system properties,

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

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

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

accessing sequenceelements, 12-13

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

environmentinitialization, 116-120

JVM initialization, 116usage information, 116

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