![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
Defines, for a table, an object list to appear using the Object Manager or modifies an existing object list definition. (E)
Developer’s workbench Type DEFINE_OBJLIST(table) <Enter> Type EX DEFINE_OBJLIST (table) <Enter>
• If you supply a new value for table, executing DEFINE_OBJLIST displays an empty Define Object List screen.
• 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).
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.
Add a line for input. The line is added after the line where your cursor is positioned. 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:
The letter to be associated with the output command. For example, type S for select. A short description of the command. It appears at the bottom of the object manager screen, for example, S for select. The name of a rule. This rule is processed when the line command is invoked, for example, STE. 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. 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: Type the names of the fields to be used; these must be the names of fields in the table or null.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. Title for Prompt Screen 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. The title to appear above the command line. Optionally, type the title to appear below the command line.
Delete the definition of a defined object list. You are prompted to confirm the deletion.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |