Specifying values in Object Lists

The Object List Edit panel is displayed when, from the Object Lists panel, you do either of the following:

Alternatively, you can enter line action V to display the Object List View panel.

Use this panel to specify values in an Object List. The Object List can then be 'reused' many times in Selection Criteria in Report Sets.

You can specify any number of values in an Object List. You can also specify any number of Object Lists as sublists to form a meaningful hierarchical grouping of values. The order of entries in the list is of no consequence to CICS PA reporting.

You must specify separate Object Lists for character field values and numeric field values:

The field lengths and formats are available in the Performance Select Statement, where Object Lists are used.

The Object List panel consists of the following:
Description
Up to 32 characters of text to describe the purpose of the Object List. This description is shown on the Object Lists panel to help you distinguish between the Object Lists displayed. It is initially set to CICS PA Object List.
1st Value
A field value.
  • If this is an Object List for character field values, the value can be up to eight characters of any nature. Masking characters % and * are allowed. The percent % is for a single character substitution and the asterisk * is for many or none. For example, you might specify %%T* to select all programs which have T as the third character of their name. LETTERS, PETE, KAT, and KAT99 match this pattern.
  • If this is an Object List for numeric field values for Decimal, Count, or Clock type fields, the value can be up to nine digits. The 1st value represents a single value if the 2nd value is blank, otherwise it represents the 'From' value in a range (span). Masking is not supported for numeric fields.
2nd Value
The 'To' value for a range (span) of numeric values for Decimal, Count, or Clock type fields. The value can be up to nine digits.

For character type fields, this value must be blank as value ranges are not supported.

Sublist
The name of an Object List in the current Object Lists data set. The values in the sublist are inserted at JCL generation time. An Object List and its sublists must contain values for the same type of field, either all character type or all numeric type.

This facility enables reuse of Object Lists and allows you to build up a hierarchy of lists of related values.

When CICS PA generates the Report Set JCL, the values in the sublist are listed in the SELECT statements along with the explicitly specified values. The order in which the values are listed in the SELECT statement is the same order as they are specified on the Object List panel(s), however this order is of no consequence to the reporting process.

Line Actions

Display the menu of line actions
I
Insert a new row
R
Repeat this row
C
Copy this row
M
Move this row
A
Move⁄Copy after this row
B
Move⁄Copy before this row
D
Delete this row

Primary Commands

SAVE
This command is only available from Edit mode and saves any changes you have made. To save any changes made in View mode, use SAVEAS.
SAVEAS objlname|datasetname(objlname)
This command is available from both Edit and View mode to save the contents of this Object List under another name, either in the current data set (assumed if no data set name is provided) or in another suitable data set (if the name of a valid PDS is provided). If you then Cancel from this panel, the contents of the current Object List remain unchanged.
RESET
This command (or RES) removes all outstanding line actions and deletes any blank rows.
CONFIRM ON|OFF
CONFIRM ON (or CONFIRM) instructs CICS PA to prompt for confirmation when you request to Cancel from the Object List panel when there have been updates.

With CONFIRM OFF, Cancel requests are actioned immediately, discarding any changes.

This command changes the setting only for the current Edit/View session. On exit, it reverts to the default set by Cancel Confirmation in CICS PA Settings.


Information Information

Feedback


Timestamp icon Last updated: Thursday, 7 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//users-guide/objspec.htm