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


Chapter 4 Defining Object Sets : Defining Object Sets

Defining Object Sets
 
Task A Access the object set definition tool
To access the Object Set Definer 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.
The DEFINE OBJECTSET screen appears.
Example
The following example illustrates the DEFINE OBJECTSET screen for the object set EMPLOYEEINFO:

 
DEFINE OBJECTSET: EMPLOYEEINFO UNIT: USR40
COMMAND ==> Scroll: P
OBJECT TYPE:
Name Type Unit Author Created Modifier
---------------- ---------------- -------- -------- ---------- --------
DELETE_EMPLOYEE RULE
NEW_EMPLOYEE RULE
ADD_EMPLOYEE_TIT SCREEN
DEL_EMPLOYEE_TIT SCREEN
DELETE_EMPLOYEE SCREEN DOCEXMPL USR40 1999-07-08 USR40
EMPLOYEE_DATA SCREEN
EMPLOYEE_INFO SCREEN
EMPLOYEE_SCR SCREEN DOCEXMPL USR40 1999-03-22 USR40
FCNKEY_SPECS SCREEN
NEW_EMPLOYEE SCREEN DOCEXMPL USR40 1999-03-06 USR40
EMPLOYEES TABLE DOCEXMPL USR40 1999-11-20 USR40
PFKEYS: 3=SAVE 12=CANCEL 22=DEL 4=SAVE & SEC 5=SELECT OBJS 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 press PF1. This displays a list of values from which you can select a value, by typing the S line command beside it, 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 those steps. 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 the objects, complete these 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 [Optional] 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 [Optional] Print the Object Set Definition
The following example illustrates the screen used for printing object set definitions:

 
DEFINE OBJECTSET: EMPLOYEEINFO
COMMAND ==>
ENTER ARGUMENTS FOR PRINTING:
LIBRARY ==>
ENVIRONMENT ==>
LOCATION ==>
PARENT ONLY ==> Y
PFKEYS: ENTER=PRINT 12=CANCEL

 
Printing the Object Set Definition
If you want to print the object set definition, complete the following steps:
1.
The Print screen appears.
2.
Only provide a library name if the object set contains rules.
3.
Only specify a presentation environment if the object set contains screens or objects that contain screens (for example, menus). The default is 3270.
4.
Only provide a node name in the LOCATION field 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.

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