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 wish
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.
In addition, the Object Lists are listed with the following system-generated
attributes:
- Changed
- Date and time when last updated.
- ID
- The userid that last updated 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 (Shared Object Lists do not support sublists).
You
cannot copy an Object List if any of the following is true:
- The Object List specifies ranges (values in the 2nd Value field;
Shared Object Lists do not support these)
- The Object List refers to a nonexistent sublist
- The Object List refers to itself as a sublist
Primary Commands: The following primary commands
are valid for this panel:
- NEW name [MODEL dsn(modelname)]
- This command creates a new Object
List. If all required parameters are specified, the Edit panel for
the new Object List is displayed. Otherwise, the New Object List window
is displayed where you specify the name of the new Object List and
optionally the name of an existing Object List to be used as a model.
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).
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.