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


Chapter 3 Tools : DEFINE_OBJLIST

DEFINE_OBJLIST
Defines, for a table, an object list to appear using the Object Manager or modifies an existing object list definition. (E)
Invocation
Do one of the following:
Type DEFINE_OBJLIST(table) <Enter>
Where:
 
Usage Notes
If you supply an existing value for table, executing DEFINE_OBJLIST displays a screen with the current characteristics of the table.
In both cases, more fields are available than can appear at one time on the screen. To view additional fields, press PF11 to move one screen to the right. This tool comprises four full lateral screens of fields.
DEFINE_OBJLIST defines rules, specifies how they should be executed, and arranges up to two lines of titling. This information is then applied against the table given as an argument to OBJECT_MGMT (or its interactive version OBJECTMGR, as both of these tools use DEFINE_OBJLIST when they are invoked).
Initial Screen
This initial screen appears when you execute DEFINE_OBJLIST:

 
Object Commands for Table: EMPLOYEES_0DPARM
Command ===>
 
 
Command Description Rule New Trans Browse Search Prompt
- ---------------- ---------------- - - - -
 
 
 
 
Titles to Appear Above and Below the Command Line
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
try this
try this again
 
 
 
 
 
 
 
 
PFKEYS: 12=CANCEL 16=DELLINE 22=DELETE 3=SAVE 4=ADDLINE

 
Top Segment
The top segment of the screen contains the name of the table and the primary command line. By changing the name of a previously defined object list you can use an existing definition as a template.
The following primary commands are supported:
Middle Segment
You use the middle segment to define the line commands. To see all the fields, position your cursor within this segment and press PF11 to scroll right. It contains the following fields:
A short description of the command. It appears at the bottom of the object manager screen, for example, S for select.
If the rule is called, this field has no effect; this field is ignored if New Trans is N. In the standard session manager, the mode is taken from the Browse field at the top of the screen, while in all other session managers, the mode is also taken from the menu.
If the Object Manager is called by an application and a new transaction is required, the search path for the new transaction is determined by the character in this field, that is, one of:
However, if the Object Manager is prompting for a session manager menu, the rule is executed with the search path specified for the menu item. If the rule is called, this field has no effect.
Use the strings in the Prompt String field described below.
The rule must have two or more arguments if prompting is expected; the first parameter is assigned a value from a specified field of the table.
If Prompt is A, the actual names of all but the first arguments of the rule appear and the user is requested to supply values for them. If Prompt is S, the strings contained in fields ARG2, ARG3, and ARG4 appear, and the user is requested to supply values that are passed as the second, third, and fourth arguments of the rule.
The screen is to be refreshed after the command is processed. Use this option if the command changed the object list, for example, if an object is deleted.
Field Source of First Argument
If the rule in the Rule field has at least one argument, the entry must be the name of one of the fields in the table. This field is then used as the source of values passed into the argument. Type the name of the appropriate field to be used. If the entry is NULL, no arguments are passed to the rule being invoked.
Field Names or Prompt Strings For Rule Arguments
Up to four arguments can be used by the rule in the Rule field. Enter the appropriate value based on which of the following appears in the Prompt field:
If ARG2 is null, only one argument is passed to the rule. If ARG2 contains the name of a field of the table, the contents of this field are passed as the second argument of the rule. ARG3 and ARG4 have similar effects.
The Prompt screen appears. If ARG2 is not null, the string it contains appears as the prompt for the second argument of the rule.
Note  There is no prompting for the first argument; it is always taken from the table. ARG3, and ARG4 are similar.
The Object Manager displays the actual arguments of the rule named in the Rule field. No entries are required.
If prompts are given for a command, the Object Manager displays a screen for the prompts. Use this field for the title of the prompt screen.
Titles to Appear Above and Below the Command Line
Function Keys
The following function keys are recognized while the screen appears:
Example
After executing DEFINE_OBJLIST (EMPLOYEE_LIST) the following screen appears:

 
Object Commands for Table: EMPLOYEE_LIST
Command ===>
 
 
Command Description Rule New Trans Browse Search Prompt
- ---------------- ---------------- - - - -
D Delete DEL_OCC Y N S S
S Select STE Y N S N
 
Titles to Appear Above and Below the Command Line
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Listing of Employee Information
 
 
 
 
 
 
 
 
 
 
PFKEYS: 12=CANCEL 16=DELLINE 22=DELETE 3=SAVE 4=ADDLINE

 
Press PF11 to scroll to additional parts of the screen not visible on your terminal display.

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