TIBCO ActiveMatrix BusinessWorks Plug-in for ......TIBCO, Two-Second Advantage, TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces, TIBCO

TIBCO ActiveMatrix BusinessWorks™ Plug-in for ActiveSpaces®

User’s GuideSoftware Release 2.2October 2015

Two-Second Advantage®

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME.TIBCO, Two-Second Advantage, TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces, TIBCO ActiveSpaces, TIBCO ActiveMatrix BusinessWorks, TIBCO Designer, TIBCO Administrator, TIBCO Rendezvous, TIBCO Runtime Agent, and TIBCO Hawk are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform Enterprise Edition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle Corporation in the U.S. and other countries.All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only.THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVERTHIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.Copyright © 2011-2015 TIBCO Software Inc. ALL RIGHTS RESERVED.

TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces User’s Guide

| iii

Contents

Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

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

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xv

Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviTIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces Documentation . . . . . . . . . . . . . . . . . . . . . . xviOther TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xixHow to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xixHow to Access TIBCO Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xixHow to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

Product Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

Chapter 2 ActiveSpaces Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

Overview of Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Shared Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Metaspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Authentication Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9Test Connection Button. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10Adding Spaces Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10Disconnect Button. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12Key Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13Affinity Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15Index Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17Export Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

Space Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19


iv | Contents

Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Put . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Take . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Begin Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Commit Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Rollback Transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Continuous Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Misc Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Event Listener . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Misc Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44


Contents | v

Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45

Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49

Query Iterator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53

Wait For Ready . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56

Lock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60

UnLock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66

Remote Invoke . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

Invocable Receiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72Misc Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74

Invocable Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75


vi | Contents

Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Space Result Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Misc Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Persister Receiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Misc Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Persister Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Space Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Space Clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Chapter 3 Working with TIBCO ActiveMatrix BusinessWork . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Overview of TIBCO ActiveMatrix BusinessWorks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Starting TIBCO Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Creating a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Creating a Metaspace Shared Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Creating a Space Shared Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Creating a Space Connection Shared Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Creating an ActiveSpaces Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Adding Activities to the Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Testing the Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Deploying a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100


Contents | vii

Chapter 4 Logging for ActiveSpaces with TIBCO Hawk. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101

Overview of TIBCO Hawk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102

Invoking an ActiveSpaces Microagent Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103

Chapter 5 Using Sample Projects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107

Overview of Sample Projects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

BatchWithTransaction Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109Process Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109Setting Up the Sample Project in TIBCO Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110Running the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110Expected Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111

DatabaseCache Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112Process Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112Setting Up the Sample Project in TIBCO Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113Running the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114Expected Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114

IterateResultSet Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115Process Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115Setting Up the Sample Project in TIBCO Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116Running the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117Expected Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117

Persister_jdbc_mysql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118Process Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118Setting Up the Sample Project in TIBCO Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125Running the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125Expected Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125

Appendix A Managing ActiveSpaces Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127

Managing Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128

Appendix B Trace Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces Error Messages . . . . . . . . . . . . . . . . . . . . . . . . .132

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139


viii | Contents


Figures | ix

Figures

Figure 1 ActiveSpaces Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Figure 2 Space Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Figure 3 Select Key Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Figure 4 Select Affinity Key Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Figure 5 Index Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Figure 6 Adding Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Figure 7 Create a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Figure 8 Save Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Figure 9 TIBCO Hawk Enterprise Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Figure 10 Micoragends, Methods and Argument Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Figure 11 SetFileLogging Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Figure 12 The BatchOperationTransaction Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Figure 13 Expected Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Figure 14 The QueryUserInfo Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Figure 15 The PutDataInABatch Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Figure 16 The persister Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Figure 17 The sub_persister_AlterAction Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Figure 18 The sub_persister_CloseAction Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Figure 19 The sub_persister_LoadAction Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Figure 20 The sub_persister_OpenAction Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Figure 21 The sub_persister_ReadAction Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Figure 22 The sub_persister_WriteAction Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Figure 23 The PUT_data Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Figure 24 Expected Result of the PUT_data Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Figure 25 Expected Result of the persister Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126


x | Figures


Tables | xi

Tables

Table 1 General Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Table 2 Metaspace—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Table 3 Metaspace—Authentication Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Table 4 Space—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Table 5 Space—Key Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Table 6 Space-Affinity Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Table 7 Space—Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Table 8 Space—Index Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Table 9 Space Connection—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Table 10 Put Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Table 11 Put Activity—Advanced Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Table 12 Put Activity—Input Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Table 13 Put Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Table 14 Put Activity—Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Table 15 Get Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Table 16 Get Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Table 17 Get Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Table 18 Take Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Table 19 Take Activity—Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Table 20 Take Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Table 21 Take Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Table 22 Take Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Table 23 Begin Transaction Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Table 24 Begin Transaction Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Table 25 Commit Transaction Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Table 26 Commit Transaction Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Table 27 Rollback Transaction Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Table 28 Rollback Transaction Activity—Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37


xii | Tables

Table 29 Continuous Query Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Table 30 Continuous Query Activity—Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Table 31 Continuous Query Activity—Misc Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Table 32 Continuous Query Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Table 33 Event Listener Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Table 34 Event Listener Activity—Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Table 35 Event Listener Activity—Misc Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Table 36 Event Listener Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Table 37 Query Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Table 38 Query Activity—Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Table 39 Query Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Table 40 Query Activity—Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Table 41 Query Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Table 42 Query Iterator Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Table 43 Query Iterator Activity—Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Table 44 Query Iterator Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Table 45 Query Iterator Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Table 46 Query Iterator Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Table 47 Wait For Ready Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Table 48 Wait For Ready Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Table 49 Wait For Ready Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Table 50 Wait For Ready Activity—Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Table 51 Lock Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Table 52 Lock Activity—Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Table 53 Lock Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Table 54 Lock Activity—Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Table 55 Lock Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Table 56 UnLock Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Table 57 UnLock Activity—Advanced Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Table 58 Unlock Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Table 59 UnLock Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Table 60 UnLock Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66


Tables | xiii

Table 61 Remote Invoke Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Table 62 Remote Invoke Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Table 63 Remote Invoke Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Table 64 Remote Invoke Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Table 65 Invocable Receiver Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Table 66 Invocable Receiver Activity—Misc Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Table 67 Invocable Receiver Activity—Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Table 68 Invocable Response Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Table 69 Invocable Response Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Table 70 Invocable Response Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Table 71 Space Result Handler Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Table 72 Invocable Receiver Activity—Misc Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Table 73 Space Result Handler Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Table 74 Persister Receiver Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Table 75 Persister Receiver Activity—Misc Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Table 76 Persister Receiver Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

Table 77 Persister Response Activity—Configuration Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Table 78 Persister Response Activity—Input Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Table 79 Persister Response Activity—Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Table 80 Space Size Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Table 81 Space Size Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Table 82 Space Size Activity—Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Table 83 Space Size Activity—Error Output Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Table 84 Space Clear Activity—Configuration Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Table 85 Space Clear Activity—Input Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Table 86 Space Clear Activity—Error Output Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Table 87 Available Logging Methods for ActiveSpaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

Table 88 BatchOperationTransaction Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Table 89 QueryUserInfo Process Activities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

Table 90 PutDataInABatch Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Table 91 persister Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Table 92 sub_persister_AlterAction Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120


xiv | Tables

Table 93 sub_persister_CloseAction Process Activities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Table 94 sub_persister_LoadAction Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Table 95 sub_persister_OpenAction Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

Table 96 sub_persister_ReadAction Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Table 97 sub_persister_WriteAction Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Table 98 PUT_data Process Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Table 99 Log Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128


| xv

Preface

TIBCO ActiveMatrix BusinessWorks™ Plug-in for ActiveSpaces® integrates with TIBCO ActiveMatrix BusinessWorks™, and they are installed separately. You can use this plug-in to utilize all the benefits of ActiveSpaces® without any coding.

Topics

• Related Documentation, page xvi

• Typographical Conventions, page xvii

• Connecting with TIBCO Resources, page xix


xvi | Related Documentation

Related Documentation

This section lists documentation resources you might find useful.

TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces DocumentationThe following documents form the TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces documentation set:

• TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces Installation Read this manual for instructions on site preparation and installation.

• TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces User’s Guide Read this manual for instructions on how to use the product.

• TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces Release Notes Read the release notes for a list of new and changed features. This document also contains lists of known issues and closed issues for this release.

Other TIBCO Product DocumentationYou might find it useful to read the documentation for the following TIBCO products:

• TIBCO ActiveSpaces®

• TIBCO ActiveMatrix BusinessWorks™

• TIBCO Designer™

• TIBCO Administrator™

• TIBCO Rendezvous®

• TIBCO Hawk®

• TIBCO Runtime Agent™


Preface | xvii

Typographical Conventions

The following typographical conventions are used in this manual.

Table 1 General Typographical Conventions

Convention Use

ENV_NAME

TIBCO_HOME

ASBW_HOME

TIBCO products are installed into an installation environment. A product installed into an installation environment does not access components in other installation environments. Incompatible products and multiple instances of the same product must be installed into different installation environments.

An installation environment consists of the following properties:

• Name Identifies the installation environment. This name is referenced in documentation as ENV_NAME. On Microsoft Windows, the name is appended to the name of Windows services created by the installer and is a component of the path to the product shortcut in the Windows Start > All Programs menu.

• Path The folder into which the product is installed. This folder is referenced in documentation as TIBCO_HOME.

TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces is installed into a directory within TIBCO_HOME. This directory is referenced in documentation as ASBW_HOME. The default value of ASBW_HOME depends on the operating system. For example, on Windows systems, the default value is C:\tibco\bw\plugins\activespaces.

code font Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window. For example:

Use MyCommand to start the foo process.

bold code

font Bold code font is used in the following ways:

• In procedures, to indicate what a user types. For example: Type admin.

• In large code samples, to indicate the parts of the sample that are of particular interest.

• In command syntax, to indicate the default parameter for a command. For example, if no parameter is specified, MyCommand is enabled: MyCommand [enable | disable]


xviii | Typographical Conventions

italic font Italic font is used in the following ways:

• To indicate a document title. For example: See TIBCO ActiveMatrix BusinessWorks Concepts.

• To introduce new terms For example: A portal page may contain several portlets. Portlets are mini-applications that run in a portal.

• To indicate a variable in a command or code syntax that you must replace. For example: MyCommand PathName

Key combinations

Key name separated by a plus sign indicate keys pressed simultaneously. For example: Ctrl+C.

Key names separated by a comma and space indicate keys pressed one after the other. For example: Esc, Ctrl+Q.

The note icon indicates information that is of special interest or importance, for example, an additional action required only in certain circumstances.

The tip icon indicates an idea that could be useful, for example, a way to apply the information provided in the current section to achieve a specific result.

The warning icon indicates the potential for a damaging situation, for example, data loss or corruption if certain steps are taken or not taken.

Table 1 General Typographical Conventions (Cont’d)

Convention Use


Preface | xix

Connecting with TIBCO Resources

How to Join TIBCOmmunityTIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is a place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety of resources. To register, go to http://www.tibcommunity.com.

How to Access TIBCO DocumentationYou can access TIBCO documentation here:

https://docs.tibco.com

How to Contact TIBCO SupportFor comments or problems with this manual or the software it addresses, contact TIBCO Support as follows:

• For an overview of TIBCO Support, and information about getting started with TIBCO Support, visit this site:

http://www.tibco.com/services/support

• If you already have a valid maintenance or support contract, visit this site:

https://support.tibco.com

Entry to this site requires a user name and password. If you do not have a user name, you can request one.

http://www.tibco.com/services/supporthttps://support.tibco.comhttp://www.tibcommunity.comhttps://docs.tibco.com


xx | Connecting with TIBCO Resources


| 1

Chapter 1 Introduction

This chapter provides an introduction to TIBCO ActiveSpaces and TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces.

Topics

• Product Overview, page 2


2 | Chapter 1 Introduction

Product Overview

TIBCO ActiveSpaces® is a peer-to-peer distributed in-memory data grid, a form of virtual shared memory that is replicated on distributed devices and applications. You can use TIBCO ActiveSpaces to easily create distributed applications that exchange and modify data shared between processes, and across a network.

TIBCO ActiveMatrix BusinessWorks is a scalable, extensible, and easy-to-use integration platform, with which you can develop integration projects. TIBCO ActiveMatrix BusinessWorks uses the TIBCO Designer graphical user interface (GUI) to define business processes and the TIBCO ActiveMatrix BusinessWorks process engine to implement these processes.

TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces integrates with TIBCO ActiveMatrix BusinessWorks, and they are installed separately. You can use this plug-in to utilize all the benefits of TIBCO ActiveSpaces without any coding.


| 3

Chapter 2 ActiveSpaces Palette

This chapter describes the ActiveSpaces palette, which contains shared resources and ActiveSpaces activities for TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces.

Topics

• Overview of Palette, page 4


4 | Chapter 2 ActiveSpaces Palette

Overview of Palette

The ActiveSpaces palette contains shared resources and activities, as shown in Figure 1.

Figure 1 ActiveSpaces Palette

Shared ResourcesThe shared resources for TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces are listed as follows:

• Metaspace, page 6

• Space, page 12

• Space Connection, page 19

ActivitiesTo achieve different functionalities, the activities for TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces can be divided into the following six groups:

• Basic operation activities are as follows:

— Put

— Get

— Take


Overview of Palette | 5

• Transaction activities are as follows:

— Begin Transaction

— Commit Transaction

— Rollback Transaction

• Browser activities are as follows:

— Continuous Query

— Event Listener

• Query activities are as follows:

— Query

— Query Iterator

• Wait and Lock activities are as follows:

— Wait For Ready

— Lock

— UnLock

• Invoke activities are as follows:

— Remote Invoke

— Invocable Receiver

— Invocable Response

• Space Result Handler activity

• Persister activities are as follows:

— Persister Receiver

— Persister Response

• Space activities are as follows:

— Space Size

— Space Clear



MetaspaceShared Resource

A metaspace is an instance of a cluster of application processes, which are typically deployed on multiple hosts interconnected by a network by using TIBCO ActiveSpaces. A metaspace is an administrative container for a set of spaces, including system spaces and user spaces. In TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces, Metaspace is a BusinessWorks shared resource representing a metaspace.

Configuration TabThe Configuration tab contains the following fields listed in Table 2.

Table 2 Metaspace—Configuration Tab (Sheet 1 of 4)

Field Global Var? Description

Name No (Required) Specifies the name for the Metaspace shared resource.

The default name is Metaspace.

Description No (Optional) Specifies the short description of the metaspace.

Metaspace Name

Yes (Required) Specifies the metaspace name.

The metaspace name must start with a letter or a digit. The name can include alphanumeric characters, "-", or "_". The default metaspace name is ms.

Note: Metaspace shared resources in the same TIBCO Designer must use different names.

Member Name Yes (Optional) Specifies a unique name to identify each member connected to the metaspace.


Metaspace | 7

Discovery URL

Yes (Optional) Specifies the URL of a metaspace used by an intended member to connect to the metaspace.

TIBCO Rendezvous, Pragmatic General Multicast (PGM), and TCP are three discovery protocols used in TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces. The default discovery mechanism is PGM.

TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces supports the connection to a metaspace as a remote client.

See TIBCO ActiveSpaces Developer’s Guide for detailed information.

Listen URL Yes (Optional) Specifies the URL that indicates the interface and the TCP port used to listen for incoming connections from new members to the metaspace.

The format of the Listen URL is tcp://interface:port.


Remote Listen URL

Yes (Optional) Specifies with which IP address and TCP port a remote client listens to the proxy metaspace member.

The format of the remote listen URL is tcp://interface:port.

Note: A remote client application can never become a seeder on a space.


Allowed Invocation Thread Count

Yes (Optional) Specifies the maximum number of threads used for invocation.

The default value is 32.

Connect timeout (milliseconds)

Yes (Optional) Specifies the amount of time (in milliseconds) to wait for a successful metaspace connection.

The default value is -1, which means waiting indefinitely.

See TIBCO ActiveSpaces Java API Reference for more information.





Member timeout (milliseconds)

Yes (Optional) Specifies the amount of time (in milliseconds) to wait for a member to reconnect to the metaspace.

The default value is 30000 ms.


Cluster suspend threshold

Yes (Optional) Specifies the number of host connections that can be lost before membership operations are suspended.

This field is used with a host-aware replication.

The default value is -1, which means that the membership operations are never suspended.


Data Store Location

Yes (Required for share-nothing persistence only) Specifies the directory where persisted data is stored.

Secure Metaspace

No (Optional) Specifies whether the metaspace is secured.

When the Secure Metaspace check box is selected, the following fields are displayed.

Domain Role No (Required) Specifies the role of a security domain. The options are CONTROLLER and REQUESTOR:

• CONTROLLER: a TIBCO ActiveSpaces node that is dedicated to enforcing the defined security behavior of a security domain for a metaspace associated with the security domain.

• REQUESTOR: a TIBCO ActiveSpaces node that requests security services from a security domain controller for a metaspace. Typically, a security domain requestor is just a normal TIBCO ActiveSpaces application that uses the security API when connecting to the metaspace associated with a security domain.

The default value is CONTROLLER.





Metaspace | 9

Authentication TabIf REQUESTOR is selected from the Domain Role list in the Configuration tab, the Authentication tab is displayed. The Authentication tab contains the following fields listed in Table 3.

Security Policy File

Yes (Optional) Specifies a policy file when TIBCO ActiveSpaces security is implemented and you are connecting from a controller node.

Note: This field is only displayed when CONTROLLER is selected from the Domain Role list.

Security Token File

Yes (Optional) Specifies the token file for a security domain requestor that is authenticated by a security domain controller.

When TIBCO ActiveSpaces security is implemented and you are connecting from a requestor node, the token file must be provided.

Note: This field is displayed only when REQUESTOR is selected from the Domain Role list.

Identity Password

Yes (Required) Specifies the password of the security policy file or security token file.



Table 3 Metaspace—Authentication Tab

Field Description

Credentials Specifies a way to authenticate the requestors:

• USERPWD: user name and password authentication.

• X509V3: certificate-based authentication against an LDAP server.

• NONE: no authentication is used.

The following fields are displayed if USERPWD is selected from the Credentials list.

Domain Specifies the domain name that is defined in the security policy file.

• system: operating system user authentication.

• ldap: LDAP user authentication.



Test Connection ButtonThe Test Connection button is used to test whether the specified configuration is valid to connect the metaspace.

Adding Spaces ButtonsTo create a space from the specified metaspace, click one of the following three buttons:

• Introspect Button

• Import Button

• Add Space Button

Introspect Button

When you click the Introspect button, TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces introspects the metaspace and retrieves all spaces currently existing in the metaspace. When you select one of them from the Space list, the plug-in generates a Space shared resource with the exact space definition as in the metaspace.

User Name Specifies the user name for the domain authentication.

Password Specifies the password for the domain authentication.

The following fields are displayed if X509V3 is selected from the Credentials list.

Key File Location Specifies the directory where the PKCS#12 file is located.

Password Specifies the password for the private key within the PKCS#12 file.

Table 3 Metaspace—Authentication Tab (Cont’d)

Field Description

Only space definition is imported. You have to create a space connection for introspected spaces. For details, see Space Connection.

Introspected spaces are read-only. If you want to modify an introspected space, you have to re-create one.


Metaspace | 11

Import Button

When you click the Import button, TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces can create a space definition from an XML file.

Add Space Button

When you click the Add Space button, TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces can create a space definition manually.

A space can also be added by dragging the space icon from the ActiveSpaces palette into the Design panel on the right.

Disconnect ButtonThe Disconnect button is used to disconnect the current valid connection to the metaspace.



SpaceShared Resource

A space provides shared virtual storage for data. It is a shared entity that can be accessed by multiple applications concurrently, each one of which has the same coherent view of the data contained in the space. The spaces in TIBCO ActiveSpaces are called tuple spaces, and the items stored in them are called tuples.

A space is also a virtual entity distributed and implemented collaboratively by a group of processes located on multiple hosts communicating over the network.

In TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces, Space is a BusinessWorks shared resource representing a space.


Table 4 Space—Configuration Tab


Name No (Required) Specifies the name for the space and Space shared resource. The name must start with a letter or a digit and can include alphanumeric characters, "-", or "_".

The default name is Space.

Field Definition

No (Required) A field is a portion of a tuple, similar to a single value in a column of a database table. A field is associated with a name, a type, and whether or not the field is nullable. If a field is nullable, the value for this field can be null.

The field name is a string and must start with a letter or an underscore character. The name can include any combination of letters and numbers.

Click to add fields, as shown in Figure 2.


Space | 13

Figure 2 Space Configuration Tab

Key TabYou must set at least one of the defined fields as the key field in the Key tab to make the space definition valid. The Key tab contains the following fields listed in Table 5.

Table 5 Space—Key Tab


Key Index Type

No (Required) Specifies the index type for the key field. An index of the key fields in the space is created automatically.

The index type can be:

• HASH: speeds up queries where the filter is an exact match of a value to the field. For example, "field = value".

• TREE: speeds up queries where the filter is a range match of a value to the field. For example, "field > value".

The index type is HASH by default.

Key Field Names

No (Required) Specifies the key fields in the space.

Click to open the Select dialog, and then select the key fields from the Field Name column, as shown in Figure 3.

Note: If the name of a field, which is specified as a key, is changed, you have to update the corresponding key field name manually.



Figure 3 Select Key Fields

Affinity TabYou can control the distribution of tuples by using the affinity key fields provided by this plug-in. Therefore, the tuples that have the same values for a particular field or fields are stored on the same seeder.

The Affinity tab contains the following field listed in Table 6.

Figure 4 Select Affinity Key Fields

Table 6 Space-Affinity Tab


Affinity Key Field Names

No Specifies the key fields to be configured for affinity.

Click to open the Select dialog, and then select the key fields from the Field Name column, as shown in Figure 4.

For detailed information about affinity, see TIBCO ActiveSapces Developer’s Guide.


Space | 15

Advanced TabThe Advanced tab contains the following fields listed in Table 7.

Table 7 Space—Advanced Tab (Sheet 1 of 3)


Distribution Policy

Yes (Optional) Specifies how to manage data in the space, DISTRIBUTED, NONE_DISTRIBUTED, and ADDRESSED:

• DISTRIBUTED: the management of entries in the space is shared among the seeders that have joined the space.

• NONE_DISTRIBUTED: a single seeder is responsible for all tuples in the space.

• ADDRESSED: this option is deprecated.

The default option is DISTRIBUTED.

Capacity Yes (Optional) Specifies the maximum number of tuples that each seeder can store in the space.

Note: The value of -1 indicates an infinite number of tuples that each seeder stores. The value of 0 is invalid.

Eviction Policy Yes (Optional) Specifies the eviction policy to be applied when an operation causes the capacity to be exceeded, NONE or LRU:

• NONE: no tuples are evicted from the space.

• LRU: uses the Least Recently Used (LRU) eviction algorithm to evict tuples from the space.

Persistence Type

Yes (Optional) Specifies the type of persistence, NONE, SHARE_ALL, or SHARE_NOTHING:

• NONE: the persistence is not enabled for the space.

• SHARE_ALL: all the seeders on a space share a single persister or a set of persisters.

• SHARE_NOTHING: each seeder that joins a space maintains a copy of space data on a disk.

Note: When you configure a share-nothing persistence, you can use a unique name for each member joining the space, and specify an existing directory for data storage.

See TIBCO ActiveSpaces Developer’s Guide for more information.



Persistence Policy

Yes (Optional) Specifies the persistence policy used for the changes in the space, SYNC, ASYNC, or NONE.

Minimum Seeder Count

Yes (Optional) Specifies the minimum number of seeders that join the space before the space is ready. The default value is 1.

Note: The value of 0 is invalid.

Replication Count

Yes (Optional) Specifies the degree of replication. The default value is 0, which means no replication is used.

See TIBCO ActiveSpaces Developer’s Guide for more information about replication count.

Replication Policy

Yes (Optional) Specifies how to replicate the data stored in a space, asynchronously (ASYNC) or synchronously (SYNC).

HostAware Replication

Yes (Optional) Select this check box to enable the host-aware replication. When you use the host-aware replication, data from the seeders in one group is replicated to seeders in other groups.

To organize seeders into groups, member names must be in the format of group_name.member_name.

The plug-in groups all seeders with the same group_name name together and their data replicated on seeders outside that group.

Entry Time to Live (milliseconds)

Yes (Optional) Specifies the amount of time (in milliseconds) that must have elapsed since the tuple was created or last modified before it expired.

Lock Time to Live (milliseconds)

Yes (Optional) Specifies the duration (in milliseconds) of a lock applied on a space.

If a thread does not clear the lock that applied on a tuple within the specified lock time-to-live period, the system automatically clears the lock.

Lock wait

(milliseconds)

Yes (Optional) Specifies the amount of time (in milliseconds) that an operation attempting to modify a locked tuple waits for the lock to be cleared.




Space | 17

Index TabIndexes are used to accelerate the filtering of data during query processing. An index uses memory to locate matching records, which is faster than iterating through every record.

Click to create an index, as shown in Figure 5.

Space Wait (milliseconds)

Yes (Optional) Specifies a timeout value (in milliseconds) that applies to operations that cannot be processed because the space is not in the READY state.


Write Timeout (milliseconds)

Yes (Optional) Specifies a write timeout value (in milliseconds) for write operations that cannot be processed because the space is occupied.


Read Timeout (milliseconds)

Yes (Optional) Specifies a read timeout value (in milliseconds) for read operations that cannot be processed because the space is occupied.


Query Limit Yes (Optional) Specifies the maximum number of tuples returned from a query operation.


Query Timeout (milliseconds)

Yes (Optional) Specifies a query timeout value in milliseconds. The default value is -1, which indicates querying indefinitely.





Figure 5 Index Tab

The Index tab contains the following fields listed in Table 8.

Export ButtonWhen you click the Export button, the definition of the current space created for TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces is exported to a file. The content of the file is in XML format.

Table 8 Space—Index Tab

Field Description

Index Name (Required) Specifies the name of the index.

The index name is a string and must start with a letter or an underscore (_). The name can include any combination of letters and numbers.

Index Type (Required) Specifies the type of index, HASH or TREE. The default type is HASH.

See Key Tab on page 13 for more information about the type of index.

Index Field Names

(Required) Specifies the field names that are included in the index. You can create a composite index that includes more than one field.

Click to open the Select dialog and select the field names you want to be indexed.

When importing a space definition, you have to manually define all the global variables used in the space definition.


Space Connection | 19

Space ConnectionShared Resource

Once a space has been defined in a metaspace, it can be joined by applications and automatically joined by agents if the space is distributed. A space can be joined as a distribution role of SEEDER or LEECH, which is specified in Space Connection. Each space can have multiple space connections.


It is good practice to use the same Space Connection type for each JVM member in a space.

Table 9 Space Connection—Configuration Tab


Name No Specifies the name for the Space Connection shared resource.

The default name is Space Connection.

Distribution Role

No Specifies the role of an application that joins the space, SEEDER or LEECH:

• SEEDER: a member that joins a space and lends resources, such as memory and processing power, to the scalability of the space.

• LEECH: a member that joins a space but does not lend any resources, such as memory or processing power, to the space.

The default option is SEEDER.



PutActivity

The Put activity is used to store tuples in a space.


Advanced TabThe Advanced tab contains the following fields listed in Table 11.

Table 10 Put Activity—Configuration Tab


Name Yes The name of the activity in the process definition.

Description No The short description of the activity.

Space Connection

Yes Click to open the Select a Resource dialog. Select one space connection to apply to your current activity.

Compare And Put

No Select this check box to enable the compareAndPut operation.

For detailed information about the compareAndPut operation, see TIBCO ActiveSpaces Developer’s Guide.

Async Operation

No Select this check box to enable the asynchronous operation. This check box is not selected by default.

Table 11 Put Activity—Advanced Tab


Time to Wait for Lock (milliseconds)

Yes The amount of time (in milliseconds) that a Put operation waits for the lock to be cleared if the tuple has been locked.

The value of the Time to Wait for Lock field overwrites the value in the Lock wait field, which is specified in the Advanced tab of the Space shared resource.

The default value of -2 or a null value indicates that the value set in the Lock wait field is not overwritten.


Put | 21

Input TabThe Input tab lists only those tuples you want to put in the associated space.

Ensure that you provide values for all the fields except for the nullable fields in the Input tab. You can click to open the XPath Formula Builder dialog to configure the input format of each field.

Time to Live (milliseconds)

Yes The amount of time (in milliseconds) that must have elapsed since the tuple was stored before the tuple expired.

The value of the Time to Live field overwrites the value in the Entry Time To Live field, which is specified in the Advanced tab of the Space shared resource. The default value of -2 or a null value indicates that the value set in the Entry Time To Live field is not overwritten.

Forget Yes When this check box is selected, no tuples are returned in the Output tab.

Lock Yes Select this check box to lock tuples after they are stored by the Put activity.

If the UnLock check box is selected, this check box is disabled.

UnLock Yes Select this check box to unlock the locked tuples before performing a Put operation on them.

If the Lock check box is selected, this check box is disabled.

Route Yes Select this check box to update tuples to another site and receive a status message.

For detailed information about route, see TIBCO ActiveSpaces Developer’s Guide.

Space Result Handler Key

Yes Specifies the key of the Space Result Handler activity, which is used for the asynchronous operation.

This field is displayed only when you select the Async Operation check box in the Configuration tab.

Table 11 Put Activity—Advanced Tab (Cont’d)




The Input tab contains the fields listed in Table 12.

Table 12 Put Activity—Input Tab

Input Item Data Type Description

The following parameters are the child parameters of the PutOptions node.

lockWait Integer The amount of time (in milliseconds) that a Put operation waits for the lock to be cleared if the tuple has been locked.

The value of the lockWait field overwrites the value in the Lock wait field, which is specified in the Advanced tab of the Space shared resource.

The default value of -2 or a null value indicates that the value set in the Lock wait field is not overwritten.

ttl Integer The amount of time (in milliseconds) that must have elapsed since the tuple was stored before the tuple expired.

The value of the ttl field overwrites the value in the Entry Time to Live field, which is specified in the Advanced tab of the Space shared resource. The default value of -2 or a null value indicates that the value set in the Entry Time to Live field is not overwritten.

isForget Boolean Specifies whether to return tuples in the Output tab. The value is true or false.

isLock Boolean Specifies whether to lock tuples after they are stored by the Put activity. The value is true or false.

Note: The values of the isLock field and the isUnlock field cannot be set to true at the same time.

isUnlock Boolean Specifies whether to unlock tuples after they are stored by the Put activity. The value is true or false.

Note: The values of the isLock field and the isUnlock field cannot be set to true at the same time.

isRoute Boolean Specifies whether to update tuples to another site and receive a status message. The value is true or false.


Put | 23

spaceResultHandlerKey

String The key of the Space Result Handler activity, which is used for the asynchronous operation.

The value of the spaceResultHandlerKey field overwrites the value in the Space Result Handler Key field, which is specified in the Advanced tab of the Put activity.

This field is displayed only when you select the Async Operation check box in the Configuration tab.

Closure Any of the following data types:

• Boolean

• Char

• Short

• Integer

• Long

• Float

• Double

• Blob

• String

• Datetime

The data structure that is used to pass data to t

Documents

TIBCO ActiveMatrix BusinessWorks Plug-in for ......TIBCO, Two-Second Advantage, TIBCO ActiveMatrix BusinessWorks Plug-in for ActiveSpaces, TIBCO