tibco object service broker parameters · 2012. 7. 31. · important information some tibco...
TRANSCRIPT
TIBCO® Object Service Broker
ParametersSoftware Release 6.0July 2012
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.This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc.TIBCO, The Power of Now, TIBCO Object Service Broker, and and TIBCO Service Gateway are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or 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. 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.The TIBCO Object Service Broker technologies described herein are protected under the following patent numbers:Australia: - - 671137 671138 673682 646408Canada: 2284250 - - 2284245 2284248 2066724Europe: - - 0588446 0588445 0588447 0489861Japan: - - - - - 2-513420USA: 5584026 5586329 5586330 5594899 5596752 5682535
Copyright © 1999-2012 TIBCO Software Inc. ALL RIGHTS RESERVED.TIBCO Software Inc. Confidential Information
| iii
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xivTIBCO Object Service Broker Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiiHow to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiiHow to Access All TIBCO Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiiHow to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Chapter 1 Using Execution Environment Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2What are Execution Environment Parameters? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Types of Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Usage of the Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Execution Environment Initialization Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Session Startup Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4TIBCO Object Service Broker Monitor Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5System Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Determining Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Where are the Parameters Specified? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Source and Evaluation for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Source and Evaluation for Open Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Determining the Values in Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Format of the Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Syntax of Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Length of Parameter Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Syntax of Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Parameter Files for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Parameter Files for Open Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Parameter Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Summary of Execution Environment Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 2 Understanding Execution Environment Parameters. . . . . . . . . . . . . . . . . . . . . . . . . 29
Descriptions of the Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30ACTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
TIBCO Object Service Broker Parameters
iv | Contents
ADAYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31ALLOWSESSIONTIMEOUTLIMIT, NOALLOWSESSIONTIMEOUTLIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . 31AMONTHS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32BATCHCONSOLE, NOBATCHCONSOLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33BINDINGAREASADDRESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33BINDINGAREASKEY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34BLTINNUM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34BROWSE, NOBROWSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35CHARSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35CICSECONTAINER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37CICSPCONTAINER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37CICSHURONTRAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38CICSPSEUDOCONVERSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39CICSREGIONSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39CICSVSAMSYNC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40CLICODEPAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41CLIENDIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41CLIENTHOSTNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42CLIENTIP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43CLIENTPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43CLIHOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43CLIMSGLENMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44CLINODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45CLIPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46CLITIMEOUTLIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46CLOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47CLOSEEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47COMMITSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48CONFIGURATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49CONNTIMEOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50DATEFORMAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50DAYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51DB2LOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52DECIMALSEPARATOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52DEFAULT_EE_NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53DEFAULT_MON_NAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53DEFAULT_SESSION_NAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53DEFAULT_TTY_NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54DELETELOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54DOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55DSBIFTYPE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56DSDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57DSFIELDSEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57DSIXFTYPE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58DSQUOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
TIBCO Object Service Broker Parameters
Contents | v
EEBIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60EEINSTANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60EELOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60EENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61EEWTODELETE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63EMSWIRECODEPAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63ERRMESSAGESCREEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64EVENTLOGHOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65EVENTLOGMSGTYPES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66EXECHASHSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66EXECLOCALNAMESIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67EXECLOCALSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67EXECSCOPESIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68EXECSTACKSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69FILEGDGSEARCH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69HAWKANAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70HAWKDAEMON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71HAWKDNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72HAWKNETWORK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73HAWKPOLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74HAWKSERVICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76IBMFLOAT, NOIBMFLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77IDLETIMEOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78IMSSCREENATTRIBU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78IMSSCREENTRAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79IMSSCREENTRANNC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80INSTANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81INSTLIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81INSTLIBNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83IPCKEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84KEEPEELOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84KEEPOSMONLOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85KEEPSESSIONLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86KEEPTTYLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87KERNEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87LIBRARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88LOGFILEMSGTYPES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88LOGFILEPATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89LOGONRULENAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89MAXEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90MAXSESSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90MDL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
TIBCO Object Service Broker Parameters
vi | Contents
MONHOST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92MONLOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92MONNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93MONPORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93MONTHS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94MSGLOGMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95NOALLOWSESSIONTIMEOUTLIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96NOBATCHCONSOLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96NOBROWSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96NOIBMFLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96NOPRINTPORTRAIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96NOPROFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96NOPROMPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96NORELOADPARAMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97NOSESSIONLOGCLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97NOSESSIONPARMLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97NOSMFDETAIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97NOSTAE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97NOSTOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98NOSTOPALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98NOTEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98NOVERBOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98ONLINE, OFFLINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98OSDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99OSMONDOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99OSMONNAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100OSMONPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100OSMONPROCID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100PASSWORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101PEERSERVERID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101PEERSERVERNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102PORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103PRINTCLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103PRINTCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104PRINTDATASET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104PRINTDEST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105PRINTDIRECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107PRINTERRORLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108PRINTFCB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109PRINTFORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110PRINTPAPERSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110PRINTPORTRAIT, NOPRINTPORTRAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111PRINTSPOOLCLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111PRINTUCS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
TIBCO Object Service Broker Parameters
Contents | vii
PRINTXWTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113PROCESSID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114PROFILE, NOPROFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115PROMPT, NOPROMPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115QUARTERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116REGIONTABLESIZE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116REGIONTRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117REGIONTRACESIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118REGIONTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119REJECTSHUTI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120RELOADPARAMS, NORELOADPARAMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120RULE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121RULESIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124SEARCH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124SECACLSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127SECADMINSIZE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128SECAUDITLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129SECCLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130SECOBJSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131SECPACLSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132SECREQUESTOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132SECSUBSYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133SECURITY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133SECURITYSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134SECUSERSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135SERVERID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136SERVERLOGPATH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136SERVERRETRIES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137SERVERS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137SERVERTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138SESSDSPXFRSCRMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140SESSIONENDACTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140SESSIONENDVALUE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141SESSIONFILEMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142SESSIONINSTANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143SESSIONLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143SESSIONLOGCLEAR, NOSESSIONLOGCLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144SESSIONMEMMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145SESSIONPARMLIST, NOSESSIONPARMLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146SESSIONTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146SESSIONUSERID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147SESSNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147SHAREDMEMADDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148SMFDETAIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148SMFPERFORMANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
TIBCO Object Service Broker Parameters
viii | Contents
SMFTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150SORTEXTMEMMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151SORTINTMEMMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151SORTINTNUMMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152SORTINTPAGESMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153SORTPGM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153SORTPRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154SORTUNIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154SORTWORKFILESMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155STAE, NOSTAE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156STANDBYNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157STANDBYWAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158STANDBYWAITLIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159STANDBYWAITMSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160STATSBUF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162STOPALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163STOPEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164STOPSESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164SVC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165SYNTAXVBLANKPAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166SYSLIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167TABLESIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168TAMBMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169TAMBMIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169TAMBSTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170TASKEXECNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170TASKFILENUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171TASKINITNUM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171TASKMISCNUM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172TASKOPERNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172TASKPOSIXNUM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173TASKRCLINUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173TASKSMFNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174TASKSORTNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174TDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175TEMPPRIMARYCYL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176TEMPSECONDARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176TEMPUNIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177TEMPUNITCOUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178TEST, NOTEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178THREADID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179THREADPOSIXNUM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180TIMEOUTLIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
TIBCO Object Service Broker Parameters
Contents | ix
TN3270PORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181TRANDSPXFRSCRMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181TRANMAXNUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182TRANMEMMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183TTYLOGFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184UNICODEDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184USERID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185VARLDELIMITER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186VARRDELIMITER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187VERBOSE, NOVERBOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188WORKINGDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188YYCENTURYRANGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Chapter 3 Specifying Data Object Broker Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Purpose of This Chapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192What are Data Object Broker Parameters? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Message Switch Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Setting the Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Where are the Parameters Specified? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193The TIBCO Object Service Broker Database Administrator Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Dynamically Modifying the Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Format of the Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195Syntax of Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Parameter Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196Summary of Data Object Broker Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Chapter 4 Understanding Data Object Broker Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204BWO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204CHKTRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204CHPAGELIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204CHPTINTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206CHTRANLIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206CLOGRETRYINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207COMMID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208CTABAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208CTABLESIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209CTABRESIDENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209DATAPAGELIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210DBPROFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211DBSNAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212DESCACTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
TIBCO Object Service Broker Parameters
x | Contents
DESCERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213DESCINFORM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213DESCLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214DESCWARN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214DUPLEXLOGFAIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215DUPUSERID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215DYNAMICRESOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216ERRNOTRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217ESTAE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217EVENTLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218FIXEDRPDPOOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218GTFID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219HAWKANAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220HAWKDAEMON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220HAWKDNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221HAWKNETWORK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221HAWKPOLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222HAWKSERVICE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223HEAPSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223IOTRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224JOURNALS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224LOCKBUFFERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225LOCKTIMEOUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226LOGMESSAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226MAXCONCURRENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227MAXDBMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227MAXDISPLAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228MAXNODES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228MAXOPERATORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229MAXQUERY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229MAXRESOURCES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230MAXTDSEXTENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230MAXTHREADS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231MAXUSERS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231MAXVSAMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232MSGSIZE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234MSGTRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234NETVIEWBASE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235NODENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235OPERATOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236PAGESWEEPACTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236PAGESWEEPLIMIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237PEERS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239PRIVILEGED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239REMOTEDUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
TIBCO Object Service Broker Parameters
Contents | xi
RESAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241RESIDENTHASHSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241RESIDENTPAGES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242ROUTACTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243ROUTERROR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244ROUTINFORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244ROUTLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245ROUTWARN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246RSCSCHEDULES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246SECCLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247SECREQUESTOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247SECSUBSYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248SECUREADMIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248SHAREDMALIGN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249SHAREDMEMADDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250SHAREDMEMPERM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251SIXDATAPAGLIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251SMFRECORD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251SMF13INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252SMF22INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253SMF23INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254SMF24INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254SMF25INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255SMF26INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256SMF27INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257SMF28INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257SMF47INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258SNAPCLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259SNAPDSPREFIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259SNAPHOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260SNAPOVERRIDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261SNAPQUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262SNAPREMOTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262SNAPSUPPRESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263SNAPUNIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263SNAPVOLSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264SPINDSNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265SPININTERVAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265SPINMEMBER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266SPINOPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267SPINSHELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268SRBMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269SSTRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270STDERRTRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270STDOUTTRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
TIBCO Object Service Broker Parameters
xii | Contents
SVCTRACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271SWAPPABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271SYNCTRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272SYSADMIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272TIMEOUTABEND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273TIMEOUTSTART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273TIMEOUTSTOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273TIMESTAMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274TRXREADLIMIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274USEREXIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275UNICODEDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276USERSHUTDOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276WORKINGSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277WTOCLASS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277WTOCONSOLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278WTODELETE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279WTOHOLD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280WTOINTERVAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280WTOPID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281WTOREMOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281WTOSOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282WTOSUFFIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282WTOSYSLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282WTOTAG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283WTOTIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283XCFGROUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284XCFMEMBER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285XCFMODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285XCFSTRUCTURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286XCFWAITTIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286XTABLESIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
Appendix A External Database Server Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Listing of the Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Valid Parameters by Server Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
TIBCO Object Service Broker Parameters
| xiii
Preface
TIBCO® Object Service Broker is an application development environment and integration broker that bridges legacy and non-legacy applications and data.
This manual describes the Execution Environment and Data Object Broker parameters used within TIBCO Object Service Broker. It includes the parameters used on all platforms supported by TIBCO Object Service Broker.
Topics
• Related Documentation, page xiv
• Typographical Conventions, page xix
• Connecting with TIBCO Resources, page xxii
TIBCO Object Service Broker Parameters
xiv | Related Documentation
Related Documentation
This section lists documentation resources you may find useful.
TIBCO Object Service Broker DocumentationThe following documents form the TIBCO Object Service Broker documentation set:
Fundamental Information
The following manuals provide fundamental information about TIBCO Object Service Broker:
• TIBCO Object Service Broker Getting Started Provides the basic concepts and principles of TIBCO Object Service Broker and introduces its components and capabilities. It also describes how to use the default developer’s workbench and includes a basic tutorial of how to build an application using the product. A product glossary is also included in the manual.
• TIBCO Object Service Broker Messages with Identifiers Provides a listing of the TIBCO Object Service Broker messages that are issued with alphanumeric identifiers. The description of each message includes the source and explanation of the message and recommended action to take.
• TIBCO Object Service Broker Messages without Identifiers Provides a listing of the TIBCO Object Service Broker messages that are issued without a message identifier. These messages use the percent symbol (%) or the number symbol (#) to represent such variable information as a rule’s name or the number of occurrences in a table. The description of each message includes the source and explanation of the message and recommended action to take.
• TIBCO Object Service Broker Quick Reference Presents summary information for use in the TIBCO Object Service Broker application development environment.
• TIBCO Object Service Broker Shareable Tools Lists and describes the TIBCO Object Service Broker shareable tools. Shareable tools are programs supplied with TIBCO Object Service Broker that facilitate rules language programming and application development.
• TIBCO Object Service Broker 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.
TIBCO Object Service Broker Parameters
Preface | xv
Application Development and Management
The following manuals provide information about application development and management:
• TIBCO Object Service Broker Application Administration Provides information required to administer the TIBCO Object Service Broker application development environment. It describes how to use the administrator’s workbench, set up the development environment, and optimize access to the database. It also describes how to manage the Pagestore, which is the native TIBCO Object Service Broker data store.
• TIBCO Object Service Broker Managing Data Describes how to define, manipulate, and manage data required for a TIBCO Object Service Broker application.
• TIBCO Object Service Broker Managing External Data Describes the TIBCO Object Service Broker interface to external files (not data in external databases) and describes how to define TIBCO Object Service Broker tables based on these files and how to access their data.
• TIBCO Object Service Broker National Language Support Provides information about implementing the National Language Support in a TIBCO Object Service Broker environment.
• TIBCO Object Service Broker Object Integration Gateway Provides information about installing and using the Object Integration Gateway which is the interface for TIBCO Object Service Broker to XML, J2EE, .NET and COM.
• TIBCO Object Service Broker for Open Systems External EnvironmentsProvides information on interfacing TIBCO Object Service Broker with the Windows and Solaris environments. It includes how to use SDK (C/C++) and SDK (Java) to access TIBCO Object Service Broker data, how to interface to TIBCO Enterprise Messaging Service (EMS), how to use the TIBCO Service Gateway for WMQ, how to use the Adapter for JDBC-ODBC, and how to access programs written in external programming languages from within TIBCO Object Service Broker.
• TIBCO Object Service Broker for z/OS External Environments Provides information on interfacing TIBCO Object Service Broker to various external environments within a TIBCO Object Service Broker z/OS environment. It also includes information on how to access TIBCO Object Service Broker from different terminal managers, how to write programs in external programming languages to access TIBCO Object Service Broker data, how to interface to TIBCO Enterprise Messaging Service (EMS), how to use the TIBCO Service Gateway for WMQ, and how to access programs written in external programming languages from within TIBCO Object Service Broker.
TIBCO Object Service Broker Parameters
xvi | Related Documentation
• TIBCO Object Service Broker Parameters Lists the TIBCO Object Service Broker Execution Environment and Data Object Broker parameters and describes their usage.
• TIBCO Object Service Broker Programming in Rules Explains how to use the TIBCO Object Service Broker rules language to create and modify application code. The rules language is the programming language used to access the TIBCO Object Service Broker database and create applications. The manual also explains how to edit, execute, and debug rules.
• TIBCO Object Service Broker Managing Deployment Describes how to submit, maintain, and manage promotion requests in the TIBCO Object Service Broker application development environment.
• TIBCO Object Service Broker Defining Reports Explains how to create both simple and complex reports using the reporting tools provided with TIBCO Object Service Broker. It explains how to create reports with simple features using the Report Generator and how to create reports with more complex features using the Report Definer.
• TIBCO Object Service Broker Managing Security Describes how to set up, use, and administer the security required for an TIBCO Object Service Broker application development environment.
• TIBCO Object Service Broker Defining Screens and Menus Provides the basic information to define screens, screen tables, and menus using TIBCO Object Service Broker facilities.
• TIBCO Service Gateway for Files SDK Describes how to use the SDK provided with the TIBCO Service Gateway for Files to create applications to access Adabas, CA Datacom, and VSAM LDS data.
System Administration on the z/OS Platform
The following manuals describe system administration on the z/OS platform:
• TIBCO Object Service Broker for z/OS Installing and Operating Describes how to install, migrate, update, maintain, and operate TIBCO Object Service Broker in a z/OS environment. It also describes the Execution Environment and Data Object Broker parameters used by TIBCO Object Service Broker.
• TIBCO Object Service Broker for z/OS Managing Backup and Recovery Explains the backup and recovery features of OSB for z/OS. It describes the key components of TIBCO Object Service Broker systems and describes how you can back up your data and recover from errors. You can use this information, along with assistance from TIBCO Support, to develop the best customized solution for your unique backup and recovery requirements.
TIBCO Object Service Broker Parameters
Preface | xvii
• TIBCO Object Service Broker for z/OS Monitoring Performance Explains how to obtain and analyze performance statistics using TIBCO Object Service Broker tools and SMF records
• TIBCO Object Service Broker for z/OS Utilities Contains an alphabetically ordered listing of TIBCO Object Service Broker utilities for z/OS systems. These are TIBCO Object Service Broker administrator utilities that are typically run with JCL.
System Administration on Open Systems
The following manuals describe system administration on open systems such as Windows or UNIX:
• TIBCO Object Service Broker for Open Systems Installing and OperatingDescribes how to install, migrate, update, maintain, and operate TIBCO Object Service Broker in Windows and Solaris environments.
• TIBCO Object Service Broker for Open Systems Managing Backup and RecoveryExplains the backup and recovery features of TIBCO Object Service Broker for Open Systems. It describes the key components of a TIBCO Object Service Broker system and describes how to back up your data and recover from errors. Use this information to develop a customized solution for your unique backup and recovery requirements.
• TIBCO Object Service Broker for Open Systems Utilities Contains an alphabetically ordered listing of TIBCO Object Service Broker utilities for Windows and Solaris systems. These TIBCO Object Service Broker administrator utilities are typically executed from the command line.
External Database Gateways
The following manuals describe external database gateways:
• TIBCO Service Gateway for Files Describes the TIBCO Object Service Broker interface to Adabas and Datacom data. Using this interface, you can access external Adabas and Datacom data and define TIBCO Object Service Broker tables based on this data.
• TIBCO Service Gateway for DB2 Installing and Operating Describes the TIBCO Object Service Broker interface to DB2 data. Using this interface, you can access external DB2 data and define TIBCO Object Service Broker tables based on this data.
• TIBCO Service Gateway for IDMS/DB Installing and Operating Describes the TIBCO Object Service Broker interface to CA-IDMS data. Using this interface, you can access external CA-IDMS data and define TIBCO Object Service Broker tables based on this data.
TIBCO Object Service Broker Parameters
xviii | Related Documentation
• TIBCO Service Gateway for IMS/DB Installing and Operating Describes the TIBCO Object Service Broker interface to IMS/DB and DB2 data. Using this interface, you can access external IMS data and define TIBCO Object Service Broker tables based on it.
• TIBCO Service Gateway for ODBC and for Oracle Installing and OperatingDescribes the TIBCO Object Service Broker ODBC Gateway and the TIBCO Object Service Broker Oracle Gateway interfaces to external DBMS data. Using this interface, you can access external DBMS data and define TIBCO Object Service Broker tables based on this data.
TIBCO Object Service Broker Parameters
Preface | xix
Typographical Conventions
The following typographical conventions are used in this manual.
Table 1 General Typographical Conventions
Convention Use
TIBCO_HOME
OSB_HOME
By default, all TIBCO products are installed into a folder referenced in the documentation as TIBCO_HOME.
On open systems, TIBCO Object Service Broker installs by default into a directory within TIBCO_HOME. This directory is referenced in documentation as OSB_HOME. The default value of OSB_HOME depends on the operating system. For example on Windows systems, the default value is C:\tibco\OSB. Similarly, all TIBCO Service Gateways on open systems install by default into a directory in TIBCO_HOME. For example on Windows systems, the default value is C:\tibco\OSBgateways\6.0.
On z/OS, no default installation directories exist.
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]
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
TIBCO Object Service Broker Parameters
xx | Typographical Conventions
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
Table 2 Syntax Typographical Conventions
Convention Use
[ ] An optional item in a command or code syntax.
For example:
MyCommand [optional_parameter] required_parameter
| A logical OR that separates multiple items of which only one may be chosen.
For example, you can select only one of the following parameters:
MyCommand para1 | param2 | param3
TIBCO Object Service Broker Parameters
Preface | xxi
{ } A logical group of items in a command. Other syntax notations may appear within each logical group.
For example, the following command requires two parameters, which can be either the pair param1 and param2, or the pair param3 and param4.
MyCommand {param1 param2} | {param3 param4}
In the next example, the command requires two parameters. The first parameter can be either param1 or param2 and the second can be either param3 or param4:
MyCommand {param1 | param2} {param3 | param4}
In the next example, the command can accept either two or three parameters. The first parameter must be param1. You can optionally include param2 as the second parameter. And the last parameter is either param3 or param4.
MyCommand param1 [param2] {param3 | param4}
Table 2 Syntax Typographical Conventions
Convention Use
TIBCO Object Service Broker Parameters
xxii | Connecting with TIBCO Resources
Connecting with TIBCO Resources
How to Join TIBCOmmunityTIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts, 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 All TIBCO DocumentationYou can access TIBCO documentation here:
http://docs.tibco.com
How to Contact TIBCO SupportFor comments or problems with this manual or the software it addresses, please 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.
TIBCO Object Service Broker Parameters
| 1
Chapter 1 Using Execution Environment Parameters
This chapter describes how to use execution environment parameters.
Topics
• Introduction, page 2
• Usage of the Parameters, page 3
• Determining Parameter Values, page 6
• Format of the Parameters, page 12
• Parameter Summary, page 15
TIBCO Object Service Broker Parameters
2 | Chapter 1 Using Execution Environment Parameters
Introduction
This chapter describes the usage of the Execution Environment parameters for all platforms supported by TIBCO Object Service Broker. Platform specific information is included and identified. This chapter should be used in conjunction with:
• TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for Open Systems Installing and Operating.
• TIBCO Object Service Broker for z/OS External Environments or TIBCO Object Service Broker for Open Systems External Environments.
What are Execution Environment Parameters?Execution Environment parameters set the characteristics of your TIBCO Object Service Broker executing environment and user sessions. When a session is activated the parameter values are evaluated and merged in a predefined order before the session begins. The following sections describe the types of parameters, how they are set, and how they are evaluated. Each of the parameters, including their defaults, valid values and where appropriate, important usage information, are described in Chapter 2, Understanding Execution Environment Parameters, on page 29.
Types of ParametersThe basic types of Execution Environment parameters are:
• Configuration parameters, used only on z/OS
• Execution Environment initialization parameters
• Session startup parameters. This includes ostty parameters, which are used only on Open Systems
• TIBCO Object Service Broker monitor parameters, used only on Open Systems
• System parameters, used only on Open Systems
• Server parameters
The external database server parameters are not included in this manual. The server-specific parameters are described in the TIBCO Service Gateway manuals. A listing of the external database server parameters is also available in Appendix A, External Database Server Parameters, on page 289.
TIBCO Object Service Broker Parameters
Usage of the Parameters | 3
Usage of the Parameters
Configuration Parametersz/OS: Configuration parameters are specified via JCL, using the EECONFIG member of the CNTL data set. This member contains JCL for creating parameter modules for all TIBCO Object Service Broker z/OS environments.
See Also TIBCO Object Service Broker for z/OS Installing and Operating for information about using EECONFIG.
Execution Environment Initialization ParametersExecution Environment initialization parameters are used to initialize peer servers and Execution Environments. The parameters are specified in the following places:
See Also TIBCO Object Service Broker for z/OS External Environments or TIBCO Object Service Broker for Open Systems External Environments for detailed information about input files and how to start up Execution Environments.
z/OS Windows Solaris
Execution Environment startup string
osBatch.exe command line
osBatch command line
Execution Environment parameter input file
Execution environment parameters file (ee.prm)
Execution environment parameters file (ee.prm)
EE registry sub-key
OS_EE_ environment variables
OS_EE_ environment variables
TIBCO Object Service Broker Parameters
4 | Chapter 1 Using Execution Environment Parameters
Session Startup ParametersYou use session startup parameters to define the characteristics of user sessions. The parameters are initially defined at the Execution Environment level in the following places:
These can then be overwritten by the following at the session level:
• SDK (C/C++) STARTSS parameter (all platforms)
• SDK (Java) Session constructor or start method (all platforms)
• ostty command line (Open Systems)
• 3270 Access Adapter login screen (Open Systems)
• TTY registry sub-key (Windows)
• tty.prm file (Open Systems)
• OS_TTY_environment variables (Open Systems)
See Also TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for z/OS Installing and Operating for detailed information about input files and how to start up sessions.
TIBCO Object Service Broker Object Integration Gateway for details about the use of session startup parameters in the Object Integration Gateway.
z/OS Windows Solaris
Session startup string
osBatch command line osBatch command line
Session parameter input file
session.prm file session.prm file
SESSION registry sub-key
TIBCO Object Service Broker user profile
TIBCO Object Service Broker user profile
TIBCO Object Service Broker user profile
OS_SESSION_environment variables
OS_SESSION_environment variables
TIBCO Object Service Broker Parameters
Usage of the Parameters | 5
TIBCO Object Service Broker Monitor ParametersOpen Systems: TIBCO Object Service Broker monitor process (osMon) parameters define the characteristics of the TIBCO Object Service Broker monitor process. This process is required to handle the communication connection and is used by all session types except for batch. The parameters are defined in the following places:
System ParametersTIBCO Object Service Broker system parameters are used to set default name values and log file information. The parameters are defined in the following places:
Windows Solaris
osMon.exe command line osMon command line
mon.prm file mon.prm file
MON registry sub-key
OS_MON_environment variable OS_MON_environment variable
Windows Solaris
system.prm file system.prm file
SYSTEM registry sub-key
OS_SYSTEM_environment variable OS_SYSTEM_environment variable
TIBCO Object Service Broker Parameters
6 | Chapter 1 Using Execution Environment Parameters
Determining Parameter Values
Where are the Parameters Specified?The type of parameter and the platform that you are running on determine where you can specify the parameters and how they are evaluated. The following sections describes how the values for Execution Environment initialization and session startup are determined. If a value is not specified at a higher point in the hierarchy, the value to be used is obtained from a lower point.
Source and Evaluation for z/OS
Values Specified In … Used by … Priority of Evaluation
Session startup string Session Highest
Session parameter input file Session
TIBCO Object Service Broker user profile Session
Session defaults for the Execution Environment Session
Execution Environment startup string Execution Environment and Session
Execution Environment input file Execution Environment and Session
Installation default Execution Environment and Session
Default supplied by TIBCO Object Service Broker
Execution Environment and Session
Lowest
TIBCO Object Service Broker Parameters
Determining Parameter Values | 7
Where to Specify Parameters for Single Session Clients
Specified In PrioritySingle Session
z/OS Batch z/OS TSO
Session startup string Highest Y a
a. Specified on the EXEC card using PARM=‘session startup string’. Maximum 100 characters.
— b
b. The TIBCO Object Service Broker CLIST creates a temporary file allocated to DDname HRNIN to pass all parameters.
Session parameter input file Y c
c. Parameter input file must be allocated to DDname HRNIN.
Y b
User Profile Y d, e
d. The User Profile is bypassed if the NOPROFILE session parameter is used.
e. The profile of the user ID is always used.
Y d, e
Installation default Y f
f. The installation default configuration module name is determined by the type of Execution Environment. The default module name can be overridden by specifying the CONFIGURATION Execution Environment parameter.
Y f
Default supplied by TIBCO Object Service Broker
Lowest Y g
g. Refer to this manual for TIBCO Object Service Broker default values.
Y g
Default module name S6BDRCB0 S6BDRCT0
TIBCO Object Service Broker Parameters
8 | Chapter 1 Using Execution Environment Parameters
Where to Specify Parameters for Multiple Session Clients
Specified In PriorityMultiple Session
CICS IMS TM Native
Session startup string Highest Y a
a. Specified on the command line in the HURN session startup string or in the parameter area of the COMMAREA passed to a non-seamless TIBCO Object Service Broker/CICS interface program. Cannot be specified to a seamless TIBCO Object Service Broker/CICS interface program.
Y b
b. Specified on the command line in the HURLOGON session startup string or in the parameter segment to a non-seamless TIBCO Object Service Broker IMS TM client program.
Y c
c. Specified when logging in to the Native Execution Environment using the DATA(‘session startup string’) argument. Maximum 64 characters.
User Profile Y d, e
d. The User Profile is bypassed if the NOPROFILE session parameter is used.
e. The external transaction profile is used for seamless clients, and the user profile is used for non-seamless clients.
Y d, e Y d, f
f. The profile of the user ID is always used.
Execution Environment startup string
Y g
g. Specified in the command line HINT region startup string.
Y h
h. Specified on the EXEC PGM=S6BDR00 card using PARM=‘region startup string’. Maximum 100 characters.
Y h
Execution Environment parameter input file
Y i Y i Y i
Installation default Y j Y j, k Y g
Default supplied by TIBCO Object Service Broker
Lowest Y l Y l Y l
Default module name S6BDRCC0 S6BDRCI0 S6BDRCN0
TIBCO Object Service Broker Parameters
Determining Parameter Values | 9
Source and Evaluation for Open Systems
i. The parameter input file must be allocated to DDname HRNIN.
j. The installation default configuration module name is determined by the type of Execution Environment. The default module name can be overridden by specifying the CONFIGURATION Execution Environment parameter.
k. IMS TM sessions run in a Native Execution Environment.
l. Refer to this manual for TIBCO Object Service Broker default values.
Values Specified In … Used by … Priority of Evaluation
Session startup string:
TTY session command line
SDK (C/C++) STARTSS parameters
SDK (Java) Session constructor or start method
3270 Access Adapter login screen PARAMS field
osBatch session command line
osMon command line
Session
Execution Environment and Session
TIBCO Object Service Broker monitor process
Highest
Parameter file: ee.prm
session.prm, tty.prm
mon.prm
system.prm
Execution Environment
Session
TIBCO Object Service Broker monitor process
System
TIBCO Object Service Broker Parameters
10 | Chapter 1 Using Execution Environment Parameters
Determining the Values in UseOpen Systems: Log files are provided that list the parameters in use. The default directory for log files is %OS_ROOT%\log on Windows and ${OS_ROOT}/log on Solaris. The default names for the files are:
Windows only:
EE registry sub-key
SESSION registry sub-key
MON registry sub-key
TTY registry sub-key
SYSTEM registry sub-key
Execution Environment
Session
TIBCO Object Service Broker monitor process
ostty
System
Environment variables: OS_EE_, OS_SESSION_, OS_TTY_, OS_MON_, OS_SYSTEM_
Execution Environment
Session
TIBCO Object Service Broker monitor process
System
TIBCO Object Service Broker user profile
Session
Default supplied by TIBCO Object Service Broker
Execution Environment, Session, TIBCO Object Service Broker monitor process, ostty, System
Lowest
Values Specified In … Used by … Priority of Evaluation
Binary or Session (Windows)
Binary or Session (Solaris) Default Log File
osee.exe osee ee.<NAME>.<timeStamp>.log a
osMon.exe osMon mon.<NAME>.<timeStamp>.log
ostty.exe ostty tty.<NAME>.<timeStamp>.log
oscli.dll liboscli.so N/A
TIBCO Object Service Broker Parameters
Determining Parameter Values | 11
Windows: All TIBCO Object Service Broker events are in the Application log available from the Event Viewer administration tool.
osBatch.exe osBatch ee.<NAME>.<timeStamp>.log
Batch session batch batch.<NAME>.<timeStamp>.log
3270 Access Adapter session
3270 Access Adapter session
session.<NAME>.<timeStamp>.log
ostty session ostty session session.<NAME>.<timeStamp>.log
SDK (C/C++) session
SDK (C/C++) session
session.<NAME>.<timeStamp>.log
SDK (Java) session SDK (Java) session session.<NAME>.<timeStamp>.log
a. timeStamp has the form M.D-H.m.s where M is the month, D is the day, H is the hour, m is the minute, and s is the second. <NAME> is the NAME parameter of the process (session) that is writing the log messages.
Binary or Session (Windows)
Binary or Session (Solaris) Default Log File
TIBCO Object Service Broker Parameters
12 | Chapter 1 Using Execution Environment Parameters
Format of the Parameters
Syntax of ParametersThe platform that you are using determines the syntax of the parameters.
z/OS
The type of client that you are using, for example, CICS or batch, determines the actual syntax to use. In general, the syntax is:
{PARAMETER=VALUE} {KEYWORD}
for example:
RULE=LOGONHURON BROWSE
Open Systems
To set a parameter, use the syntax:
{PARAMETER=VALUE} {KEYWORD}
for example:
RULE=LOGONHURON BROWSE
See Also TIBCO Object Service Broker for z/OS External Environments or TIBCO Object Service Broker for Open Systems External Environments for detailed information about the syntax for a specific client type.
Length of Parameter Listsz/OS: TIBCO Object Service Broker limits the total list of parameters you specify when you start an Execution Environment to a length of 900 characters. The mechanism you use to run the Execution Environment can further reduce this limit.
Syntax of Environment VariablesOpen Systems: To set a parameter using an environment variable, use a name in the following format:
OS_<type>_<parameter group name>_<parameter name>
where:
TIBCO Object Service Broker Parameters
Format of the Parameters | 13
• <type> is one of: EE, SESSION, MON, or TTY
• <parameter group name > is the name of an Execution Environment, session, osMon, or ostty (specified by the NAME parameter and present, for example, in ee.prm, session.prm, or mon.prm as names of parameter groups)
• <parameter name> is the name of the parameter that you want to set
For example, in Windows:
• To set the environment variable for the DOB parameter to MYDOB for an Execution Environment called PROD, use:Set OS_EE_PROD_DOB=MYDOB
• To set the environment variable for the INSTLIB parameter to MYLIB for a TIBCO Object Service Broker monitor process called PRODMON, use:Set OS_MON_PRODMON_INSTLIB=MYLIB
• To set a variable for a logical parameter, use, for exampleSet OS_MON_MYOTHERMON_VERBOSE=TRUE
or, to set NOVERBOSESet OS_MON_MYOTHERMON_VERBOSE=FALSE
Parameter Files for z/OSYou can specify TIBCO Object Service Broker parameters using the HRNIN DD statement for all client styles, or a CLIST for TSO clients. The following section describes using an input file. For details about using a CLIST, refer to TIBCO Object Service Broker for z/OS External Environments.
Format of the Input File
The data set associated with HRNIN can be sequential, partitioned, or instream. The format of HRNIN must be as follows:
• The data set must be either RECFM=VB or RECFM=FB with LRECL=80
• Columns 73 through 80 are reserved for card sequence numbers for RECFM=FB data sets
• Parameters can be separated by commas
• Spaces are ignored
• Quoted strings can span multiple lines
• Comments are denoted with an asterisk (*) in column 1, or delimited anywhere between parameters by /* */
TIBCO Object Service Broker Parameters
14 | Chapter 1 Using Execution Environment Parameters
Example of Instream Parameter List Using HRNIN in JCL
/...//HURON EXEC PGM=S6BBATCH,REGION=4M,//PARM=(OFFLINE,’U=USERID,TDS=VTAMID’) > USER AND VTAM IDS//STEPLIB DD DSN=HUR01.HURON.LOAD,DISP=SHR > SHOULD CUSTOMIZE//HRNOUT DD SYSOUT=*//HRNPRNT DD SYSOUT=*//HRNIN DD * > RULE AND PARAMETERSRULE=HLIPREPROCESSOR(’COBOL’,’HURON’,’HURON AND COBOL SOURCE’,’COBOL ONLY SOURCE’,’HLL.HLLLIST’,’ERRORSTOP’), MSGLOGMAX=4M,CHARSET=CDNB /* HRNIN comment *//*
Parameter Files for Open SystemsYou can specify parameter values using parameter files. The parameter files are located in %OS_ROOT%\database on Windows and ${OS_ROOT}/database on Solaris. The files are indexed by a NAME parameter and only parameter assignments that follow the NAME parameter whose value corresponds to the current NAME parameter for the process to be used.
Format of the Parameter Specifications
NAME=value1P1=pvalue1P2=pvalue2NAME=value2P1=pvalue1P2=pvalue2
If a parameter is specified in both HRNIN and the PARM statement, the value in the PARM statement takes precedence.
TIBCO Object Service Broker Parameters
Parameter Summary | 15
Parameter Summary
Summary of Execution Environment Parameters
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
ACTION AC X X X X (z/OS)
X (z/OS)
X (all) X
ADAYS AD X X X X
ALLOWSESSIONTIMEOUTLIMIT, NOALLOWSESSIONTIMEOUTLIMIT
ALLOWSESSTIMEOUT, NOALLOWSESSTIMEOUT
X X X X X X X
AMONTHS AM X X X X
BATCHCONSOLE, NOBATCHCONSOLE
BC, NOBC X X X X
BINDINGAREASADDRESS X X X
BINDINGAREASKEY X X
BLTINNUM X X X X
BROWSE, NOBROWSE B, NOB X X X X (z/OS)
X (z/OS)
X (all) X
CHARSET C X X X X (z/OS)
X (z/OS)
X (all) X
CICSECONTAINER CICSECONT X X X X
CICSPCONTAINER CICSECONT X X X X
CICSHURONTRAN X X X X
CICSPSEUDOCONVERSE CICSCONVERSE X X X X
TIBCO Object Service Broker Parameters
16 | Chapter 1 Using Execution Environment Parameters
CICSREGIONSIZE X X X X
CICSVSAMSYNC CICSVSAM X X X X X
CLICODEPAGE X X X
CLIENDIAN CLIE X X X X
CLIENTHOSTNAME X X X
CLIENTIP X X X
CLIENTPORT X X X
CLIHOST X X X X X
CLIMSGLENMAX X X X
CLINODE X X X X X
CLIPORT X X X X X
CLITIMEOUTLIMIT X X X
CLOSE C X X X X
CLOSEEE CEE X X X X
COMMITSIZE CS X X X X X
CONFIGURATION CONFIG X X X
CONNTIMEOUT CTO X X X X
DATEFORMAT DF X X X X
DAYS DY X X X X
DB2LOG X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
Parameter Summary | 17
DECIMALSEPARATOR DECSEP X X X X X
DEFAULT_EE_NAME DEN X X X X
DEFAULT_MON_NAME DMN X X X X
DEFAULT_SESSION_NAME DSN X X X X
DEFAULT_TTY_NAME DTN X X X X
DELETELOG DL X X X X
DOBDB X X X X
D X X X X
DSBIFTYPE DSBT X X X X
DSDIR DSD X X X X
DSFIELDSEP DSFS X X X X
DSIXFTYPE DSXT X X X X
DSQUOTE DSQ X X X X
EEBIN X X X X
EEINSTANCE X X X
EELOG EEL X X X X
EEWTODELETE EE X X X X (z/OS)
X (z/OS)
X (all) X
EEBIN X X X
ERRMESSAGESCREEN ERRMSGSCR X X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
18 | Chapter 1 Using Execution Environment Parameters
EVENTLOGHOST ELH X X X
EVENTLOGMSGTYPES ELMT X X X X
EXECHASHSIZE X X X X
EXECLOCALNAMESIZE X X X X
EXECLOCALSIZE LOCALSIZE X X X X X
EXECSCOPESIZE X X X X
EXECSTACKSIZE STACKSIZE X X X X (z/OS)
X (z/OS)
X (all) X
FILEGDGSEARCH FILEGDG X X X X X
HAWKANAME HAWKAN X X X X X
HAWKDAEMON HAWKD X X X X X
HAWKDNAME HAWKDN X X X X X
HAWKNETWORK HAWKN X X X X X
HAWKPOLL HAWKP X X X X X
HAWKSERVICE HAWKS X X X X X
HELP X X X X
HOST H X X X X
IBMFLOAT, NOIBMFLOAT
IBMF, NOIBMF X X X X
IDLETIMEOUT ITO X X X X
IMSSCREENATTRIBU IMSEDS X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
Parameter Summary | 19
IMSSCREENTRAN X X X X
IMSSCREENTRANNC X X X X
INSTANCE X X X
INSTLIB I X X X X (z/OS)
X(all)
X (z/OS)
X (Windows, Solaris)
X
INSTLIBNUM X X X
IP X X X X
IPCKEY IPCK X X X
KEEPEELOG KEEL X X X X
KEEPOSMONLOG KOSML X X X X
KEEPSESSIONLOG KSL X X X X
KEEPTTYLOG KTTYL X X X X
KERNEL X X X
LIBRARY L X X X X X
LOGFILEMSGTYPES LFMT X X X X
LOGFILEPATH LFP X X X X
LOGONRULENAME X X X X
MAXEE MEE X X X X
MAXSESSION MXS X X X X
MDL MD X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
20 | Chapter 1 Using Execution Environment Parameters
MONHOST MH X X X X
MONLOG ML X X X X
MONNAME MNM X X X X
MONPORT MP X X X X
MONTHS MN X X X X
MSGLOGMAX MLM X X X X (z/OS)
X (z/OS)
X (all) X
NAME N X X X X X X X
NOSMFDETAIL NOSMF X X X
ONLINE, OFFLINE ON, OFF X X X X (z/OS)
X (z/OS)
X (all) X
OSDIR OD X X X X
OSMONDOB X X X
OSMONNAME X X X
OSMONPORT X X X
OSMONPROCID OSMPID X X X X
PASSWORD P X X X X X
PEERSERVERNUM X X X X
PORT X X X X
PRINTCLASS CLASS X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
Parameter Summary | 21
PRINTCOPY COPY X X X X (z/OS)
X (all) X
PRINTDATASET DATASET X X X X (z/OS)
X (all) X
PRINTDEST DEST X X X X (z/OS)
X (all) X
PRINTDIRECTION DIRECTION X X X X
PRINTERRORLOG PERL X X X X
PRINTFCB FCB X X X X
PRINTFORM FORM X X X X
PRINTPAPERSIZE PAPERSIZE X X X
PRINTPORTRAIT, NOPRINTPORTRAIT
PORTRAIT, NOPORTRAIT
X X X
PRINTSPOOLCLASS SPOOLCLASS X X X
PRINTUCS UCS X X X X
PRINTXWTR XWTR X X X (z/OS)
X (all) X
PROCESSID PID X X X X
PROFILE, NOPROFILE PR, NOPR X X X X (z/OS)
X (z/OS)
X (all) X
PROMPT, NOPROMPT PRM, NOPRM
X X X X X
QUARTERS Q X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
22 | Chapter 1 Using Execution Environment Parameters
REGIONTABLESIZE X X X
REGIONTRACE X X X X
REGIONTRACESIZE X X X X
REGIONTYPE X X X X
REJECTSHUTI X X X
RELOADPARAMS, NORELOADPARAMS
RLP, NORLP X X X X
RULE R X X X X X
RULESIZE RSZ X X X X
SEARCH SEA X X X X (z/OS)
X (all) X
SECACLSIZE X X X X
SECADMINSIZE X X X X
SECAUDITLOG SAL X X X X (z/OS)
X (Open Systems) X
SECCLASS X X
SECOBJSIZE X X X X
SECPACLSIZE X X X X
SECREQUESTOR X X X
SECSUBSYSTEM X X
SECURITY SEC X X X X (z/OS)
X (all) X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
Parameter Summary | 23
SECURITYSIZE SSZ X X X X
SECUSERSIZE X X X X
SERVERID SID X X X X (z/OS)
X (z/OS)
X (Windows, Solaris)
X
SERVERLOGPATH SLP X X X X
SERVERRETRIES SRT X X X X
SERVERS SRV X X X X (z/OS)
X (z/OS)
X (Windows, Solaris)
X
SERVERTYPE ST X X X X (z/OS)
X X
SESSDSPXFRSCRMAX SDXMAX X X X X X
SESSIONENDACTION X X X
SESSIONENDVALUE X X X
SESSIONFILEMAX X X X X X
SESSIONINSTANCE X X X
SESSIONLOG SL X X X X
SESSIONLOGCLEAR, NOSESSIONLOGCLEAR
SLC, NOSLC X X X X
SESSIONMEMMAX SMMX X X X X (z/OS)
X (z/OS)
X (all) X
SESSIONPARMLIST, NOSESSIONPARMLIST
SPL, NOSPL X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
24 | Chapter 1 Using Execution Environment Parameters
SESSIONTYPE X X X
SESSIONUSERID SUID X X X X
SESSNAME SN X X X X
SHAREDMEMADDR SMA X X X X
SMFDETAIL SMF X X X X X
SMFPERFORMANCE SMFP X X X X X
SMFTYPE X X X X
SORTEXTMEMMAX X X X X
SORTINTMEMMAX X X X X
SORTINTNUMMAX X X X X
SORTINTPAGESMAX SIPM X X X X (z/OS)
X (all) X
SORTPGM X X X X
SORTPRINT X X X X X
SORTUNIT SU X X X X (z/OS)
X (all) X
SORTWORKFILESMAX X X X X X
STAE, NOSTAE SE, NOSE X X X X X
STANDBYNUM STANDBY X X X X
STANDBYWAIT X X X X X
STANDBYWAITLIMIT X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
Parameter Summary | 25
STANDBYWAITMSG X X X X
STATSBUF X X X
STATSBUF ST X X X X
STOP X X X X
STOPALL SA X X X X
STOPEE SEE X X X X
STOPSESS SS X X X X
SVC X X X
SYSLIB S X X X X (z/OS)
X (all) X (z/OS)
X (Windows, Solaris)
X
TABLESIZE TSZ X X X X
TAMBMAX X X X X
TAMBMIN X X X X
TAMBSTS X X X
TASKEXECNUM X X X X
TASKFILENUM X X X X
TASKINITNUM X X X X
TASKMISCNUM X X X X
TASKOPERNUM X X X X
TASKRCLINUM X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
26 | Chapter 1 Using Execution Environment Parameters
TASKSMFNUM X X X X
TASKSORTNUM X X X X
TDS TD X X X X
TEMPPRIMARYCYL PRIMARY X X X X
TEMPSECONDARY SECONDARY X X X X
TEMPUNIT UNIT TU X X X X (z/OS)
X (all) X
TEMPUNITCOUNT UNITCOUNT X X X X
TEST, NOTEST TE, NOTE X X X X (z/OS)
X (z/OS)
X (all) X
THREADID X X X
TIMEOUTLIMIT X X X X X X X
TN3270PORT TNPORT X X X X
TRANDSPXFRSCRMAX TDXMAX X X X X X
TRANMAXNUM TMN X X X X (z/OS)
X X
TRANMEMMAX X X X X (z/OS)
X (z/OS)
X (all) X
TTYLOGFILE TLF X X X X
UNICODEDIR UNIDIR X X X X
USERID U X X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
Parameter Summary | 27
VARLDELIMITER VLD X X X X (z/OS)
X (z/OS)
X (all) X
VARRDELIMITER VRD X X X X (z/OS)
X (z/OS)
X (all) X
VERBOSE, NOVERBOSE V, NOV X X X X X
WORKINGDIR WD X X X X
YYCENTURYRANGE YY X X X X
Parameter Name
Abbreviation Environ-ment Parameter Type
Use
r M
od
ifia
ble
z/O
S
Win
do
ws
and
So
lari
s
z/O
S
Win
do
ws
So
lari
s
Co
nfi
gu
rati
on
Exe
cuti
on
En
viro
nm
ent
Init
ializ
atio
n
Ses
sio
n s
tart
up
osM
on
ost
ty
Sys
tem
TIBCO Object Service Broker Parameters
28 | Chapter 1 Using Execution Environment Parameters
TIBCO Object Service Broker Parameters
| 29
Chapter 2 Understanding Execution Environment Parameters
This chapter describes the Execution Environment parameters.
Topics
• Descriptions of the Parameters, page 30
TIBCO Object Service Broker Parameters
30 | Chapter 2 Understanding Execution Environment Parameters
Descriptions of the Parameters
ACTIONThe type of invocation for the initial user rule specified in the RULE parameter.
Environment All.
Abbreviated Name AC
Valid User Values C—CALL the rule
E—EXECUTE the rule
T—TRANSFERCALL the rule
Default E
Recommendation The action coded is valid only when a value is specified in the RULE parameter. ACTION=T is strongly recommended.
Effects The rule specified by the RULE parameter is invoked by the login rule according to the value of this parameter:
If ACTION=T, the login rule TRANSFERCALLs to the specified rule. This will cause the current transaction stream to end the new rule will run at the same transaction stream level.
If ACTION=E, the login rule EXECUTEs the specified rule. This generates a second TIBCO Object Service Broker transaction stream.
If ACTION=C, the login rule CALLs the specified rule. The specified rule run as at the same TIBCO Object Service Broker transaction stream level.
Related Topics Refer to RULE on page 121 for additional information.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 31
ADAYSThe spelling to be used for abbreviated names of the days of the week when converting a date field to a string.
ALLOWSESSIONTIMEOUTLIMIT, NOALLOWSESSIONTIMEOUTLIMITSpecifies whether the TIMEOUTLIMIT session startup parameter takes precedence over the Execution Environment initialization parameter.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name AD
Valid User Values A series of abbreviations of up to 16 characters in length each.
Default Mon, Tue, Wed, Thurs, Fri, Sat, Sun
Related Topics On the z/OS platform, the $SYSDATE macro is used to set date masks. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about using the $SYSDATE macro.
Type Session startup parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name ALLOWSESSTIMEOUT, NOALLOWSESSTIMEOUT
TIBCO Object Service Broker Parameters
32 | Chapter 2 Understanding Execution Environment Parameters
AMONTHSThe spelling to be used for abbreviated names of the months of the year when converting a date field to a string.
Valid User Values ALLOWSESSIONTIMEOUTLIMIT, ALLOWSESSTIMEOUT, NOALLOWSESSIONTIMEOUTLIMIT, NOALLOWSESSTIMEOUT
Default NOALLOWSESSIONTIMEOUTLIMIT
Recommendation Set ALLOWSESSIONTIMEOUTLIMIT according to site requirements.
Effects Using the ALLOWSESSIONTIMEOUTLIMIT parameter you can override the TIMEOUTLIMIT Execution Environment initialization parameter, on a session-by-session basis, through the use of the TIMEOUTLIMIT session startup parameter.
Using the default of NOALLOWSESSIONTIMEOUTLIMIT causes the value of the TIMEOUTLIMIT session startup parameter to be ignored.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name AM
Valid User Values A series of abbreviations of up to 16 characters in length each.
Default Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec
Related Topics On the z/OS platform, the $SYSDATE macro is used to set date masks. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about using the $SYSDATE macro.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 33
BATCHCONSOLE, NOBATCHCONSOLESpecifies whether to send osBatch output to the display console and to the log files.
BINDINGAREASADDRESSThe binding area address.
It is set by the TIBCO Object Service Broker monitor process when it starts the Execution Environment process.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems: applies only to osBatch sessions.
Abbreviated Name BC, NOBC
Valid User Values BATCHCONSOLE, BC, NOBATCHCONSOLE, NOBC
Default NOBATCHCONSOLE
Effects BATCHCONSOLE—The osBatch output is sent to the display console, except for the copyright notice and the parameter list. After the first rule is completed, the return value and end message are also sent to the display console.
NOBATCHCONSOLE—No output is sent to the display console, except for parameter syntax errors.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Recommendation This is a read-only parameter and should not be modified by a user.
Type Execution Environment initialization parameter.
TIBCO Object Service Broker Parameters
34 | Chapter 2 Understanding Execution Environment Parameters
BINDINGAREASKEYThe binding area key.
It is set to the value of the IPCKEY Execution Environment parameter by the TIBCO Object Service Broker monitor process when starting the Execution Environment.
BLTINNUMThe estimated number of routines (builtins) for the rules manager.
User Modifiable No.
Environment Solaris.
Recommendation This is a read-only parameter and should not be modified by a user.
Type Execution Environment initialization parameter.
User Modifiable No.
Environment z/OS.
Valid User Values 128 to 256K
Default 192
Recommendation Use the default.
Effects This value determines the number of entries in the builtin name hash table. Each entry is 4 bytes long. Storage is virtual, non-fixed, above the 16 MB line, and allocated once at Execution Environment initialization.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 35
BROWSE, NOBROWSESpecifies whether the first transaction of the session can update TDS tables and external databases.
CHARSETThe default national character set.
Environment All.
Abbreviated Name B, NOB
Valid User Values BROWSE, B, NOBROWSE, NOB
Default BROWSE
Recommendation If no persistent database updates are required in the first transaction, use BROWSE; otherwise, use NOBROWSE.
Effects BROWSE—The first transaction of the session runs in browse mode, disallowing updates to TDS and external databases. An exception is raised if a rule attempts to update data inappropriately.
NOBROWSE—The first transaction of the session runs in update mode. Table type of TDS and external databases can be updated.
Performance: Running in BROWSE mode does not request any locks. This reduces locking conflicts and message traffic between the Execution Environment and the Data Object Broker.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter
User Modifiable Yes.
Environment All.
TIBCO Object Service Broker Parameters
36 | Chapter 2 Understanding Execution Environment Parameters
Abbreviated Name C
Valid User Values z/OS:
• CNDB—Canadian - Bilingual
• DANS—Danish
• DEUT—Austrian /German
• ENGB—English (British)
• ENGL—English (U. S.)
• ESPA—Spanish
• FRAN—French
• ITAL—Italian
• NORS—Norwegian
• PORT—Portuguese
• SCHW—Swiss German
• SUOM—Finnish
• SVEN—Swedish
Open Systems: ENGL is the only valid value.
Default ENGL
Effects Each national character set name must have a one-page table for all 256 characters in the set. Each table entry includes an attribute list that describes the effects of converting type V syntax characters to type C.
Notes:
• Setting the character set does not set the decimal separator.
• By entering a value in the @NLS1 table, you can use uppercasing rules other than ENGL on Open Systems.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 37
CICSECONTAINERThe name of the CICS container to be used by the Execution Environment to pass back error messages.
CICSPCONTAINERThe name of the CICS container to be used for passing session parameters to the Execution Environment for session startup.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter
User Modifiable Yes.
Environment z/OS: CICS Execution Environment.
Abbreviated Name CICSECONT
Valid User Values 16-character container name according to the CICS specification
Default HERRCONTAINER
Recommendation Use the default.
Effects This parameter enables the user to select any valid 16-character name.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS: CICS Execution Environment.
Abbreviated Name CICSPCONT
TIBCO Object Service Broker Parameters
38 | Chapter 2 Understanding Execution Environment Parameters
CICSHURONTRANThe CICS transaction name to be used by the Execution Environment to start a peer server.
Valid User Values 16-character container name according to the CICS specification
Default PARMCONTAINER
Recommendation Use the default.
Effects This parameter enables the user to select any valid 16-character name.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS: CICS Execution Environment.
Valid User Values A valid four-byte CICS transaction code associated with S6BCSSC2, the TIBCO Object Service Broker CICS client program.
Default HURN
Recommendation Use the default for a non-MRO environment.
Effects This enables the user to select any valid four-byte CICS transaction code to access TIBCO Object Service Broker. It is used when starting peer servers in the CICS Execution Environment.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 39
CICSPSEUDOCONVERSESpecifies whether the CICS Execution Environment makes use of CICS pseudo-conversational processing whenever a DISPLAY statement or a DISPLAY & TRANSFERCALL statement is executed in a rule.
CICSREGIONSIZEThe amount of virtual storage above the 16 MB line to be made available to the CICS address space.
Environment z/OS: CICS Execution Environment.
Abbreviated Name CICSCONVERSE
Valid User Values Y, YES, N, NO
Default Y
Recommendation Set CICSPSEUDOCONVERSE=Y to use CICS pseudo-conversational processing.
Effects CICSPSEUDOCONVERSE=Y implements 3270 text display with the sequence:
EXEC CICS SEND, EXEC CICS RETURN TRANSID, EXEC CICS RECEIVE
CICSPSEUDOCONVERSE=N uses the sequence:
EXEC CICS SEND, EXEC CICS RECEIVE.
Storage: running in pseudo-conversational mode releases CICS owned storage only. TIBCO Object Service Broker controlled storage is still retained.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS: CICS Execution Environment.
Valid User Values 0K to 2048M
Default 0K
TIBCO Object Service Broker Parameters
40 | Chapter 2 Understanding Execution Environment Parameters
CICSVSAMSYNCSpecifies whether the VSAM server should issue SYNCPOINTs under CICS.
Recommendation Set this parameter based on the needs of your CICS environment.
Effects This parameter increases only the site’s default upper limit of virtual storage that can be used above the 16 MB line. If this parameter is not coded or is set to 0K, this limit is determined by the REGION CICS parameter or the IEFUSI exit, if coded.
This parameter overrides the CICS storage limit set by your systems programmer.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS: CICS Execution Environment.
Abbreviated Name CICSVSAM
Valid User Values Y, YES, N, NO
Default Y
Recommendation Use the default unless you want to issue your own SYNCPOINTs.
Effects When you issue a VSAM close at the end of a TIBCO Object Service Broker transaction, a SYNCPOINT is done only if CICSVSAMSYNC=Y or if the session is an API session.
You can change the setting during the session by calling $SETOPT('CICSVSAMSYNC',newvalue).
Related Topics Refer to TIBCO Object Service Broker Managing External Data for information on handling TIBCO Object Service Broker requests with respect to synchronization.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 41
CLICODEPAGEThe name of the SDK (C/C++)/SDK (Java) code page to be used for national language support. Set by the TIBCO Object Service Broker monitor process.
CLIENDIANThe SDK (C/C++)/SDK (Java) endian type. This sets the order of the bytes in a word: placing first the most significant or the least significant part of the number.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment Open Systems: applies only to SDK (C/C++) and SDK (Java) sessions.
Effects The code page setting determines the code page of certain cliProc in and out parameters, as well as the external representation of MAP table fields with “*” external syntax and textual internal syntaxes.
NOTE Setting the national character set does not set the decimal separator.
Related Topics Refer to TIBCO Object Service Broker for z/OS External Environments or TIBCO Object Service Broker for Open Systems External Environments for information on the SDK (C/C++) and the SDK (Java).
Type Session startup parameter.
User Modifiable No. CLICODEPAGE can be set only by:
• The cliSetCodepage SDK (C/C++) function
• The STARTSS SDK (C/C++) operation
• The Session SDK (Java) constructor
• The start SDK (Java) method
TIBCO Object Service Broker Parameters
42 | Chapter 2 Understanding Execution Environment Parameters
This parameter can be used only as part of a parameter string passed to the STARTSS cliProc request (SDK (C/C++)) or to the Session or start methods (SDK (Java)).
CLIENTHOSTNAMEThe client host name.
Environment Open Systems: applies only to SDK (C/C++) and SDK (Java) sessions.
Abbreviated Name CLIE
Valid User Values big, little
Default The endian type of the SDK (C/C++) or SDK (Java) platform.
Recommendation Use the default.
Effects big—The most significant byte is first.
little—The least significant byte is first.
This parameter affects the external representation of MAP table fields with internal syntax B and “*” external syntax.
Related Topics Refer to TIBCO Object Service Broker for z/OS External Environments or TIBCO Object Service Broker for Open Systems External Environments for information on the SDK (C/C++) and the SDK (Java).
Type Session startup parameter.
User Modifiable No. CLIENDIAN can be set only by:
• The STARTSS SDK (C/C++) operation
• The Session SDK (Java) constructor
• The start SDK (Java) method
Environment Open Systems: applies only to online sessions.
Recommendation This is a read-only parameter and should not be modified by a user.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 43
CLIENTIPThe client IP address.
CLIENTPORTThe client TCP/IP port number. The value is set by the parent TIBCO Object Service Broker monitor process.
CLIHOSTThe TCP/IP host name of the machine that runs the TIBCO Object Service Broker monitor process or the z/OS Execution Environment where the SDK (Java) client is to connect.
Type Session startup parameter.
User Modifiable No.
Environment Open Systems: applies only to online sessions.
Recommendation This is a read-only parameter and should not be modified by a user.
Type Session startup parameter.
User Modifiable No.
Environment Open Systems: applies only to online sessions.
Recommendation This is a read-only parameter and should not be modified by a user.
Type Session startup parameter.
User Modifiable No.
Environment All.
Valid User Values A valid machine name of up to 64 characters in length.
TIBCO Object Service Broker Parameters
44 | Chapter 2 Understanding Execution Environment Parameters
CLIMSGLENMAXThe maximum length of an SDK (C/C++) or SDK (Java) message that can be sent or received between clients and servers. The length includes the message and control information.
Default None
Recommendation Use the host name of the machine that runs the TIBCO Object Service Broker monitor process (Open Systems) or the Execution Environment (z/OS).
Effects CLIHOST can be used only as part of a session parameter string passed to a STARTSS cliProc request. It identifies the host name where the SDK (C/C++) client is to establish a session. CLIHOST must be used in pair with the CLIPORT parameter to fully identify the target TIBCO Object Service Broker monitor process (Open Systems) or Execution Environment (z/OS). Use of CLIHOST and CLIPORT pair is optional; the CLINODE parameter can be used instead.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for z/OS Installing and Operating for additional information about the SDK (C/C++). Also refer to CLINODE on page 45, CLIPORT on page 46, HOST on page 76, IP on page 83, and PORT on page 103.
Type Session startup parameter.
User Modifiable Yes.
Environment z/OS: CICS Execution Environment, Native Execution Environment.
Valid User Values 0 to 32M
Default 256K
Effects A value of 0 MB means no limit. Use the specification of 0 MB with caution as it can cause storage constraint in the system.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 45
CLINODEThe node name of the TIBCO Object Service Broker monitor process or the z/OS Execution Environment where the SDK (C/C++) client is to connect.
SDK (Java) does not support CLINODE.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment All.
Valid User Values A valid node name of up to 64 characters in length.
Default None
Recommendation For Open Systems, use the name specified for a node in the huron.dir file.
For z/OS, use the value of the EENAME parameter, if it exists, or of the MDL parameter, from the HRNIN file.
Effects CLINODE can be used only as part of a session parameter string passed to a STARTSS cliProc request. It is used to identify the target TIBCO Object Service Broker monitor process (Open Systems) or Execution Environment (z/OS). Use of CLINODE is optional; the CLIHOST/CLIPORT pair can be used instead.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for Open Systems Installing and Operating for additional information about CLINODE and the huron.dir configuration. Also refer to CLIHOST on page 43 and CLIPORT on page 46.
Type Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
46 | Chapter 2 Understanding Execution Environment Parameters
CLIPORTThe TCP/IP port number of the TIBCO Object Service Broker monitor process or the z/OS Execution Environment where the SDK (Java) client is to connect.
CLITIMEOUTLIMITSpecifies the CLI request processing elapsed time interval in centiseconds, after which the IMS TM Logger Exit is disabled and the Execution Environment shutdown.
Environment All.
Valid User Values A valid port number up to 65535.
Default None
Effects CLIPORT can be used only as part of a session parameter string passed to a STARTSS cliProc request. It is used in conjunction with CLIHOST to identify the target TIBCO Object Service Broker monitor process (Open Systems) or Execution Environment (z/OS). Use of the CLIHOST/CLIPORT pair is optional; the CLINODE parameter can be used instead.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for z/OS Installing and Operating for additional information about the SDK (C/C++) and the SDK (Java). Also refer to CLIHOST on page 43 and CLINODE on page 45.
Type Session startup parameter.
User Modifiable Yes.
Environment z/OS IMS TM
Valid User Values 0 to 232 -1 (100 = 1 second)
Default 1000 (10 seconds)
If you specify 0, the system default of 1000 is in effect.
Type Execution Environment initialization parameter.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 47
CLOSECloses the TIBCO Object Service Broker monitor process that is listening on the host specified by the HOST parameter and listening on the port specified by the PORT parameter.
CLOSEEEStops the specified Execution Environment process started by the TIBCO Object Service Broker monitor process that is running on the host specified by the HOST parameter and listening on the port specified by the PORT parameter.
User Modifiable No.
Environment Open Systems.
Abbreviated Name C
Valid User Values CLOSE, C
Default An empty string
Effects When CLOSE is specified with a TIBCO Object Service Broker monitor process, this process initiates a close sequence for the target TIBCO Object Service Broker monitor process and then exits immediately. As the target TIBCO Object Service Broker monitor process closes, its listening port is shutdown and it waits for any child Execution Environment processes to exit before exiting.
Related Topics For additional information, refer to HOST on page 76, PORT on page 103, and STOP on page 162.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name CEE
TIBCO Object Service Broker Parameters
48 | Chapter 2 Understanding Execution Environment Parameters
COMMITSIZEThe buffer size for the intent list of a transaction.
The list contains all the uncommitted database updates for the transaction.
Valid User Values The Execution Environment operating system process ID, or the EENAME:Execution Environment instance pair.
Default An empty string.
Effects When CLOSEEE is specified with a TIBCO Object Service Broker monitor process, this process initiates a stop sequence for the target instance of Execution Environment and then exits immediately. The target instance of the Execution Environment waits for all its sessions to stop.
Related Topics For additional information, refer to HOST on page 76, PORT on page 103, and STOPEE on page 164. See also TIBCO Object Service Broker for Open Systems Installing and Operating.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name z/OS: none
Open Systems: CS
Valid User Values • 16K to 32K
• Numeric values, such as 18000, are accepted; they are rounded to the next higher KB
Open Systems: Appears as a hexadecimal value in the log.
Default 16K
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 49
CONFIGURATIONThe default Execution Environment configuration name.
Effects With COMMITSIZE=16K, an application that updates long rows where the length is 1 KB or more has to commit every 16 rows. Increasing COMMITSIZE to 32 KB allows the application to extend the number of row updates to 32, thereby maintaining a larger logical unit of work.
For an application that updates rows with short row lengths and runs into a COMMITLIMIT exception, increasing COMMITSIZE allows a larger logical unit of work, that is, a larger number of updates.
Extending COMMITSIZE for this application could require a corresponding increase in the WORKINGSET Data Object Broker parameter. This avoids the Data Object Broker “too many buffers required” error message that implies that the logical unit of work is updating too many data store pages.
For some applications, extending COMMITSIZE allows fewer intermediate COMMITs. This lowers the number of sync messages from the Execution Environment to the Data Object Broker.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name CONFIG
Valid User Values A three- to eight-character name.
Default • S6BDRCB0—TIBCO Object Service Broker Batch Execution Environment
• S6BDRCC0—CICS Execution Environment
• S6BDRCI0—IMS TM Execution Environment
• S6BDRCN0—Native Execution Environment
• S6BDRCT0—TSO Execution Environment
TIBCO Object Service Broker Parameters
50 | Chapter 2 Understanding Execution Environment Parameters
CONNTIMEOUTThe amount of time, in seconds, that the TIBCO Object Service Broker monitor process waits for a connection to be made before timing out.
DATEFORMATThe default date format for a session.
Recommendation Use the defaults, unless you have a requirement for multiple modules in a specific environment.
Effects This parameter is specified at Execution Environment initialization to select an alternative module to supply the configuration defaults. The TIBCO Object Service Broker SVC number (specified by the SVC parameter) is extracted from the default module of the respective environment, regardless of the setting of the parameter.
Related Topics For additional information, refer to SVC on page 165.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name CTO
Valid User Values 0 to 2147483647
Default 120
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DF
Valid User Values A valid TIBCO Object Service Broker date format; length must be other than six (6).
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 51
DAYSThe spelling to be used for names of the days of the week when converting a date field to a string.
Default YYYY-MM-DD
Recommendation Refer to TIBCO Object Service Broker Shareable Tools for a listing of valid formats.
Effects All fields defined as TYPE=DATE use this date format.
Related Topics On the TIBCO Object Service Broker z/OS platform, the $SYSDATE macro is used to set date masks. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about using the $SYSDATE macro.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DY
Valid User Values A series of words up to 16 characters in length each.
Default Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
Related Topics On the TIBCO Object Service Broker z/OS platform, the $SYSDATE macro is used to set date masks. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about using the $SYSDATE macro.
Type Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
52 | Chapter 2 Understanding Execution Environment Parameters
DB2LOGSpecifies whether the Execution Environment is to log DB2 server commands for the purpose of creating STATIC SQL handlers.
DECIMALSEPARATORThe character to be used as the decimal separator.
Environment z/OS.
Valid User Values Y, YES, N, NO
Default N
Related Topics Refer to TIBCO Service Gateway for DB2 Installing and Operating for more detail.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name DECSEP
Valid User Values period (. or '.') and comma (','). That is, the period can appear with or without single quotation marks, while the comma must appear within single quotation marks.
Default period (.)
Effects Specifies the character to be used as the decimal separator. The value can be queried by the $GETOPT tool.
Note Setting the national character set does not set the decimal separator.
Type Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 53
DEFAULT_EE_NAMEThe default value of the EENAME parameter.
DEFAULT_MON_NAMEThe default value of the MONNAME parameter.
DEFAULT_SESSION_NAMEThe default value of the SESSNAME parameter.
Environment Open Systems.
Abbreviated Name DEN
Valid User Values A word of up to 32 characters in length.
Default DEFAULT
Type System parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DMN
Valid User Values A word of up to 32 characters in length.
Default DEFAULT
Type System parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DSN
Valid User Values A word of up to 32 characters in length.
Default DEFAULT
TIBCO Object Service Broker Parameters
54 | Chapter 2 Understanding Execution Environment Parameters
DEFAULT_TTY_NAMEThe default value of the ostty NAME parameter.
DELETELOGThe number of seconds after which a log file is to be deleted.
Type System parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DTN
Valid User Values A word of up to 32 characters in length.
Default DEFAULT
Type System parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name
DL
Valid User Values 0 to x‘7FFFFFFF’ (2147483647, about 68 years)
Default 0 (This indicates that the log file should never be deleted.)
Recommendations If you do not want a log file deleted, do one of the following:
• Move it from the %OS_ROOT%\log (Windows) or ${OS_ROOT}/log (Solaris) directory
• Set its read-only attribute
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 55
DOBThe name of the Data Object Broker to which a session is to connect. Can also affect binding between sessions.
Effects Only log files not marked as read-only are deleted. They are deleted when the current time minus the last change time of the log file is greater than the value specified for DELETELOG.
Startup logs require special consideration: Startup log files are opened and appended to by all TIBCO Object Service Broker processes run during a day. When the date changes, a startup log is not used again. The startup log file is deleted only when the current time is greater than the value specified for DELETELOG after the end of the day when the startup log is created.
The hrncr log files are never deleted.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name
osMon: D
osee: DB
Valid User Values A valid upper case alphanumeric identifier of one to 16 characters in length.
Default osMon: an empty string
osee: For online sessions, it defaults to the OSMONDOB parameter value. For osBatch, it defaults to an empty string.
Recommendation The Data Object Broker name is expected to be set to the name of an accessible Data Object Broker whose connection information is listed in the file specified by the OSDIR parameter.
The simplest way to set the DOB parameter is to set the osMon DOB parameter and let osee use it as the default.
TIBCO Object Service Broker Parameters
56 | Chapter 2 Understanding Execution Environment Parameters
DSBIFTYPEThe file type used to process calls to the @READDSN and @WRITEDSN tools and the load/unload to external files tools.
Effects When you use the TIBCO Object Service Broker monitor process (osMon) parameter, osMon writes this name to the OSMONDOB parameter to serve as a default value for the Execution Environment (osee) initialization parameter.
As an osee parameter, this is the name of the Data Object Broker to which all sessions in the osee connect.
Binding between sessions is performed only if the osMon DOB parameter is not empty and the osee DOB parameter is either empty or is the same as the osMon DOB parameter.
Related Topics Refer to OSDIR on page 99 and to OSMONDOB on page 99 for more information. Refer to TIBCO Object Service Broker Application Administion for more information about binding.
Type • TIBCO Object Service Broker monitor parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name
DSBT
Valid User Values LENGTH_PREFIXED_EBCDIC, LINE_SEPARATED_ASCII
Default LENGTH_PREFIXED_EBCDIC
Recommendation Use the file type of LENGTH_PREFIXED_EBCDIC if you are using the load/unload to external file tools.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 57
DSDIRThe path to the directory containing files accessed with the @OPENDSN tool, import and export tables, and load/unload to external files tools.
DSFIELDSEPThe field separator for TEXT type import and export tables.
Effects LENGTH_PREFIXED_EBCDIC—Native TIBCO Object Service Broker format. This data is stored in EBCDIC and big-endian format. The length of a record is determined by a length stored in the first two bytes of a record.
LINE_SEPARATED_ASCII—ASCII line-oriented data where the end of a line is delimited by a new line character or the end of the file format.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DSD
Valid User Values A valid path of up to 255 characters in length.
Default The current working directory of the osee process.
Related Topics Refer to WORKINGDIR on page 188 for more information.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DSFS
Valid User Values COMMA, SPACE, TAB, NONE
TIBCO Object Service Broker Parameters
58 | Chapter 2 Understanding Execution Environment Parameters
DSIXFTYPEThe file type used to process import and export tables.
Default NONE
Recommendation Use the default
Effects If both quote character and field separator characters are defined, fields are delimited by the quote characters.
If quote character is NONE and a field separator is defined, a backslash (\) is inserted in the output before any characters that are the same character as the field separator and that are not generated as field separators. The backslash does not appear before the actual separator.
For example, if you set quote character to NONE, and field separator to COMMA, commas that your application inserts, that are not field separators, are preceded by a backslash in the output.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DSXT
Valid User Values LENGTH_PREFIXED_EBCDIC, LENGTH_PREFIXED_EBCDIC_NATIVE_ENDIAN, LINE_SEPARATED_ASCII
Default LINE_SEPARATED_ASCII
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 59
DSQUOTEThe quote character used for TEXT import tables.
Effects LENGTH_PREFIXED_EBCDIC—Native TIBCO Object Service Broker format. This data is stored in EBCDIC and big-endian format. The length of a record is determined by a length stored in the first two bytes of a record.
LENGTH_PREFIXED_EBCDIC_NATIVE_ENDIAN—The native format of the platform.
LINE_SEPARATED_ASCII—ASCII line-oriented data where the end of a line is delimited by a new line character or the end of the file format.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DSQ
Valid User Values DOUBLE, SINGLE, NONE
Default SINGLE
Effects If both quote character and field separator characters are defined, fields are delimited by the quote characters.
If quote character is NONE and a field separator is defined, a backslash (\) is inserted in the output before any characters that are the same character as the field separator, and that are not generated as field separators. The backslash does not appear before the actual separator.
For example, if you set quote character to NONE, and field separator to COMMA, commas that your application inserts, that are not field separators, are preceded by a backslash in the output.
Type Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
60 | Chapter 2 Understanding Execution Environment Parameters
EEBINThe Execution Environment binary name.
EEINSTANCEThe Execution Environment instance number.
EELOGThe name of the Execution Environment log file.
Environment Open Systems.
Valid User Values A word of up to 256 characters in length.
Default osee
Recommendation This parameter should not be modified by a user.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes, but modification is not recommended.
Environment Open Systems.
Effects This parameter’s value can be used as a reference to the Execution Environment process that runs the session.
Related Topics Refer to EENAME on page 61 for additional information.
Type Session startup parameter.
User Modifiable No.
Environment Open Systems.
Abbreviated Name
EEL
Valid User Values A valid filename of up to 256 characters in length.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 61
EENAMEThe name of the Execution Environment to be used to run the session.
Default For batch Execution Environments: ee.name.mm.dd-hh.MM.ss.log,
For all other Execution Environments: ee.monname.name.mm.dd-hh.MM.ss.instance.log,
where:
• name is the name of the Execution Environment parameter group (refer to NAME on page 95)
• from the Execution Environment startup timestamp:
— mm is the month
— dd is the day
— hh is the hour
— MM is the minutes
— ss is the seconds
• monname is the name of the TIBCO Object Service Broker monitor parameter group (refer to NAME on page 95)
• instance is the Execution Environment instance number
Recommendation Use the default.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS: Native Execution Environment, IMS TM MPR, CICS.
Open Systems.
Abbreviated Name
EE
Valid User Values z/OS: A word of up to 8 characters in length.
Open Systems: A word of up to 32 characters in length.
TIBCO Object Service Broker Parameters
62 | Chapter 2 Understanding Execution Environment Parameters
Default z/OS: none
Open Systems: an empty string
Recommendation z/OS: Use a name that starts and ends with an alphabetic character (does not end in a numeric character). For Execution Environments supporting the SDK (C/C++) or the SDK (Java), specify the 8-byte ID of the IP address of the TCP/IP socket.
Effects z/OS:
• If not specified, the value for the MDL parameter is used. If specified, the value for EENAME is used instead of the value for the MDL parameter. Refer to MDL on page 91 for more information about the MDL parameter.
• If you specify a value of the form AAAnnn, that is, one that ends in numeric characters, communications tries to open an identifier of AAA001, AAA002, and so on, until either it finds an available ID or the pool of names is exhausted.
• For a Native Execution Environment, EENAME should NOT end in numerics, to avoid pattern matching behavior.
• For the SDK (C/C++) and the SDK (Java) running under a Native Execution Environment, if the Native Execution Environment is to support VTAM terminals, the VTAM definitions should have the same applid.
Open Systems:
This parameter defines which osee process is to run the session. The monitor process tries to find an instance of osee with the specified name and number of running sessions below the value of the MAXSESSION parameter. If it finds such an instance, it selects that instance to run the new session. Otherwise, a new instance of osee with the specified name and with parameters corresponding to that name is created to run the new session.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about specifying the application identifier model.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 63
EEWTODELETESpecifies whether to suppress informational error messages that are destined for the console.
EMSWIRECODEPAGESpecifies the codepage (net_codepage) that TIBCO Enterprise Message Service uses to transmit TIBCO Enterprise Message Service messages.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values YES, Y, NO, and N
Default N
Recommendation Use the default to print the messages with suffix I that are destined for the console, unless you want the system to suppress them.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values ISO8859-1 and UTF-8.
Default null (this results in a codepage of ISO8859-1).
Type Execution Environment initialization parameter.
User Modifiable Yes
TIBCO Object Service Broker Parameters
64 | Chapter 2 Understanding Execution Environment Parameters
See also: Refer to TIBCO Enterprise Message Service C and COBOL Reference for information on the tibems_SetCodePages() function and to TIBCO Object Service Broker National Language Support for the value of the host_codepage mentioned in TIBCO Enterprise Message Service C and COBOL Reference.
ERRMESSAGESCREENThe response to the CICS end message that is issued when a TIBCO Object Service Broker session ends.
Environment z/OS: CICS Execution Environment.
Abbreviated Name
ERRMSGSCR
Valid User Values HOLD, NOHOLD
Default HOLD
Recommendation Use the default. In conjunction with ERRMESSAGESCREEN=HOLD, you can set the RTIMOUT CICS transaction profile parameter to an appropriate value (for example, two minutes). This prevents CICS from entering a terminal READ state immediately, enabling the operator to read the end message and respond.
NOTE If CICS does not receive input from the terminal before the time-out period specified by RTIMOUT expires, the transaction is terminated abnormally.
RTIMOUT has no effect for MRO connections. In an MRO environment, you can use the terminal-level TYPETERM equivalent SIGNOFF setting. The time-out value can then be set in the RACF profile information.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 65
AssociatedDocumentation
The CICS Resource Definition Guide IBM manual for information about the RTIMOUT CICS parameter.
EVENTLOGHOSTThe target machine for event log messages.
Effects When a TIBCO Object Service Broker session ends with a SESSIONENDACTION, an error message is sent to the terminal. ERRMESSAGESCREEN specifies how you want to handle the error message screen that appears:
• HOLD—Waits for the terminal operator to read the message before terminating the TIBCO Object Service Broker transaction. The transaction is conversational while it waits for terminal input.
• NOHOLD—Displays the error message screen for two seconds and then terminates the task.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment Windows.
Abbreviated Name ELH
Valid User Values A string of up to 255 characters in length.
Default localHost
Type System parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
66 | Chapter 2 Understanding Execution Environment Parameters
EVENTLOGMSGTYPESThe types of message to be written to the Windows event log or to the Solaris system log.
EXECHASHSIZEThe number of Executor rule name hash table buckets.
Environment Open Systems.
Abbreviated Name
ELMT
Valid User Values One or more of the following, each separated by a single space: INFORMATION, LOG, WARNING, ERROR; or an empty string meaning that no message is to be written
Default Empty string
Effects • INFORMATION—Informational messages
• LOG—Audit log messages
• WARNING—Warning messages
• ERROR—Error messages
Type System parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values 127 to 4K
Default 127
Recommendation Use the default.
Effects Storage: This value is used to determine the number of entries in the rule name hash table. Each table entry is 4 bytes long and is allocated for each transaction stream level. The storage is non-fixed virtual above the 16 MB line.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 67
EXECLOCALNAMESIZEThe size of the Executor Local Name table.
EXECLOCALSIZEThe size of the area for rules local variables.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 1K to 176K
Default 12K
Recommendation Use the default.
Effects This parameter is used to determine the size of the table containing local variable names and is allocated for each transaction stream level. Each local variable uses a 24-byte table entry. The storage is non-fixed virtual above the 16 MB line.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated value LOCALSIZE
Valid User Values 1K to 256K
Default 16K
TIBCO Object Service Broker Parameters
68 | Chapter 2 Understanding Execution Environment Parameters
EXECSCOPESIZEThe size of the Executor Scope stack.
Recommendation Use the default unless you are using large strings or are accessing CICS or IMS COMMAREAs; then set EXECLOCALSIZE to 128K.
Effects Storage: This is used to determine the size of the heap containing storage for TIBCO Object Service Broker local variables and is allocated for each transaction stream level. The storage is non-fixed virtual above the 16 MB line.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 1K to 64K
Default 2K
Recommendation Use the default, unless performing a significant amount of nesting within FORALL statements.
Effects Allocates storage for the Executor Scope stack of each transaction stream level. Each entry corresponds to one nested FORALL statement. The size of each entry is 22 bytes plus the length of all parameters of the table. The storage is non-fixed virtual above the 16 MB line.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 69
EXECSTACKSIZEThe size of the rules executor runtime stack in bytes.
FILEGDGSEARCHThe method of allocation of GDG (Generation Data Group) data sets accessed either as tables of type IMP and EXP or through the @OPENDSN, @READDSN, @WRITEDSN shareable tools.
TIBCO Object Service Broker passes this information to the operating system for use during dynamic allocation.
Environment All.
Abbreviated value STACKSIZE
Valid User Values 16K to 256K
Default 70K
Recommendation Use the default, unless you are using CICS or IMS COMMAREAs; then set EXECSTACKSIZE to 128K.
Effects Allocates storage for the interpreter runtime stack of each transaction stream level.
z/OS storage: The storage is non-fixed virtual above the 16 MB line.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name FILEGDG
Valid User Values STATIC, DYNAMIC
TIBCO Object Service Broker Parameters
70 | Chapter 2 Understanding Execution Environment Parameters
HAWKANAMEThe TIBCO Hawk microagent application name for a Hawk microagent embedded in the TIBCO Object Service Broker monitor process (osMon) or the TIBCO Object Service Broker batch client (osBatch). This name can be used by TIBCO Hawk Agents when applying a Hawk rulebase. For online Execution Environments, the value is set by the parent TIBCO Object Service Broker monitor process.
Default STATIC
Recommendation Set as appropriate.
Effects • If FILEGDGSEARCH=STATIC, the requested level of the GDG is allocated based on the state of the GDG at the time of the first allocation under TIBCO Object Service Broker. This behavior was standard before the introduction of this parameter. This ensures that multiple accesses to the same level from the same TIBCO Object Service Broker session results in the same data set generation being accessed.
• If FILEGDGSEARCH=DYNAMIC, the requested level of the GDG is allocated by doing a catalog search. This is to ensure that level 0 always returns the most recent data set generation. If the same level is requested more than once in a TIBCO Object Service Broker session, the data set accessed could differ.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default An empty string.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 71
HAWKDAEMONThe TIBCO Hawk Rendezvous daemon and TCP port parameters. For online Execution Environments, the value is set by the parent TIBCO Object Service Broker monitor process.
Effects If the value is an empty string, the default application name used will be based upon the location of the Hawk microagent:
Hawk microagent embedded within osMon:
com.tibco.osb.osMon
Hawk microagent embedded within osBatch:
com.tibco.osb.osBatch.
Recommendation Set as appropriate to avoid Hawk microagent application name collisions.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk.
Related Parameters HAWKDNAME on page 72.
Type • TIBCO Object Service Broker monitor parameter.
• Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default An empty string.
Effects Setting this parameter enables the Hawk microagent within osMon or osBatch.
TIBCO Object Service Broker Parameters
72 | Chapter 2 Understanding Execution Environment Parameters
HAWKDNAMEThe TIBCO Hawk microagent display name for a Hawk microagent embedded in the TIBCO Object Service Broker monitor process (osMon) or the TIBCO Object Service Broker batch client (osBatch). This name is displayed when using a TIBCO Hawk console application, such as TIBCO Hawk Display. For online Execution Environments, the value is set by the parent TIBCO Object Service Broker monitor process.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk. Refer to product documentation for TIBCO Hawk and TIBCO Rendezvous for information about the Rendezvous daemon parameter.
Related Parameters HAWKDNAME on page 72.
HAWKNETWORK on page 73.
HAWKPOLL on page 74.
HAWKSERVICE on page 75.
Type • TIBCO Object Service Broker monitor parameter.
• Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default An empty string.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 73
HAWKNETWORKThe TIBCO Hawk Rendezvous network parameter. For online Execution Environments, the value is set by the parent TIBCO Object Service Broker monitor process.
Effects If the value is an empty string, a default display name will be generated based upon the location of the Hawk microagent:
Hawk microagent embedded within osMon:
TIBCO OSB Monitor, Name <name>, Host <host>, Port <port>
When osMon is configured to only listen on a specific network interface, the following is used:
TIBCO OSB Monitor, Name <name>, Host <host>, IP <address>, Port <port>
Hawk microagent embedded within osBatch:
TIBCO OSB Batch Execution Environment, Name <name>, Host <host>
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk.
Related Parameters HAWKANAME on page 70.
Type • TIBCO Object Service Broker monitor parameter.
• Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default An empty string.
Effects Setting this parameter enables the Hawk microagent within osMon or osBatch.
TIBCO Object Service Broker Parameters
74 | Chapter 2 Understanding Execution Environment Parameters
HAWKPOLLThe number of milliseconds to wait between TIBCO Hawk session creation attempts. For online Execution Environments, the value is set by the parent TIBCO Object Service Broker monitor process.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk. Refer to product documentation for TIBCO Hawk and TIBCO Rendezvous for information about the Rendezvous network parameter.
Related Parameters HAWKDAEMON on page 71.
HAWKPOLL on page 74.
HAWKSERVICE on page 75.
Type • TIBCO Object Service Broker monitor parameter.
• Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Valid User Values 1000 to 2147483647
Default 5000.
Effects If the internal Hawk microagent is not able to establish a connection to TIBCO Hawk, then it will sleep for at most the specified number of microseconds before trying again.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk.
Related Parameters HAWKDAEMON on page 71.
HAWKNETWORK on page 73.
HAWKSERVICE on page 75.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 75
HAWKSERVICEThe TIBCO Hawk Rendezvous UDP service port. For online Execution Environments, the value is set by the parent TIBCO Object Service Broker monitor process.
Type • TIBCO Object Service Broker monitor parameter.
• Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default An empty string.
Effects Setting this parameter enables the Hawk microagent within osMon or osBatch.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk. Refer to product documentation for TIBCO Hawk and TIBCO Rendezvous for information about the Rendezvous network parameter.
Related Parameters HAWKDAEMON on page 71.
HAWKNETWORK on page 73.
HAWKPOLL on page 74.
Type • TIBCO Object Service Broker monitor parameter.
• Execution Environment initialization parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
76 | Chapter 2 Understanding Execution Environment Parameters
HELPDisplays help information for TIBCO Object Service Broker monitor process parameters.
HOSTThe name of the host machine where the TIBCO Object Service Broker monitor process listens for connections; also, the name of the destination machine for the STOP, CLOSE, RELOADPARAMS, STOPEE, CLOSEEE, STOPSESS, and STATUS TIBCO Object Service Broker monitor commands.
Environment Open Systems.
Valid User Values HELP
Default An empty string.
Effects This parameter can be specified only from a command line. It is ignored for online execution.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name H
Valid User Values A string of up to 64 characters in length.
Default An empty string.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 77
IBMFLOAT, NOIBMFLOATSpecifies whether to use emulated IBM S/370 floating-point operations for all arithmetic on floating point data.
Effects • If HOST is set to an empty string and the IP parameter is set to an empty string, the TIBCO Object Service Broker monitor process listens on all IP addresses associated with the machine where it is executing.
• If HOST is not set to an empty string or the IP parameter is not set to an empty string, the TIBCO Object Service Broker monitor process listens only to the specified IP address.
• If both HOST and IP are not set to empty strings, both parameters must specify the same IP address.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name IBMF, NOIBMF
Valid User Values IBMFLOAT, IBMF, NOIBMFLOAT, NOIBMF
Default IBMFLOAT
Recommendation Use IBMFLOAT to obtain identical results when running on Windows or Solaris as compared with z/OS or to obtain greater precision for the results. Use NOIBMFLOAT only if it is important to ensure that results obtained on TIBCO Object Service Broker Release 4.0 or later are identical to those obtained on Release 3.2.
Type Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
78 | Chapter 2 Understanding Execution Environment Parameters
IDLETIMEOUTThe time in seconds an Execution Environment with no sessions waits before it shuts down.
IMSSCREENATTRIBUSpecifies whether terminals with sessions established under this IMS TMclient or Native Execution Environment have the extended data stream or extended attribute support.
Environment Open Systems.
Abbreviated Name ITO
Valid User Values 0 to 2147483647
Default 60
Recommendation Set it depending on your resource requirements.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS: IMS TM client (MPR), Native Execution Environment.
Abbreviated Name IMSEDS
Valid User Values YES and NO
Default none
Recommendation Specify according to capabilities of terminals.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 79
IMSSCREENTRANThe name of the transaction to invoke when resuming a TIBCO Object Service Broker IMS TM conversational transaction in the Message Processing Region (MPR).
Effects This parameter can be specified in the MPR, in the Native Execution Environment, or in both.
• If this parameter is not specified in the MPR, the Native Execution Environment setting is used.
• If specified both in the MPR and the Native Execution Environment, the MPR setting is used.
• If not specified in either the MPR or the Native Execution Environment, no extended attribute support is assumed for IMS TM terminals.
Type • Configuration parameter
• IMS TM client
• Native Execution Environment initialization parameter
• Native Execution Environment JCL EXEC PARM
User Modifiable Yes.
Environment z/OS: IMS TM MPR.
Valid User Values A string of up to 8 characters in length.
Default S6BDCKRN
Recommendation Use the default IMSSCREENTRAN=S6BDCKRN.
TIBCO Object Service Broker Parameters
80 | Chapter 2 Understanding Execution Environment Parameters
IMSSCREENTRANNCThe name of the transaction to invoke when resuming a TIBCO Object Service Broker IMS TM non-conversational transaction in the Message Processing Region (MPR).
Effects The named conversational IMS transaction must be associated with the S6BDCKRN TIBCO Object Service Broker IMS continuation-client program.
The named transaction is used by TIBCO Object Service Broker to implement the rules statements DISPLAY, UNTIL DISPLAY, and DISPLAY & TRANSFERCALL in an IMS TM conversational environment.
To use one IMS TM system to connect to multiple TIBCO Object Service Broker environments, specify a transaction code name on the IMSSCREENTRAN parameter that is different from the default S6BDCKRN. To avoid an 806 abend when loading the module with the new name, relink the S6BDCKRN module with the new module name. The PSB name must match the transaction code to avoid a 0C4 abend.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS: IMS TM MPR.
Valid User Values A string of up to 8 characters in length.
Default S6BNCKRN
Recommendation Use the default IMSSCREENTRANNC=S6BNCKRN.
Effects The named non-conversational IMS transaction must be associated with the S6BNCKRN TIBCO Object Service Broker IMS continuation-client program. The named transaction is used by TIBCO Object Service Broker to implement the rules statements DISPLAY, UNTIL DISPLAY, and DISPLAY & TRANSFERCALL in an IMS TM non-conversational environment.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 81
INSTANCEThe instance number for an Execution Environment process. It is used in conjunction with the MAXSESSION and EENAME parameters.
INSTLIBThe name of the library that holds the rules for the installation promoted from the local libraries.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment Open Systems: except for batch.
Recommendation This is a read-only parameter and should not be modified by a user.
Effects The value for MAXSESSION determines when a new instance is created for an Execution Environment. Refer to MAXSESSION on page 90 and EENAME on page 61 for additional information.
Type Execution Environment initialization parameter.
User Modifiable No.
Environment All.
Abbreviated Name
I
Valid User Values A string of up to 8 characters in length.
TIBCO Object Service Broker Parameters
82 | Chapter 2 Understanding Execution Environment Parameters
Default z/OS: SITE
Open Systems:
• osMon and osBatch: SITE.
• TIBCO Object Service Broker UI, Object Integration Gateway, ostty, SDK (C/C++), and SDK (Java): The value is set by the parent TIBCO Object Service Broker monitor process.
Recommendation z/OS: Use the default.
Open Systems:
• For osMon and osBatch, use the default of SITE.
• For TIBCO Object Service Broker UI, Object Integration Gateway, ostty, SDK (C/C++), and SDK (Java) sessions, this is a read-only parameter and should not be modified by a user.
Effects Establishes the library to be searched for application rules.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems:
• Execution Environment initialization parameter
• TIBCO Object Service Broker monitor parameter
User Modifiable z/OS: Yes.
Open Systems:
• osMon and osBatch: Yes
• Other session types: No
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 83
INSTLIBNUMThe estimated number of rules that can be executed during a session from the installation library, for the rules manager.
IPThe IP address of the host where the TIBCO Object Service Broker monitor process listens for connections.
Environment z/OS.
Valid User Values 128 to 65531
Default 8192
Recommendation Use the default, or the actual number of rules in your system/installation library.
Effects This value determines the number of entries in the installation library rules name hash table. If the value is less than the number of rules that can be executed, the table grows dynamically. Over-allocating increases storage usage unnecessarily, while under-allocating could increase search time, as the dynamic nature of the table chains new entries to the original table.
Each entry is 4 bytes long. Storage allocated is virtual, non-fixed, above the 16 MB line, and allocated once at Execution Environment initialization.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Valid User Values A valid IP address of up to 15 characters in length.
Default An empty string.
TIBCO Object Service Broker Parameters
84 | Chapter 2 Understanding Execution Environment Parameters
IPCKEYThe unique identifier for the binding area IPC key.
KEEPEELOGSpecifies whether to keep the Execution Environment log after the Execution Environment shuts down.
Effects • If IP is set to an empty string and the HOST parameter is set to an empty string, the TIBCO Object Service Broker monitor process listens on all IP addresses associated with the machine where it is executing.
• If IP is not set to an empty string or the HOST parameter is not set to an empty string, the TIBCO Object Service Broker monitor process listens only to the specified IP address.
• If both IP and HOST are not set to empty strings, both parameters must specify the same IP address.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Solaris.
Abbreviated Name IPCK
Valid User Values 0 to 0x7FFF
Default 0x7900
Recommendations This must be a unique value for each TIBCO Object Service Broker monitor process.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name KEEL
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 85
KEEPOSMONLOGSpecifies whether to keep the monitor process log after the TIBCO Object Service Broker monitor process shuts down.
Valid User Values ALWAYS, ANY_MSG, WARNING_MSG, ERROR_MSG, NEVER
Default ALWAYS
Effects ALWAYS—Never deletes the log at Execution Environment shutdown.
ANY_MSG—Deletes the log file only if no messages were logged (other than the parameter listings).
WARNING_MSG—Deletes the log file only if no warning or error messages were logged.
ERROR_MSG—Deletes the log file only if no error messages were logged.
NEVER—Always deletes the log file at Execution Environment shutdown.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name KOSML
Valid User Values ALWAYS, ANY_MSG, WARNING_MSG, ERROR_MSG, NEVER
Default ALWAYS
TIBCO Object Service Broker Parameters
86 | Chapter 2 Understanding Execution Environment Parameters
KEEPSESSIONLOGSpecifies whether to keep the session log after the TIBCO Object Service Broker session shuts down.
Effects ALWAYS—Never deletes the log at process shutdown.
ANY_MSG—Deletes the log file only if no messages were logged (other than the parameter listings).
WARNING_MSG—Deletes the log file only if no warning or error messages were logged.
ERROR_MSG—Deletes the log file only if no error messages were logged.
NEVER—Always deletes the log file at process shutdown.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name KSL
Valid User Values ALWAYS, ANY_MSG, WARNING_MSG, ERROR_MSG, NEVER
Default ALWAYS
Effects ALWAYS—Never deletes the log at session end.
ANY_MSG—Deletes the log file only if no messages were logged (other than the parameter listings).
WARNING_MSG—Deletes the log file only if no warning or error messages were logged.
ERROR_MSG—Deletes the log file only if no error messages were logged.
NEVER—Always deletes the log file at session end.
Type Session parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 87
KEEPTTYLOGSpecifies whether to keep the ostty log after the ostty shuts down.
KERNELThe TIBCO Object Service Broker monitor process machine operating system name.
This parameter must not be modified by the user. It is used to report the operating system name.
Environment Open Systems.
Abbreviated Name KTTYL
Valid User Values ALWAYS, ANY_MSG, WARNING_MSG, ERROR_MSG, NEVER
Default ALWAYS
Effects ALWAYS—Never deletes the log at ostty shutdown.
ANY_MSG—Deletes the log file only if no messages were logged (other than the parameter listings).
WARNING_MSG—Deletes the log file only if no warning or error messages were logged.
ERROR_MSG—Deletes the log file only if no error messages were logged.
NEVER—Always deletes the log file at ostty shutdown.
Type ostty parameter.
User Modifiable Yes.
Environment Open Systems.
Valid User Values NT, UNIX
Effects Indicates the operating system name
Type Execution Environment initialization parameter.
User Modifiable No.
TIBCO Object Service Broker Parameters
88 | Chapter 2 Understanding Execution Environment Parameters
LIBRARYThe name of the local library for rules calls.
LOGFILEMSGTYPESThe types of messages to be written to the log file.
Environment All.
Abbreviated Name L
Valid User Values A string of up to 8 characters in length.
Default None
Effects The library specified here is searched when SEARCH=L is specified.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name LFMT
Valid User Values One or more of the following, each separated by a single space: INFORMATION, LOG, WARNING, ERROR; or an empty string meaning that no message is to be written
Default Empty string
Effects INFORMATION—Informational messages
LOG—Audit log messages
WARNING—Warning messages
ERROR—Error messages
Type System parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 89
LOGFILEPATHThe default file system location of the log file.
LOGONRULENAMEThe rule to be executed when a session starts.
Environment Open Systems.
Abbreviated Name LFP
Valid User Values A string of up to 255 characters in length.
Default Windows: %OS_ROOT%\log
Solaris: ${OS_ROOT}\log
Recommendations To reduce fragmentation on the database disk, specify a location on a disk separate from the one used to store TIBCO Object Service Broker database files.
Type System parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values A string between 3 and 16 characters in length.
Default LOGONHURON
Recommendation Use the default.
Effects If your site defines an alternate rule to the default LOGONHURON rule, the alternate rule must be available in your search path. If it is in your site library, the SEARCH parameter must be set to I. If the rule is in the user’s local library, the SEARCH parameter must be set to L. The alternate rule must also have the same number of arguments as the LOGONHURON default rule.
The login rule is responsible for implementing the behavior of the ACTION and RULE parameters.
TIBCO Object Service Broker Parameters
90 | Chapter 2 Understanding Execution Environment Parameters
MAXEEThe maximum number of Execution Environments that the TIBCO Object Service Broker monitor process can simultaneously execute.
MAXSESSIONThe maximum number of sessions that the Execution Environment can execute simultaneously.
Related Topics Refer to ACTION on page 30 and RULE on page 121 for more information.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name MEE
Valid User Values 1 to 32767
Default 100
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name MXS
Valid User Values 1 to 2147483647
Default 1
Effects Another instance of the Execution Environment is started when the maximum number of sessions for an instance is reached.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 91
MDLThe model Execution Environment communications identifier.
Related Topics Refer to INSTANCE on page 81 and EENAME on page 61 for more information.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS, all z/OS servers.
Abbreviated Name MD
Valid User Values A string of up to 8 characters in length.
Default OSB9999
Recommendation Coordinate with Communications Support, to ensure acceptability by VTAM.
Effects • The identifier must be available even when z/OS Cross Memory Services are being used.
• If EENAME is specified, the value for EENAME overrides the value for the MDL parameter. Refer to EENAME on page 61 for more information about the EENAME parameter.
• If you specify a value of the form AAAnnn, that is, one that ends in numeric characters, communications tries to open an identifier of AAA001, AAA002, and so on, until either it finds an available ID or the pool of names is exhausted.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about specifying the application identifier model.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
92 | Chapter 2 Understanding Execution Environment Parameters
MONHOSTThe host name or IP address of the TIBCO Object Service Broker monitor process.
MONLOGThe name of the log file for the TIBCO Object Service Broker monitor process.
Environment Open Systems.
Abbreviated Name MH
Valid User Values A string of up to 32 characters in length.
Default localhost
Effects If MONNAME is set to empty string, MONHOST and MONPORT are used to determine the address of the TIBCO Object Service Broker monitor process.
Type ostty parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name ML
Valid User Values A valid filename of up to 256 characters in length.
Default mon.name.mm.dd-hh.MM.ss.log, where:
• name is the name of the TIBCO Object Service Broker monitor parameter group (refer to NAME on page 95)
• From the TIBCO Object Service Broker monitor startup timestamp:
— mm is the month
— dd is the day
— hh is the hour
— MM is the minutes
— ss is the seconds
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 93
MONNAMEThe name of the TIBCO Object Service Broker monitor process to which ostty is to connect.
MONPORTThe socket port number of the TIBCO Object Service Broker monitor process.
Recommendations Use the default.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name MNM
Valid User Values A string of up to 32 characters in length.
Default An empty string.
Effects If this parameter is set to a non-empty string, ostty attempts to determine the address of the TIBCO Object Service Broker monitor process by using this name to look up the address of the process in the mon.prm file or, for Windows only, in the registry under the MON key.
Type ostty parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name MP
Valid User Values -2147483648 to 2147483647
Default 9068
TIBCO Object Service Broker Parameters
94 | Chapter 2 Understanding Execution Environment Parameters
MONTHSThe spelling to be used for names of the months of the year when converting a date field to a string.
MSGLOGMAXThe size of a user session message log in bytes.
Effects If MONNAME is set to empty string, MONHOST and MONPORT are used to determine the address of the TIBCO Object Service Broker monitor process.
Type ostty parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Value MN
Valid User Values A series of words of up to 16 characters in length each.
Default January, February, March, April, May, June, July, August, September, October, November, December
Related Topics On the TIBCO Object Service Broker z/OS platform, the $SYSDATE macro is used to set date masks. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about using the $SYSDATE macro.
Type Session startup parameter.
User Modifiable Yes.
Environment All.
Abbreviated Value z/OS: none
Open Systems: MLM
Valid User Values 32K to 2048M
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 95
NAMEThe name of the group of ostty, Execution Environment, session, or TIBCO Object Service Broker monitor process parameter assignments to be used.
Multiple groups of parameter assignments can be stored in the parameter sources. The NAME parameter identifies the start of a group of defaults within the parameter source. It is used to specify which group of defaults are to be used from the file or, for Windows only, in the registry under the appropriate key.
Default 2M
Recommendation Use the default.
Effects Limits virtual storage available to the session’s message log. The LOGLIMIT exception is raised if the allocated message log is exceeded.
z/OS storage: Non-fixed virtual storage, above the 16 MB line, managed by TIBCO Object Service Broker.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name N
Valid User Values A string of up to 32 characters in length.
Default default
Effects Used to index into the ostty, Execution Environment, session, or TIBCO Object Service Broker monitor parameter sources to set the remaining parameters.
TIBCO Object Service Broker Parameters
96 | Chapter 2 Understanding Execution Environment Parameters
NOALLOWSESSIONTIMEOUTLIMITRefer to ALLOWSESSIONTIMEOUTLIMIT, NOALLOWSESSIONTIMEOUTLIMIT on page 31.
NOBATCHCONSOLERefer to BATCHCONSOLE, NOBATCHCONSOLE on page 33.
NOBROWSERefer to BROWSE, NOBROWSE on page 35.
NOIBMFLOATRefer to IBMFLOAT, NOIBMFLOAT on page 77.
NOPRINTPORTRAITRefer to PRINTPORTRAIT, NOPRINTPORTRAIT on page 111.
NOPROFILERefer to PROFILE, NOPROFILE on page 115.
NOPROMPTRefer to PROMPT, NOPROMPT on page 115.
Type • ostty parameter
• Execution Environment initialization parameter
• Session startup parameter
• TIBCO Object Service Broker monitor parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 97
NORELOADPARAMSRefer to RELOADPARAMS, NORELOADPARAMS on page 120.
NOSESSIONLOGCLEARRefer to SESSIONLOGCLEAR, NOSESSIONLOGCLEAR on page 144.
NOSESSIONPARMLISTRefer to SESSIONPARMLIST, NOSESSIONPARMLIST on page 146.
NOSMFDETAILIf present, this parameter specifies that SMF detail records cannot be created. This parameter overrides SMFDETAIL, if SMFDETAIL is specified at the session level. The parameter can be specified only at installation time when creating default Execution Environment option modules.
NOSTAERefer to STAE, NOSTAE on page 156.
Environment z/OS.
Abbreviated Name NOSMF
Valid User Values n/a
Default none
Recommendation Specify to conform to site standards.
Effects If specified as a configuration parameter, System Management Facility (SMF) records are not created even if requested at Execution Environment or session startup.
Type Configuration parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
98 | Chapter 2 Understanding Execution Environment Parameters
NOSTOPRefer to STOP on page 162.
NOSTOPALLRefer to STAE, NOSTAE on page 156.
NOTESTRefer to TEST, NOTEST on page 178.
NOVERBOSERefer to VERBOSE, NOVERBOSE on page 188.
ONLINE, OFFLINESpecifies whether the session (Windows or Solaris) or the Execution Environment (z/OS) is to run in online mode and that screen I/O can take place using rules statements DISPLAY, UNTIL DISPLAY, and DISPLAY & TRANSFERCALL.
Environment All.
Abbreviated Name ON, OFF
Valid User Values ONLINE, ON, OFFLINE, OFF
Default z/OS: ONLINE
Open Systems: ONLINE for ostty, otherwise OFFLINE. The value is passed to the Execution Environment by the parent TIBCO Object Service Broker monitor process.
Recommendation z/OS: Use the value appropriate to the session:
• ONLINE—for a session requiring screen interaction
• OFFLINE—for an Execution Environment in batch mode
Open Systems: This is a read-only parameter and should not be modified by a user.
Effects When OFFLINE, no screen I/O can take place.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 99
OSDIRThe name of the file that contains the location directory for Data Object Broker and TIBCO Object Service Broker monitor processes.
OSMONDOBThe default Data Object Broker name for the osee, as set by the TIBCO Object Service Broker monitor process.
Type z/OS:
• Configuration parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable z/OS: Yes.
Open Systems: No.
Environment Open Systems.
Abbreviated Name OD
Valid User Values A valid filename of up to 255 characters in length.
Default Windows: %OS_ROOT%\database\huron.dir
Solaris: ${OS_ROOT}/database/huron.dir
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Recommendation This is a read-only parameter and should not be modified by a user.
Related Topics Refer to DOB on page 55.
Type Execution Environment initialization parameter.
TIBCO Object Service Broker Parameters
100 | Chapter 2 Understanding Execution Environment Parameters
OSMONNAMEThe TIBCO Object Service Broker monitor name.
OSMONPORTThis non-user configurable Execution Environment parameter is set to the TIBCO Object Service Broker monitor listening TCP/IP port number.
OSMONPROCIDThe TIBCO Object Service Broker monitor process ID.
User Modifiable No.
Environment Open Systems.
Recommendation This is a read-only parameter and should not be modified by a user.
Type Execution Environment initialization parameter.
User Modifiable No.
Environment Open Systems.
Effects TIBCO Object Service Broker monitor process sets this Execution Environment parameter to its listening port number.
Related Topics Refer to PORT on page 103.
Type Execution Environment initialization parameter.
User Modifiable No.
Environment Open Systems.
Abbreviated Name OSMPID
Valid User Values -2147483648 to 2147483647
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 101
PASSWORDThe user’s login password to be passed to TIBCO Object Service Broker.
PEERSERVERIDThe name of the peer server within the Execution Environment to be started for servicing remote data access requests.
You can also name the Gateway for Files server with this parameter. For details on configuring the Gateway for the Files component, see the chapter “Installing and Using TIBCO Service Gateway for Files” in the TIBCO Object Service Broker Managing External Data manual.
Default This value is passed to the Execution Environment by the parent TIBCO Object Service Broker monitor process.
Recommendation This is a read-only parameter and should not be modified by a user.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name P
Valid User Values A string of up to 8 characters in length.
Open Systems: The value is case sensitive.
Default None
Type Session startup parameter.
User Modifiable Yes.
Environment z/OS: distributed Execution Environments (CICS and Native Execution Environments). To enable the server sessions to connect to the DOB, define the z/OS Data Object Broker (DOB) Resource Manager with the S6BTLADM tool.
TIBCO Object Service Broker Parameters
102 | Chapter 2 Understanding Execution Environment Parameters
PEERSERVERNUMThe number of peer servers within an Execution Environment to be started up for a Data Object Broker using the same startup parameters with the same SERVERID.
Valid User Values A string of up to eight characters in length.
Default DEFAULT0.
Recommendation Use the default value of DEFAULT0 unless you must distinguish between your peer servers.
Related Parameter PEERSERVERNUM.
Effects Setting one PEERSERVERID name, such as DEFAULT0, simplifies configuration and allows maximum sharing of peer-server sessions. Setting multiple PEERSERVERID names requires that you configure more settings to the z/OS Data Object Broker Resource Manager and the server name in the rule or table definition for the resource being accessed.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS: distributed Execution Environments (CICS and Native Execution Environments).
Valid User Values 0 to 512
Default 0
Recommendation Set up enough servers to accommodate the number of concurrent remote requests expected to be serviced by the associated Data Object Broker. Use this parameter instead of the obsolete REMOTESERVERNUM parameter.
Related Parameter PEERSERVERID.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 103
PORTThe number of the TIBCO Object Service Broker monitor socket port.
PRINTCLASSThe default JES SYSOUT class for output generated using TIBCO Object Service Broker print facilities.
Effects If not enough servers are available to serve concurrent remote requests, a request queue results in waiting time.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment Open Systems.
Valid User Values 1024 to 65535
Default 9068
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name CLASS
Valid User Values A-Z, 0-9 (a valid JES output class at your site)
Default A
Recommendation Specify a value that is valid for your JES and that provides the default printing characteristics required by TIBCO Object Service Broker output.
Effects When specified at session startup, the setting overrides the default established during Execution Environment initialization.
TIBCO Object Service Broker Parameters
104 | Chapter 2 Understanding Execution Environment Parameters
PRINTCOPYThe number of copies to print of a report generated by TIBCO Object Service Broker.
PRINTDATASETThe name of a file or existing data set to which a TIBCO Object Service Broker generated report is written.
Type • Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment All.
Abbreviated Name COPY
Valid User Values z/OS: 1 to nnn, where nnn is the maximum allowed COPIES value for your site’s JES.
Open Systems: 1 to 255
Default 1
Recommendation Use the default, unless more than 1 copy of a report is always required.
Effects When specified at session startup, the setting overrides the default established during Execution Environment initialization.
Type z/OS:
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
Environment All.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 105
PRINTDESTThe default printer destination for output generated by TIBCO Object Service Broker.
Abbreviated Name DATASET
Valid User Values Valid z/OS data set name
Open Systems: A valid filename of up to 256 characters in length.
Default z/OS: none.
Open Systems: An empty string.
Recommendation Specify this parameter when you want output generated by TIBCO Object Service Broker to be written to a data set rather than JES spool.
Effects When specified at session startup, the setting overrides the default established during Execution Environment initialization. PRINTDATASET takes precedence over PRINTDEST if both are specified.
You can specify PRINTDATASET for a specific online session in the MANAGE USERID screen.
z/OS: You can set PRINTDATASET using the $SETOPT shareable tool.
Related Topics Refer to PRINTDEST on page 105 for more information.
Type z/OS:
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name DEST
TIBCO Object Service Broker Parameters
106 | Chapter 2 Understanding Execution Environment Parameters
Valid User Values z/OS:
A string of between 2 and 18 characters in length, in this format:{<node><char>}<printer>
• <node> is optional and specifies the JES node where the output prints.
• <char> is required when node is specified. Otherwise, it is optional.
• <printer> is the JES name of the printer where the output prints. Use a period (.) when specifying the JES printer name; for example, N2.P57.
Windows:
A string of up to 256 characters in length, in this format:[\\machinename]\printername
A value of LOCAL results in using the Windows default printer.
• if you are using a Windows network printer, machinename indicates the computer on the network where the printer resides
• printername is the share name of the printer where you want to print
For example: \\sherbrook\printer1
Solaris:
A string of up to 256 characters in length, in this format:/printername/printqueuename
A value of LOCAL results in using the Solaris default printer.
• if you are using an IP printer, printername is the name or the IP address of the printer
• printqueuename is the name of the print queue associated with the selected printer
For example: /sherbrookprinter/ltrszqueue
Default z/OS: LOCAL
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 107
PRINTDIRECTIONThe source to be used to determine the destination of printer output.
Recommendation Specify this parameter when you want your output generated by TIBCO Object Service Broker to be printed at a destination other than your site’s default.
Effects • If specified in the parameters used to generate the Execution Environment environment default options module, all output generated by the Execution Environment is routed to the same destination for printing by default.
• If specified in the session login command, the value specified during Execution Environment initialization is overridden for the user specifying it.
PRINTDATASET takes precedence over PRINTDEST if both are specified.
You can specify PRINTDEST for a specific online session in the MANAGE USERID screen.
z/OS: You can set PRINTDEST using the $SETOPT shareable tool.
Related Topics Refer to PRINTDATASET on page 104 for more information.
Type z/OS:
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name DIRECTION
Valid User Values User Profile Settings, Printer, File
Default User Profile Settings
TIBCO Object Service Broker Parameters
108 | Chapter 2 Understanding Execution Environment Parameters
PRINTERRORLOGThe default option for printing or not printing the TIBCO Object Service Broker workbench information logs in a multi-user Execution Environment, that is, CICS or Native Execution Environment.
PRINTERRORLOG is ignored in single-user environments like TSO and Batch, when the TIBCO Object Service Broker error log is always printed.
Effects User Profile — The print output is directed to the values supplied in the print options fields in the TIBCO Object Service Broker User Profile. If this value is specified, the following parameters are also determined from the User Profile: PRINTCOPY. PRINTDATASET, PRINTDEST.
Printer — The print output is directed to the printer named in PRINTDEST.
File — The print output is directed to the file named in PRINTDATASET.
Related Topics Refer to PRINTCOPY on page 104, PRINTDATASET on page 104, and PRINTDEST on page 105 for more information.
Type Session startup parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name PERL
Valid User Values YES, NO
Default NO
Recommendation Specify the desired option for your Execution Environment.
Generally, it is preferable to not print the error log for a production system, support personnel preferring the error log to remain in the system. Developers, on the other hand, could prefer to see the error log printed.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 109
PRINTFCBThe name of a Forms Control Buffer (FCB) to be used when printing output generated by TIBCO Object Service Broker.
Effects When specified at Execution Environment start-up, the setting overrides the default value specified in the configuration module.
When specified at session start-up, the setting overrides the default established during Execution Environment initialization.
When specified via the $SETOPT tool, the setting overrides the then current value in effect.
Type Execution Environment initialization parameter.
Session startup parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name FCB
Recommendation Use your site’s default as assigned by JES. If the TIBCO Object Service Broker report has special printing requirements such as a special pre-printed form, use the FCB for that form.
Effects • If specified in the parameters used to generate the Execution Environment environment default options module, all output generated by the Execution Environment is printed to the same FCB.
• If specified in the session login command, the value specified during Execution Environment initialization is overridden for the user specifying it.
Type • Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
110 | Chapter 2 Understanding Execution Environment Parameters
PRINTFORMThe name of a form on which JES SYSOUT output generated by TIBCO Object Service Broker is to be printed.
PRINTPAPERSIZEThe size of paper to be used for printing.
Environment z/OS.
Abbreviated Name FORM
Recommendation Use your site’s default as assigned by JES. If the report has special printing requirements such as a special pre-printed form, specify that particular form name.
Effects • If specified in the parameters used to generate the Execution Environment environment default options module, all output generated by the Execution Environment is printed using the same form.
• If specified in the session login command, the value specified during Execution Environment initialization is overridden for the user specifying it.
Type • Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment Windows.
Abbreviated Name PAPERSIZE
Valid User Values 10x14 11x17 5FOLIO A3A4 A4SMALL A5 B4CSHEET DSHEET ENV_5 ENV_9ENV_10 ENV_11 ENV_12 ENV_14ENV_DL ESHEET EXECUTIVE FANFOLD_STD_GERMAN FANFOLD_US LEDGER LEGALLETTER LETTERSMALL NOTE QUATROSTATEMENT TABLOID
Default LETTER
Type Session startup parameter.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 111
PRINTPORTRAIT, NOPRINTPORTRAITSpecifies whether to use portrait as the paper orientation for printing.
PRINTSPOOLCLASSThe default intermediary JES SYSOUT class for the SPOOLSTRIP job in a multi-user Execution Environment such as the Native Execution Environment or in a CICS region.
User Modifiable Yes.
Environment Windows.
Abbreviated Name PORTRAIT, NOPORTRAIT
Valid User Values PRINTPORTRAIT, PORTRAIT, NOPRINTPORTRAIT, NOPORTRAIT
Default PRINTPORTRAIT
Type Session startup parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name SPOOLCLASS
Valid User Values A-Z, 0-9 (a valid JES output class at your site)
Default A
TIBCO Object Service Broker Parameters
112 | Chapter 2 Understanding Execution Environment Parameters
PRINTUCSThe name of a universal character set (UCS) to be used to print the JES SYSOUT output generated by TIBCO Object Service Broker.
Recommendation Specify a value that is valid for your JES and that provides the default Intermediary JES SYSOUT class required by the TIBCO Object Service Broker SPOOLSTRIP job.
If running in JES2 in a multi-user environment, such as CICS or a native Execution Environment, do not specify a print class that is HELD. When a print request tries to use a HELD class, an IEFSSREQ error occurs and the print request fails.
Use the JES2 command $DOUTCLASS to display the characteristics of the SYSOUT classes. This is shown by the values for the CLASS OUTDISP=(normal_disposition, abnormal_disposition).
The following definition for SYSOUT=A is inappropriate for use in PRINTSPOOLCLASS=A as shown by the JES2 display of the class features:$DOUTCLASS(A)$HASP842 OUTCLASS(A)$HASP842 OUTCLASS(A) OUTPUT=PRINT,BLNKTRNC=YES,$HASP842 OUTDISP=(HOLD,HOLD),TRKCELL=YES
PRINTSPOOLCLASS=W however is valid:$DOUTCLASS(W)$HASP842 OUTCLASS(W)$HASP842 OUTCLASS(W) OUTPUT=PRINT,BLNKTRNC=YES,$HASP842 OUTDISP=(WRITE,WRITE),TRKCELL=YES
Effects When specified, the setting overrides the default in the installation configuration module.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 113
PRINTXWTRThe name of an external writer (XWTR) to be used to print output generated by TIBCO Object Service Broker.
Abbreviated Name UCS
Recommendation Use your site’s default as assigned by JES. If the report has special printing requirements such as unique characters, specify that particular UCS name.
Effects • If specified in the parameters used to generate the Execution Environment environment default options module, all output generated by the Execution Environment is printed using the same character set.
• If specified in the session login command, the value specified during Execution Environment initialization is overridden for the user specifying it.
Type • Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment z/OS and Solaris.
Abbreviated Name XWTR
Valid User Values z/OS: n/a
Solaris: A string of up to 256 characters in length.
Default z/OS: none
Solaris: An empty string
Recommendation Use your site’s default. Specify this parameter only if the report has unique characteristics that require it to be printed by a special site supplied writer program.
TIBCO Object Service Broker Parameters
114 | Chapter 2 Understanding Execution Environment Parameters
See Also TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for Open Systems Installing and Operating for additional information about printing.
PROCESSIDThe operating system process ID of the Execution Environment.
Effects In z/OS:
• If PRINTXWTR is specified in the parameters used to generate the Execution Environment environment default options module, all output generated by the Execution Environment is printed using the same external writer. Normally standard printing services are used and this parameter is not specified.
• If PRINTXWTR is specified in the session login command, the value specified during Execution Environment initialization is overridden for the user specifying it.
For Solaris, PRINTXWTR takes precedence over PRINTDEST if both are specified.
Type z/OS:
• Execution Environment initialization parameter
• Session startup parameter
Solaris: Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name PID
Default The value is set by the parent TIBCO Object Service Broker monitor process.
Recommendation This is a read-only parameter and should not be modified by a user.
Type Execution Environment initialization parameter.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 115
PROFILE, NOPROFILESpecifies whether the user’s profile information stored within TIBCO Object Service Broker is to be merged by the startup rule with Execution Environment parameters at session startup.
PROMPT, NOPROMPTSpecifies whether to prompt the user for session parameters.
User Modifiable Yes.
Environment All.
Abbreviated Name PR, NOPR
Valid User Values PROFILE, PR, NOPROFILE, NOPR
Default PROFILE
Recommendation Use the default to take advantage of the user profile feature that sets the user’s session defaults at every login.
Effects If NOPROFILE, the user’s profile information that is stored within TIBCO Object Service Broker is not merged with session parameters.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
Environment z/OS.
Open Systems: applies only to ostty sessions.
TIBCO Object Service Broker Parameters
116 | Chapter 2 Understanding Execution Environment Parameters
QUARTERSThe format to be used for quarters of the year when converting a date field to a string.
REGIONTABLESIZEThe amount of storage to be allocated during Execution Environment initialization to bind table definitions and data.
Abbreviated Name z/OS: None
Open Systems: PRM, NOPRM
Valid User Values z/OS: Y, N, YES, and NO
Open Systems: PROMPT, PRM, NOPROMPT, NOPRM
Default z/OS: N
Open Systems: NOPROMPT
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems: applies only to server execution.
Abbreviated Name Q
Valid User Values A series of strings of up to 16 characters in length each.
Default 1Q, 2Q, 3Q, 4Q
Type Session startup parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values 48K to 16M
Default 196K
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 117
REGIONTRACEDetermines what Execution Environment components are traced.
Recommendation Specify a value large enough so that table data and definitions that are bound can reside in Execution Environment storage. Binding table definitions and data that are frequently accessed is part of a well-tuned system.
Effects The amount of storage defined for REGIONTABLESIZE is allocated from private, non-fixed, virtual storage above the 16 MB line.
Specifying a value that is too small to hold all the bound table data and definitions accessed by rules causes the non-bound data to be continually refetched from the Data Object Broker each time it is referenced. This results in increased rules transaction times, Data Object Broker overhead to refetch data, and increased Execution Environment virtual storage usage, as each user has their own copy of the table definition and data.
Specifying a large value provides the necessary storage for bound data and table definitions. References to this information are satisfied from the data and definitions in the Execution Environment and access to the Data Object Broker is not necessary. Transactions run faster and Data Object Broker overhead decreases.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values 0 to 2147483647
Default 31
TIBCO Object Service Broker Parameters
118 | Chapter 2 Understanding Execution Environment Parameters
REGIONTRACESIZEThe size, in bytes, of each Execution Environment internal system services trace buffer.
Recommendation Use the default. Indicates that only the following components are to be traced: RTH, SFR, EXR, CQH, OCP
This parameter is used in conjunction with the REGIONTRACESIZE parameter.
Modify only if directed to by TIBCO Support.
Effects Each bit of the binary representation of the parameter value corresponds to a single Execution Environment component for which the trace is to be activated.
Only the following components are currently defined for tracing: RTH, SFR, EXR, CQH, OCP, CSD, QMR, SRS, HAX, RCX, SNX, TMR, OAI, MSG, SMC, TAM, MEM, DYN, EDP, GAT, MOM.
• 0 — indicates that no components are to be traced
• 2147483647 — indicates that all components are to be traced
The higher the number of components being traced, the more useful the trace; however, the CPU utilization increases as more components are traced.
This information is useful to TIBCO Support in diagnosing TIBCO Object Service Broker system problems.
Related Topics Refer to REGIONTRACESIZE on page 118 for more information.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 1K to 16M
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 119
REGIONTYPEThe type of Execution Environment that is started.
Default 128K
Recommendation Use the default.
This parameter is used in conjunction with the REGIONTRACE parameter and must specify a non-zero value.
Modify only if directed by the TIBCO Support.
Effects By specifying a larger buffer you can get a greater amount of trace information recorded. This information is useful to the TIBCO Support in diagnosing TIBCO Object Service Broker system problems.
Related Topics Refer to REGIONTRACE on page 117 for more information.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values LOCAL and REMOTE
Default LOCAL
Effects REGIONTYPE=REMOTE must be coded in an IMS MPR. Specifying REMOTE causes TIBCO Object Service Broker to connect to a Native Execution Environment defined by the EENAME parameter to access full Execution Environment services, as well as Data Object Broker and external database server data.
For other environments, this parameter must have a value of LOCAL, which is the default setting.
TIBCO Object Service Broker Parameters
120 | Chapter 2 Understanding Execution Environment Parameters
REJECTSHUTISpecifies whether the multi-user Execution Environment should accept the SHUTI (shutdown immediately) command without a prior SHUT command.
When you specify REJECTSHUTI=N, the Execution Environment honors the SHUTI command and abnormally terminates all login sessions and shuts down the Execution Environment. This is not a good idea, as it can cause system abends. REJECTSHUTI=N is the default.
When you specify REJECTSHUTI=Y, the Execution Environment rejects the SHUTI command that is not preceded by a SHUT command. It serves as a warning that SHUTI should be used only when it is absolutely required.
RELOADPARAMS, NORELOADPARAMSReloads the Execution Environment and session parameter settings.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated Name None
Valid User Values Y, YES, N, NO
Default N
Recommendation Specify YES if you prefer a warning for SHUTI. Specify NO to retain the default behavior of no warning.
Effects When specified, the setting overrides the default in the installation configuration module.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 121
RULEThe name and arguments of the first application rule to be invoked after login rules processing completes. Does not apply to SDK (C/C++) or SDK (Java) sessions.
Abbreviated Name RLP, NORLP
Valid User Values RELOADPARAMS, RLP, NORELOADPARAMS, NORLP
Default NORELOADPARAMS
Effects RELOADPARAMS causes the configuration source parameters to be reloaded.
When RELOADPARAMS is specified with a TIBCO Object Service Broker monitor process, this process sends a RELOADPARAMS request to the TIBCO Object Service Broker monitor process connected to the same PORT.
Related parameters
Refer to PORT on page 103 for additional information.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name R
TIBCO Object Service Broker Parameters
122 | Chapter 2 Understanding Execution Environment Parameters
Valid User Values All:
The rule specification can be in one of the following forms:
rulename
or
rulename(argument1, argument2,...)
where:
• rulename is a valid name of a rule located in one of the libraries specified by the SEARCH parameter.
• argumentn is the value of the nth argument.
In the example:
RULE=ABC(1,’X’,’46’)
the first argument is the number 1; the second argument is the string 'X'; and the third argument is the string of length 2 whose value is '46’
z/OS: No limit (refer to Length of Parameter Lists on page 12)
Open Systems: A string of up to 512 characters in length.
Default z/OS: Seamless clients and non-seamless offline clients use the default rule name specified in the user profile.
Open Systems: An empty string. For ostty clients, if a session parameter string does not contain a rule name, a start-up rule from the user profile is used, unless NOPROFILE is also specified. If the user profile contains an empty rule name, SESSMGR (workbench) is called.
For SDK (C/C++) and SDK (Java): the RULE parameter has no effect.
Recommendation Use this parameter to specify a rule to run after TIBCO Object Service Broker session startup.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 123
Effects z/OS:
If the RULE parameter is defaulted or overridden by a rule name specification, the named rule is run from the library, as determined by the SEARCH parameter, using the method specified in the ACTION parameter, in the transactional environment specified by the BROWSE and TEST parameters.
If the RULE parameter is not specified for an ONLINE non-seamless client, the rule specified in the user profile is run before the menu specified in the profile appears.
Open Systems:
This parameter specifies a rule to be invoked after session startup. If the value of the parameter is not empty, the following takes place:
• A transaction with default flags is created. The default flags are defined by the BROWSE, NOBROWSE; TEST, NOTEST; and SEARCH session parameters.
• The rule runs.
• After the rule completes, the session ends.
If the value of the parameter is empty and NOPROFILE is not present in the session parameter string, the following happens:
• A transaction with BROWSE, TEST, and SEARCH=S is created and the SESSMGR rule is called.
• If the startup rule field of the user profile is not empty, SESSMGR invokes this rule. The invocation method depends on the ACTION session parameter. The transaction flags for ACTION=E (execute) and ACTION=T (transfercall) are the session defaults (BROWSE/NOBROWSE, TEST/NOTEST, and SEARCH session parameters).
• After the rule runs, a menu specified in the user profile appears.
TIBCO Object Service Broker Parameters
124 | Chapter 2 Understanding Execution Environment Parameters
RULESIZEThe amount of storage to be allocated to bind rules.
SEARCHThe library search environment for the first rule to be executed.
Related Topics Refer to TIBCO Object Service Broker Managing Security for more information on the startup rule field in the user profile, as well as to ACTION on page 30 and to LOGONRULENAME on page 89.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name RSZ
Valid User Values 0 to 2048M
Default 1.75M
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name SEA
Valid User Values S, I, L
Default S
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 125
Recommendation Use S, which is the default, or I. Specify I or L only when one or more required rules reside in the site’s installation or local library. Specification L causes overhead in finding rules; the local library must be searched whenever a new rule name is encountered for the first time in a transaction. Significant performance benefits can be realized when frequently used rules are promoted to the installation library.
TIBCO Object Service Broker Parameters
126 | Chapter 2 Understanding Execution Environment Parameters
Effects If SEARCH=S is specified, TIBCO Object Service Broker searches for rules, external routines, or builtins in the following order:
1. The builtin library
2. The system library, as specified by the SYSLIB parameter
3. The external routines library that is contained in the ROUTINES table
If SEARCH=I is specified, TIBCO Object Service Broker searches for rules, external routines, or builtins in the following order:
1. The installation library, as specified by the INSTLIB parameter
2. The builtin library
3. The system library, as specified by the SYSLIB parameter
4. The external routines library that is contained in the ROUTINES table
If SEARCH=L is specified, TIBCO Object Service Broker searches for rules, external routines, or builtins in the following order:
1. The local library, as specified by the LIBRARY parameter
2. The installation library, as specified by the INSTLIB parameter
3. The builtin library
4. The system library, as specified by the SYSLIB parameter
5. The external routines library that is contained in the ROUTINES table
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 127
SECACLSIZEThe size of the discretionary permission access control list area for access-securable TIBCO Object Service Broker objects: libraries, screens, tables, object sets, and reports.
Type z/OS:
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 2K to 16M
Default 64K
Recommendation Use the default.
Effects This parameter allocates an area for containing information that allows or disallows access to objects based on the user ID and current group set for the user. Each entry in this area occupies 35 bytes. If the area fills up, it is flushed and restarted, resulting in increased overhead.
Storage: This requires non-fixed virtual storage above the 16 MB line; the larger a value that you specify, the more storage is required.
Measurement Execute the SECSTATS rule. The area defined by this parameter is shown as OBJACL. The Storage Used field indicates how much of this area is currently in use.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information on SECSTATS.
TIBCO Object Service Broker Parameters
128 | Chapter 2 Understanding Execution Environment Parameters
SECADMINSIZEThe size of a table of users and their security administrators.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS
Valid User Values 2K to 2M
Default 14K
Recommendation For a single-user Execution Environment, the minimum value provides more than enough space. For multiple users, start with the default value and tune from there.
Effects In a multiple session situation, the amount of space required is 18 bytes for each user logged in to TIBCO Object Service Broker. If the area fills up, it is flushed and restarted, resulting in increased overhead.
Storage: This requires non-fixed virtual storage above the 16 MB line; the larger a value that you specify, the more storage is required.
Measurement Execute the SECSTATS rule. The area defined by this parameter is shown as USERSEC.
The Storage Used field indicates how much of this area is currently in use. The number of times the list has flushed should be zero; otherwise, it is indicates that space allocation is too small.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information on SECSTATS.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 129
SECAUDITLOGThe accesses to non-dictionary (MetaStor) tables to be logged to the AUDITLOG. You can have different settings for Execution Environments on the same Data Object Broker.
z/OS: SECAUDITLOG can be set only using the EECONFIG member in the CNTL data set.
Environment All.
Abbreviated Name z/OS: none
Open Systems: SAL
Valid User Values STRICT, NORMAL, DISABLED
Default z/OS: STRICT
Open Systems: NORMAL
Recommendation • Use SECAUDITLOG=DISABLED for batch jobs and promotions.
• Use SECAUDITLOG=STRICT for production systems.
• Use SECAUDITLOG=NORMAL for test and development systems.
TIBCO Object Service Broker Parameters
130 | Chapter 2 Understanding Execution Environment Parameters
SECCLASSThe security class of the request defined by TIBCO Object Service Broker for archiving the Audit Log.
Effects • SECAUDITLOG=STRICT means all accesses are logged for objects with the log accessed flag set to Y; update accesses by level-7 users are logged, regardless of the setting of the Log Accesses flag set in the Security Manager.
• SECAUDITLOG=NORMAL means all accesses are logged for all objects with the Log Accesses flag set to Y. When Log Accesses is set to N, table accesses are not logged.
• SECAUDITLOG=DISABLED means that nothing is recorded except for an initial entry indicating that SECAUDITLOG is disabled.
• With all the above settings per login and logout, for each TSO and batch user there is one entry per execution; for CICS and Native Execution Environments there is one entry per user per address space.
Related Topics Refer to TIBCO Object Service Broker Managing Security for more information about the audit log facility and TIBCO Object Service Broker for z/OS Installing and Operating about EECONFIG and the CNTL data set.
Type z/OS: Configuration parameter.
Open Systems: Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS
Valid User Values 1- to 8-character security class name.
Default S6BEE
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 131
SECOBJSIZEThe size of the TIBCO Object Service Broker object security information area. This area holds entries that contain object name, owner, and security classification.
Related Topics Refer to SECREQUESTOR on page 132, SECSUBSYSTEM on page 133 and TIBCO Object Service Broker Managing Security.
Type Configuration parameter.
User Modifiable No
Environment z/OS.
Valid User Values 800 to 16M
Default 40K
Recommendation Use the default.
Effects Each entry in this area uses 42 bytes. If the area fills up, it is flushed and restarted, resulting in increased overhead.
Storage: This requires non-fixed virtual storage above the 16 MB line; the larger a value that you specify, the more storage is required.
Measurement Execute the SECSTATS rule. The area defined by this parameter is shown as OBJSEC. The Storage Used field indicates how much of this area is currently in use.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information on SECSTATS.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
132 | Chapter 2 Understanding Execution Environment Parameters
SECPACLSIZEThe size of the discretionary permission access control list area for parameterized tables. This area contains information to allow or disallow access to parameterized table instances based on the user’s user ID, group or ALL permission, when the table data is secured by individual parameter instances.
SECREQUESTORThe requestor name as defined by TIBCO Object Service Broker. for archiving the Audit Log
Environment z/OS.
Valid User Values 2K to 16M
Default 64K
Recommendation Use the default.
Effects Each entry in this area uses 102 bytes. If the area fills up, it is flushed and restarted, resulting in increased overhead.
Storage: This requires non-fixed virtual storage above the 16 MB line; the larger a value that you specify, the more storage is required.
Measurement Execute the SECSTATS rule. The area defined by this parameter is shown as TBLACL. The Storage Used field indicates how much of this area is currently in use.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS
Valid User Values 1- to 8-character security requestor name.
Default S6BEEOP
Related Topics Refer to SECCLASS on page 130, SECSUBSYSTEM on page 133, and TIBCO Object Service Broker Managing Security.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 133
SECSUBSYSTEMThe subsystem name as defined by TIBCO Object Service Broker for archiving the Audit Log.
SECURITYThe type of security used to verify user access to TIBCO Object Service Broker from an Execution Environment.
Type Configuration parameter.
User Modifiable No
Environment z/OS
Valid User Values 1- to 8-character security subsystem name.
Default S6B
Related Topics Refer to SECCLASS on page 130, SECREQUESTOR on page 132, and TIBCO Object Service Broker Managing Security.
Type Configuration parameter.
User Modifiable No
Environment All.
Abbreviated Name z/OS: none
Open Systems: SEC
Valid User Values INTERNAL, EXTERNAL, MIXED
Default INTERNAL
TIBCO Object Service Broker Parameters
134 | Chapter 2 Understanding Execution Environment Parameters
SECURITYSIZEThe size of the TIBCO Object Service Broker object security information area. This area holds entries that contain object name, owner, and security classification.
Effects • INTERNAL or null implies that TIBCO Object Service Broker internal security is used for user ID login verification. This is typically done because the external security environment cannot be trusted.
• EXTERNAL implies that an external security product is controlling access to TIBCO Object Service Broker. SAF security packages such as IBM RACF, CA-ACF2, and CA-Top Secret are supported on z/OS. Native security and the Generic Security Service (GSS) API are supported on Open Systems.
• MIXED causes the password to be verified against the TIBCO Object Service Broker password first. If this fails, it is then checked against the password in the external security system. This is useful where some user identifications are managed externally by the operating system security manager and others are defined only to TIBCO Object Service Broker.
Related Topics Refer to TIBCO Object Service Broker Managing Security for more information about the different types of security.
Type z/OS:
• Configuration initialization parameter
• Execution Environment initialization parameter
Open Systems: Execution Environment initialization parameter.
User Modifiable Yes.
If an Userid profile is set with EXT Security Mixed-case Password: Y, the security for that user is set as if this parameter was set with EXTERNAL regardless of its actual setting.
Environment Open Systems.
Abbreviated Name SSZ
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 135
SECUSERSIZEThe size of the user basic security information area. This area holds one entry for each user logged in to the address space.
Valid User Values 0 to 2048M
Default 1.75M
Recommendation Use the default.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values 2K to 2M
Default 14K
Recommendation Use the default.
Effects Each entry in this area uses 33 bytes. If the area fills up, it is flushed and restarted, resulting in increased overhead.
Storage: This requires non-fixed virtual storage above the 16 MB line; the larger a value that you specify, the more storage is required.
Measurement Execute the SECSTATS rule. The area defined by this parameter is shown as USRSEC. The Storage Used field indicates how much of this area is currently in use.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information on SECSTATS.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
136 | Chapter 2 Understanding Execution Environment Parameters
SERVERIDThe identifier for an external database server or Service Gateway for Files server. For details on configuring the Service Gateway for Files component, see the TIBCO Object Service Broker Managing External Data manual.
This identifier directs remote TIBCO Object Service Broker table accesses to a particular group of servers. Some table definitions enable you to specify a server identifier for routing requests to the correct server. For example, you might need to do so for VSAM files that are controlled by a particular CICS/TS Execution Environment (EE) server.
SERVERLOGPATHThe path for the peer server log files.
Environment All.
Abbreviated Name z/OS: none
Open Systems: SID
Valid User Values A string of up to 8 characters in length.
Default z/OS: none
Open Systems: An empty string
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name SLP
Valid User Values A string of up to 256 characters in length.
Default Windows: %OS_ROOT%\log
Solaris: ${OS_ROOT}/log
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 137
SERVERRETRIESThe maximum number of times the TIBCO Object Service Broker monitor process is to attempt to restart a peer or rules-based server after a severe server failure.
SERVERSz/OS: The maximum number of server sessions that are managed in this Execution Environment.
Open Systems: A string containing the set of servers to be started by TIBCO Object Service Broker monitor. Syntax is: ‘number1 sessionname1 number2 sessionname2 numberN sessionnameN’
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name SRT
Valid User Values 0 to 2048
Default 1000
Recommendation Use the default.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name z/OS: none
Open Systems: SRV
Valid User Values z/OS: 0 to 255
Open Systems: The validity of the values in the user string is not checked.
TIBCO Object Service Broker Parameters
138 | Chapter 2 Understanding Execution Environment Parameters
SERVERTYPEThe type of external database gateway to initialize including peer servers.
Examples z/OS: SERVERS=2
Open Systems: SERVERS='10 NodeA 12 NodeB'
Default z/OS: 0
Open Systems: An empty string
Recommendation z/OS: You must specify at least one when starting an external database server. If the SERVERBUSY exception is encountered frequently, consider increasing the value.
Open Systems: Each session parameter group (sessionnameN) must contain a non-blank SERVERTYPE server parameter.
Effects z/OS:
The higher the value of SERVERS, the more concurrent accesses can be made to the external database.
Open Systems:
The higher the number in numberN, the more concurrent accesses can be made to the external database via server sessionnameN.
Related Topics Refer to the appropriate Service Gateway manual for additional information about this parameter.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
Open Systems: TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment All.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 139
Abbreviation z/OS: none
Open Systems: ST
Valid User Values • ADA (Adabas)
• API (peer servers on the z/OS platform)
• DAT (Datacom)
• IMS (IMS/DB)
• IMSCICS (CICS DL/I)
• IMSDRA (IMSDRA)
• IMSDFS (IMSDFS)
• IM2DFS (IM2DFS)
• ORS (Oracle on the Windows and Solaris platforms)
• PRS (peer servers on the Open Systems platforms)
• SLK (ODBC on the Windows platform)
Default None
Related Topics Refer to the appropriate Service Gateway manual for further details about this parameter. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for further details about server types.
Type z/OS
• Configuration parameter
• Execution Environment initialization parameter
Open Systems: Execution Environment initialization parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
140 | Chapter 2 Understanding Execution Environment Parameters
SESSDSPXFRSCRMAXThe maximum amount of display and transfer (DISPLAY & TRANSFERCALL rules language statement) screen rows storage allowed for a user session.
SESSIONENDACTIONThe action to be performed when a TIBCO Object Service Broker session terminates. The action performed uses the SESSIONENDVALUE as the object of the action.
Environment z/OS.
Abbreviation SDXMAX
Valid User Values Minimum: 0; no maximum
Default 0
Recommendation Use the default, unless you need a limit to impose some restriction.
Effects A value of 0 means no limit.
This storage limit is the aggregate of all the transactions of a session.
You can change the setting during the session by calling the $SETOPT tool.
Related parameter TRANDSPXFRSCRMAX
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment z/OS: CICS and IMS TM Execution Environments.
Valid User Values • For CICS—START and XCTL
• For IMS TM—FORMAT and SWITCH
Default None
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 141
SESSIONENDVALUEThe CICS transaction ID or CICS program name or IMS TM screen name or IMS TM program name, depending on the action defined by the SESSIONENDACTION parameter.
Recommendation In conjunction with the SESSIONENDVALUE parameter, this parameter can be used to implement automatic control switching between TIBCO Object Service Broker and non-TIBCO Object Service Broker applications.
Effects • START requests a CICS transaction be automatically started after a TIBCO Object Service Broker session ends. The name of the transaction ID is specified with SESSIONENDVALUE or the $SETSESSIONEND tool.
• XCTL requests a program be executed automatically after a TIBCO Object Service Broker session ends. The name of the program to be invoked is specified by SESSIONENDVALUE or the $SETSESSIONEND tool.
• FORMAT requests that an IMS TM screen appear automatically after a TIBCO Object Service Broker transaction ends. The name of the screen to appear is specified by SESSIONENDVALUE or the $SETSESSIONEND tool.
• SWITCH requests than an immediate switch to a program be performed automatically after a TIBCO Object Service Broker session ends. The name of the program to be invoked is specified by SESSIONENDVALUE or the $SETSESSIONEND tool.
Related Topics Refer to TIBCO Object Service Broker Shareable Tools for more information on the $SETSESSIONEND tool.
Type Session startup parameter.
User Modifiable Yes (using the $SETSESSIONEND shareable tool).
Environment z/OS: CICS and IMS TM Execution Environments.
Valid User Values A string of up to 8 characters in length, 4 characters for CICS transaction IDs
TIBCO Object Service Broker Parameters
142 | Chapter 2 Understanding Execution Environment Parameters
SESSIONFILEMAXThe maximum number of data sets a user can have open at one time.
Default None
Recommendation In conjunction with the SESSIONENDACTION parameter, this parameter can be used to implement automatic control switching between TIBCO Object Service Broker and non-TIBCO Object Service Broker applications.
Effects This parameter is valid only if SESSIONENDACTION is specified.
Related Topics Refer to TIBCO Object Service Broker Shareable Tools for more information on the $SETSESSIONEND tool.
Type Session startup parameter.
User Modifiable Yes (using the $SETSESSIONEND shareable tool).
Environment z/OS.
Valid User Values 0 to the maximum at your location
Default 32
Recommendation Use the default.
Effects Performance: Data sets opened by one user could be inaccessible by another user; therefore, the higher the value specified, the more likely data set contention can occur among users.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 143
SESSIONINSTANCEThis non-user configurable session parameter is set to the session instance number.
SESSIONLOGThe name of the session log file.
Environment Open Systems.
Effects This parameter’s value can be used as a reference to the instance number of the current session.
Type Session startup parameter.
User Modifiable No.
Environment Open Systems.
Abbreviated Name SL
Valid User Values A valid filename of up to 256 characters in length.
TIBCO Object Service Broker Parameters
144 | Chapter 2 Understanding Execution Environment Parameters
SESSIONLOGCLEAR, NOSESSIONLOGCLEARSpecifies whether to clear the session log before a session is started.
Default For batch sessions: batch.name.mm.dd-hh.MM.ss.log
For all other session types: session.monname.eename.name.mm.dd-hh.MM.ss.eeinstance.instance.log
... where:
• name is the name of the session parameter group (refer to NAME on page 95)
• from the session startup timestamp:
— mm is the month
— dd is the day
— hh is the hour
— MM is the minutes
— ss is the seconds
• monname is the name of the TIBCO Object Service Broker monitor parameter group (refer to NAME on page 95)
• eename is the name of the Execution Environment parameter group (refer to NAME on page 95)
• eeinstance is the Execution Environment instance number
• instance is the session instance number
Recommendation Use the default.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name SLC, NOSLC
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 145
SESSIONMEMMAXThe maximum amount of session memory for a user. On z/OS it also controls the maximum amount of storage available for EES tables.
Valid User Values SESSIONLOGCLEAR, SLC, NOSESSIONLOGCLEAR, NOSLC
Default SLC
Type Session startup parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name z/OS: none
Open Systems: SMMX
Valid User Values z/OS: minimum: 320K; no maximum
Open Systems: 320K to 2048M
Default 16M
Recommendation Use the default.
Effects This storage limit has no effect on the maximum transaction memory set by the TRANMEMMAX parameter.
z/OS Storage: Non-fixed virtual storage above the 16 MB line.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
146 | Chapter 2 Understanding Execution Environment Parameters
SESSIONPARMLIST, NOSESSIONPARMLISTSpecifies whether to list the session parameter values in a session log.
SESSIONTYPEThe type of the session:
• BATCH for an osBatch session
• CLI for an SDK (C/C++), SDK (Java), and Object Integration Gateway sessions
• TTY for an ostty session
• PRS for a peer server
• RLS for an external database server
Environment Open Systems.
Abbreviated Name SPL, NOSPL
Valid User Values SESSIONPARMLIST, SPL, NOSESSIONPARMLIST, NOSPL
Default SESSIONPARMLIST
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Recommendation This is a read-only parameter and should not be modified by a user.
Type Session startup parameter.
User Modifiable No.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 147
SESSIONUSERIDThe session user ID for the rules server.
SESSNAMEThe NAME parameter to be used for a session.
Environment Open Systems.
Abbreviated Name SUID
Valid User Values A string of up to 8 characters in length.
Default An empty string.
Type Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name SN
Valid User Values A string of up to 32 characters in length.
Default default
Effects This parameter enables a user to specify the NAME parameter for the session. When a NAME parameter is specified on the ostty command line, or any other TTY source, the specification always refers to the ostty NAME parameter not the NAME parameter for the session. The SESSNAME parameter is used to set the NAME parameter for the session.
Type ostty parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
148 | Chapter 2 Understanding Execution Environment Parameters
SHAREDMEMADDRThe binding area address to be used by the osee processes.
SMFDETAILIf present, this parameter specifies that System Management Facility (SMF) records for TIBCO Object Service Broker (subtype 72) be created for each user session.
Environment Open Systems.
Abbreviated Name SMA
Valid User Values 0 to x7FFFFFFF
Default Windows: x08000000
Solaris: x04000000
Recommendation Use the default value.
Effects This value is used by the osee as the virtual memory address where it maps the binding area.
This value is passed on to the osee in the BINDINGAREASADDRESS parameter.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name SMF
Valid User Values n/a
Default No TIBCO Object Service Broker SMF detail records are written.
Recommendation Use SMFDETAIL when you want SMF records to be produced at the TIBCO Object Service Broker transaction level for reporting or debugging purposes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 149
SMFPERFORMANCEIf present, this parameter specifies that TIBCO Object Service Broker Execution Environment performance information be collected and reported in TIBCO Object Service Broker System Management Facility (SMF) subtype-52, -62 and -72 records (if requested).
Effects • If present as a session parameter and NOSMFDETAIL is not specified in the default option module, SMF detail records are created for the requesting user.
• If NOSMFDETAIL is specified, SMF detail records are not produced.
For SMF detail data to be reported, SMF data collection in the Execution Environment must be turned on by specifying the SMFTYPE parameter, and the Execution Environment must be authorized.
Performance: Running with SMF detail causes a significant overhead in the Execution Environment.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about generating SMF records.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated Name SMFP
Valid User Values n/a
Default No SMF performance information is collected.
Recommendation Use SMFPERFORMANCE only when you require the additional information.
TIBCO Object Service Broker Parameters
150 | Chapter 2 Understanding Execution Environment Parameters
SMFTYPEThe record number to be written by the Execution Environment.
Effects For performance data to be reported, SMF data collection in the Execution Environment must be turned on by specifying the SMFTYPE parameter and the Execution Environment must be authorized.
Performance: Running with SMFPERFORMANCE causes additional overhead in the Execution Environment.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about generating SMF records.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 0, 128 to 255
Default 0
Recommendation • When you want to collect SMF data for the Execution Environment (subtypes 50, 51, and 52) and the user sessions (subtype 60, 61, and 62), specify a number that is not currently being used by your site.
• If you are collecting SMF data for the Data Object Broker, specify the same number here.
Effects SMFTYPE=0 indicates that SMF records are not to be generated.
Performance: Generating SMF data from the Execution Environment involves minimal overhead.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 151
SORTEXTMEMMAXThe amount of storage that can be used by an external sort product. This value is specified in the sort options via the MAINSIZE sort product parameter.
SORTINTMEMMAXThe amount of storage that can be used by the TIBCO Object Service Broker internal sort. Allocated storage is released when the sort ends, rather than at the transaction end.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about generating SMF records.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 1K to 2G
Default 244K
Recommendation Use the default, unless you want to allow the external sort product to use more virtual storage. External sorting is invoked when seven or more fields are sorted.
Effects Performance: More virtual storage enables the sort to perform better, although it can increase your paging rate.
Storage: More non-fixed virtual storage above the 16 MB line is used.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
TIBCO Object Service Broker Parameters
152 | Chapter 2 Understanding Execution Environment Parameters
SORTINTNUMMAXThe maximum number of medium-sized internal sorts that can be active concurrently. Small sorts are not subject to this limit.
Valid User Values 200K to 2G
Default 4M
Recommendation Use the default.
Effects Performance: More virtual storage enables the sort to perform better.
Storage: More non-fixed virtual storage above the 16 MB line is used.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 1 to 99
Default 5
Recommendation Use the default.
Effects Performance: Allowing more internal sort tasks improves throughput if there is a lot of sort activity.
Storage: More non-fixed virtual storage above the 16 MB line is used.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 153
SORTINTPAGESMAXThe maximum number of pages for rows during an internal sort.
SORTPGMThe name of the site’s external sort program.
Environment All.
Abbreviated Name z/OS: none
Open Systems: SIPM
Valid User Values z/OS: 10 to no maximum
Open Systems: 1 to 2048M
Default z/OS: 500
Open Systems: 30
Recommendation Use the default.
Effects Performance: Allowing more pages can improve transaction performance, if sufficient memory is available.
z/OS storage: More non-fixed virtual storage above the 16 MB line is used.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
Open Systems: Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values A string of up to 8 characters in length.
Default SORT
TIBCO Object Service Broker Parameters
154 | Chapter 2 Understanding Execution Environment Parameters
SORTPRINTThe print option for external sort messages.
SORTUNITz/OS:
The DASD UNIT specification to be used for SORTWORK data sets.
Recommendation Specify the name of sort program to be used.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values ALL, CRITICAL, NONE
Default NONE
Recommendation Use the default, unless you want sort messages to be printed.
Effects This value is being passed to the external sort routine via the MSGPRT sort product parameter. Control statements are printed according to installation defaults.
• ALL—Specifies that all messages, except diagnostic, are printed to the message data set
• CRITICAL—Specifies that only critical messages are printed
• NONE—Specifies that sort messages are not printed
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 155
Open Systems:
The path used to allocate a temporary file for sorting.
SORTWORKFILESMAXThe number of SORTWORK data sets that can be used by the external sort package.
Environment All.
Abbreviated Name z/OS: none
Open Systems: SU
Valid User Values z/OS: A string of up to 8 characters in length.
Open Systems: A string of up to 256 characters in length.
Default z/OS: SYSDA
Windows: The value of the TMP environment variable if it is set, otherwise the value of the TEMP environment variable if it is set, otherwise the Windows directory.
Solaris: Value of the TMPDIR environment variable if it is set and is valid, otherwise the value of the P_tmpdir manifest found in stdio.h (which is usually /var/tmp/) if it is valid, otherwise /tmp/.
For Open Systems, Execution Environment start-up checks that the value represents a usable directory for temporary files.
Recommendation Use the default.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
Open Systems: Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
TIBCO Object Service Broker Parameters
156 | Chapter 2 Understanding Execution Environment Parameters
STAE, NOSTAESpecifies whether to enable the Execution Environment Extended Specified Task Abnormal Exit (ESTAE) routine for handling abnormal terminations.
Valid User Values 1 to 256
Default 3
Recommendation Use the default, unless you have very large sorts.
Effects This value is passed to the external sort package via the DYNALLOC sort parameter.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated Name SE, NOSE
Valid User Values STAE, SE, NOSTAE, NOSE
Default STAE
Recommendation Use the default, unless requested not to by the TIBCO Support.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 157
STANDBYNUMThe number of Execution Environment standby sessions.
Effects Enabling the STAE routine releases z/OS common system storage (SQA, CSA, and so on) acquired for Service Request Blocks (SRBs) should the Execution Environment abnormally terminate.
The NOSTAE parameter disables the ESTAE routine. Disabling the STAE routine retains z/OS common system storage (SQA, CSA and so on) acquired for Service Request Blocks (SRBs) should the Execution Environment abnormally terminate.
NOSTAE should be specified only when requested by the TIBCO Support for purposes of debugging. An IPL is then required to release the z/OS common system storage if the Execution Environment abnormally terminates.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated Name STANDBY
Valid User Values 0 to 4096
Default 0
TIBCO Object Service Broker Parameters
158 | Chapter 2 Understanding Execution Environment Parameters
STANDBYWAITSpecifies whether the Object Service Broker SDK start-session request is to wait for an available standby session if all the standby sessions are busy.
• Specifying NO causes the Object Service Broker SDK start-session request to be rejected with an error return code of x’04’ (Start session failed) and a reason code of x’4C’ (All standby sessions are busy).
• Specifying YES causes the Object Service Broker SDK start-session request to go on a wait queue for a standby session. The wait time is controlled by the STANDBYWAITLIMIT parameter. For details, see the description of that parameter.
Also, you can specify STANDBYWAIT as a parameter on the Object Service Broker SDK start-session request. In that case, the value specified in the request overrides that of STANDBYWAIT specified as a configuration or EE initialization parameter.
Recommendation Set according to your installation’s Call Level Interface (CLI) usage.
For Call Level Interface, SDK (C/C++), and SDK (Java) support, specify a minimum of 1.
To improve the performance of the SDK (C/C++) or SDK (Java) sessions, use the TASKINITNUM Execution Environment parameter to increase the number of Session Initiator Tasks. The number of Session Initiator Tasks is independent of the number of concurrent SDK (C/C++) or SDK (Java) client sessions. Refer to TASKINITNUM on page 171.
Effects Each API in session occupies one standby session until the API releases the session. If no standby session is available when an API calls for one, the API is queued to a wait queue.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 159
STANDBYWAITLIMITSpecifies the wait-time limit for an available standby session if all standby sessions are busy. When that limit expires, the Object Service Broker SDK start- session request terminates with an error Return Code of x’04’ (Start session failed) and a Reason Code of x’4C’ (All standby sessions are busy).
Abbreviated Name None.
Valid User Values Y, YES, N, NO.
Default Y.
Recommendation Use the default.
Effects Each installation must set the three parameters, STANDBYWAIT, STANDBYWAITLIMIT, and STANDBYWAITMSG, as appropriate, for the desired behavior.
Type Execution Environment parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name None.
Valid User Values 0 (no limit) to no maximum in minutes.
Default 0.
Recommendation Use the default.
Effects Each installation must set the three parameters, STANDBYWAIT, STANDBYWAITLIMIT, and STANDBYWAITMSG, as appropriate, for the desired behavior.
Type z/OS:
• Configuration parameter.
• Execution Environment.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
160 | Chapter 2 Understanding Execution Environment Parameters
STANDBYWAITMSGSpecifies whether to log the waiting-for-an-available-standby-session message in the system log.
• Specifying YES causes a warning message to be logged for every TIBCO Object Service Broker SDK start-session request that encounters the busy condition for all standby sessions.
• Specifying NO causes no logging of such warning messages. Also, no other indications show that the SDK start-session request is awaiting an available standby session; the request appears to be hung.
STATSBUFThe number of statistics buffers allocated for a session.
Environment z/OS.
Abbreviated Name None.
Valid User Values Y, YES, N, NO.
Default Y.
Recommendation Use the default.
Effects Each installation must set the three parameters, STANDBYWAIT, STANDBYWAITLIMIT, and STANDBYWAITMSG, as appropriate, for the desired behavior.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated Name STATSBUF
Valid User Values 0 to 2147483647
Default 200
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 161
STATUSDisplays current status information for the TIBCO Object Service Broker monitor process that is running on the host specified by the HOST parameter and listening on the port specified by the PORT parameter.
Recommendation Use the default value. To capture better information on the performance of an application, consider increasing this for a development or new production system. Each entry is 160 bytes in length. You can display the information using the TIBCO Object Service Broker Performance Monitor utility.
Effects Controls the number of buffers allocated for a session. When needed, these buffers are used each in turn.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance.
Type Execution Environment parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name ST
Valid User Values DETAIL, SUMMARY
TIBCO Object Service Broker Parameters
162 | Chapter 2 Understanding Execution Environment Parameters
STOPStops the TIBCO Object Service Broker monitor process that is running on the machine specified by the HOST parameter and listening on the port specified by the PORT parameter.
Effects If DETAIL is specified, the TIBCO Object Service Broker monitor process displays status information for the specified TIBCO Object Service Broker monitor process and exits immediately. The information is similar to the following:osmon at host=[] port=9068 is: online
name: [DEFAULT]:0pid: 204counters: max=1, total=1 (actual=1, starting=0, pending=0)map: 0
If SUMMARY is specified, the TIBCO Object Service Broker monitor process displays basic status information plus counts only for the specified TIBCO Object Service Broker monitor process and exits immediately. The information is similar to the following:
osmon at host=[] port=9068 is: onlineosee processes: 1sessions: 1
Related Topics Refer to HOST on page 76 and PORT on page 103. See also TIBCO Object Service Broker for Open Systems Installing and Operating.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Valid User Values STOP
Default An empty string
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 163
STOPALLStops all TIBCO Object Service Broker monitor processes currently executing on the given machine.
Effects When STOP is specified with a TIBCO Object Service Broker monitor process, this process initiates a stop sequence for the target TIBCO Object Service Broker monitor process and then exits immediately. When the target TIBCO Object Service Broker monitor process is stopped, any child Execution Environment processes are terminated immediately. For a more orderly shutdown, use the CLOSE parameter.
Related parameters Refer to HOST on page 76, PORT on page 103, and CLOSE on page 47 for additional information.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name SA
Valid User Values STOPALL, SA
Default An empty string
Effects When STOPALL is specified with a TIBCO Object Service Broker monitor process, this process initiates a stop sequence for all other TIBCO Object Service Broker monitor processes on the same system and then exits immediately. When a TIBCO Object Service Broker monitor process is stopped, all its child Execution Environment processes are terminated immediately.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
164 | Chapter 2 Understanding Execution Environment Parameters
STOPEEStops the Execution Environment process specified. This process is identified by the Execution Environment operating system process ID, or the EENAME:Execution Environment instance pair.
STOPSESSStops the session identified either by Execution Environment and session instance numbers, or by Execution Environment operating system process ID and session operating system thread ID.
Environment Open Systems.
Abbreviated Name SEE
Valid User Values The Execution Environment operating system process ID, or the EENAME:Execution Environment instance pair.
Default An empty string
Effects When STOPEE is specified with a TIBCO Object Service Broker monitor process, this process initiates a stop sequence for the target instance of Execution Environment and then exits immediately. When the target instance of Execution Environment is stopped, all its sessions are terminated immediately. If a more orderly shutdown is required, use the CLOSEEE parameter.
Related Topics For additional information, refer to CLOSEEE on page 47.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name SS
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 165
SVCThe type-3 TIBCO Object Service Broker SVC number assigned to be used in establishing an authorized Execution Environment. The parameter SVC was previously named HURONSVC. Even though both names are supported, the name HURONSVC is deprecated and might be discontinued in the future.
Valid User Values A valid value is in one of the following formats:
• EENAME:EEINSTANCE:SESSIONINSTANCE, for example:osMon STOPSESS=DEFAULT:0:0
• Execution Environment instance operating system process ID:session instance THREADID, for example:osMon STOPSESS=2028:1996
You can find the values for the different parts of these formats in the session log for the session you want to stop.
Default An empty string.
Effects If STOPSESS is specified, the TIBCO Object Service Broker monitor process initiates a stop sequence for the target session and then exits immediately.
Related Topics For additional information, refer to HOST on page 76 and PORT on page 103. Also refer to EEINSTANCE on page 60, INSTANCE on page 81, SESSIONINSTANCE on page 143, and THREADID on page 179. See also TIBCO Object Service Broker for Open Systems Installing and Operating.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values A valid SVC number between 200 and 255
Default None
TIBCO Object Service Broker Parameters
166 | Chapter 2 Understanding Execution Environment Parameters
SYNTAXVBLANKPADSpecifies whether fields whose external definition specifies type "V" will be padded with blanks or NULL (0x00) characters.
Recommendation For CICS or IMS TM, you must use this parameter if you require an authorized Execution Environment. Authorized Execution Environments are required to obtain SMF records, use cross memory communications, and clear the TIBCO Object Service Broker audit log.
Warning If the TIBCO Object Service Broker SVC is not going to be used to authorize the CICS Execution Environment, do not include this parameter in the EECONFIG jobstream input.
Effects SVC can be specified only in the default Execution Environment environment option modules. When the TIBCO Object Service Broker interface is activated in these environments, the appropriate parameter module is loaded, the SVC number is extracted, and the module deleted.
To run TIBCO Object Service Broker authorized, your site must have default option modules. These modules are created during the installation process by uncommenting steps in member EECONFIG in CNTL.
Related Topics For additional information, refer to CONFIGURATION on page 49.
Type Configuration parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name VPAD
Valid User Values Y, YES, N, NO.
Default Y
Recommendation Set to match the expected encoding of the field in question.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 167
SYSLIBThe name of the rules library that contains the rules shipped with the TIBCO Object Service Broker product.
Effects • YES causes all external syntax V fields to be padded with EBCDIC blanks (X'40'). This is the same behavior as on TIBCO Object Service Broker for z/OS systems, but is different from the usual Open Systems behavior.
• NO causes external syntax V fields to be padded with bytes of zero (X'00'). This is the standard behavior for TIBCO Object Service Broker for Open Systems, but is different from the behavior on z/OS.
Type Execution Environment initialization parameter.
User Modifiable No.
Environment All.
Abbreviated Name S
Valid User Values A string of up to 8 characters in length.
Default z/OS: COMMON
Open Systems:
• osMon and osBatch: COMMON.
• All other session types: The value is set by the parent TIBCO Object Service Broker monitor process.
Recommendation z/OS: Use the default.
Open Systems:
• For osMon and osBatch, use the default.
• For ostty, SDK (C/C++), and SDK (Java) sessions, this is a read-only parameter and should not be modified by a user.
TIBCO Object Service Broker Parameters
168 | Chapter 2 Understanding Execution Environment Parameters
TABLESIZEThe amount of storage to be allocated to bind table definitions and data.
Effects The SYSLIB parameter establishes the rules library to be searched for system rules that implement the TIBCO Object Service Broker shareable tools.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems:
• Execution Environment initialization parameter
• TIBCO Object Service Broker monitor parameter
User Modifiable z/OS: Yes.
Open Systems:
• osMon and osBatch: Yes
• All other session types: No
Environment Open Systems.
Abbreviated Name TSZ
Valid User Values 0 to 2048M
Default 196K
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 169
TAMBMAXThe maximum TAM row buffer size.
TAMBMINThe minimum TAM row buffer size.
Environment z/OS.
Valid User Values 4096 to 32766
Default 32766
Effects When the Execution Environment needs a buffer for a table row, it tries to create one of size TAMBMIN. If this size is too small, the Execution Environment creates one of size TAMBMAX.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated Name TAMBMIN
Valid User Values 128 to 4096
Default 4096
Effects When the Execution Environment needs a buffer for a table row, it tries to create one of size TAMBMIN. If this size is too small, the Execution Environment creates one of size TAMBMAX.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
170 | Chapter 2 Understanding Execution Environment Parameters
TAMBSTSThe buffer size for the directory of session (SES) and Execution Environment (EES) tables.
TASKEXECNUMThe number of interpreter tasks to be started at Execution Environment initialization.
Environment z/OS.
Valid User Values 4K to 64K.
Default 8K
Recommendation Use the default, 8K, if the number of SESSION (SES) tables used is less than 64. If the maximum number of SESSION (SES) tables used in a Execution Environment is n, set TAMBSTS to n *128.
Effects Each entry in SES directory is 128 bytes. The maximum number of SES directory entries is 32. For the default value (TAMBSTS=8K), if the 65th SES table in the Execution Environment is referenced, the transaction is terminated and an error is issued.
Storage: Non-fixed virtual above the 16 MB line.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values 0 to 130
Default 8
Recommendation Specify a value equivalent to the maximum number of TCBs that can be active at one time on your processor.
Increase the value if external routines and VSAM files are involved because TCB affinity is required for them.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 171
TASKFILENUMThe number of file I/O tasks to be started at Execution Environment initialization.
TASKINITNUMThe number of session initiator tasks to be started at Execution Environment initialization.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 0 to 25
Default 5
Recommendation Use the default, or reduce to the maximum number of TCBs that can be active at one time on your processor.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 2 to 50
Default 2
Recommendation Use the default, except when running in a Native Execution Environment. In this case, increase the number of session initiator tasks.
TIBCO Object Service Broker Parameters
172 | Chapter 2 Understanding Execution Environment Parameters
TASKMISCNUMThe number of miscellaneous tasks to be started at Execution Environment initialization.
TASKOPERNUMThe number of operator tasks to be started at Execution Environment initialization.
Effects If users log in to a Native Execution Environment through a VTAM session monitor without completing the entire login process before switching to another VTAM session, the session initiator task could go into a wait state until the login process completes. To remedy this situation, increase the number of session initiator tasks.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 0 to 25
Default 5
Recommendation Use the default, unless you want to decrease it to the number of TCBs that can be active concurrently on your processor.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 0 to 10
Default 1
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 173
TASKPOSIXNUMThe number of POSIX on tasks to be started at Execution Environment initialization.
TASKRCLINUMThe number of remote CLI tasks to be started at initialization of the Execution Environment.
Recommendation Use the default.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 0 and 1. Setting the value to 0 disables TIBCO Enterprise Message Service support for the Execution Environment.
Default 1
Recommendation If you do not use TIBCO Enterprise Message Service, set the parameter value to 0, otherwise use the default.
Type Execution Environment initialization parameter
User Modifiable Yes
Environment z/OS.
Valid User Values 0 to 50.
Default 2
Recommendation Use the default.
TIBCO Object Service Broker Parameters
174 | Chapter 2 Understanding Execution Environment Parameters
TASKSMFNUMThe number of System Management Facility (SMF) Writer Tasks to be started at Execution Environment initialization.
TASKSORTNUMThe number of sort tasks to be started at Execution Environment initialization.
Effects To improve the performance of the SDK (C/C++) or SDK (Java) sessions, set the TASKRCLINUM Execution Environment parameter to increase the number of remote CLI tasks. The number of those tasks is independent of the number of concurrent SDK (C/C++) or SDK (Java) client sessions.
Type • Configuration parameter.
• Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
Valid User Values 0 to 2
Default 0
Recommendation Set to 1, if you want SMF data collected.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Valid User Values 0 to 25
Default 2
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 175
TDSThe communications identifier (COMMID) of the Data Object Broker to which an Execution Environment or Message Switch is to connect.
Recommendation Set according to resource availability. Some sort products utilize Virtual Storage below the 16 MB line, and this should be considered.
Effects Too many sort tasks could degrade the performance of the Execution Environment. Not having enough could create bottlenecks for TIBCO Object Service Broker sessions that perform sorting.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated Name TD
Valid User Values A valid identifier of up to eight uppercase characters in length.
Default HURSRV
Effects Must be specified; otherwise, the Execution Environment cannot communicate with a Data Object Broker.
Related Topics The COMMID Data Object Broker parameter on page 208
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
TIBCO Object Service Broker Parameters
176 | Chapter 2 Understanding Execution Environment Parameters
TEMPPRIMARYCYLThe SVC99 dynamic allocation default primary space quantity for the temporary input and output data sets used for large sorts. Space is allocated in cylinders of the device type selected by the TEMPUNIT parameter.
TEMPSECONDARYThe SVC99 dynamic allocation secondary space quantity for the temporary input and output data sets used for large sorts. Space is allocated in cylinders of the device type selected by the TEMPUNIT parameter.
Environment z/OS.
Abbreviated Name
PRIMARY
Valid User Values 0 to the maximum at your location
Default 20
Recommendation Use the default, unless dictated otherwise by large sorts, for example.
Effects Too small a value can result in x37 abends.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment z/OS.
Abbreviated Name SECONDARY
Valid User Values 0 to the maximum at your location
Default 30
Recommendation Use the default, unless dictated otherwise by large sorts, for example.
Effects Too small a value can result in x37 abends.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 177
TEMPUNITz/OS:
The SVC99 dynamic allocation unit name to be used to allocate temporary data sets.
Open Systems:
The default path for creation of temporary files..
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment All.
Abbreviated Name z/OS: UNIT
Open Systems: TU
Valid User Values z/OS: A string of up to 8 characters in length.
Open Systems: A string of up to 255 characters in length.
Default z/OS: SYSDA
Windows: The value of the TMP environment variable if it is set, otherwise the value of the TEMP environment variable if it is set, otherwise the Windows directory.
Solaris: Value of the TMPDIR environment variable if it is set and is valid, otherwise the value of the P_tmpdir manifest found in stdio.h (which is usually /var/tmp/) if it is valid, otherwise /tmp/.
For Open Systems, Execution Environment start-up checks that the value represents a usable directory for temporary files.
Recommendation Use the default.
TIBCO Object Service Broker Parameters
178 | Chapter 2 Understanding Execution Environment Parameters
TEMPUNITCOUNTThe SVC 99 dynamic allocation unit and volume count for the temporary input and output data sets used for large sorts.
TEST, NOTESTSpecifies whether user sessions should be run in test mode.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
Open Systems: Execution Environment initialization parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviated Name UNITCOUNT
Valid User Values 1 to 59
Default 1
Recommendation One unit is more than adequate for general use. For specific applications requiring more than one unit, specify the number of units according to your space calculations.
Effects When set to a value greater than 1, this parameter allows the temporary data sets to span multiple volumes.
Type • Configuration parameter
• Execution Environment initialization parameter
User Modifiable Yes.
Environment All.
Abbreviated Name TE, NOTE
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 179
THREADIDThe operating system thread ID for the session.
Valid User Values TEST, TE, NOTEST, NOTE
Default NOTEST
Recommendation Do not specify, leaving the default value, unless TEST mode is specifically required.
Effects If TEST mode is on, changes to tables that are initiated by a rule are in effect only for the duration of the transaction. When the transaction ends or a COMMIT is issued, the updates are rolled back.
This does not apply to external data tables; updates to external data are not rolled back.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
Environment Open Systems.
Effects This value can be used in conjunction with STOPSESS to stop a session.
Related Topics Refer to STOPSESS on page 164.
Type Session startup parameter.
User Modifiable No.
TIBCO Object Service Broker Parameters
180 | Chapter 2 Understanding Execution Environment Parameters
THREADPOSIXNUMThe number of POSIX threads initialized under the POSIX task.
TIMEOUTLIMITThe time in minutes after which a terminal session terminates when there is no keyboard input.
Environment z/OS.
Valid User Values 1 to 200.
Default 50
Recommendation In a multiuser region, use the default unless a larger number of long running requests are active at any given time. An example of a long running request is a request waiting for data to be read from an TIBCO Enterprise Message Service queue.
Only 1 thread is required in a single user region.
Type Execution Environment initialization parameter
User Modifiable Yes.
Environment All: all terminal-based sessions.
Valid User Values 0 to 1440; 0 disables the feature
Default 0
Recommendation Set depending on site requirements.
Effects Causes terminal sessions idle for more than this limit to terminate.
Related Topics Refer to ALLOWSESSIONTIMEOUTLIMIT, NOALLOWSESSIONTIMEOUTLIMIT on page 31.
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 181
TN3270PORTThe number of the TIBCO Object Service Broker monitor socket port for a Telnet 3270 client.
TRANDSPXFRSCRMAXThe maximum amount of display and transfer (DISPLAY & TRANSFERCALL rules language statement) screen rows storage allowed for a transaction.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name TNPORT
Valid User Values 1024 to 65535
Default 9099
Effects The Execution Environment parameters that use the value in the PORT parameter cannot use the value in the TN3270PORT parameter. These include CLOSE, CLOSEEE, RELOADPARAMS, NORELOADPARAMS, STATUS, STOP, STOPEE, and STOPSESS.
Type TIBCO Object Service Broker monitor parameter.
User Modifiable Yes.
Environment z/OS.
Abbreviation TDXMAX
Valid User Values Minimum: 0; no maximum
Default 0
Recommendation Use the default, unless you need a limit to impose some restriction.
TIBCO Object Service Broker Parameters
182 | Chapter 2 Understanding Execution Environment Parameters
TRANMAXNUMThe maximum number of nested transactions for a session.
Effects A value of 0 means no limit.
This storage limit is the limit for each transaction of a session.
You can change the setting during the session by calling the $SETOPT tool.
Related parameter SESSDSPXFRSCRMAX
Type • Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
User Modifiable Yes.
Environment All.
Abbreviated Name z/OS: none
Open Systems: TMN
Valid User Values z/OS: 1 to 9
Open Systems: 1 to 99
Default 9
Recommendation Use the default. To run the workbench, this must be set to at least 4.
Effects z/OS storage: Non-fixed virtual storage above the 16 MB line.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
Open Systems: Execution Environment initialization parameter.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 183
TRANMEMMAXz/OS:
The maximum amount of transaction memory a single transaction can use.
Open Systems:
The maximum amount of transaction memory for a session.
User Modifiable Yes.
Environment All.
Valid User Values z/OS: Minimum is 364K to the maximum at your location
Open Systems: 364K to 2048M
Default z/OS: 16M
Open Systems: 16M
Recommendation Use the default.
Effects A transaction fails if it requests more memory than specified here.
z/OS storage: Non-fixed virtual storage above the 16 MB line
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
184 | Chapter 2 Understanding Execution Environment Parameters
TTYLOGFILEThe ostty client log file.
UNICODEDIRThe path to the directory that contains the Unicode configuration files.
Environment Open Systems.
Abbreviated Name TLF
Valid User Values A valid filename of up to 256 characters in length.
Default tty.name.mm.dd-hh.MM.ss.log, where:
• name is the name of the ostty parameter group (refer to NAME on page 95)
• from the ostty session startup timestamp:
— mm is the month
— dd is the day
— hh is the hour
— MM is the minutes
— ss is the seconds
Effects This log is written to the client machine.
Type ostty parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name UNIDIR
Valid User Values A valid directory path of up to 255 characters in length.
Must be the same as the UNICODEDIR Data Object Broker parameter.
Default None, TIBCO Object Service Broker uses its default information for Unicode processing.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 185
USERIDThe TIBCO Object Service Broker session user ID.
Effect The TIBCO Object Service Broker initialization code uses the files in this directory to configure Unicode processing.
In the absence of any of the files in the directory, TIBCO Object Service Broker uses the default information for that portion of Unicode processing: translation, casing, or collation.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about Unicode configuration.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name U
Valid User Values A string of up to 8 characters in length.
Default z/OS:
• The external logon ID; for example, if under TSO, the TSO logon ID; in batch, the user ID submitting the job; in CICS or IMS TM, the sign-on ID.
• There is no default for the Native Execution Environment.
Open Systems: An empty string.
Recommendation Use this parameter to override the default.
Related Topics Refer to TIBCO Object Service Broker for z/OS External Environments for more information about z/OS sessions invoked by other programs.
Effects A TIBCO Object Service Broker session does not start without a user ID.
TIBCO Object Service Broker Parameters
186 | Chapter 2 Understanding Execution Environment Parameters
VARLDELIMITERThe character to be used as the left delimiter for enclosing substituted variables in @SCHEDULEMODEL.
Type Session startup parameter.
User Modifiable Yes.
Environment All.
Abbreviated Name VLD
Valid User Values A string of 1 to 3 characters in length.
Default Left brace ({)
Recommendation If appropriate for your installation, use the default character (left brace). Otherwise, use a character or a string of up to three characters that is not used for other purposes.
Effects This parameter specifies the character string to be recognized by TIBCO Object Service Broker as the left delimiter for enclosing substituted variables in @SCHEDULEMODEL table instances.
Instances of @SCHEDULEMODEL that are supplied with TIBCO Object Service Broker use the left brace as the left delimiter for substituted variables. If your VARLDELIMITER setting is other than the default, you must edit the @SCHEDULEMODEL instances to be consistent with this parameter’s setting.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 187
VARRDELIMITERThe character to be used as the right delimiter for enclosing substituted variables in @SCHEDULEMODEL.
Environment All.
Abbreviated Name VRD
Valid User Values A string of 1 to 3 characters in length
Default Right brace (})
Recommendation If appropriate for your installation, use the default character (right brace). Otherwise, use a character or a string of up to three characters that is not used for other purposes.
Effects This parameter specifies the character string to be recognized by TIBCO Object Service Broker as the right delimiter for enclosing substituted variables in @SCHEDULEMODEL table instances.
Instances of @SCHEDULEMODEL that are supplied with TIBCO Object Service Broker use the right brace as the right delimiter for substituted variables. If your VARRDELIMITER setting is other than the default, you must edit the @SCHEDULEMODEL instances to be consistent with this parameter’s setting.
Type z/OS:
• Configuration parameter
• Execution Environment initialization parameter
• Session startup parameter
Open Systems: Session startup parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
188 | Chapter 2 Understanding Execution Environment Parameters
VERBOSE, NOVERBOSESpecifies whether informational messages are printed.
WORKINGDIRThe working directory.
YYCENTURYRANGEThe current century to be used for a date in a 2-digit year date semantic type field.
Environment Open Systems.
Abbreviated Name V, NOV
Valid User Values VERBOSE, V, NOVERBOSE, NOV
Default NOVERBOSE
Recommendation Change to VERBOSE if diagnosing configuration parameters
Type • Execution Environment initialization parameter
• TIBCO Object Service Broker monitor parameter
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name WD
Valid User Values A string of up to 255 characters in length.
Default The current directory.
Type Execution Environment initialization parameter.
User Modifiable Yes.
Environment Open Systems.
Abbreviated Name YY
TIBCO Object Service Broker Parameters
Descriptions of the Parameters | 189
Valid User Values 0 to 9999
Default 1980
Effects If YYCENTURYRANGE is not 0, for example a valid value such as 1970, and the input year is greater than or equal to the year portion of the YYCENTURYRANGE value, the century portion of the YYCENTURYRANGE value is used. If the input year is smaller than the year portion of YYCENTURYRANGE, the century portion of YYCENTURYRANGE+1 is used.
Related Topics On the TIBCO Object Service Broker z/OS platform, the $SYSDATE macro is used to set the YYCENTURYRANGE. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about using the $SYSDATE macro.
Type Execution Environment initialization parameter.
User Modifiable Yes.
TIBCO Object Service Broker Parameters
190 | Chapter 2 Understanding Execution Environment Parameters
TIBCO Object Service Broker Parameters
| 191
Chapter 3 Specifying Data Object Broker Parameters
This chapter describes how to specify Data Object Broker parameters.
Topics
• Introduction, page 192
• Setting the Values, page 193
• Format of the Parameters, page 195
• Parameter Summary, page 196
TIBCO Object Service Broker Parameters
192 | Chapter 3 Specifying Data Object Broker Parameters
Introduction
Purpose of This ChapterThis chapter describes how to set the Data Object Broker parameters on the platforms supported by TIBCO Object Service Broker. This chapter should be used in conjunction with TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for Open Systems Installing and Operating for your operating environment.
What are Data Object Broker Parameters?Data Object Broker parameters determine how updates are made to the MetaStor and Pagestore, control data integrity, and provide monitoring statistics. The following sections describe the how the parameters are set for each of the supported platforms. Each of the parameters, including their defaults, valid values and where appropriate, important usage information, are described in Chapter 4, Understanding Data Object Broker Parameters, on page 203.
Message Switch ParametersThe following Data Object Broker parameters are supported by Message Switches and have the same functionality as when applied to a Data Object Broker:
Messages Switches also support the Execution Environment parameter TDS. When used to configure Messages Switches, TDS represents the COMMID of the Data Object Broker to which the MSW will connect.
For details on configuring and using Message Switches, see Chapter 10, Using Multiple Data Object Brokers, TIBCO Object Service Broker for z/OS Installing and Operating.
• DESCACTION • MAXUSERS • ROUTWARN
• DESCERROR • ROUTACTION • WTOSUFFIX
• DESCINFORM • ROUTERROR • XCFGROUP
• DESCLOG • ROUTINFORM • XCFMEMBER
• DESCWARN • ROUTLOG • XCFWAITTIME
TIBCO Object Service Broker Parameters
Setting the Values | 193
Setting the Values
Where are the Parameters Specified?
z/OS
The OSRUNPRM member in the CNTL data set distributed with TIBCO Object Service Broker contains the Data Object Broker parameters used at initialization. This member contains the parameters set to default values. If you have the appropriate security privileges, you can edit the member by invoking the OSEMOD ISPF edit macro.
Open Systems
The crparm file in the database directory distributed with TIBCO Object Service Broker contains the Data Object Broker parameters used at initialization. This file contains detailed instructions on how to change the parameter values. If you have the appropriate security privileges, you can edit the file using a simple text editor such as Notepad.
The TIBCO Object Service Broker Database Administrator MenuYou can modify the Data Object Broker parameters using the TIBCO Object Service Broker Database Administrator menu. Refer to TIBCO Object Service Broker for Open Systems Installing and Operating.
Dynamically Modifying the ParametersSome of the parameters can be modified dynamically by an operator through the Administration menu (S6BTLADM/hrntladm) or through a command. Chapter 4, Understanding Data Object Broker Parameters, on page 203 identifies the modifiable parameters.
Command Format for z/OS
The format for commands to modify Data Object Broker startup parameters is:
MODIFY dob_jobname,Parm=parm_name=value
MODIFY or F The z/OS operator command
TIBCO Object Service Broker Parameters
194 | Chapter 3 Specifying Data Object Broker Parameters
Command Format for Open Systems
The format for commands to modify Data Object Broker startup parameters is:
hrncr Parm=parmname=value
dob_jobname The name of the batch job or the system task name under which the Data Object Broker is running
Parm= The TIBCO Object Service Broker operator command for changing a startup parameter
parm_name The name of the startup parameter you want to override
value The new value that you want to assign to the parameter
Parm= The TIBCO Object Service Broker operator command for changing a startup parameter
parm_name The name of the startup parameter you want to override
value The new value that you want to assign to the parameter
When you modify a Data Object Broker parameter that represents an interval (such as CHPTINTERVAL and SPININTERVAL), TIBCO Object Service Broker immediately ends any active interval of the corresponding type and starts a new interval using the new value.
TIBCO Object Service Broker Parameters
Format of the Parameters | 195
Format of the Parameters
Syntax of ParametersThe platform that you are using determines the syntax of the parameters.
z/OS
PARAMETER=VALUE,
for example:
CHPAGELIMIT=380,CHPTINTERVAL=360,CHTRANLIMIT=2000,CTABLESIZE=8,
Open Systems
PARAMETER=VALUE
for example:
CHKTRACE=YES # Checkpoint traceERRNOTRACE=YES # System and internal error trace
TIBCO Object Service Broker Parameters
196 | Chapter 3 Specifying Data Object Broker Parameters
Parameter Summary
Summary of Data Object Broker Parameters
An X in the Change column indicates that a parameter is operator modifiable. If marked X (NR), the parameter can be modified, but this is not recommended.
ParameterEnvironment
ChangeSupportsMSWz/OS Windows Solaris
BWO X
CHKTRACE X X X
CHPAGELIMIT X X X X (NR)
CHPTINTERVAL X X X X
CHTRANLIMIT X X X X (NR)
CLOGRETRYINT X X X
COMMID X
CTABAGE X X
CTABLESIZE X X X
CTABRESIDENT X X X
DATAPAGELIMIT X X (NR)
DBPROFILE X X X X
DBSNAP X X
DESCACTION X X (NR) X
DESCERROR X X (NR) X
DESCINFORM X X (NR) X
DESCLOG X X (NR) X
TIBCO Object Service Broker Parameters
Parameter Summary | 197
DESCWARN X X (NR) X
DUPLEXLOGFAIL X
DUPUSERID X X
ERRNOTRACE X X X
ESTAE X
EVENTLOG X
FIXEDRPDPOOL X
GTFID X X
HAWKANAME X X
HAWKDAEMON X X
HAWKDNAME X X
HAWKNETWORK X X
HAWKPOLL X X
HAWKSERVICE X X
HEAPSIZE X X
IOTRACE X X X
JOURNALS X
LOCKBUFFERS X X X
LOCKTIMEOUT X X
LOGMESSAGE X X
MAXCONCURRENT X X
MAXDBMS X X
MAXDISPLAY X
MAXNODES X
ParameterEnvironment
ChangeSupportsMSWz/OS Windows Solaris
TIBCO Object Service Broker Parameters
198 | Chapter 3 Specifying Data Object Broker Parameters
MAXOPERATORS X X
MAXQUERY X
MAXRESOURCES X
MAXTDSEXTENTS X X
MAXTHREADS X
MAXUSERS X X X X
MAXVSAMC X
MSGSIZE X X
MSGTRACE X X X X
NETVIEWBASE X X
NODENAME X X X
OPERATOR X X
PAGESWEEPACTION X X
PAGESWEEPLIMIT X X
PEERS X X
PRIVILEGED X X
REMOTEDUP X X
RESAGE X X
RESIDENTHASHSIZE X
RESIDENTPAGES X X X
ROUTACTION X X (NR) X
ROUTERROR X X (NR) X
ROUTINFORM X X (NR) X
ROUTLOG X X (NR) X
ParameterEnvironment
ChangeSupportsMSWz/OS Windows Solaris
TIBCO Object Service Broker Parameters
Parameter Summary | 199
ROUTWARN X X (NR) X
RSCSCHEDULES X
SECCLASS X
SECREQUESTOR X
SECSUBSYSTEM X
SECSUBSYSTEM X X
SHAREDMALIGN X X
SHAREDMEMADDR X X
SHAREDMEMPERM X
SIXDATAPAGLIM X X
SMFRECORD X X (only once)
SMF13INTERVAL X X
SMF22INTERVAL X X
SMF23INTERVAL X X
SMF24INTERVAL X X
SMF25INTERVAL X X
SMF26INTERVAL X X
SMF27INTERVAL X X
SMF28INTERVAL X X
SMF47INTERVAL X X
SNAPCLASS X X
SNAPDSPREFIX X X
SNAPHOLD X X
ParameterEnvironment
ChangeSupportsMSWz/OS Windows Solaris
TIBCO Object Service Broker Parameters
200 | Chapter 3 Specifying Data Object Broker Parameters
SNAPOVERRIDE X X
SNAPQUERY X X X X
SNAPREMOTE X X
SNAPSUPPRESS X X
SNAPUNIT X X
SNAPVOLSER X X
SPINDSNAME X X
SPININTERVAL X X
SPINMEMBER X
SPINOPTION X
SPINSHELL X X
SRBMODE X
SSTRACE X X
STDERRTRACE X X X
STDOUTTRACE X X X
SVCTRACE X X X
SWAPPABLE X
SYNCTRACE X X X
SYSADMIN X X
TIMEOUTABEND X X
TIMEOUTSTART X X
TIMEOUTSTOP X X
TIMESTAMP X X
TRXREADLIMIT X X
ParameterEnvironment
ChangeSupportsMSWz/OS Windows Solaris
TIBCO Object Service Broker Parameters
Parameter Summary | 201
USEREXIT X
USEREXIT X X X
USERSHUTDOWN X
WORKINGSET X X X X
WTOCLASS X X
WTOCONSOLE X X
WTODELETE X X
WTOHOLD X X
WTOINTERVAL X X (NR)
WTOPID X X X
WTOREMOTE X X
WTOSOURCE X X X
WTOSUFFIX X X (if not previously set)
X
WTOSYSLOG X X
WTOTAG X X X
WTOTIME X X X
XCFGROUP X X
XCFMEMBER X X
XCFMODE X
XCFSTRUCTURE X X
XCFWAITTIME X X
XTABLESIZE X X X
ParameterEnvironment
ChangeSupportsMSWz/OS Windows Solaris
TIBCO Object Service Broker Parameters
202 | Chapter 3 Specifying Data Object Broker Parameters
TIBCO Object Service Broker Parameters
| 203
Chapter 4 Understanding Data Object Broker Parameters
This chapter describes the Data Object Broker parameters.
Topics
• Parameter Descriptions, page 204
TIBCO Object Service Broker Parameters
204 | Chapter 4 Understanding Data Object Broker Parameters
Parameter Descriptions
BWOSpecifies whether Backup While Open is supported.
CHKTRACESpecifies whether to make a checkpoint trace.
CHPAGELIMITThe threshold, in number of changed pages, that triggers a checkpoint.
Environment z/OS
Valid Values Y, N
Default N
Operator Modifiable
No
Environment Open Systems.
Valid Values Y and N
Default Y
Effects If CHKTRACE is set to Y (a trace is requested), a message is printed to the Data Object Broker log at the beginning and end of each checkpoint.
Operator Modifiable Yes.
Environment All
Valid Values Must be less than 15% of RESIDENTPAGES.
z/OS: 50 to 32767
Open Systems: 50 to 36695
TIBCO Object Service Broker Parameters
Parameter Descriptions | 205
Default 1000
Recommendation Use the default as a starting point, and then monitor the frequency of checkpoints. You can adjust this value in conjunction with CHTRANLIMIT to cause a moderate frequency of checkpoint activity during peak load times.
NOTE The value can be reduced by the Data Object Broker startup process if the redolog and cache are determined to be too small.
Effects A high frequency of checkpoints can have a negative effect on the overall performance of the Data Object Broker. However, the frequency should support your backup and recovery requirements.
Usage Notes z/OS:
• The journal must be large enough to hold 50 checkpoints, that is, 50*CHPAGELIMIT 4 KB pages.
• If the journal is too small, adjust CHPAGELIMIT accordingly or increase the size of the journal data sets.
All:
• CHPAGELIMIT must not exceed 15% of the resident pages value.
• The redolog must hold at least two complete checkpoints. See also, CHTRANLIMIT, on page 206.
Measurement z/OS: If collection of SMF records is enabled, a subtype 12 record is produced on a checkpoint. The field HU12PAG contains the number of physical pages updated during each checkpoint.
Operator Modifiable Yes, but modification is not recommended.
TIBCO Object Service Broker Parameters
206 | Chapter 4 Understanding Data Object Broker Parameters
CHPTINTERVALThe maximum time interval in minutes between checkpoints, before the Data Object Broker triggers another checkpoint.
CHTRANLIMITThe number of commits, issued from Execution Environments connected to this Data Object Broker, that cause it to take a checkpoint.
Environment All.
Valid Values 5 to 1440, and 0, which disables this feature
Default 360
Recommendation This feature should be used only when you want to set a maximum interval between checkpoints during periods of low activity.
Effects A high frequency of checkpoints can have a negative effect on the overall performance of the Data Object Broker. However, the frequency should support your backup and recovery requirements.
Measurement z/OS: If collection of SMF records is enabled, a subtype 12 record is produced on a checkpoint. These records contain the date and time of each checkpoint taken.
Operator Modifiable Yes.
Environment All.
Valid Values 0 to 3000
Default 2000
TIBCO Object Service Broker Parameters
Parameter Descriptions | 207
CLOGRETRYINTThe retry interval, in seconds, at which the Data Object Broker should attempt to resolve in-doubt distributed transactions.
Recommendation • Use the default as a starting point, and then monitor the frequency of checkpoints.
• You can adjust this value in conjunction with CHPAGELIMIT to cause a moderate amount of checkpoint activity during peak load times.
• Size your redolog for at least 2*(CHTRANLIMIT*32 KB)+4 KB.
Effects A high frequency of checkpoints can have a negative effect on the overall performance of the Data Object Broker. However, the frequency should support your backup and recovery requirements.
A value of 0 causes the actual value of CHTRANLIMIT to be set based on the calculated maximum capacity of the redolog ((size of redolog in bytes - 4096)/32768).
Measurement z/OS: If collection of SMF records is enabled, a subtype 12 record is produced on a checkpoint. The field HU12NTRX contains the number of commits processed during each checkpoint.
Operator Modifiable Yes, but modification is not recommended.
Environment Open Systems.
Valid Values 15 to 86400
Default 60
Recommendation Use the default.
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
208 | Chapter 4 Understanding Data Object Broker Parameters
COMMIDThe Data Object Broker communications identifier. If a user wants to connect to this Data Object Broker, the identifier must be specified as the TDS Execution Environment parameter.
CTABAGEThe CTABLE LRU-2 aging threshold.
Environment z/OS.
Valid Values A valid identifier of 1 to 8 uppercase characters in length
Default HURSRV
Recommendation Specify a valid communications application identifier dedicated to this Data Object Broker.
NOTE This identifier is required regardless of the communication method used, for example, VTAM, Cross Memory Services, or TCP/IP.
Related Parameters TDS on page 175.
Operator Modifiable No.
Environment Open Systems.
Valid Values 0 to 256
Default 20
Recommendation Use the default.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information on the LRU-2 algorithm.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 209
CTABLESIZEThe maximum size, in kilobytes, for CTABLEs, the internal representations of TIBCO Object Service Broker table definitions.
The size required depends on the complexity of the table definition.
CTABRESIDENTThe maximum number of table definitions, in CTABLEs, that can simultaneously reside in Data Object Broker storage.
Environment All.
Valid Values z/OS: 4 to 31
Open Systems: 4 to 32, in increments of 4
Default 8
Recommendation Use the default initially, and adjust if necessary. 8 KB supports approximately 150 fields.
The ESTIMATETBLDFN tool provides an approximation of CTABLE size required for table definitions.
Effects If the CTABLESIZE is too small to accommodate a table definition, the transaction requesting the table definition fails.
The actual amount of storage allocated by the Data Object Broker for CTABLEs is CTABLESIZE * CTABRESIDENT. This CTABLE pool is above the 16 MB line on z/OS.
Related Topics Refer to TIBCO Object Service Broker Shareable Tools for more information about the ESTIMATETBLDFN tool.
Operator Modifiable No.
Environment All.
Valid Values 256 to 4096
TIBCO Object Service Broker Parameters
210 | Chapter 4 Understanding Data Object Broker Parameters
DATAPAGELIMITThe maximum number of data pages that can be updated within a transaction synchronization point process.
Default 1024
Recommendation Use the default initially and later adjust if necessary.
Effects Application response times and Data Object Broker CPU consumption will be reduced if requested CTABLES are resident and do not have to be built.
The actual amount of storage allocated by the Data Object Broker for CTABLEs is CTABLESIZE * CTABRESIDENT. This CTABLE pool is above the 16 MB line on z/OS.
Measurement z/OS:
SMF record subtypes 10 and 26 contain the number of requests for CTABLE definitions:
• Field HU10CTAB is the number of logical CTABLE requests
• Field HU10BLDC is the number of physical CTABLE requests. This means that the CTABLE had to be built to satisfy the request.
Try to attain the highest possible ratio of logical CTABLE requests to physical CTABLE requests.
All:
The TIBCO Object Service Broker Administration menu also displays the logical and physical CTAB values on the General Statistics screen.
Operator Modifiable No.
Environment z/OS.
Valid Values 32 to 512, and 999.
Specify 999 to limit the number of updated pages to the WORKINGSETSIZE parameter value.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 211
DBPROFILEThe action to be performed when an external resource commit fails and the resource has Fail Safe level set to 0.
This parameter has no effect if the resource has Fail Safe level set to 1.
Default 256
Recommendation Use 999 to avoid secondary indices becoming invalid.
Effects • Requests attempting to update more data pages than the specified value are aborted.
• The larger the value the more data pages can be physically held by a transaction, thus there is greater potential for interference between transactions.
Operator Modifiable Yes, but modification is not recommended.
Environment All.
Valid Values 0, 1
Default 1
Recommendation Use the default.
For serial commit with more than 1 external resource. If the first resource fails the commit terminates. If the second or subsequent commit terminates, fail continuance depends on the value for this parameter.
Effects • Value of 0 ignores external resource failures and continues with the commit cycle.
• Value of 1 terminates the commit cycle, abandoning all updates.
TIBCO Object Service Broker Parameters
212 | Chapter 4 Understanding Data Object Broker Parameters
DBSNAPSpecifies whether a snap dump is to be generated when an in-doubt transaction is detected.
DESCACTIONThe descriptor code to use for A (alert) WTO messages. This is also a Message Switch parameter.
Related Topics For more information about Fail Safe processing, refer to:
• TIBCO Object Service Broker for z/OS Managing Backup and Recovery or TIBCO Object Service Broker for Open Systems Managing Backup and Recovery
• TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for Open Systems Installing and Operating
Operator Modifiable Yes.
Environment: z/OS.
Valid Values Y and N
Default N
Recommendation Use the default.
Effects The resources required to schedule the snap dump are minimal and have little impact on the system.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16)
Default 0
Recommendation Set as appropriate.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 213
See Also The MVS Routing and Descriptor Codes IBM manual for code descriptions of WTO messages.
DESCERRORThe descriptor code to use for E (error) WTO messages. This is also a Message Switch parameter.
DESCINFORMThe descriptor code to use for I (information) WTO messages. This is also a Message Switch parameter.
Effects Descriptor codes determine how the system displays and deletes messages. If you do not specify a descriptor code, messages are issued as standard console messages.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16)
Default 0
Recommendation Set as appropriate.
Effects Descriptor codes determine how the system displays and deletes messages. If you do not specify a descriptor code, messages are issued as standard console messages.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16)
Default 0
Recommendation Set as appropriate.
TIBCO Object Service Broker Parameters
214 | Chapter 4 Understanding Data Object Broker Parameters
DESCLOGThe descriptor code to use for L (log) WTO messages. This is also a Message Switch parameter.
DESCWARNThe descriptor code to use for W (warning) WTO messages. This is also a Message Switch parameter.
Effects Descriptor codes determine how the system displays and deletes messages. If you do not specify a descriptor code, messages are issued as standard console messages.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16)
Default 0
Recommendation Set as appropriate.
Effects Descriptor codes determine how the system displays and deletes messages. If you do not specify a descriptor code, messages are issued as standard console messages.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16)
Default 0
Recommendation Set as appropriate.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 215
DUPLEXLOGFAILSpecifies whether to continue processing in the event of an I/O error on the primary or duplex redolog.
DUPUSERIDSpecifies whether to allow duplicate online user IDs to create sessions concurrently.
Effects Descriptor codes determine how the system displays and deletes messages. If you do not specify a descriptor code, messages are issued as standard console messages.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values END and CONTINUE
Default CONTINUE
Recommendation Set as appropriate.
Effects If DUPLEXLOGFAIL is set to CONTINUE, processing is based on a single image of the log.
Operator Modifiable No.
Environment: z/OS.
Valid Values Y and N
Default N
Recommendation If multiple user logins are required, specify Y.
If ISPF remote console servers are used, you should change the default ISPF command separator from a semicolon (;) to some other character. When DUPUSERID is Y, a semicolon separates the user ID from the user connection identifier.
TIBCO Object Service Broker Parameters
216 | Chapter 4 Understanding Data Object Broker Parameters
DYNAMICRESOURCESpecifies whether to allow resource entries to be created dynamically.
Effects Provides a unique identifier for user connections. The CANCELUSER, NOTRACE, and TRACEID operator commands refer to this identifier (COMMNUM). If DUPUSERID is set to Y, and one of these commands is issued for a user ID with multiple connections, the command returns messages that help you identify the connection you want to process. The messages prompt you to repeat the command with a unique identifier.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information on the CANCELUSER, NOTRACE, and TRACEID commands.
Operator Modifiable Yes.
Environment z/OS
Valid Values Y and N
Default Y
Recommendation Use the default unless required for security reasons.
Effects If set to N, all external gateway and Peer resources must be pre-defined using the Object Service Broker Administration utility.
If set to Y, allows Object Sevice Broker gateways to dynamically create resource manager entries when they connect to the DOB. In this mode only Peer resources need to be pre-defined using the Object Service Broker Administration utility.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 217
ERRNOTRACESpecifies whether to have system and internal error tracing. This traces the failure of system library calls showing the errno value at the point of failure.
ESTAESpecifies whether to enable the Data Object Broker Extended Specific Task Abnormal Exit (ESTAE) routine for handling abnormal terminations.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information on the Administration Utility, the pre-requisites paragraphs in the varous service gateway manuals for configuring the gateway resources, and Chapter 2 of the TIBCO Object Service Broker Managing Exterenal Data manual for configuring the service gateway for files resources.
Environment Open Systems.
Valid Values Y and N
Default Y
Recommendation Use the default.
Operator Modifiable Yes.
Environment z/OS.
Valid Values Y (yes) and N (no)
Default Y
Recommendation Use the default unless it is already in use by another product.
Effects If there is no ESTAE, memory could be held after abnormal termination.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
218 | Chapter 4 Understanding Data Object Broker Parameters
EVENTLOGSpecifies whether to log Execution Environment and Data Object Broker events.
FIXEDRPDPOOLSpecifies whether the Data Object Broker resident page directory is to be page fixed in storage.
Environment Windows.
Valid Values NONE, ERRORS, ALL
Default NONE
Effects NONE—Do not log any events
ERRORS—Only log error events
All—Log all events
Usage Notes Registry entries for event logging can be created only if the user starting the Execution Environment or Data Object Broker has administrator rights.
Operator Modifiable No.
Environment z/OS.
Valid Values Y and N
Default Y
Recommendation Use the default.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 219
GTFIDThe hexadecimal identifier for GTF trace records produced by the Data Object Broker when tracing is in effect.
Effects A Y value causes the Data Object Broker to page fix additional real storage frames based on the RESIDENTPAGES value. It provides a performance benefit in a production environment by keeping the resident page directory in memory.
However, this can cause additional z/OS paging to occur when real storage is constrained.
• If FIXEDRPDPOOL=N, the number of fixed frames required for the resident page directory is: Fixed Frames = (8*RESIDENTPAGES*1000/4096) rounded to next higher integer.
• If FIXEDRPDPOOL=Y, the number of additional fixed frames allocated for the resident page directory is: Fixed Frames = (80*RESIDENTPAGES*1000/4096) rounded to next higher integer.
Measurement Monitor z/OS paging rate before and after setting this parameter.
Related Parameters RESIDENTPAGES on page 242
Operator Modifiable No.
Environment z/OS.
Valid Values 00 to FF
Default AA
TIBCO Object Service Broker Parameters
220 | Chapter 4 Understanding Data Object Broker Parameters
HAWKANAMEThe TIBCO Hawk microagent application name. This name can be used by TIBCO Hawk Agents when applying a Hawk rulebase.
HAWKDAEMONThe TIBCO Hawk Rendezvous daemon and TCP port parameters.
Recommendation • Use the default unless it is already in use by another product.
• Start the GTF trace with USR(xx), where xx is the value of GTFID.
• Set the MSGTRACE and SSTRACE parameters to Y.
Operator Modifiable Yes.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default com.tibco.osb.dob.
Recommendation Set as appropriate to avoid Hawk microagent application name collisions.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk.
Related Parameters HAWKDNAME on page 221.
User Modifiable No.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default An empty string.
Effects Setting this parameter enables the Hawk microagent within the Data Object Broker.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 221
HAWKDNAMEThe TIBCO Hawk microagent display name. This name is displayed when using a TIBCO Hawk console application, such as TIBCO Hawk Display.
HAWKNETWORKThe TIBCO Hawk Rendezvous network parameter.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk. Refer to product documentation for TIBCO Hawk and TIBCO Rendezvous for information about the Rendezvous daemon parameter.
Related Parameters HAWKNETWORK on page 221.
HAWKPOLL on page 222.
HAWKSERVICE on page 223.
User Modifiable No.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default TIBCO OSB Data Object Broker, Name <name>, Host <host>.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk.
Related Parameters HAWKANAME on page 220.
User Modifiable No.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default An empty string.
TIBCO Object Service Broker Parameters
222 | Chapter 4 Understanding Data Object Broker Parameters
HAWKPOLLThe number of milliseconds to wait between TIBCO Hawk session creation attempts.
Effects Setting this parameter enables the Hawk microagent within the Data Object Broker.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk. Refer to product documentation for TIBCO Hawk and TIBCO Rendezvous for information about the Rendezvous network parameter.
Related Parameters HAWKDAEMON on page 220.
HAWKPOLL on page 222.
HAWKSERVICE on page 223.
User Modifiable No.
Environment Open Systems.
Valid User Values 1000 to 2147483647
Default 5000.
Effects If the internal Hawk microagent is not able to establish a connection to TIBCO Hawk, then it will sleep for at most the specified number of milliseconds before trying again.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk.
Related Parameters HAWKDAEMON on page 220.
HAWKNETWORK on page 221.
HAWKSERVICE on page 223.
User Modifiable No.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 223
HAWKSERVICEThe TIBCO Hawk Rendezvous UDP service port.
HEAPSIZEThe number of kilobytes in the heap available to TDS for each table access message.
Environment Open Systems.
Valid User Values A string of up to 128 characters in length.
Default An empty string.
Effects Setting this parameter enables the Hawk microagent within the Data Object Broker.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the TIBCO Object Service Broker interface to TIBCO Hawk. Refer to product documentation for TIBCO Hawk and TIBCO Rendezvous for information about the Rendezvous network parameter.
Related Parameters HAWKDAEMON on page 220.
HAWKNETWORK on page 221.
HAWKPOLL on page 222.
User Modifiable No.
Environment Open Systems.
Valid Values 4 to 256
Default 48
Operator Modifiable No.
TIBCO Object Service Broker Parameters
224 | Chapter 4 Understanding Data Object Broker Parameters
IOTRACESpecifies whether to trace the page I/O.
JOURNALSSpecifies whether to enable the Data Object Broker to write images of updated data store pages to journal files.
• JOURNALS=Y causes the Data Object Broker to perform journaling for all segments whose database definition allows journaling to be done.
• JOURNALS=N disables journaling for all segments.
Regardless of the setting for this parameter, journaling is never done for a segment whose database definition explicitly specifies no journaling for the segment.
Environment Open Systems.
Valid Values Y and N
Default N
Effects If IOTRACE is set to Y (trace the I/O), a message is written to the Data Object Broker log for each I/O operation.
Operator Modifiable Yes.
Environment z/OS.
Valid Values Y and N
Default Y
Recommendation Use the default.
Journaling is also controllable using TIBCO Object Service Broker operator commands.
Effects If journals are not available for your segments, you cannot create a continuous backup of your system. This means you can restore your system only to the last complete backup taken.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 225
LOCKBUFFERSThe number of additional 4 KB lock buffers to be acquired beyond the base amount.
z/OS: This base amount is defined as MAXTHREADS*8.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information on journal control commands.
Operator Modifiable No.
Environment All.
Valid Values z/OS: 4 to 8192
Open Systems: 1 to 1024
Default z/OS:128
Open Systems: 1
Recommendation Use the default value unless you determine by measurement that you need additional lock buffers.
Effects In heavy locking situations, a lock buffer pool that is too small can degrade service time, since transactions could be waiting on the lock buffer pool space.
z/OS: If the available lock buffer space is inadequate more table locks are generated to reduce the number of occurrence locks, thus making more space available.
Measurement On z/OS, the Buffer Pool screen of the TIBCO Object Service Broker Administration menu provides information about the LOCK pool usage. When the IN-USE MAX field shows the same value as the BUFFERS, the maximum has been reached. In that case use either this parameter or MAXTHREADS to increase the pool size.
Related Parameters z/OS: MAXTHREADS on page 231
TIBCO Object Service Broker Parameters
226 | Chapter 4 Understanding Data Object Broker Parameters
LOCKTIMEOUTThe wait interval in seconds before a lock request is retried if the initial request cannot be satisfied.
LOGMESSAGEDetermines whether logon or logoff messaging is to be issued by the Message Switch.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
Operator Modifiable No.
Environment z/OS.
Valid Values 1 to 60
Default 5
Recommendation Use the default value and adjust according to user response time experience.
Effects • If lock interference results from transactions of short duration, a small value could be appropriate.
• If an excessive number of transactions are failing due to lock interference the value is too small.
• A smaller value is better for a high volume online operating mode.
• To improve response time, use a smaller value.
Also consider the application design, since it can have greater impact on response times than this parameter.
Operator Modifiable Yes.
Environment z/OS.
Valid Values ON, OFF, BOTH, NONE.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 227
MAXCONCURRENTThe maximum number of concurrent Data Object Broker transactions that can execute at a time.
MAXDBMSThe maximum number of external database servers that can be connected to the Data Object Broker at one time.
Default None.
Effects • ON — Issues an S6BMS207L message for a logon.
• OFF — Issues an S6BMS207L message for a logoff.
• BOTH — Issues an S6BMS207L message for both a logon and logoff.
• NONE — Does not issue S6BMS207L messages.
Operator Modifiable Yes.
Environment Open Systems.
Valid Values 1 to 64
Default 3
Recommendation In a distributed data environment, the value of MAXCONCURRENT should be greater than the number of peers that you expect to be active simultaneously. For example, in a distributed data configuration with eight peers, you should set MAXCONCURRENT to at least nine.
Operator Modifiable No.
Environment Open Systems.
Valid Values 0 to 4096
Default 0
TIBCO Object Service Broker Parameters
228 | Chapter 4 Understanding Data Object Broker Parameters
MAXDISPLAYThe maximum number of CICS display-type connections that are allowed to connect concurrently to the Data Object Broker.
MAXNODESThe maximum number of peer nodes.
Operator Modifiable No.
Environment z/OS
Valid Values 0 to 3600
Default 0 (Indicates limit checking is disabled.)
Recommendation Use the default of 0 to disable limit checking unless you have a reason to limit the number of CICS display type sessions.
Related Parameter MAXUSERS on page 231
Effect Causes CICS sessions to be rejected with an S6BSM047E error message if the limit is exceeded.
Operator Modifiable
Yes
Environment z/OS.
Valid Values 1 to 1500
Default 128
Recommendation The default can be reduced to the number of peer TIBCO Object Service Broker nodes plus at least 10% for growth.
Effects This controls the amount of space allocated to support the Resource Manager.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 229
MAXOPERATORSThe maximum number of concurrent operator/administrator sessions that can be connected to the Data Object Broker at one time.
MAXQUERYThe number of parallel query TCBs.
MAXQUERY supports the TIBCO Object Service Broker Accelerator Pack for z/OS, which is installed with TIBCO Object Service Broker.
Related Parameters • MAXRESOURCES on page 230
• RSCSCHEDULES on page 246
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about TIBCO Object Service Broker resources.
Operator Modifiable No.
Environment Open Systems.
Valid Values 1 to 64
Default Windows: 2
Solaris: 4
Operator Modifiable No.
Environment z/OS.
Valid Values 1 to 8
Default 1
Effects Use of this parameter increases parallel processing.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
230 | Chapter 4 Understanding Data Object Broker Parameters
MAXRESOURCESThe maximum number of TIBCO Object Service Broker resources.
MAXTDSEXTENTSThe maximum number of extents in a TDS page file.
Environment z/OS.
Valid Values 1 to 3500
Default 128
Recommendation None
Related Parameters • MAXDBMS on page 227
• RSCSCHEDULES on page 246
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about TIBCO Object Service Broker resource management and other administration controls.
Operator Modifiable No.
Environment Open Systems.
Valid Values 1 to 16
Default 4
Recommendation Since an extent contains 31,744 pages and the default is 4 extents, you must adjust this parameter if any page file exceeds 126,976 pages (4 x 31,744 =126,976). Set this parameter to the number of pages in the largest TDS page file divided by 31,744 (rounded up to the next integer) or 4, whichever is larger.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 231
MAXTHREADSThe number of requests that the Data Object Broker can service at the same time.
MAXUSERSThe maximum number of user sessions that the Data Object Broker allows to be active at one time. This is also a Message Switch parameter.
This number includes user online and batch sessions. User connections are refused after this limit is reached. This limit does not include operator, external server, and peer server sessions. External and peer server sessions are limited by:
• z/OS: The Data Object Broker Resource Manager definitions
• Open Systems: The sum of the values in the MAXDBMS and PEERS parameters.
Environment z/OS.
Valid Values 1 to 2048
Default 16
Recommendation Specify a value that is at least equal to the number of queries and updates that can be pending in the Data Object Broker at any given time from all Execution Environment.
Effects If too low a value is specified, requests are delayed. Approximately 70 KB of non-fixed virtual storage above 16 MB is used for each concurrent request.
Measurement Refer to IN-USE MAX field in the Buffer Pool Statistics screen (option D) of the TIBCO Object Service Broker Administration menu. One session buffer is assigned to each actively dispatched user.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
Operator Modifiable No.
Environment All.
TIBCO Object Service Broker Parameters
232 | Chapter 4 Understanding Data Object Broker Parameters
MAXVSAMCThe maximum number of concurrent I/O requests to all page data sets.
Valid Values 1 to 4096.
Default z/OS: 16
Windows: 4
Solaris: 16
Recommendation Specify a value that is at least equal to the maximum number of user sessions logged in at one time.
Effects If too low a value is specified, logins are rejected. On z/OS, approximately 2 KB of non-fixed virtual storage above the 16 MB is used for each login.
Additional operator sessions are started when an Execution Environment is started or terminated—one operator session per Execution Environment.
The impact of these sessions is minimal in most multiple-user Execution Environments (for example, Native Execution Environment or CICS). MAXUSERS should be increased only to accommodate the additional operator sessions if TSO or batch Execution Environments are heavily used.
Measurement The TIBCO Object Service Broker Administration menu’s General Statistics screen indicates how many users are currently logged in (USERS) and the maximum number of concurrent connections (users and servers) measured (MAXCON) during the life of this Data Object Broker.
On z/OS, this information is also available in TIBCO Object Service Broker SMF subtype-10 (total) and -26 (interval) records.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 233
You can reduce the maximum for a particular segment using the THREADS parameter in the segment’s database definition.
Environment z/OS.
Valid Values 3 to 255
Default 24
Recommendation Use the default and change it if necessary, based on measurement.
Effects Too low a value causes processing overhead, as more VSAM scheduling is necessary. This results in additional VSAM requests and associated processing overhead. Increasing this value improves performance by allowing VSAM to allocate virtual storage for its control blocks.
Measurement The TIBCO Object Service Broker Administration menu shows the actual count of concurrent I/Os on its DASD Statistics screen. It shows the parameter setting on the Installation/Configuration screen as CONCURRENT VSAM.
This information is also available in the TIBCO Object Service Broker SMF subtype-11 records (at page data set level).
Related Parameters THREADS (Database definition parameter). The THREADS parameter is described in TIBCO Object Service Broker for z/OS Installing and Operating.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
234 | Chapter 4 Understanding Data Object Broker Parameters
MSGSIZEThe size of buffers, in kilobytes, for table access to TDS messages.
MSGTRACESpecifies whether to produce records for all query and commit requests received by the Data Object Broker. Use this parameter only in consultation with your TIBCO Support representative, as it can affect system performance.
Environment Open Systems.
Valid Values 4 to 32
Default 32
Operator Modifiable No.
Environment All.
Valid Values Y and N
Default N
Recommendation Do not set to Y unless directed to do so by your TIBCO Support representative.
Effects z/OS:
• GTF must be active to record the data produced. The use of GTF can affect overall system performance.
• Media storage space is affected, if External TRACE data set used.
Solaris: Records are copied to $OS_ROOT/log/hrncr.99999.msg, where 99999 is the process ID of the hrncr supervisor process.
Windows: Records are copied to %OS_ROOT\LOG\hrncr.999.msg, where 999 is a sequence incremented for each instance of the log file.
Related Parameters z/OS: GTFID on page 219.
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 235
NETVIEWBASEThe base code point indicator, during startup, for Netview support for alert-level messages.
NODENAMEA symbolic name to uniquely identify a Data Object Broker. When specifying a location in a rule, you use the “nodename” to identify the target location.
In Open Systems, the value for this parameter is also used as the communications identifier to identify the Data Object Broker to connect to for components such as client processes, Execution Environments, external database servers, and peer Data Object Brokers. (On z/OS, the COMMID parameter is used as the communications identifier to identify the Data Object Brokers to connect to for these components.)
Environment z/OS.
Valid Values 0 to 16
Default 0
Recommendation If no other applications are using user code points, use NETVIEWBASE=1.
Effects NETVIEWBASE=0 turns off Netview support. The recommended NETVIEWBASE=1 setting translates to x'E000' as the base code point.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about Netview support.
Operator Modifiable Yes.
Environment All.
Valid Values A valid uppercase alphanumeric identifier of 1 to 16 characters in length
Default z/OS: none
Open Systems: Data Object Broker name specified at installation time.
TIBCO Object Service Broker Parameters
236 | Chapter 4 Understanding Data Object Broker Parameters
OPERATOROne or more user IDs that should have operator authority for this Data Object Broker. User IDs with operator authority can cancel users.
PAGESWEEPACTIONThe page sweep reporting option.
After triggering a page sweep report, the transaction continues normally.
Recommendation When assigning a nodename, consider all other Data Object Broker nodes in your TIBCO Object Service Broker distributed network.
Related Parameters z/OS: COMMID on page 208.
Operator Modifiable No.
Environment Open Systems.
Valid Values Operating system user ID. Separate each entry with a comma. Up to fifteen values can be specified.
To specify an entry with non-alphanumeric characters, surround the entry with double quotes ("). The backslash (\) may be used to escape a double quote or itself.
NOTE Case sensitive.
Default The system user ID used during installation.
Recommendation When assigning a node name, consider all other Data Object Broker nodes in your TIBCO Object Service Broker distributed data network.
Related Parameters • PRIVILEGED on page 239
• SYSADMIN on page 272
Operator Modifiable No.
Environment z/OS.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 237
PAGESWEEPLIMITThe threshold number of logical page reads for page sweep reporting.
On z/OS, when a Data Object Broker transaction processes this number of page reads, PAGESWEEPACTION is triggered.
Valid Values DUMP, NODUMP, LOG, NOLOG, SMF, NOSMF
Default NODUMP, NOLOG, and NOSMF.
Effects When a message requests a logical page read that exceeds the threshold limit specified in the PAGESWEEPLIMIT parameter:
• If the value is DUMP, an SVC dump is taken.
• If the value is LOG, the S6BKF038W warning message appears in the log and on the console.
• If the value is SMF, an SMF record is written. For this option, SMFRECORD must be other than 0.
Using a value with the “NO” prefix disables the corresponding option.
To get TIBCO Object Service Broker to perform more than one action, you must submit the PAGESWEEPACTION parameter more than once. For example, you could get an SVC dump and an SMF record.
The effect of PAGESWEEPACTION is global. To affect individual users, use the Sweepaction Data Object Broker command.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about Data Object Broker commands.
Related Parameter PAGESWEEPACTION takes effect only if PAGESWEEPLIMIT is greater than zero.
Operator Modifiable Yes.
Environment All.
TIBCO Object Service Broker Parameters
238 | Chapter 4 Understanding Data Object Broker Parameters
Valid Values 0 to 65535. 0 indicates that the page sweep reporting function is to be disabled.
Default 0
Recommendation Set the limit high enough that it is seldom reached. This reduces impact on your system, especially if you chose DUMP for action.
Effects PAGESWEEPLIMIT is reset for each Data Object Broker transaction, of which there can be many during an Execution Environment transaction. In fact, each GET or FORALL in a rule starts a new Data Object Broker transaction. Also, if a FORALL retrieves more than 4 KB of data, each 4 KB request is a separate Data Object Broker transaction.
Each time the Data Object Broker reads a page, the counter is decremented. When it reaches zero on z/OS, the PAGESWEEPACTION is taken. When it reaches zero on Open Systems, a warning message is issued in the log. Because each Data Object Broker transaction can access more than one table, hitting the limit means the transaction has read the specified number of pages from all the tables it needed to access, not just a single table.
PAGESWEEPACTION on z/OS or the warning message on Open Systems reports the table being accessed at the time the transaction reads the last page; all the preceding pages could be from different tables if, for example:
• A ctable had to be built, that is, the table is not bound or this is the first read for this table
• A trigger rule on the table referenced another table
• Records were written to ACCESSLOG
• Security tables were read
Related Parameter If PAGESWEEPLIMIT is greater than zero on z/OS, PAGESWEEPACTION must be valid.
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 239
PEERSA connection that this Data Object Broker can establish with another Data Object Broker in the TIBCO Object Service Broker distributed data network. Define all the remote Data Object Brokers with which you want to establish communications. Session requests from undefined Data Object Brokers are rejected.
PRIVILEGEDOne or more user IDs that should have privileges for this Data Object Broker. A privileged user can, for example, view the list of users, but cannot cancel users.
Environment Open Systems.
Valid Values The PEERS parameter accepts the following arguments:
• nodename—The node alias (in huron.dir) of the Data Object Broker being defined. The peer identified can be on any supported system, and must be valid and defined in the Data Object Broker directory file.
• outbound—Maximum number of sessions to establish for this connection (minimum 0, maximum 128).
• inbound—Maximum number of sessions that are accepted from the peer specified (minimum 0, maximum 128).
• prefix—A one to three character prefix used to build user IDs to login to the target Data Object Broker. For example, for prefix TOR, user IDs TOR00001, TOR00002, and so on are generated.
• fslevel—The Fail Safe level this connection is capable of supporting. For connections between Data Object Brokers, valid options are: 0, 1, or 2. This argument is optional; if it is omitted, the default 2 is assumed.
Code one PEERS parameter per statement. You can code up to 64 statements.
Operator Modifiable No.
Environment Open Systems.
TIBCO Object Service Broker Parameters
240 | Chapter 4 Understanding Data Object Broker Parameters
REMOTEDUPSpecifies whether to allow connections with duplicate user IDs when either the existing or the connecting use is for an API process.
Valid Values Operating system user ID. Separate each entry with a comma. Up to fifteen values can be specified.
To specify an entry with non-alphanumeric characters, surround the entry with double quotes ("). The backslash (\) may be used to escape a double quote or itself.
NOTE Case sensitive.
Default None.
Related Parameters • OPERATOR on page 236
• SYSADMIN on page 272
Operator Modifiable No.
Environment: z/OS.
Valid Values Y and N
Default N
Recommendation If there is likely to be a local user ID that matches the user ID of the request from an API process (for example, if batch jobs share names), specify REMOTEDUP=Y.
Effects If REMOTEDUP is set to Y (allow connection), a user can connect under their user ID even though an API process is running under that same user ID.
Provides a unique identifier for user connections. The CANCELUSER, NOTRACE, and TRACEID operator commands refer to this identifier (COMMNUM). If REMOTEDUP is set to Y, and one of these commands is issued for a user ID with multiple connections, the command returns messages that help you identify the connection you want to process. The messages prompt you to repeat the command with a unique identifier.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 241
RESAGEThe resident page LRU-2 aging threshold.
RESIDENTHASHSIZEThe number of entries in the resident page hash table.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information on the CANCELUSER, NOTRACE, and TRACEID commands.
Related Parameter DUPUSERID on page 215.
Operator Modifiable Yes.
Environment Open Systems.
Valid Values 0 to 4096
Default 300
Recommendation Use the default and change it only if necessary, based on the results of measurement.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information on the LRU-2 algorithm.
Operator Modifiable No.
Environment z/OS.
Valid Values 2039 to 16777213
Default 65521
Recommendation Use the default. If the value is set, use a large prime number or a multiple of a large prime number to ensure that the hashing mechanism works effectively.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
242 | Chapter 4 Understanding Data Object Broker Parameters
RESIDENTPAGESThe number of 4 KB pages for data and index buffers in thousands.
Environment All.
Valid Values z/OS: 2 to 8192 (thousands of pages)
Open Systems: 100 to 262144
On z/OS, the actual number of pages allocated will be at the next higher 1 megabyte boundary. For example, a value of 2 (2000) will result in an allocation of 2048 pages.
Default z/OS: 10
Open Systems: 7000
Recommendation Use the default and change it if necessary, based on the results of measurement.
Effects Too low a value causes processing overhead and longer transaction times, as pages could have to be brought into memory to satisfy database access requests. A larger value increases the likelihood of needed pages being in storage, unless accesses are very random.
Non-fixed virtual storage requirements vary proportionally with this parameter. At a minimum, 4096 bytes of virtual storage is allocated for each buffer. This virtual storage is obtained above the 16 MB line.
Measurement Comparing Logical Gets to Physical Reads, as provided by the TIBCO Object Service Broker Administration menu’s General Statistics screen, gives an estimate of buffer hit rate.
Low ratios can indicate that performance could be enhanced by the allocation of more RESIDENTPAGES, while extremely high ratios can indicate an over-allocated resource (Virtual Storage).
On z/OS, the above information is also available in the TIBCO Object Service Broker SMF subtype-10 (total) and -26 (interval) records.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 243
ROUTACTIONThe route code for A (alert) WTO messages. This is also a Message Switch parameter.
AssociatedDocumentation
The MVS Routing and Descriptor Codes IBM manual for code descriptions of WTO messages.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating or TIBCO Object Service Broker for Open Systems Installing and Operating for more information about the Administration menu.
Related Parameters Open Systems: ERRNOTRACE on page 217.
Operator Modifiable No.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16). You can specify multiple values for the parameter. For example, ROUTACTION=B14 sets ROUTACTION to 1, 4, and 11.
Default B
Recommendation You could change route code 1 to specify operator action routing.
Measurement You can view this parameter’s setting online through the TIBCO Object Service Broker Administration menu’s Installation/Configuration screen. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information on how this screen displays the settings.
Related Parameters DESCACTION on page 212
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
Operator Modifiable Yes, but modification is not recommended.
TIBCO Object Service Broker Parameters
244 | Chapter 4 Understanding Data Object Broker Parameters
ROUTERRORThe route code for E (error) WTO messages. This is also a Message Switch parameter.
ROUTINFORMThe route code for I (information) WTO messages. This is also a Message Switch parameter.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16). You can specify multiple values for the parameter. For example, ROUTERROR=B14 sets ROUTERROR to 1, 4, and 11.
Default B
Recommendation You could change route code A to specify error routing.
Measurement You can view this parameter’s setting online through the TIBCO Object Service Broker Administration menu’s Installation/Configuration screen. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information on how this screen displays the settings.
Related Parameters DESCERROR on page 213
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16). You can specify multiple values for the parameter. For example, ROUTINFORM=B14 sets ROUTINFORM to 1, 4, and 11.
Default B
Recommendation You could change route code 2 to specify operator information routing.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 245
ROUTLOGThe route code for L (log) WTO messages This is also a Message Switch parameter.
Measurement You can view this parameter’s setting online through the TIBCO Object Service Broker Administration menu’s Installation/Configuration screen. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information on how this screen displays the settings.
Related Parameters DESCINFORM on page 213
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16). You can specify multiple values for the parameter. For example, ROUTLOG=B14 sets ROUTLOG to 1, 4, and 11.
Default B
Recommendation Use the default. Route code B specifies routing to the log.
Measurement You can view this parameter’s setting online through the TIBCO Object Service Broker Administration menu’s Installation/Configuration screen. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information on how this screen displays the settings.
Related Parameters DESCLOG on page 214.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
TIBCO Object Service Broker Parameters
246 | Chapter 4 Understanding Data Object Broker Parameters
ROUTWARNThe route code for W (warning) WTO messages. This is also a Message Switch parameter.
RSCSCHEDULESThe average number of schedule entries for each TIBCO Object Service Broker resource.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values 0 to 9 and A to G (for 10-16). You can specify multiple values for the parameter. For example, ROUTWARN=B14 sets ROUTWARN to 1, 4, and 11.
Default B
Recommendation You could change route code 2 to specify operator information routing.
Measurement You can view this parameter’s setting online through the TIBCO Object Service Broker Administration menu’s Installation/Configuration screen. Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information on how this screen displays the settings.
Related Parameters DESCWARN on page 214
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about the Administration menu.
Operator Modifiable Yes, but modification is not recommended.
Environment z/OS.
Valid Values 1 to 24
Default 1
TIBCO Object Service Broker Parameters
Parameter Descriptions | 247
SECCLASSThe security class of the request defined by TIBCO Object Service Broker for Data Object Broker access.
SECREQUESTORThe internal requestor name as defined by TIBCO Object Service Broker for Data Object Broker access.
Recommendation None
Effects Each line in a schedule entry counts as an entry when estimating a value for RSCSCHEDULES.
Related Parameters • MAXDBMS on page 227
• MAXRESOURCES on page 230
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about TIBCO Object Service Broker resource management and other administration controls.
Operator Modifiable No.
Environment z/OS
Valid Values 1- to 8-character security class name.
Default S6BDOB
Related Topics Refer to SECREQUESTOR on page 247, SECSUBSYSTEM on page 248, and TIBCO Object Service Broker Managing Security.
Type Configuration parameter.
Operator Modifiable
No
Environment z/OS
TIBCO Object Service Broker Parameters
248 | Chapter 4 Understanding Data Object Broker Parameters
SECSUBSYSTEMThe subsystem as defined by TIBCO Object Service Broker for Data Object Broker access.
SECUREADMINSpecifies whether the System Authorization Facility (SAF) calls are made to the site’s security system. These calls are made for authorization of access to sensitive operational utilities requested from other than the z/OS operator console (for example, S6BTLADM, S6BTLCMD and S6BSPJEX).
Valid Values 1- to 8-character security requestor name.
Default S6BDOBOP
Related Topics Refer to SECCLASS on page 247, SECSUBSYSTEM on page 248, and TIBCO Object Service Broker Managing Security.
Type Configuration parameter.
Operator Modifiable
No
Environment z/OS
Valid Values 1- to 8-character security subsystem name.
Default S6B
Related Topics Refer to SECCLASS on page 247, SECREQUESTOR on page 247, and TIBCO Object Service Broker Managing Security.
Type Configuration parameter.
Operator Modifiable
No
Environment z/OS.
Valid Values Y and N
TIBCO Object Service Broker Parameters
Parameter Descriptions | 249
SHAREDMALIGNThe virtual address boundaries where shared memory segments should be aligned.
Default N
Effects The SAF interface is used to secure operator functions. While there is no effect on the operator MODIFY command, the functions supported by the S6BTLADM, S6BTLBRM, S6BTLCMD, and S6BSPJEX utilities are affected.
The SAF interface determines whether the user falls into one of four user types (general, privileged, DBA, or operator) based on user-written access rules in an external security package.
Related Topics Refer to TIBCO Object Service Broker Managing Security for more information about using external security and to TIBCO Object Service Broker for z/OS Utilities for more information about the utilities.
Operator Modifiable Yes.
Environment Open Systems.
Valid Values A multiple of 64 KB. Values are rounded up to the nearest 64 KB boundary.
Default 0x00100000
Recommendation Should not be changed from the default.
Effects The parameter can be used to position TIBCO Object Service Broker shared memory within available virtual space.
Related Parameters • SHAREDMEMADDR on page 250
• Solaris: SHAREDMEMPERM on page 251
Operator Modifiable No.
TIBCO Object Service Broker Parameters
250 | Chapter 4 Understanding Data Object Broker Parameters
SHAREDMEMADDRThe virtual memory address where shared memory should begin.
Environment Open Systems.
Valid Values A multiple of 64 KB. Values are rounded up to the nearest 64 KB boundary.
Default Windows: 0x20000000
Solaris: 0x10000000
Recommendation When two or more peer Data Object Brokers coexist on the same system, the SHAREDMEMADDR must be different for each Data Object Broker:
• If there are two nodes, adjust the SHAREDMEMADDR value of one of the nodes to a multiple of the value of its SHAREDMALIGN parameter.
• If there are more than two nodes, each node must have a different value for SHAREDMEMADDR, and the values must align with the value of SHAREDMALIGN.
As a rule of thumb, you can approximate the value for the next SHAREDMEMADDR by converting the value 2500000 + 5000 * RESIDENTPAGES to hexadecimal and rounding up to the next multiple of SHAREDMALIGN.
A typical value for the next SHAREDMEMADDR that allows for the maximum size of RESIDENTPAGES is 0x5000000 plus the value of the SHAREDMEMADDR for the previous node.
Related Parameters • SHAREDMALIGN on page 249
• Solaris: SHAREDMEMPERM on page 251
Operator Modifiable No.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 251
SHAREDMEMPERMThe permission settings for Data Object Broker shared memory.
SIXDATAPAGLIMThe maximum number of data pages a table can have for a secondary index to be built on it online.
SMFRECORDThe numerical identifier that this Data Object Broker uses when generating SMF records.
This number is used to associate the SMF records with this Data Object Broker.
A value of zero (0) disables SMF recording.
Environment Solaris.
Valid Values 0 to 0777
Default 0666
Related Parameters • SHAREDMALIGN on page 249
• SHAREDMEMADDR on page 250
Operator Modifiable No.
Environment z/OS.
Valid Values 0 to 65535
Default 3333
Operator Modifiable Yes.
Environment z/OS.
Valid Values 128 to 255, and 0
Default 0
TIBCO Object Service Broker Parameters
252 | Chapter 4 Understanding Data Object Broker Parameters
SMF13INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-13 records for Pagestore response time statistics. Records are produced only for segments that had I/O activity during the interval.
Each record contains an entry for every page data set contained in the segment. Segments with a large number of page data sets can have multiple records generated to describe all page data set activity.
Recommendation If SMF recording is enabled, consider using the same identifier as the Execution Environments running off this Data Object Broker. This gives you a uniform identifier for the TIBCO Object Service Broker system that is based on this Data Object Broker.
Effects SMF recording entails minimal overhead.
If SMFRECORD is set to 0 when the Data Object Broker starts up, it can be set by operator command to a value in the 128 to 255 range. If it is set in the 128 to 255 range at Data Object Broker startup, the operator cannot set it to zero (0). This means SMF recording can be switched on only by an operator and cannot be switched off while the Data Object Broker is running.
Related Parameters • SMF13INTERVAL on page 252
• SMF22INTERVAL on page 253
• SMF23INTERVAL on page 254
• SMF24INTERVAL on page 254
• SMF25INTERVAL on page 255
• SMF26INTERVAL on page 256
• SMF47INTERVAL on page 258
Related Topics TIBCO Object Service Broker for z/OS Monitoring Performance for more information about generating SMF records.
Operator Modifiable Operator modifiable, but can be modified only once.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 253
A setting of zero (0) disables recording of this SMF record subtype.
SMF22INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-22 records for lock manager statistics.
Environment z/OS.
Valid Values 1 to 30, and 0
Default 15
Recommendation Use the default value. During normal system operation a value of 15 should be adequate. When performing system tuning, a smaller value provides greater detail and enables the site to uncover any problem areas more easily.
Effects The smaller the interval value the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
Related Parameters SMFRECORD on page 251.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 5 to 1440, and 0
Default 30
Recommendation Use the default value. During normal system operation a value of 30 should be adequate. When performing system tuning a smaller value provides greater detail and enables the site to uncover any problem areas more easily.
TIBCO Object Service Broker Parameters
254 | Chapter 4 Understanding Data Object Broker Parameters
SMF23INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-23 records for query TCB statistics.
A setting of zero (0) disables recording of this SMF record subtype.
SMF24INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-24 records for query and commit response time statistics.
Effects The smaller the interval value the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 5 to 1440, and 0
Default 30
Recommendation Use the default value. During normal system operation a value of 30 should be adequate. When performing system tuning a smaller value provides greater detail and enables the site to uncover any problem areas more easily.
Effects The smaller the interval value the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 255
A setting of zero (0) disables recording of this SMF record subtype.
SMF25INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-25 records. These records, used for message length histograms, contain the number of requests received and the message length associated with the requests.
A setting of zero (0) disables recording of this SMF record subtype.
Environment z/OS.
Valid Values 5 to 1440, and 0
Default 30
Recommendation Use the default value. During normal system operation a value of 30 should be adequate. When performing system tuning a smaller value provides greater detail and enables the site to uncover any problem areas more easily.
WARNING SMF24INTERVAL is mutually exclusive with SMF27INTERVAL. Specifying both parameters results in the following Data Object Broker initialization failure:S6BKS013W- SMF 24 OR SMF 27 MAY BE REQUESTED BUT NOT BOTH
Effects The smaller the interval value the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 5 to 1440, and 0
Default 30
TIBCO Object Service Broker Parameters
256 | Chapter 4 Understanding Data Object Broker Parameters
SMF26INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-26 records, which contain general Data Object Broker statistics.
A setting of zero (0) disables recording of this SMF record subtype.
Recommendation Use the default value. During normal system operation a value of 30 should be adequate. When performing system tuning a smaller value provides greater detail and enables the site to uncover any problem areas more easily.
Effects The smaller the interval value the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 5 to 1440, and 0
Default 30
Recommendation Use the default value. During normal system operation a value of 30 should be adequate. When performing system tuning, a smaller value provides greater detail and enables the site to uncover any problem areas more easily.
Effects The smaller the interval value, the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 257
SMF27INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-27 records, which contain query and commit extended response time statistics.
A setting of zero (0) disables recording of this SMF record subtype.
SMF28INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-28 records, which contain server usage response time statistics.
A setting of zero (0) disables recording of this SMF record subtype.
Environment z/OS.
Valid Values 5 to 1440, and 0
Default 30
Recommendation If you want more detailed response time reporting than provided by SMF24 records, set SMF24INT to zero and set SMF27INT to 30.
WARNING SMF27INTERVAL is mutually exclusive with SMF24INTERVAL. Specifying both parameters results in the following Data Object Broker initialization failure:S6BKS013W- SMF 24 OR SMF 27 MAY BE REQUESTED BUT NOT BOTH
Effects The smaller the interval value, the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 5 to 1440, and 0
Default 0
TIBCO Object Service Broker Parameters
258 | Chapter 4 Understanding Data Object Broker Parameters
SMF47INTERVALThe interval in minutes for generating TIBCO Object Service Broker SMF subtype-47 records for user Data Object Broker resource consumption statistics for an interval.
A setting of zero (0) disables recording of this SMF record subtype.
Recommendation By default SMF28 records are not produced. To record and report server usage and response times, specify SMF28INT explicitly. Only resources whose Monitor/SMF flag is activated are recorded. Refer to the resource detail screen of the Resource Manager in the S6BTLADM (Administration Menu) utility.
Effects The smaller the interval value, the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Refer to TIBCO Object Service Broker for z/OS Installing and Operating for information about the Administration menu.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 5 to 1440 and 0
Default 30
Recommendation Use the default value. During normal system operation a value of 30 should be adequate. When performing system tuning a smaller value provides greater detail and enables the site to uncover any problem areas more easily.
Effects The smaller the interval value the greater the number of SMF records created. There is a slight overhead in the preparation and recording of each record.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 259
SNAPCLASSThe JES output class for SYSOUT snap dumps generated by the Data Object Broker.
SNAPDSPREFIXThe high-level qualifiers for Data Object Broker snap dumps taken to a data set on DASD.
Related Topics Refer to TIBCO Object Service Broker for z/OS Monitoring Performance for more information about this SMF record type.
Operator Modifiable Yes.
Environment z/OS.
Valid Values A to Z and 0 to 9
Default A
Recommendation Specify a value that keeps a generated snap dump on JES spool long enough for it to be reviewed, if necessary.
Effects Data Object Broker snap dumps are generally less than 500 lines and are taken only when a diagnostic dump is requested (from option Z on the Administration menu). This parameter takes effect only if SNAPOVERRIDE=N.
Related Parameters • SNAPOVERRIDE on page 261
• SNAPHOLD on page 260
• SNAPREMOTE on page 262
• DBSNAP on page 212
Operator Modifiable Yes.
Environment z/OS.
TIBCO Object Service Broker Parameters
260 | Chapter 4 Understanding Data Object Broker Parameters
SNAPHOLDSpecifies whether a SYSOUT Data Object Broker snap dump should be held on the JES spool.
Valid Values Data set qualifiers valid in z/OS. You can specify multiple levels and the total length including periods cannot exceed 17 characters. The first qualifier must be a valid catalog alias at your site.
Default Set by $HLQNONV$ in the OSEMOD ISPF edit CLIST used during Data Object Broker installation.
Recommendation Specify the same data set name prefix as the Data Object Broker data sets.
Effects SNAPDSPREFIX is in effect only if SNAPOVERRIDE=Y. See SNAPOVERRIDE on page 261 for DASD space considerations.
Related Parameters • SNAPOVERRIDE on page 261
• SNAPVOLSER on page 264
• SNAPUNIT on page 263
Operator Modifiable Yes.
Environment z/OS.
Valid Values Y and N
Default N
Recommendation Determine how your site wants to handle Data Object Broker snap dumps. If snap dumps are held, they are available on JES spool for viewing. If they are not to be held, specify an output class and destination. Also consider if they should print automatically.
Effects This determines the JES output queue (HELD or READY) where the snap dump data sets appear. Snap dump data sets must be manually deleted when they are no longer required.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 261
SNAPOVERRIDESpecifies whether the Data Object Broker snap dumps are to be written to individual data sets on DASD; if not, they go to JES SYSOUT.
Related Parameters • SNAPCLASS on page 259
• SNAPOVERRIDE on page 261
• SNAPREMOTE on page 262
Operator Modifiable Yes.
Environment z/OS.
Valid Values Y and N
Default N
Recommendation Use whatever is appropriate for your site. You must ensure that there is sufficient DASD or JES spool space to hold all snap dumps taken during this Data Object Broker’s operation.
TIBCO Object Service Broker does not delete snap dump data sets. You must determine their disposition and manually delete them if you no longer need them.
Effects Snap dumps are typically less than 500 lines. If the snap dumps are written to DASD, they go to the volume named by SNAPVOLSER, or in the DASD pool named by SNAPUNIT, with the name: SNAPDSPREFIX.#YYYYDDD.#HHMMSS.#TH.
Related Parameters • SNAPCLASS on page 259
• SNAPDSPREFIX on page 259
• SNAPHOLD on page 260
• SNAPREMOTE on page 262
• SNAPUNIT on page 263
• SNAPVOLSER on page 264
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
262 | Chapter 4 Understanding Data Object Broker Parameters
SNAPQUERYSpecifies whether the Data Object Broker generates a transaction dump for failed query requests.
SNAPREMOTEThe JES output destination for JES SYSOUT snap dumps generated by the Data Object Broker.
Refer to $JESPRT$ in OSEMOD ISPF edit CLIST for the default.
Environment All.
Valid Values Y and N
Default N
Recommendation Use the default.
Effects The Data Object Broker takes a transaction dump only when it fails a query request. This is an exceptional condition and should not occur frequently. The vast majority of Data Object Broker requests are queries.
Related Parameters z/OS: SNAPSUPPRESS on page 263
Operator Modifiable Yes.
Environment z/OS.
Valid Values A valid symbolic printer name of 1 to 8 characters in length.
Default LOCAL
Recommendation Use the default or specify a JES destination that is valid for your site.
Effects SYSOUT snap dumps generated by the Data Object Broker are sent to the destination specified. SNAPREMOTE is in effect only if SNAPOVERRIDE=N.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 263
SNAPSUPPRESSSpecifies whether Data Object Broker transaction dumps are to be suppressed.
SNAPUNITThe generic name of a DASD pool from which to allocate DASD snap dump data sets.
Related Parameters • SNAPCLASS on page 259
• SNAPHOLD on page 260
• SNAPOVERRIDE on page 261
Operator Modifiable Yes.
Environment z/OS.
Valid Values Y and N
Default N
Recommendation Use the default. A transaction dump often provides the necessary information to determine why a Data Object Broker request failed. It should be kept until technical support staff no longer need it.
Effects A transaction dump is provided using the SVC dump facility, therefore it has the overhead and constraints of the SVC dump.
Related Parameters SNAPOVERRIDE on page 261.
Operator Modifiable Yes.
Environment z/OS.
Valid Values n/a
Default Refer to $INSTUNT$ OSEMOD ISPF edit CLIST used during Data Object Broker installation for the default.
TIBCO Object Service Broker Parameters
264 | Chapter 4 Understanding Data Object Broker Parameters
SNAPVOLSERThe volume serial of the DASD where the Data Object Broker can allocate snap dump data sets.
Recommendation Specify a value that is valid for your site and for the DASD volume where you want the Data Object Broker to allocate snap dump data sets.
Effects SNAPUNIT is in effect only when SNAPOVERRIDE=Y. Refer to SNAPOVERRIDE on page 261 for DASD space considerations.
Related Parameters • SNAPOVERRIDE on page 261
• SNAPDSPREFIX on page 259
• SNAPVOLSER on page 264
Operator Modifiable Yes.
Environment z/OS.
Valid Values n/a
Default Refer to $WORKVOL$ OSEMOD ISPF edit CLIST used during Data Object Broker installation.
Recommendation Specify a volume serial with adequate space for the Data Object Broker to allocate snap dump data sets. Snap dumps are typically less than 500 lines. For current device types (3390, for example), several tracks are required.
Effects The Data Object Broker security ID must have access to the specified volume to create and catalog data sets. If SNAPUNIT is specified, specify a volume serial that belongs to the DASD pool. SNAPVOLSER is in effect only if SNAPOVERRIDE=Y.
Refer to SNAPOVERRIDE on page 261 for DASD space considerations.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 265
SPINDSNAMEThe data set name from which SPIN jobs are submitted. It must be an existing partitioned data set containing member names set by the SPINMEMBER parameter.
SPININTERVALThe maximum time interval between journal spins. If a spin is not scheduled during an interval due to a full journal or an operator request, the Data Object Broker schedules a spin at the end of this interval. Set this parameter’s value to the length of that interval, in minutes.
Related Parameters • SNAPDSPREFIX on page 259
• SNAPOVERRIDE on page 261
• SNAPUNIT on page 263
Operator Modifiable Yes.
Environment z/OS.
Valid Values n/a
Default Set by $HLQNONV$.$INSTVER$.JCL Refer to the OSEMOD ISPF edit CLIST used during Data Object Broker installation.
Effects Applicable only if SPINOPTION=JOB. The Data Object Broker initialization fails if this data set does not exist or if member names set by SPINMEMBER do not exist in this data set.
Related Parameters • SPINMEMBER on page 266
• SPINOPTION on page 267
Operator Modifiable Yes.
Environment z/OS.
Valid Values 60 to 1440; and 0 to suppress this feature
TIBCO Object Service Broker Parameters
266 | Chapter 4 Understanding Data Object Broker Parameters
SPINMEMBERThe prefix for the member names that contain JCL for journal spins.
• If SPINOPTION=JOB, this is used as a member name prefix for spin jobs. You need one member corresponding to each journal. A full member name consists of this prefix followed by a number representing the journal number.
For example, if SPINMEMBER=SPIN0, the Data Object Broker uses member SPIN01 to offload journal 1, SPIN037 to off load journal 37, and so on.
• If SPINOPTION=STC, this value specifies the name of the started task procedure. Only one procedure is used.
Default 0
Recommendation Use this feature only if you need the extra journal spins during periods of low database activity. Keep in mind that you can schedule journal spins on demand via a TIBCO Object Service Broker operator command.
Effects This feature causes extra journal spins, that is, in addition to those normally scheduled when journal data sets fill up.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about operator commands.
Operator Modifiable Yes.
Environment z/OS.
Valid Values • SPINOPTION=JOB: 1 to 7 characters; the prefix plus the journal number must be no more than 8 characters.
• SPINOPTION=STC: 8 characters
Default SPIN0
TIBCO Object Service Broker Parameters
Parameter Descriptions | 267
SPINOPTIONSpecifies whether the journal spin JCL is run as a started task or batch job.
Effects If SPINOPTION=STC, member names set by SPINMEMBER must be in the system PROCLIB; otherwise, the START command issued by the Data Object Broker fails.
SPINMEMBER is not operator modifiable. It is set at start up time only.
Related Parameters • SPINDSNAME on page 265
• SPINOPTION on page 267
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about operator commands.
Operator Modifiable No.
Environment z/OS.
Valid Values JOB and STC
Default JOB
Recommendation Use the method that is consistent with your site’s operations practice.
TIBCO Object Service Broker Parameters
268 | Chapter 4 Understanding Data Object Broker Parameters
SPINSHELLThe shell to use when executing a spin script.
Effects • If SPINOPTION=JOB the Data Object Broker, when it starts up, reads and stores in memory the spin JCL from the data set and members specified in the SPINDSNAME and SPINMEMBER parameters. It submits them as batch jobs for dumping the journal’s data and resetting it.
• If SPINOPTION=STC the Data Object Broker issues a START command using the catalogued procedure name defined by SPINMEMBER. The system searches for the JCL procedure in the system PROCLIB concatenation that is in effect for the Data Object Broker. Your spin JCL modifications take effect the next time the Data Object Broker issues a START command.
Related Parameters • SPINDSNAME on page 265
• SPINMEMBER on page 266
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information about operator commands.
Operator Modifiable No.
Environment Solaris.
Valid Values A valid path of up to 255 characters in length.
Default /bin/ksh
Recommendation Use the default when using the sample spin scripts.
Effects The specified shell is used for executing a spin script during journal processing.
The Data Object Broker will abend on startup if a valid path to a shell that is both readable and executable is not specified.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 269
SRBMODEControls the dispatching of Data Object Broker Query requests on z/OS.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Managing Backup and Recovery for more information on journal processing.
Operator Modifiable Yes.
Environment z/OS.
Valid Values • N — Use Task mode dispatching.
• Y — Use SRB mode dispatching.
• Z — Use SRB mode dispatching and enable the dispatching of SRBs on any available zIPP processor.
Default N.
Recommendation If one or more zIIP processors are available, set the value to Z; otherwise, set it to N.
Effects • N — Object Service Broker dispatches query requests to one of the query tasks that traditionally run in TCB mode. This task might involve queuing the request for a query task to become available.
• Y or Z — Object Service Broker dispatches query requests in SRB mode. Since only one SRB applies to each valid thread, no queuing occurs for a task to become available in this mode.
Each valid thread consumes approximately 8 Kbytes of Extended System Queue Area (ESQA). The number of threads is the value of MAXTHREADS plus four. To take advantage of SRB scheduling, you might need to revise the z/OS system parameters.
• Z — Object Service Broker takes advantage of any available zIIP processor.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
270 | Chapter 4 Understanding Data Object Broker Parameters
SSTRACESpecifies whether GTF records are to be created each time a TIBCO Object Service Broker system service event occurs. Use this parameter only in consultation with your TIBCO Support representative, as it can affect system performance.
STDERRTRACESpecifies whether to include messages to stderr in the Data Object Broker log file.
Environment z/OS.
Valid Values Y and N
Default N
Recommendation Use Y only in consultation with the TIBCO Support to collect trace information for diagnosing problems.
Effects Use of GTF trace can have some effect on overall system performance. GTF trace must be active to record the data produced.
Related Parameters GTFID on page 219.
Operator Modifiable Yes.
Environment Open Systems.
Valid Values Y and N
Default N
Recommendation For best performance, use the default.
Related Parameters STDOUTTRACE on page 271.
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 271
STDOUTTRACESpecifies whether to include messages to stdout in the Data Object Broker log file.
SVCTRACESpecifies whether to write a message to the Data Object Broker for each supervisor call to the Data Object Broker from TDS.
SWAPPABLESpecifies whether the Data Object Broker is marked as swappable after initialization.
Environment Open Systems.
Valid Values Y and N
Default N
Recommendation For best performance, use the default.
Related Parameters STDERRTRACE on page 270.
Operator Modifiable Yes.
Environment Open Systems.
Valid Values Y and N
Default N
Recommendation For best performance, use the default.
Operator modifiable Yes.
Environment z/OS.
Valid Values Y and N
Default N
Recommendation For best performance, use the default.
TIBCO Object Service Broker Parameters
272 | Chapter 4 Understanding Data Object Broker Parameters
SYNCTRACESpecifies whether to write a message to the Data Object Broker for each commit.
SYSADMINThe TIBCO Object Service Broker administrator user ID for this Data Object Broker.
Operator Modifiable No.
Environment Open Systems.
Valid Values Y and N
Default N
Recommendation For best performance, use the default.
Operator modifiable Yes.
Environment Open Systems.
Valid Values An operating system user ID. Only one system user ID can be the TIBCO Object Service Broker system administrator.
To specify an entry with non-alphanumeric characters, surround the entry with double quotes ("). The backslash (\) may be used to escape a double quote or itself.
NOTE Case sensitive.
Default huron
Related Parameters • OPERATOR on page 236
• PRIVILEGED on page 239
Operator Modifiable No.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 273
TIMEOUTABENDThe time allowed for the Data Object Broker to abend.
If the abend is not completed in the specified time, all Data Object Broker processes are immediately killed.
TIMEOUTSTARTThe time allowed for the Data Object Broker to complete startup processing.
If the Data Object Broker is not successful in the specified time, the Data Object Broker abends and all processes are killed.
TIMEOUTSTOPThe time allowed for the Data Object Broker to perform a graceful shutdown.
Environment Open Systems.
Valid Values 30 to 3600 seconds
Default 30
Related Parameters • TIMEOUTSTART on page 273
• TIMEOUTSTOP on page 273
Operator Modifiable No.
Environment Open Systems.
Valid Values 30 to 3600 seconds
Default 120
Related Parameters • TIMEOUTABEND on page 273
• TIMEOUTSTOP on page 273
Operator Modifiable No.
TIBCO Object Service Broker Parameters
274 | Chapter 4 Understanding Data Object Broker Parameters
If the Data Object Broker is not successful in the specified time, the Data Object Broker abends and all processes are killed.
TIMESTAMPThe interval in minutes for producing a WTO message reporting current date and time.
TRXREADLIMITThe maximum number of pages that can be read in by a single Data Object Broker request. Transaction message requests that exceed the specified number of pages are aborted.
Environment Open Systems.
Valid Values 30 to 3600 seconds
Default 120
Related Parameters • TIMEOUTABEND on page 273
• TIMEOUTSTART on page 273
Operator Modifiable No.
Environment z/OS.
Valid Values 10 to 1440; and 0 to disable this feature
Default 1440
Recommendation Use the default.
Effects The value 1440 produces a timestamp daily at midnight.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 0 to 9999; and 0 to disable this feature
Default 0
TIBCO Object Service Broker Parameters
Parameter Descriptions | 275
USEREXITSpecifies whether user exit processing is required for this Data Object Broker. If USEREXIT is set to N and a USRX0000 routine is detected at startup, an error message appears and the Data Object Broker terminates. If USEREXIT is set to Y and a USRX0000 routine is not detected at startup, an error message appears and the Data Object Broker terminates.
Recommendation This parameter can be used to identify inappropriate requests to the Data Object Broker.
Effects Requests that cause more physical reads than the specified value are aborted. This prevents transactions from flooding the resident page pool with pages with a low reference frequency, allowing pages referenced more frequently to be read.
Some operations process many buffers, without requiring I/O services (for example, when an entire table is already in the resident page pool). This can cause the Data Object Broker to be slow in processing new requests since the required data is always available. These transactions are not aborted, but they are periodically interrupted so that other service requests can be processed.
Related Parameters • ERRNOTRACE on page 217
• RESIDENTPAGES on page 242
Operator Modifiable Yes.
Environment z/OS
Valid Values Y, N
Default N
Operator Modifiable
No
TIBCO Object Service Broker Parameters
276 | Chapter 4 Understanding Data Object Broker Parameters
UNICODEDIRThe path to the directory that contains the Unicode configuration files.
USERSHUTDOWNSpecifies whether a user is allowed to use the S6BTLADM (Administration menu) utility to shut down the Data Object Broker.
Environment Open Systems.
Abbreviated Name UNIDIR
Valid Values A valid directory path of up to 255 characters in length.
Must be the same as the UNICODEDIR Execution Environment parameter.
Default None, TIBCO Object Service Broker uses its default information for Unicode processing.
Effect The TIBCO Object Service Broker initialization code uses the files in this directory to configure Unicode processing.
In the absence of any of the files in the directory, TIBCO Object Service Broker uses the default information for that portion of Unicode processing: translation, casing, or collation.
Related Topics Refer to TIBCO Object Service Broker for Open Systems Installing and Operating for more information about Unicode configuration.
Operator Modifiable Yes.
Environment: z/OS.
Valid Values Y and N
Default Y
TIBCO Object Service Broker Parameters
Parameter Descriptions | 277
WORKINGSETThe maximum number of Pagestore pages that can be updated or physically locked (held) in a single Data Object Broker commit.
WTOCLASSThe output class of a dynamically allocated JES SYSOUT file where the Data Object Broker copies WTO (write to operator) messages.
Effects If USERSHUTDOWN is set to Y (allow shut down), a user can use the S6BTLADM (Administration menu) utility to display the Administration menu, and then use the operator functions to shut down the Data Object Broker.
Related Topics Refer to TIBCO Object Service Broker for z/OS Installing and Operating for more information on monitoring and controlling the TIBCO Object Service Broker environment using the Administration menu.
Operator Modifiable No.
Environment All.
Valid Values 32 to 512; and 999.
z/OS: Specify 999 to set this limit to the value of the CHPAGELIMIT parameter or 4096, whichever is the smaller value.
Open Systems: If 999 is specified, the limit is set to 15% of the checkpoint size or 50% of the redolog size, whichever is larger.
Default 256.
Recommendation Use 999 to avoid secondary indices becoming invalid.
Effects Requests attempting to update more pages than the specified value are aborted.
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
278 | Chapter 4 Understanding Data Object Broker Parameters
Use of this parameter enables the duplication of WTO messages. If it is not specified, WTO messages are not duplicated.
AssociatedDocumentation
The MVS Routing and Descriptor Codes IBM manual for code descriptions of WTO messages.
WTOCONSOLEThe minimum level of Data Object Broker WTO messages eligible for display on z/OS operator consoles. Message levels in descending order of importance are:
• A—action
• E—error
• W—warning
• I—information
• L—log
• N—messages not displayed
Environment z/OS.
Valid Values A to Z and 0 to 9
Default A
Recommendation If WTO messages are suppressed by WTOSYSLOG, this parameter should be specified to collect all WTO messages for problem diagnosis.
Effects There is minimal overhead in duplicating WTO messages.
Related Parameters • WTOHOLD on page 280
• WTOINTERVAL on page 280
• WTOREMOTE on page 281
Operator Modifiable Yes.
Environment z/OS.
Valid Values A, E, W, I, L, N
TIBCO Object Service Broker Parameters
Parameter Descriptions | 279
WTODELETEThe minimum level of Data Object Broker WTO messages to be suppressed rather than written to SYSLOG, or displayed on the z/OS operator console. The following message levels that can be suppressed:
• I—information
• L—log
The value N specifies that messages not be suppressed.
Default E
Recommendation Follow your site standard regarding message handling.
Effects WTOCONSOLE=N requests that messages not appear on the console during Data Object Broker execution. Messages of lower importance are issued in SYSLOG, except during startup, shut down, or operator command responses.
Related Parameters WTODELETE on page 279.
Operator Modifiable Yes.
Environment z/OS.
Valid Values I, L, N
Default N
Recommendation Follow your site standard regarding message handling.
Effects Specifying I deletes both I-level and L-level messages, except during startup, shut down, or operator command responses.
Related Parameters WTOCONSOLE on page 278.
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
280 | Chapter 4 Understanding Data Object Broker Parameters
WTOHOLDSpecifies whether the Data Object Broker’s WTO SYSOUT log data set is to be held in the JES output queue.
This parameter is in effect only if WTOCLASS is specified.
WTOINTERVALThe time interval after which the WTO output is to copied to a new data set. This parameter is in effect only if WTOCLASS is specified. A value of zero (0) disables this feature.
Environment z/OS.
Valid Values Y and N
Default N
Effects • If Y is specified, the JES SYSOUT data sets must be deleted manually from the output queue.
• If N is specified, these data sets are sent to their destination after the time interval set by WTOINTERVAL.
Related Parameters • WTOCLASS on page 277
• WTOINTERVAL on page 280
• WTOREMOTE on page 281
Operator Modifiable Yes.
Environment z/OS.
Valid Values 30 to 1440, and 0
Default 1440
Effects Specifying 1440 produces a spun JES SYSOUT log data set daily at midnight. After the log is spun, you can print or delete it. The smaller the interval, the more frequently a JES SYSOUT log data set is spun, each containing a smaller number of WTO messages.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 281
WTOPIDSpecifies whether to include the process ID (PID) in WTO messages.
WTOREMOTEThe output destination for this Data Object Broker’s JES WTO SYSOUT log data set.
This parameter is in effect only if WTOCLASS is specified.
Related Parameters WTOCLASS on page 277.
Operator Modifiable Yes, but modification is not recommended.
Environment Open Systems
Valid Values Y and N
Default N
Related Parameters • WTOSOURCE on page 282
• WTOTAG on page 283
• WTOTIME on page 283
Operator Modifiable Yes.
Environment z/OS.
Valid Values A valid destination of 1 to 8 characters in length
Default LOCAL
Effects When it is spun, the JES SYSOUT log data set is routed to the defined destination.
Related Parameters • WTOCLASS on page 277
• WTOHOLD on page 280
Operator Modifiable Yes.
TIBCO Object Service Broker Parameters
282 | Chapter 4 Understanding Data Object Broker Parameters
WTOSOURCESpecifies whether to include source code origin in the ERRNOTRACE messages.
WTOSUFFIXThe suffix that identifies messages issued from a specific Data Object Broker and that is appended to all Data Object Broker messages, for example, S6BDB090I-XXXX. This is also a Message Switch parameter.
WTOSYSLOGThe minimum level of messages to be written to the z/OS JES WTO SYSOUT file. All messages are written to the Data Object Broker JES SYSOUT file.
Message levels in descending order of importance are:
• A—action
• E—error
Environment Open Systems.
Valid Values Y and N
Default Y
Related Parameters • WTOPID on page 281
• WTOTAG on page 283
• WTOTIME on page 283
Operator Modifiable Yes.
Environment z/OS.
Valid Values 1 to 4 characters
Default None
Recommendation When several Data Object Brokers are active at the same time, this feature is useful for quickly determining which Data Object Broker issued a message.
Operator Modifiable If a value is not set, a value can be set by the operator.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 283
• W—warning
• I—information
• L—log only
A parameter value of N specifies that all messages are to be written to the z/OS SYSLOG.
WTOTAGSpecifies whether to include the user ID/transaction tag in WTO messages.
WTOTIMESpecifies whether to include the timestamp in WTO messages.
Environment z/OS.
Valid Values A, E, W, I, L, N
Default L
Recommendation Follow your site standards regarding message handling.
Related Parameters • WTODELETE on page 279
• WTOCONSOLE on page 278
Operator Modifiable Yes.
Environment Open Systems.
Valid Values Y and N
Default Y
Related Parameters • WTOPID on page 281
• WTOSOURCE on page 282
• WTOTIME on page 283
Operator Modifiable Yes.
Environment Open Systems.
TIBCO Object Service Broker Parameters
284 | Chapter 4 Understanding Data Object Broker Parameters
XCFGROUPThe XCF group that the Data Object Broker is to join. This is a Message Switch parameter.
Valid Values Y and N
Default Y
Related Parameters • WTOPID on page 281
• WTOSOURCE on page 282
• WTOTAG on page 283
Operator Modifiable Yes.
Environment z/OS.
Valid Values Any name that is unique to the set DOBs and message switches that comprise an OSB image.
Default None.
Effects This parameter enables support for multiple Data Object Brokers.
Related Topics See TIBCO Object Service Broker for z/OS Installing and Operating for details on how to use multiple Data Object Brokers.
Related Parameters • XCFMEMBER on page 285.
• XCFMODE on page 285.
• XCFSTRUCTURE on page 286.
Operator Modifiable No.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 285
XCFMEMBERThe member name of the Data Object Broker instance in the XCF group. This is a Message Switch parameter.
XCFMODEDetermines if a Data Object Broker is a primary or secondary Data Object Broker at startup. This is a Message Switch parameter.
Environment z/OS.
Valid Values Any valid XCF member name of up to eight characters.
Default The Job name of this Data Object Broker instance.
Related Topics See TIBCO Object Service Broker for z/OS Installing and Operating for details on how to use multiple Data Object Brokers.
Related Parameters • XCFGROUP on page 284.
• XCFMODE on page 285.
• XCFSTRUCTURE on page 286.
Operator Modifiable No.
Environment z/OS.
Valid Values AUTOMATIC, SECONDARY
Default AUTOMATIC.
Effects • AUTOMATIC — This DOB becomes the primary Data Object Broker if no primary Data Object Broker already exists in the XCF Group.
• SECONDARY — This Data Object Broker initializes as a secondary Data Object Broker.
Related Topics See TIBCO Object Service Broker for z/OS Installing and Operating for details on how to use multiple Data Object Brokers.
TIBCO Object Service Broker Parameters
286 | Chapter 4 Understanding Data Object Broker Parameters
XCFSTRUCTUREThe name of Coupling Facility structure to be used by this Data Object Broker group. This is a Message Switch parameter.
XCFWAITTIMEThe number of seconds an MSW address space waits for the primary Data Object Broker to become available. This is a Message Switch parameter.
Related Parameters • XCFGROUP on page 284.
• XCFMEMBER on page 285.
• XCFSTRUCTURE on page 286.
Operator Modifiable No.
Environment z/OS.
Valid Values Any valid Coupling Facility structure name.
Default None.
Related Topics See TIBCO Object Service Broker for z/OS Installing and Operating for details on how to use multiple Data Object Brokers.
Related Parameters • XCFGROUP on page 284.
• XCFMEMBER on page 285.
• XCFMODE on page 285.
Operator Modifiable No.
Environment z/OS.
Valid Values 0 – 43200.
Default None.
Effects 0 means to wait indefinitely.
TIBCO Object Service Broker Parameters
Parameter Descriptions | 287
XTABLESIZEThe size, in kilobytes, of the buffer pool for XTABLEs, the internal representations of TIBCO Object Service Broker report and screen definitions.
Related Topics See TIBCO Object Service Broker for z/OS Installing and Operating for details on how to use multiple Data Object Brokers.
Operator Modifiable Yes.
Environment z/OS.
Valid Values 4 to 31
Default 16
Recommendation Use the default initially, and adjust if necessary. The default value supports approximately 150 fields.
The ESTIMATETBLDFN tool provides an approximation of XTABLE size required for screen and report definitions.
Effects If the XTABLESIZE is too small to accommodate the definition, the transaction requesting the definition fails.
The Data Object Broker allocates the XTABLE pool in blocks, the size of which is determined by this parameter. This XTABLE pool is above the 16 MB line.
The number of buffers is MAXTHREADS +4.
Operator Modifiable No.
Related Topics Refer to TIBCO Object Service Broker Shareable Tools for information about the ESTIMATETBLDFN tool.
TIBCO Object Service Broker Parameters
288 | Chapter 4 Understanding Data Object Broker Parameters
TIBCO Object Service Broker Parameters
| 289
Appendix A External Database Server Parameters
This appendix lists TIBCO Object Service Broker’s external database parameters used by the TIBCO Object Service Broker Gateways and the Datacom and Adabas servers. Refer to the appropriate Service Gateway manual for details on how to set those parameters.
For details on the Datacom and Adabas servers, see the Service Gateway for Files SDK User's Guide.
Topics
• Listing of the Parameters, page 290
TIBCO Object Service Broker Parameters
290 | Appendix A External Database Server Parameters
Listing of the Parameters
Valid Parameters by Server TypeThe following table lists the valid parameters for the external gateway or server. Y denotes that the parameter is used by a given gateway or server.
Gateway or Server Type
Parameter Name Ad
abas
Dat
aco
m
IDM
S/D
B
DB
2
IMS
/DB
SQ
L a
nd
Ora
cle
ACCOUNT
BROWSEPLAN Y
BUFFERLEN Y
CICSHURON Y
CLASS Y
DBDCLASS Y
DEBUG Y Y Y
DEBUGLEVEL Y Y
DECIMALPOINT Y
DECOUPL Y
DLIQUERYLIMIT Y
DLIUPDATELIMIT Y
DRASUFFIX Y
DUMP Y Y
DUMPLIMIT Y Y
EXTERNALGROUP Y Y Y Y
EXTERNALROUTINE Y
TIBCO Object Service Broker Parameters
Listing of the Parameters | 291
EXTERNALSECURITY Y
EXTERNALUSERID Y Y Y Y
FSLEVEL Y Y Y Y Y Y
FSTABLENAME Y Y Y Y Y
IDPREFIX Y Y Y Y Y Y
IFAMCHNL
INVARSLEN Y
KEEPLOG Y Y
LIBRARY Y
LOGMEDIA Y Y
MDL Y Y Y Y Y
MIXEDSSCDETECTION Y
MODE Y
NONSWAPPABLE Y
NOSTAE Y
OTHERPASSWORD Y
OTHERUSERID Y
OUTVARSLEN Y
PLAN Y Y
POOLSIZE Y Y Y Y
PROGRAMLIBRARY Y Y
PSBCLASS Y
Gateway or Server Type
Parameter Name Ad
abas
Dat
aco
m
IDM
S/D
B
DB
2
IMS
/DB
SQ
L a
nd
Ora
cle
TIBCO Object Service Broker Parameters
292 | Appendix A External Database Server Parameters
PSBNAME Y
RECOVERYID Y Y Y
RECOVERYPASSWORD Y
REQSTOR Y
RESOURCE Y
RESPONSEMODE Y Y Y Y
RUNAWAY Y
SCOPE Y Y Y
SECLEVEL Y Y Y Y
SEGCLASS Y
SERVERID Y Y Y Y Y Y
SERVERPARM Y
SERVERS Y Y Y Y Y
SERVERSTATISTICS Y Y
SERVERTYPE Y Y Y Y
SESSIONPASSWORD Y
SESSIONUSERID Y
SSID Y
STATEMENTLEN Y
STATICCURSORSELECT Y
SUBSYS Y
TDS Y Y Y Y Y
Gateway or Server Type
Parameter Name Ad
abas
Dat
aco
m
IDM
S/D
B
DB
2
IMS
/DB
SQ
L a
nd
Ora
cle
TIBCO Object Service Broker Parameters
Listing of the Parameters | 293
THREADUSAGE Y
TRACE Y N Y Y Y
TRXDB Y Y Y Y Y
UPDATEPLAN Y
USEDB2LIKE Y
USERTYPE Y Y
VERIFYEXTACCESS Y
Gateway or Server Type
Parameter Name Ad
abas
Dat
aco
m
IDM
S/D
B
DB
2
IMS
/DB
SQ
L a
nd
Ora
cle
TIBCO Object Service Broker Parameters
294 | Appendix A External Database Server Parameters
TIBCO Object Service Broker Parameters
| 295
Index
Symbols
@OPENDSN tool 57, 69@READDSN tool 56, 69@WRITEDSN tool 56, 69$GETOPT tool 52$SETSESSIONEND tool 141, 142
A
ACCOUNT server parameter 290ACTION Execution Environment parameter 30ADAYS Execution Environment parameter 31ALLOWSESSIONTIMEOUTLIMIT Execution Envi-
ronment parameter 31AMONTHS Execution Environment parameter 32
B
BATCHCONSOLE Execution Environment parameter 33
BINDINGAREASADDRESS Execution Environment parameter 33
BINDINGAREASKEY Execution Environment parameter 34
BLTINNUM Execution Environment parameter 34BROWSE Execution Environment parameter 35BROWSEPLAN server parameter 290BUFFERLEN server parameter 290BWO Data Object Broker parameter 204
C
CHARSET Execution Environment parameter 35CHKTRACE Data Object Broker parameter 204CHPAGELIMIT Data Object Broker parameter 204CHPTINTERVAL Data Object Broker parameter 206CHTRANLIMIT Data Object Broker parameter 206CICSECONTAINER Execution Environment
parameter 37CICSHURON server parameter 290CICSHURONTRAN Execution Environment
parameter 38CICSPCONTAINER Execution Environment
parameter 37CICSPSEUDOCONVERSE Execution Environment
parameter 39CICSREGIONSIZE Execution Environment
parameter 39CICSVSAMSYNC Execution Environment
parameter 40CLASS server parameter 290CLICODEPAGE Execution Environment
parameter 41CLIENDIAN Execution Environment parameter 41CLIENTHOSTNAME Execution Environment
parameter 42CLIENTIP Execution Environment parameter 43CLIENTPORT Execution Environment parameter 43CLIHOST Execution Environment parameter 43CLIMSGLENMAX Execution Environment
parameter 44CLINODE Execution Environment parameter 45CLIPORT Execution Environment parameter 46CLITIMEOUTLIMIT Execution Environment
parameter 46CLOGRETRYINT Data Object Broker parameter 207CLOSE Execution Environment parameter 47CLOSEEE Execution Environment parameter 47
TIBCO Object Service Broker Parameters
296 | Index
CNTL data set membersEECONFIG 3OSRUNPRM 193
COMMID Data Object Broker parameter 208COMMITSIZE Execution Environment parameter 48CONFIGURATION Execution Environment
parameter 49
TIBCO Object Service Broker Parameters
Index | 297
Configuration parametersdescription of 3ACTION 30ALLOWSESSIONTIMEOUTLIMIT 31BLTINNUM 34BROWSE 35CHARSET 35CICSECONTAINER 37CICSHURONTRAN 38CICSPCONTAINER 37CICSPSEUDOCONVERSE 39CICSREGIONSIZE 39CICSVSAMSYNC 40EENAME 61ERRMESSAGESCREEN 64EXECHASHSIZE 66EXECLOCALNAMESIZE 67EXECLOCALSIZE 67EXECSCOPESIZE 68EXECSTACKSIZE 69FILEGDGSEARCH 69IMSSCREENATTRIBU 78IMSSCREENTRAN 79IMSSCREENTRANNC 80INSTLIB 81LOGONRULENAME 89MDL 91MSGLOGMAX 94NOBROWSE 31, 35NOSMFDETAIL 97NOSTAE 156NOTEST 178ONLINE 98PEERSERVERID 101PEERSERVERNUM 102PROFILE 115, 115REGIONTRACE 117REGIONTRACESIZE 118REGIONTYPE 119SECACLSIZE 127SECADMINSIZE 128SECAUDITLOG 129SECCLASS 130SECOBJSIZE 131SECPACLSIZE 132
SECREQUESTOR 132SECSUBSYSTEM 133SECUSERSIZE 135SERVERID 136SERVERS 137SESSDSPXFRSCRMAX 140SESSIONFILEMAX 142SESSIONMEMMAX 145SMFDETAIL 148SMFPERFORMANCE 149SMFTYPE 150SORTEXTMEMMAX 151SORTINTPAGESMAX 153SORTPGM 153SORTPRINT 154SORTUNIT 154SORTWORKFILESMAX 155STAE 156STANDBYNUM 157STATSBUF 160SVC 165SYNTAXVBLANKPAD 166SYSLIB 167TAMBMAX 169TAMBMIN 169TASKEXECNUM 170TASKFILENUM 171TASKINITNUM 171TASKMISCNUM 172TASKOPERNUM 172TASKPOSIXNUM 173TASKRCLINUM 173TASKSMFNUM 174TASKSORTNUM 174TDS 175TEMPPRIMARYCYL 176TEMPSECONDARY 176TEMPUNIT 177TEMPUNITCOUNT 178TEST 178TIMEOUTLIMIT 180TRANDSPXFRSCRMAX 181TRANMAXNUM 182TRANMEMMAX 183VARLDELIMITER 186
TIBCO Object Service Broker Parameters
298 | Index
VARRDELIMITER 187CONNTIMEOUT Execution Environment
parameter 50CTABAGE Data Object Broker parameter 208CTABLESIZE Data Object Broker parameter 209CTABRESIDENT Data Object Broker parameter 209customer support xxii
D
Data Object Broker parametersdescriptions of 203–287specifying 191–195
Data Object Broker parameters, operator modifiable See operator modifiable, Data Object Broker parameters
DATAPAGELIMIT Data Object Broker parameter 210DATEFORMAT Execution Environment parameter 50DAYS Execution Environment parameter 51DB2LOG Execution Environment parameter 52DBDCLASS server parameter 290DBMS parameters. See server parametersDBPROFILE Data Object Broker parameter 211DBSNAP Data Object Broker parameter 212DEBUG server parameter 290DEBUGLEVEL server parameter 290DECIMALPOINT server parameter 290DECIMALSEPARATOR Execution Environment
parameter 52DECOUPL server parameter 290DEFAULT_EE_NAME system parameter 53DEFAULT_MON_NAME system parameter 53DEFAULT_SESSION_NAME system parameter 53DEFAULT_TTY_NAME system parameter 54DELETELOG OSB monitor parameter 54DESCACTION Data Object Broker parameter 212DESCERROR Data Object Broker parameter 213DESCINFORM Data Object Broker parameter 213DESCLOG Data Object Broker parameter 214DESCWARN Data Object Broker parameter 214DLIQUERYLIMIT server parameter 290DLIUPDATELIMIT server parameter 290DOB Execution Environment parameter 55
DRASUFFIX server parameter 290DSBIFTYPE Execution Environment parameter 56DSDIR Execution Environment parameter 57DSFIELDSEP Execution Environment parameter 57DSIXFTYPE Execution Environment parameter 58DSQUOTE Execution Environment parameter 59DUMP server parameter 290DUMPLIMIT server parameter 290DUPLEXLOGFAIL Data Object Broker parameter 215DUPUSERID Data Object Broker parameter 215
E
EEBIN Execution Environment parameter 60EECONFIG member, of CNTL data set 3EEINSTANCE Execution Environment parameter 60EELOG Execution Environment parameter 60EENAME Execution Environment parameter 61EEWTODELETE Execution Environment
parameter 63, 63environment variables, syntax 12ERRMESSAGESCREEN Execution Environment
parameter 64ERRNOTRACE Data Object Broker parameter 217ESTAE Data Object Broker parameter 217ESTIMATETBLDFN tool 209, 209, 287, 287EVENTLOG Data Object Broker parameter 218EVENTLOGHOST system parameter 65EVENTLOGMSGTYPES system parameter 66EXECHASHSIZE Execution Environment
parameter 66EXECLOCALNAMESIZE Execution Environment
parameter 67EXECLOCALSIZE Execution Environment
parameter 67EXECSCOPESIZE Execution Environment
parameter 68EXECSTACKSIZE Execution Environment
parameter 69Execution Environment 101, 166Execution Environment initialization 37, 37
TIBCO Object Service Broker Parameters
Index | 299
Execution Environment initialization parametersdescription of 3ACTION 30ALLOWSESSIONTIMEOUTLIMIT 31BINDINGAREASADDRESS 33BINDINGAREASKEY 34BLTINNUM 34BROWSE 35CHARSET 35CICSHURONTRAN 38CICSPSEUDOCONVERSE 39CICSREGIONSIZE 39CLIMSGLENMAX 44COMMITSIZE 48CONFIGURATION 49DB2LOG 52DOB 55EELOG 60EENAME 61ERRMESSAGESCREEN 64EXECHASHSIZE 66EXECLOCALNAMESIZE 67EXECLOCALSIZE 67EXECSCOPESIZE 68EXECSTACKSIZE 69FILEGDGSEARCH 69HELP 76IDLETIMEOUT 78IMSSCREENATTRIBU 78IMSSCREENTRAN 79IMSSCREENTRANNC 80INSTANCE 81INSTLIB 81INSTLIBNUM 83KEEPEELOG 84KERNEL 87LOGONRULENAME 89MAXSESSION 90MDL 91MSGLOGMAX 94NOBROWSE 31, 35NOSTAE 156NOTEST 178NOVERBOSE 188OSDIR 99
OSMONDOB 99OSMONNAME 100OSMONPORT 100OSMONPROCID 100PEERSERVERNUM 102PRINTCLASS 103PRINTCOPY 104PRINTDATASET 104PRINTDEST 105PRINTDIRECTION 107PRINTERRORLOG 108PRINTFCB 109PRINTFORM 110PRINTSPOOLCLASS 111PRINTUCS 112PRINTXWTR 113PROCESSID 114PROFILE 115, 115REGIONTABLESIZE 116REGIONTRACE 117REGIONTRACESIZE 118REGIONTYPE 119REJECTSHUTI 120SEARCH 124SECACLSIZE 127SECADMINSIZE 128SECAUDITLOG 129SECOBJSIZE 131SECPACLSIZE 132SECURITY 133SECUSERSIZE 135SERVERID 136SERVERS 137SESSDSPXFRSCRMAX 140SESSIONFILEMAX 142SESSIONMEMMAX 145SMFDETAIL 148SMFPERFORMANCE 149SMFTYPE 150SORTEXTMEMMAX 151SORTINTPAGESMAX 153SORTPGM 153SORTPRINT 154SORTUNIT 154SORTWORKFILESMAX 155
TIBCO Object Service Broker Parameters
300 | Index
STAE 156STANDBYNUM 157STATSBUF 160SYSLIB 167TAMBMAX 169TAMBMIN 169TAMBSTS 170TASKEXECNUM 170TASKFILENUM 171TASKINITNUM 171TASKMISCNUM 172TASKOPERNUM 172, 173TASKSMFNUM 173, 174TASKSORTNUM 174TDS 175TEMPPRIMARYCYL 176TEMPSECONDARY 176TEMPUNIT 177TEMPUNITCOUNT 178TEST 178TIMEOUTLIMIT 180TRANDSPXFRSCRMAX 181TRANMAXNUM 182TRANMEMMAX 183UNICODEDIR 184VARLDELIMITER 186VARRDELIMITER 187VERBOSE 188WORKINGDIR 188YYCENTURYRANGE 188
Execution Environment parameters, description of 2Execution Environment parameters, descriptions
of 29–189Execution Environment parameters, usage of 1–14external database server parameters, listing
of 289–293EXTERNALGROUP server parameter 290EXTERNALROUTINE server parameter 290EXTERNALSECURITY server parameter 291EXTERNALUSERID server parameter 291
F
FILEGDGSEARCH Execution Environment parameter 69
FIXEDRPDPOOL Data Object Broker parameter 218FSLEVEL server parameter 291FSTABLENAME server parameter 291
G
GTFID Data Object Broker parameter 219
H
HAWKANAME Data Object Broker parameter 220HAWKANAME Execution Environment
parameter 70HAWKDAEMON Data Object Broker parameter 220HAWKDAEMON Execution Environment
parameter 71HAWKDNAME Data Object Broker parameter 221HAWKDNAME Execution Environment
parameter 72HAWKNETWORK Data Object Broker parameter 221HAWKNETWORK Execution Environment
parameter 73HAWKPOLL Data Object Broker parameter 222HAWKPOLL Execution Environment parameter 74HAWKSERVICE Data Object Broker parameter 223HAWKSERVICE Execution Environment
parameter 75HEAPSIZE Data Object Broker parameter 223HELP Execution Environment parameter 76HOST Execution Environment parameter 76HRNIN DDNAME, format for use 13
I
IBMFLOAT Execution Environment parameter 77
TIBCO Object Service Broker Parameters
Index | 301
IDLETIMEOUT Execution Environment parameter 78IDPREFIX server parameter 291IFAMCHNL server parameter 291IMSSCREENATTRIBU Execution Environment
parameter 78IMSSCREENTRAN Execution Environment
parameter 79IMSSCREENTRANNC Execution Environment
parameter 80initialization parameters See Execution Environment
initialization parametersINSTANCE Execution Environment parameter 81INSTLIB Execution Environment parameter 81INSTLIBNUM Execution Environment parameter 83INVARSLEN server parameter 291IOTRACE Data Object Broker parameter 224IP Execution Environment parameter 83IPCKEY Execution Environment parameter 84
J
JOURNALS Data Object Broker parameter 224
K
KEEPEELOG Execution Environment parameter 84KEEPLOG server parameter 291KEEPOSMONLOG OSB monitor parameter 85KEEPSESSIONLOG OSB monitor parameter 86KEEPTTYLOG Execution Environment parameter 87KERNEL Execution Environment parameter 87
L
length of parameter lists 12LIBRARY Execution Environment parameter 88LIBRARY server parameter 291LOCKBUFFERS Data Object Broker parameter 225LOCKTIMEOUT Data Object Broker parameter 226
LOGFILEMSGTYPES system parameter 88LOGFILEPATH system parameter 89LOGMEDIA server parameter 291LOGMESSAGE Data Object Broker parameter 226LOGONRULENAME Execution Environment
parameter 89
M
MAXCONCURRENT Data Object Broker parameter 227
MAXDBMS Data Object Broker parameter 227MAXDISPLAY Data Object Broker parameter 228MAXEE Execution Environment parameter 90MAXNODES Data Object Broker parameter 228MAXOPERATORS Data Object Broker parameter 229MAXQUERY Data Object Broker parameter 229MAXRESOURCES Data Object Broker parameter 230MAXSESSION Execution Environment parameter 90MAXTDSEXTENTS Data Object Broker
parameter 230MAXTHREADS Data Object Broker parameter 231MAXUSERS Data Object Broker parameter 231MAXVSAMC Data Object Broker parameter 232MDL Execution Environment parameter 91MDL server parameter 291message switch parameters 192MIXEDSSCDETECTION server parameter 291MODE server parameter 291MODIFY z/OS operator command, overriding Data
Object Broker startup parameters 193MONHOST Execution Environment parameter 92MONLOG Execution Environment parameter 92MONNAME Execution Environment parameter 93MONPORT Execution Environment parameter 93MONTHS Execution Environment parameter 94MSGLOGMAX Execution Environment parameter 94MSGSIZE Data Object Broker parameter 234MSGTRACE Data Object Broker parameter 234
TIBCO Object Service Broker Parameters
302 | Index
N
NAME Execution Environment parameter 95NETVIEWBASE Data Object Broker parameter 235NOALLOWSESSIONTIMEOUTLIMIT Execution
Environment parameter. See ALLOWSESSION-TIMEOUTLIMIT Execution Environment param-eter
NOBATCHCONSOLE Execution Environment parameter. See BATCHCONSOLE Execution Environment parameter
NOBROWSE Execution Environment parameter 31, 35
NOBROWSE Execution Environment parameter. See BROWSE Execution Environment parameter
NODENAME Data Object Broker parameter 235NONSWAPPABLE server parameter 291NOPRINTPORTRAIT Execution Environment
parameter 111NOPRINTPORTRAIT Execution Environment param-
eter. See PRINTPORTRAIT Execution Environ-ment parameter
NOPROFILE Execution Environment parameter. See PROFILE Execution Environment parameter
NOPROMPT Execution Environment parameter 115NOPROMPT Execution Environment parameter. See
PROMPT Execution Environment parameterNORELOADPARAMS Execution Environment
parameter 120NORELOADPARAMS Execution Environment
parameter. See RELOADPARAMS Execution Environment parameter
NOSESSIONLOGCLEAR Execution Environment parameter
Session startup parametersNOSESSIONLOGCLEAR 144
NOSESSIONLOGCLEAR Execution Environment parameter. See SESSIONLOGCLEAR Execution Environment parameter
NOSESSIONPARMLIST Execution Environment parameter 146
NOSESSIONPARMLIST Execution Environment parameter. See SESSIONPARMLIST Execution Environment parameter
NOSMFDETAIL Execution Environment
parameter 97NOSTAE Execution Environment parameter 156NOSTAE Execution Environment parameter. See STAE
Execution Environment parameterNOSTAE server parameter 291NOSTOP Execution Environment parameter. See
STOP Execution Environment parameterNOSTOPALL Execution Environment parameter. See
STOPALL Execution Environment parameterNOTEST Execution Environment parameter 178NOTEST Execution Environment parameter. See TEST
Execution Environment parameterNOVERBOSE Execution Environment parameter 188NOVERBOSE Execution Environment parameter. See
VERBOSE Execution Environment parameter
O
Object Integration Gateway, session startup parameters 4
ONLINE Execution Environment parameter 98OPERATOR Data Object Broker parameter 236
TIBCO Object Service Broker Parameters
Index | 303
operator modifiable, Data Object Broker parametersCHPTINTERVAL 206DBPROFILE 211DBSNAP 212DUPUSERID 215GTFID 219LOCKTIMEOUT 226MAXUSERS 231MSGTRACE 234NETVIEWBASE 235PAGESWEEPACTION 236PAGESWEEPLIMIT 237REMOTEDUP 240SECUREADMIN 248SMF13INTERVAL 252SMF22INTERVAL 253SMF23INTERVAL 254SMF24INTERVAL 254SMF25INTERVAL 255SMF26INTERVAL 256, 257, 257SMF47INTERVAL 258SMFRECORD 251SNAPCLASS 259SNAPDSPREFIX 259SNAPHOLD 260SNAPOVERRIDE 261SNAPQUERY 262SNAPREMOTE 262SNAPSUPPRESS 263SNAPUNIT 263SNAPVOLSER 264SPININTERVAL 265SSTRACE 268, 270SVCTRACE 271SYNCTRACE 272TIMESTAMP 274TRXREADLIMIT 274WTOCLASS 277WTOCONSOLE 278WTODELETE 279WTOHOLD 280WTOINTERVAL 280WTOREMOTE 281WTOSUFFIX 282WTOSYSLOG 283
OSB Accelerator Pack for z/OS 229OSB monitor parameters
description of 5CLOSE 47CLOSEEE 47CONNTIMEOUT 50DELETELOG 54DOB 55EEBIN 60HELP 76HOST 76INSTLIB 81IP 83IPCKEY 84KEEPOSMONLOG 85KEEPSESSIONLOG 86MAXEE 90MONLOG 92MONNAME 93NORELOADPARAMS 120NOVERBOSE 188PORT 103RELOADPARAMS 120RULESIZE 124SECURITYSIZE 134SERVERRETRIES 137SERVERS 137SHAREDMEMADDR 148STATUS 161STOP 162STOPALL 163STOPEE 164STOPSESS 164TABLESIZE 168TN3270PORT 181VERBOSE 188
OSDIR Execution Environment parameter 99OSMONDOB Execution Environment parameter 99OSMONNAME Execution Environment
parameter 100OSMONPORT Execution Environment parameter 100OSMONPROCID Execution Environment
parameter 100OSRUNPRM member, CNTL data set 193
TIBCO Object Service Broker Parameters
304 | Index
ostty parametersKEEPTTYLOG 87MONHOST 92MONPORT 93NAME 95SESSNAME 147TTYLOGFILE 184
OTHERPASSWORD server parameter 291OTHERUSERID server parameter 291OUTVARSLEN server parameter 291
P
PAGESWEEPACTION Data Object Broker parameter 236
PAGESWEEPLIMIT Data Object Broker parameter 237
parameter values, determining forData Object Broker 193Execution Environment 6–11
parametersData Object Broker. See Data Object Broker parame-
tersExecution Environment. See Execution Environment
parametersservers. See server parameters
PASSWORD Execution Environment parameter 101PEERS Data Object Broker parameter 239PEERSERVERID Execution Environment
parameter 101PEERSERVERNUM Execution Environment
parameter 102PLAN server parameter 291POOLSIZE server parameter 291PORT Execution Environment parameter 103PRINTCLASS Execution Environment parameter 103PRINTCOPY Execution Environment parameter 104PRINTDATASET Execution Environment
parameter 104PRINTDEST Execution Environment parameter 105PRINTDIRECTION Execution Environment
parameter 107PRINTERRORLOG Execution Environment
parameter 108PRINTFCB Execution Environment parameter 109PRINTFORM Execution Environment parameter 110PRINTPAPERSIZE Execution Environment
parameter 110PRINTPORTRAIT Execution Environment
parameter 111PRINTSPOOLCLASS Execution Environment
parameter 111PRINTUCS Execution Environment parameter 112PRINTXWTR Execution Environment parameter 113PRIVILEGED Data Object Broker parameter 239PROCESSID Execution Environment parameter 114PROFILE Execution Environment parameter 115, 115PROGRAMLIBRARY server parameter 291PROMPT Execution Environment parameter 115PSBCLASS server parameter 291PSBNAME server parameter 292
Q
QUARTERS Execution Environment parameter 116
R
RECOVERYID server parameter 292RECOVERYPASSWORD server parameter 292REGIONTABLESIZE Execution Environment
parameter 116REGIONTRACE Execution Environment
parameter 117REGIONTRACESIZE Execution Environment
parameter 118REGIONTYPE Execution Environment parameter 119REJECTSHUTI Execution Environment
parameter 120RELOADPARAMS Execution Environment
parameter 120REMOTEDUP Data Object Broker parameter 240REQSTOR server parameter 292RESAGE Data Object Broker parameter 241
TIBCO Object Service Broker Parameters
Index | 305
RESIDENTHASHSIZE Data Object Broker parameter 241
RESIDENTPAGES Data Object Broker parameter 242RESOURCE server parameter 292RESPONSEMODE server parameter 292ROUTACTION Data Object Broker parameter 243ROUTERROR Data Object Broker parameter 244ROUTINFORM Data Object Broker parameter 244ROUTLOG Data Object Broker parameter 245ROUTWARN Data Object Broker parameter 246RSCSCHEDULES Data Object Broker parameter 246RULE Execution Environment parameter 121RULESIZE Execution Environment parameter 124RUNAWAY server parameter 292
S
SCOPE server parameter 292SEARCH Execution Environment parameter 124SECACLSIZE Execution Environment parameter 127SECADMINSIZE Execution Environment
parameter 128SECAUDITLOG Execution Environment
parameter 129SECCLASS Data Object Broker parameter 247SECCLASS Execution Environment parameter 130SECLEVEL server parameter 292SECOBJSIZE Execution Environment parameter 131SECPACLSIZE Execution Environment
parameter 132SECREQUESTOR Data Object Broker parameter 247SECREQUESTOR Execution Environment
parameter 132SECSUBSYSTEM Execution Environment
parameter 133SECSUBSYSTEMData Object Broker parameter 248SECUREADMIN Data Object Broker parameter 248SECURITY Execution Environment parameter 133SECURITYSIZE Execution Environment
parameter 134SECUSERSIZE Execution Environment parameter 135SEGCLASS server parameter 292server parameters, listing of 289–293
SERVERID Execution Environment parameter 136SERVERID server parameter 292SERVERLOGPATH Execution Environment
parameter 136SERVERPARM server parameter 292SERVERRETRIES Execution Environment
parameter 137SERVERS Execution Environment parameter 137SERVERS server parameter 292SERVERSTATISTICS server parameter 292SERVERTYPE Execution Environment parameter 138SERVERTYPE server parameter 292SESSDSPXFRSCRMAX Execution Environment
parameter 140
TIBCO Object Service Broker Parameters
306 | Index
Session startup parametersdescription of 4ACTION 30ADAYS 31AMONTHS 32BATCHCONSOLE 33BROWSE 35CHARSET 35CICSVSAMSYNC 40CLICODEPAGE 41CLIENDIAN 41CLIENTHOSTNAME 42CLIENTIP 43CLIENTPORT 43CLIHOST 43CLINODE 45CLIPORT 46CLITIMEOUTLIMITT 46DATEFORMAT 50DAYS 51DECIMALSEPARATOR 52DSBIFTYPE 56DSDIR 57DSFIELDSEP 57DSIXFTYPE 58DSQUOTE 59EEINSTANCE 60EENAME 61EEWTODELETE 63, 63ERRMESSAGESCREEN 64EXECLOCALSIZE 67EXECSTACKSIZE 69FILEGDGSEARCH 69IBMFLOAT 77INSTLIB 81LIBRARY 88MONTHS 94MSGLOGMAX 94NOBROWSE 31, 35NOPRINTPORTRAIT 111NOPROMPT 115NOSESSIONPARMLIST 146NOSTAE 156NOTEST 178ONLINE 98
PASSWORD 101PRINTCLASS 103PRINTCOPY 104PRINTDATASET 104PRINTDEST 105PRINTDIRECTION 107PRINTERRORLOG 108PRINTFCB 109PRINTFORM 110PRINTPAPERSIZE 110PRINTPORTRAIT 111PRINTUCS 112PRINTXWTR 113PROFILE 115, 115PROMPT 115QUARTERS 116RULE 121SEARCH 124SECURITY 133SERVERID 136SERVERLOGPATH 136SERVERTYPE 138SESSDSPXFRSCRMAX 140SESSIONENDACTION 140SESSIONENDVALUE 141SESSIONFILEMAX 142SESSIONINSTANCE 143SESSIONLOG 143SESSIONLOGCLEAR 144SESSIONMEMMAX 145SESSIONPARMLIST 146SESSIONTYPE 146SESSIONUSERID 147SMFDETAIL 148SMFPERFORMANCE 149SORTPRINT 154SORTWORKFILESMAX 155STAE 156SYSLIB 167TEST 178THREADID 179THREADPOSIXNUM 180TIMEOUTLIMIT 180TRANDSPXFRSCRMAX 181TRANMEMMAX 183
TIBCO Object Service Broker Parameters
Index | 307
USERID 185VARLDELIMITER 186VARRDELIMITER 187
SESSIONENDACTION Execution Environment parameter 140
SESSIONENDVALUE Execution Environment parameter 141
SESSIONFILEMAX Execution Environment parameter 142
SESSIONINSTANCE Execution Environment parameter 143
SESSIONLOG Execution Environment parameter 143SESSIONLOGCLEAR Execution Environment
parameter 144SESSIONMEMMAX Execution Environment
parameter 145SESSIONPARMLIST Execution Environment
parameter 146SESSIONPASSWORD server parameter 292SESSIONTYPE Execution Environment
parameter 146SESSIONUSERID Execution Environment
parameter 147SESSIONUSERID server parameter 292SESSNAME Execution Environment parameter 147SHAREDMALIGN Data Object Broker parameter 249SHAREDMEMADDR Data Object Broker
parameter 250SHAREDMEMADDR Execution Environment
parameter 148SHAREDMEMPERM Data Object Broker
parameter 251SIXDATAPAGLIM Data Object Broker parameter 251SMFDETAIL Execution Environment parameter 148SMFPERFORMANCE Execution Environment
parameter 149SMFRECORD Data Object Broker parameter 251SMFTYPE Execution Environment parameter 150SMFxxINTERVAL Data Object Broker
parameters 252–258SNAPCLASS Data Object Broker parameter 259SNAPDSPREFIX Data Object Broker parameter 259SNAPHOLD Data Object Broker parameter 260SNAPOVERRIDE Data Object Broker parameter 261SNAPQUERY Data Object Broker parameter 262
SNAPREMOTE Data Object Broker parameter 262SNAPSUPPRESS Data Object Broker parameter 263SNAPUNIT Data Object Broker parameter 263SNAPVOLSER Data Object Broker parameter 264SORTEXTMEMMAX Execution Environment
parameter 151SORTINTMEMMAX Execution Environment
parameter 151SORTINTNUMMAX Execution Environment
parameter 152SORTINTPAGESMAX Execution Environment
parameter 153SORTPGM Execution Environment parameter 153SORTPRINT Execution Environment parameter 154SORTUNIT Execution Environment parameter 154SORTWORKFILESMAX Execution Environment
parameter 155SPINDSNAME Data Object Broker parameter 265SPININTERVAL Data Object Broker parameter 265SPINMEMBER Data Object Broker parameter 266SPINOPTION Data Object Broker parameter 267SPINSHELL Data Object Broker parameter 268SRBMODE Data Object Broker parameter 269SSID server parameter 292SSTRACE Data Object Broker parameter 270STAE Execution Environment parameter 156STANDBYNUM Execution Environment
parameter 157STANDBYWAIT Execution Environment
parameter 158STANDBYWAITLIMIT Execution Environment
parameter 159STANDBYWAITMSG Execution Environment
parameter 160STATEMENTLEN server parameter 292STATICCURSORSELECT server parameter 292STATSBUF Execution Environment parameter 160STATUS Execution Environment parameter 161STDERRTRACE Data Object Broker parameter 270STDOUTTRACE Data Object Broker parameter 271STOP Execution Environment parameter 162STOPALL Execution Environment parameter 163STOPEE Execution Environment parameter 164STOPSESS Execution Environment parameter 164SUBSYS server parameter 292
TIBCO Object Service Broker Parameters
308 | Index
support, contacting xxiiSVC Execution Environment parameter 165SVCTRACE Data Object Broker parameter 271SWAPPABLE Data Object Broker parameter 271SYNCTRACE Data Object Broker parameter 272syntax of environment variables 12SYNTAXVBLANKPAD Execution Environment
parameter 166SYSADMIN Data Object Broker parameter 272SYSLIB Execution Environment parameter 167SYSLOG, writing messages to 283system parameters
DEFAULT_EE_NAME 53DEFAULT_MON_NAME 53DEFAULT_SESSION_NAME 53DEFAULT_TTY_NAME 54description of 5EVENTLOGHOST 65EVENTLOGMSGTYPES 66LOGFILEMSGTYPES 88LOGFILEPATH 89
T
TABLESIZE Execution Environment parameter 168TAMBMAX Execution Environment parameter 169TAMBMIN Execution Environment parameter 169TAMBSTS Execution Environment parameter 170TASKEXECNUM Execution Environment
parameter 170TASKFILENUM Execution Environment
parameter 171TASKINITNUM Execution Environment
parameter 171TASKMISCNUM Execution Environment
parameter 172TASKOPERNUM Execution Environment
parameter 172TASKPOSIXNUM Execution Environment
parameter 173TASKRCLINUM Execution Environment
parameter 173TASKSMFNUM Execution Environment
parameter 174TASKSORTNUM Execution Environment
parameter 174TDS Execution Environment parameter 175TDS server parameter 292technical support xxiiTEMPPRIMARYCYL Execution Environment
parameter 176TEMPSECONDARY Execution Environment
parameter 176TEMPUNIT Execution Environment parameter 177TEMPUNITCOUNT Execution Environment
parameter 178TEST Execution Environment parameter 178THREADID Execution Environment parameter 179THREADPOSIXNUM Execution Environment
parameter 180THREADUSAGE server parameter 293TIBCO_HOME xixTIMEOUTABEND Data Object Broker parameter 273TIMEOUTLIMIT Execution Environment
parameter 180TIMEOUTSTART Data Object Broker parameter 273TIMEOUTSTOP Data Object Broker parameter 273TIMESTAMP Data Object Broker parameter 274TN3270PORT Execution Environment parameter 181tools
@OPENDSN 57, 69@READDSN 56, 69@WRITEDSN 56, 69$GETOPT 52$SETSESSIONEND 141, 142ESTIMATETBLDFN 209, 209, 287, 287
TRACE server parameter 293TRANDSPXFRSCRMAX Execution Environment
parameter 181TRANMAXNUM Execution Environment
parameter 182TRANMEMMAX Execution Environment
parameter 183TRXDB server parameter 293TRXREADLIMIT Data Object Broker parameter 274TTYLOGFILE Execution Environment parameter 184
TIBCO Object Service Broker Parameters
Index | 309
U
UNICODEDIR Data Object Broker parameter 276UNICODEDIR Execution Environment
parameter 184UPDATEPLAN server parameter 293USEDB2LIKE server parameter 293user modifiable, Execution Environment parameters
ACTION 30ADAYS 31ALLOWSESSIONTIMEOUTLIMIT 31AMONTHS 32BATCHCONSOLE 33BLTINNUM 34BROWSE 35CHARSET 35CICSHURONTRAN 38CICSPSEUDOCONVERSE 39CICSREGIONSIZE 39CICSVSAMSYNC 40CLIENDIAN 42CLIHOST 43CLIMSGLENMAX 44CLINODE 45CLOSE 47CLOSEEE 46, 47, 70, 71, 72, 73, 74, 75, 220, 220, 221,
TIBCO Object Service Broker Parameters
310 | Index
221, 222, 223COMMITSIZE 48CONFIGURATION 49CONNTIMEOUT 50DATEFORMAT 50DAYS 51DB2LOG 52DECIMALSEPARATOR 52DEFAULT_EE_NAME 53DEFAULT_MON_NAME 53DEFAULT_SESSION_NAME 53DEFAULT_TTY_NAME 54DELETELOG 54DOB 55DSBIFTYPE 56DSDIR 57DSFIELDSEP 57DSIXFTYPE 58DSQUOTE 59EEBIN 60EELOG 60EENAME 61EEWTODELETE 63, 63ERRMESSAGESCREEN 64EVENTLOGMSGTYPES 66EXECHASHSIZE 66EXECLOCALNAMESIZE 67EXECLOCALSIZE 67EXECSCOPESIZE 68EXECSTACKSIZE 69FILEGDGSEARCH 69HELP 76HOST 65, 76HURONSVC 165IBMFLOAT 77IDLETIMEOUT 78IMSSCREENATTRIBU 78IMSSCREENTRAN 79IMSSCREENTRANNO 80INSTLIBNUM 83IP 83IPCKEY 84KEEPEELOG 84KEEPOSMONLOG 85KEEPSESSIONLOG 86
KEEPTTYLOG 87LIBRARY 88LOGFILEMSGTYPES 88LOGFILEPATH 89LOGONRULENAME 89MAXEE 90MAXSESSION 90MDD 91MONHOST 92MONLOG 92MONNAME 93MONPORT 93MONTHS 94MSGLOGMAX 94NAME 95NOBATCHCONSOLE 33NOBROWSE 31, 35NOCLOSE 47NOHELP 76NOPRINTPORTRAIT 111NOPROFILE 115NOPROMPT 115NORELOADPARAMS 120NOSESSIONLOGCLEAR 144NOSESSIONPARMLIST 146NOSMFDETAIL 97NOSTAE 156NOSTOP 162NOSTOPALL 163NOTEST 178NOVERBOSE 188OFFLINE 98ONLINE 98OSDIR 99OSMONNAME 100OSMONPROCID 100PASSWORD 101PEERSERVERNUM 101, 102PORT 103PRINTCLASS 103PRINTCOPY 104PRINTDATASET 104PRINTDEST 105PRINTDIRECTION 107PRINTERRORLOG 108
TIBCO Object Service Broker Parameters
Index | 311
PRINTFCB 109PRINTFORM 110PRINTPAPERSIZE 110PRINTPORTRAIT 111PRINTSPOOLCLASS 111PRINTUCS 112PRINTXWTR 113, 120PROCESSID 114PROFILE 115PROMPT 115QUARTERS 116REGIONTABLESIZE 116REGIONTRACE 117REGIONTRACESIZE 118REGIONTYPE 119RELOADPARAMS 120RULE 121RULESIZE 124SEARCH 124SECACLSIZE 127SECADMINSIZE 128SECAUDITLOG 129SECOBJSIZE 131SECPACLSIZE 132SECURITY 133SECURITYSIZE 134SECUSERSIZE 135SERVERID 136SERVERLOGPATH 136SERVERRETRIES 137SERVERS 137SERVERTYPE 138SESSDSPXFRSCRMAX 140SESSIONENDACTION 140SESSIONENDVALUE 141SESSIONFILEMAX 142SESSIONLOG 143SESSIONLOGCLEAR 144SESSIONMEMMAX 145SESSIONPARMLIST 146SESSIONUSERID 147SESSNAME 147SMFDETAIL 148SMFPERFORMANCE 149SMFTYPE 150
SORTEXTMEMMAX 151SORTINTMEMMAX 151SORTINTNUMMAX 152SORTINTPAGESMAX 153, 160SORTPGM 153SORTPRINT 154SORTUNIT 155SORTWORKFILESMAX 155STAE 156STANDBYNUM 157STATSBUF 160STATUS 161STOP 162STOPALL 163STOPEE 164STOPSESS 164TABLESIZE 168TAMBMAX 169TAMBMIN 169TAMBSTS 170TASKEXECNUM 170TASKFILENUM 171TASKINITNUM 171TASKMISCNUM 172TASKOPERNUM 172, 173TASKSMFNUM 174TASKSORTNUM 174TDS 175TEMPPRIMARYCYL 176TEMPSECONDARY 176TEMPUNIT 177TEMPUNITCOUNT 178TEST 178TIMEOUTLIMIT 180TN3270PORT 181TRANDSPXFRSCRMAX 181TRANMAXNUM 182TRANMEMMAX 183TTYLOGFILE 184UNICODEDIR 184USERID 185VARLDELIMITER 186VARRDELIMITER 187VERBOSE 188WORKINGDIR 188
TIBCO Object Service Broker Parameters
312 | Index
YYCENTURYRANGE 188USEREXIT Data Object Broker parameter 275USERID Execution Environment parameter 185USERSHUTDOWN Data Object Broker
parameter 276USERTYPE server parameter 293
V
VARLDELIMITER Execution Environment parameter 186
VARRDELIMITER Execution Environment parameter 187
VERBOSE Execution Environment parameter 188VERIFYEXTACCESS server parameter 293
W
WORKINGDIR Execution Environment parameter 188
WORKINGSET Data Object Broker parameter 277WTOCLASS Data Object Broker parameter 277WTOCONSOLE Data Object Broker parameter 278WTODELETE Data Object Broker parameter 279WTOHOLD Data Object Broker parameter 280WTOINTERVAL Data Object Broker parameter 280WTOPID Data Object Broker parameter 281WTOREMOTE Data Object Broker parameter 281WTOSOURCE Data Object Broker parameter 282WTOSUFFIX Data Object Broker parameter 282WTOSYSLOG Data Object Broker parameter 282WTOTAG Data Object Broker parameter 283WTOTIME Data Object Broker parameter 283
X
XCFGROUP Data Object Broker parameter 284, 286XCFMEMBER Data Object Broker parameter 285XCFMODE Data Object Broker parameter 285
XCFSTRUCTURE Data Object Broker parameter 286XTABLESIZE Data Object Broker parameter 287
Y
YYCENTURYRANGE Execution Environment parameter 188
TIBCO Object Service Broker Parameters