Maintaining object lists
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.
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.
- 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
- ⁄
- 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
- 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.