To display the list of Object Lists:
- Use the Options menu on the action bar to nominate the
Object Lists data set (if one has not yet been nominated, or you want
to change the data set).
- Select option 4 Object Lists from the CICS PA Primary
Option Menu.
Figure 1. Object Lists File Confirm Options Help
------------------------------------------------------------------------------
Object Lists Row 1 to 5 of 5
Command ===> ________________________________________________ Scroll ===> ____
Object Lists Data Set . . : xxxx.CICSPA.OBJL
/ Name Description Changed ID
_ FINANCE Finance Transactions 2005/01/03 12:27 JCH02
_ FINRESP Finance Transaction Response Time 2004/12/27 09:00 MKR08
_ HQTERMS Terminals at headquarters 2005/01/02 08:57 DAM13
_ HQUSERS Users at headquarters 2005/01/05 10:49 SEC22
_ STOCK Stock Transactions 2005/01/05 16:57 DOC17
********************************* End of list *********************************
This panel lists all the Object Lists in the current Object Lists
data set and allows you to select one at a time to view or modify.
The Object Lists are listed with the following user-defined attributes:
- Name
- 1-8 character name in ISPF member name format, used to uniquely
identify the Object List within the Object Lists data set. By default,
the panel is sorted on the Name field.
- Description
- Free format text up to 32 characters that describes the contents
and purpose of the Object List.
Line Actions: The following line actions can be entered
against an Object List:
- ⁄
- Display the menu of line actions.
- E
- Edit the Object List.
- S
- Select the Object List (same as Edit).
- V
- View the Object List. This looks like the Edit panel but has
no 'hold' on the data and has no Save capability. SaveAs is available.
- D
- Delete the Object List.
- R
- Rename the Object List.
- C
- Copy the Object List to a Resource List.
Copying an Object List expands and copies the values of any sublists that
the Object List refers to. Resource Lists do
not support sublists.
You cannot copy an Object List if any of the following conditions is true:
- The Object List refers to a nonexistent sublist.
- The Object List refers to itself as a sublist.
- The Object List specifies a value in the 2nd Value field. Resource Lists do not support ranges.
Primary Commands: The following primary commands
are valid for this panel:
- NEW name [MODEL dsn(modelname)]
- This command
creates an Object List. The new Object List can be modeled on one
of your existing Object Lists or it can be initialized by selecting
one of the sample object lists included with CICS PA. If the
model is in the current Object Lists data set, specify just the name
of the Object List. If it is in another data set, specify the name
of the data set and the Object List in the format datasetname(modelname).
If you do not specify a model name in the NEW command,
the New Object List window is displayed.
Also available from File in
the action bar.
See Creating new Object Lists for information on how to proceed.
- SELECT name
- This command (or S)
selects the specified Object List for editing. If the Object List
does not exist, it is created as if the NEW command was used.
Also available from File in
the action bar.
- SORT Name|Description|Changed|Id
- This command sorts the list
of Object Lists on one or two columns. The default sort field is Name. The
sort disregards upper and lower case, and is ascending for all but
the Changed column. The sort order is retained only until Exit or
another SORT command is issued.
- LOCATE string
- This command (or L or LOC)
is used to locate an entry in the list based on the primary sort field.
By default, LOCATE operates on the Name field. The string should
be no longer than the primary sort field and not enclosed in quotes.
The display will scroll to the entry which matches the string, or
the entry preceding it if an exact match is not found.
- CONFIRM ON|OFF
- CONFIRM ON (or CONFIRM)
instructs CICS PA to
prompt for confirmation when you request to Delete an Object List.
With CONFIRM OFF, Delete requests are actioned immediately.
Deleted Object Lists cannot be reinstated.
This command changes
the setting only for the current invocation of the Object Lists panel.
On exit, it reverts to the default set by Delete Confirmation in CICS PA Settings.
Also available from Confirm in
the action bar.