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. Viewing an Object List works in every way
like Edit except there is no exclusive hold on the data and changes
cannot be saved. However you can use
SAVEAS. Figure 1. Specifying Values
for Character Fields in an Object List File Edit Confirm Options Help
------------------------------------------------------------------------------
EDIT Object List – BILLING Row 1 to 4 of 4
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . Billing Transactions____________
Specify the Object List values:
/ 1st Value 2nd Value Sublist
_ BIL1_____ _________ ________
_ BIL2_____ _________ ________
_ %TRA*____ _________ ________
_ _________ _________ ________
********************************* End of list *********************************
Figure 2. Specifying Values for Numeric Fields in an Object
List File Edit Options Help
------------------------------------------------------------------------------
EDIT Object List – BILRESP Row 1 to 3 of 3
Command ===> ________________________________________________ Scroll ===> PAGE
Description . . . . Billing Transact'n Response Time
Specify the Object List values:
/ 1st Value 2nd Value Sublist
_ 100______ 200______ ________
_ _________ _________ B1RESP__
_ _________ _________ B2RESP__
********************************* End of list *********************************
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: The following line actions are valid
on this panel:
- ⁄
- 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: The following primary commands
are valid for this panel:
- 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.
Also available from File in
the action bar.
- 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.
Also
available from File in the action bar.
- RESET
- This command (or RES)
removes all outstanding line actions and deletes any blank rows.
Also
available from Edit in the action bar.
- 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.
Also
available from Confirm in the action bar.