Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Tools : DEFINE_OBJECTSET

DEFINE_OBJECTSET
Defines a set of objects or modifies an existing set. (E)
Invocation
Do one of the following:
Type objsetname <Enter>
Type DEFINE_OBJECTSET (objsetname)<Enter>
Type OS objsetname <Enter>
Where:
 
Usage Notes
You can specify security later only for those objects that are identified explicitly as components of the object set.
Steps for Defining Object Sets
Overview
To define an object set, complete the following tasks:
The following sections provide a detailed description for defining object sets.
 
Task A Access the Object Set Definition tool
To access the Object Set Definition tool, use one of the following methods. The objsetname is the name of the new or existing object set you are defining.
Type define_objectset(objsetname) at the EX execute rule option on the workbench and press Enter.
Type an objsetname at the OS object set option on the workbench and press Enter.
Type os objsetname at the command prompt and press Enter.
Example
The following is an example of the Object Definition screen for the object set SAMPLAPP:

 
DEFINE OBJECTSET: SAMPLAPP UNIT: SAMPLAPP
COMMAND ==> Scroll: P
OBJECT TYPE:
Name Type Unit Author Created Modifier Modified
---------------- ---------------- -------- -------- ------- -------- -------
SAMPLAPP LIBRARY SAMPLAPP USR40 97.339 USR40 98.094
@EXPENSE_ITEMS REPORT
@EXPENSE_SUMMARY REPORT
@EXPENSE_ITEMS SCREEN
@EXPENSE_SELECT SCREEN
@CURRENCIES TABLE
@DETAIL_DATE_BRK TABLE
@DETAIL_FINALBRK TABLE
@EXCHANGE TABLE
@EXCHANGE_RATES TABLE
@EXCHANGE_RATES$ TABLE
@EXPENSE_BODY TABLE
@EXPENSE_EMP TABLE
@EXPENSE_FOOTER TABLE
@EXPENSE_HEADER TABLE
PFKEYS: 1=HELP 3=SAVE 12=CANCEL 2=DOC 22=DEL 4=SAVE & SEC 9=DEFINE 21=MSGLOG

 
Task B Specify a valid object type
In the OBJECT TYPE field, specify a valid object type by using one of the following methods:
Position your cursor on the OBJECT TYPE field and then press PF1. This displays a listing of values from which you can select a value and press PF3 to return to the Object Set Definition screen. Press Enter when the value appears in the Object Type field.
Press PF5 without specifying an object type. The Object Selection screen appears and you can select from a list of all types of objects. Refer to Selecting Objects for Object Set Definitions for more information.
Task C Specify a value for the Name field
To specify a value for the Name field, use one of the following methods:
In the Name field, type the name of an existing object of the type specified in the OBJECT TYPE field and press Enter.
In the Name field, type the name of a new object of the type specified in the OBJECT TYPE field.
You can use one of the following options to define the new object:
Save the object set definition and return to the workbench. Access the appropriate definer for the object and define the object.
Invoke the Definer for the object type specified. Define the object as required. When you press PF3 or PF12 from the Definer screen, you are returned to the Object Set Definer.
If the object is a table, refer to Using Tables in Object Set Definitions for more information on adding tables to the object set definition.
Task D Specify additional object types
If you want to specify additional object types, repeat the above tasks. A sub-screen appears for each object type that you are defining.
Task E Specify access permissions
If you want to specify access permissions to any of the objects, complete the following steps:
1.
This saves the definition of the object set and invokes the Manage Permissions screen for TIBCO Object Service Broker security.
2.
For more information on the FETCH command and access permissions, refer to TIBCO Object Service Broker Managing Security.
Task F View the full object definition
To view the full definition of your object set, leave the Object Type field on the Object Definition screen blank and press Enter.
Task G Print the object set definition
The following is an example of the screen used for printing object set definitions:

 
DEFINE OBJECTSET: DOCEXAMPLE
COMMAND ==>
ENTER ARGUMENTS FOR PRINTING:
LIBRARY ==>
ENVIRONMENT ==>
LOCATION ==>
PARENT ONLY ==> Y

 
To print the object set definition, complete the following steps:
1.
The Print screen appears.
2.
Provide a library name only if the object set contains rules.
3.
This field is currently not in use.
4.
Provide a node name in the LOCATION field only if the objects are located on a node other than your home node. If this field is left blank, it defaults to your home node.
5.
If PARENT ONLY is Y, only the definition of the object set (parent) is printed. If it is N, the object set and all the objects it contains (children) have their definitions printed.
Task H Save the definition
Press PF3 from the Object Definition screen to save your definition and exit to the workbench.
Selecting Objects for Object Set Definitions
Overview
To select objects for object set definitions or modify a series of objects that are selected by default, complete the following tasks:
 
Task A Invoking the Object Selection screen
To invoke the Object Selection screen, complete the following steps:
1.
The Object Selection screen appears. The screen displays a series of objects that are selected by default based on the values in the UNIT field and the OBJECT TYPE field provided in the Object Set Definition screen. The OBJECT TYPE field could be blank if you pressed PF5 before specifying an object type.
The following is an example of the Object Selection screen:

 
O b j e c t S e l e c t i o n Scroll: P
COMMAND ==>
Location: Select All: N
Library (for RULES): Deselect All: N
Presentation Environment: List Children: N
Show selection specs: Y
========================== Selection Specification ============================
Attr Op Value
------ ---- ----------------
NAME ____ ________________ AND unspecified
TYPE = SCREEN__________ AND attributes will
UNIT =___ SAMPLAPP AND be ignored
AUTHOR ____ ________
===============================================================================
Name Type Library Environment Unit
---------------- ---------------- -------- ---------------- --------
_ @EXPENSE_ITEMS SCREEN SAMPLAPP
_ @EXPENSE_SELECT SCREEN SAMPLAPP

 
2.
You can modify the listing by excluding fields that are not required when you are searching through the list of objects. This helps in object selection, since many lists are long and you must narrow down your selection requirements.
Task B Narrowing the selection scope
If you want to narrow the selection scope, you can use two different portions of the screen:
Specifying Values in the Header Portion
You can use the Location, Library, and Presentation Environment fields in the header portion of the screen to narrow the selection scope for objects.
Specifying a Location
In the Location field, you can specify a node where the selection criteria are to be applied. If you do not specify a value in this field, your home node is used.
Specifying a Library
If your selection list contains rules or if the OBJECT TYPE field is empty, you can specify the name of the rules library to be searched. If the OBJECT TYPE field is empty, a library should be specified to ensure that all object types are included in the list. Press PF1 to display a list of valid values from which you can select.
Specifying a Presentation Environment
This field is currently not in use.
Listing Child Objects
If some objects have child objects associated with them, you can specify if you want to list all the child objects that compose the parent objects.
Specifying Selection Specifications
The middle section of the screen can be used to select items to be included in the definition or to narrow the selection list. You can use more than one type of selection criteria for each object type and you can specify multiple object types within one session. For a list of valid values for each of these fields, position your cursor on the field and press PF1.
Do the following when specifying selection criteria:
The name of the unit associated with the object
Considerations
Note the following about the object type selection criteria:
If you specify only an object type and no further selection values, a listing of the items for the object type defined in your TIBCO Object Service Broker database appears for further selection.
Task C Selecting objects
There are two ways you can select objects:
Select Objects from Header Portion
Using the Select All field, you can specify whether all the items displayed, based on selection criteria, should be copied into the Object Definition screen.
Deselecting All Objects
Use the Deselect All field if you want to deselect the items that you selected.
Select Objects from the List of Objects
After you specify the selection criteria and press Enter, the selected items appear in the bottom portion of the screen. You can select the objects displayed in this section by typing an S in the line command fields beside the objects.
After selecting the items that you require, press PF3 to save the selections and return to the Object Set Definition screen. The items are listed in the appropriate type sub-screen within the Object Set Definition screen.
To un-select items that you selected, use the Deselect All field.
Using Tables in Object Set Definitions
Adding Tables to the Object Set Definition
When adding table objects, you are prompted to supply a value for the following:
At least one of these fields must contain a Y.
Security Requirements for a Table
If security is to be specified for temporary (TEM) or TDS tables, the following values must be set to Y:
Specifying Table Instances
If the object is a parameterized table, press PF6 to display one of two screens for selecting table instances to be part of your definition. The screen that appears depends on whether the table has a parameter value table (table of type PRM) associated with it.
Screen for Table with No PRM Table
The Specifying Table Instances screen appears when the table does not have a parameter (PRM) table associated with it. Use this screen to individually specify all the table instances that are to be part of the object set definition. If no values are specified, the default is all instances of the table.

 
------------------------------------------------------------------------------
SPECIFY INSTANCE OF TABLE: @EXPENSES
------------------------------------------------------------------------------
Table Parameters: REGION =
( ALL DATA: Y )
< specify all parameter values or set ALL DATA = Y for whole table >

 
Screen for Table with a PRM Table
The Parameters for table screen appears when the table has a parameter (PRM) table associated with it. Use this screen to select all the table instances that are to be part of the object set definition. If no values are specified, the default is all instances of the table.

 
Parameters for table EMPLOYEES Scroll: P
COMMAND ==> Select All: N
Location: Deselect All: N
Show selection specs: Y
========================== Selection Specification ============================
Selection: REGION LIKE '*'
AND Op Value
---- ---------------------------------------------------------
REGION
===============================================================================
Region
----------------
_ A
_ CANADA
_ CENTCANADA
_ MEXICO
_ MIDWEST
_ SOUTHWEST
 
 
 
 
PFKEYS: ENTER=UPDATE 3=SAVE 12=CANCEL

 
Example
The following example shows defined sub-screens for objects of type screen, table, and rule as well as the final screen with all the objects listed.
Subscreen for Screen Objects

 
DEFINE OBJECTSET: UPDATE_EMPLOYEES UNIT: USR40
COMMAND ==> Scroll: P
 
OBJECT TYPE: SCREEN
 
Name Type Unit Author Created Modifier Modified
---------------- ---------------- -------- -------- ------- -------- -------
DELETE_EMPLOYEE SCREEN USR40 USR40 97.312 USR50 98.175
NEW_EMPLOYEE SCREEN USR40 USR40 97.310 USR50 98.173

 
Subscreen for Table Objects

DEFINE OBJECTSET: UPDATE_EMPLOYEES UNIT: USR40
COMMAND ==> Scroll: P
 
OBJECT TYPE: TABLE
 
Name Parms Defn Data Type Unit Author Created Modifier Modified
---------------- - - - --- -------- -------- ------ -------- -----
$EMPLOYEES N Y Y PRM USR60 USR60 96.350 USR50 96.35
EMPLOYEES Y Y Y TDS ACC USR40 97.110 USR40 98.14
MANAGER N Y Y TDS DOC01 USR40 97.290 USB80 98.11
 
 
 
 
 
 
 
 
 
 
 
 
PFKEYS: 1=HELP 3=SAVE 12=CANCEL 2=DOC 22=DELETE 4=SAVE & SECURITY 9=DEFINE

 
Subscreen for Rule Objects

 
DEFINE OBJECTSET: UPDATE_EMPLOYEES UNIT: USR40
COMMAND ==> Scroll: P
 
OBJECT TYPE: RULE
 
Name Unit Author Created Modifier Modified
---------------- -------- -------- ------- -------- ------ ------------------
DEL_EMP USR40 USR40 96.312 USR40 97.175
DELETE_EMPLOYEE USR40 USR40 96.312 USR40 97.165
NEW_EMPLOYEE USR40 USR40 96.310 USL12 97.175
PRINT_EMP USR40 USR40 95.317 USR40 96.310
SAVE_EMP USR40 USR40 96.310 USR40 97.160

 
Defined Object Set

 
DEFINE OBJECTSET: UPDATE_EMPLOYEES UNIT: USR40
COMMAND ==> Scroll: P
 
OBJECT TYPE:
 
Name Type Unit Author Created Modifier Modified
---------------- ---------------- -------- -------- ------- -------- ------ -
DEL_EMP RULE USR40 USR40 96.312 USR40 98.145
DELETE_EMPLOYEE RULE USR40 USR40 96.312 USR40 97.165
NEW_EMPLOYEE RULE USR40 USR40 96.310 USL12 97.175
PRINT_EMP RULE USR40 USR40 96.317 USR40 98.115
SAVE_EMP RULE USR40 USR40 96.310 USR40 97.160
DELETE_EMPLOYEE SCREEN USR40 USR40 96.312 USR40 97.175
NEW_EMPLOYEE SCREEN USR40 USR40 96.310 USR40 97.173
$EMPLOYEES TABLE ACE60 USR40 97.350 USG60 97.350
EMPLOYEES TABLE ACC USR40 95.110 USR40 96.149
MANAGER TABLE DOC01 USR40 96.290 USB80 97.110

 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved