Maintaining Object Lists

To display the list of Object Lists:

  1. 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).
  2. 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)]
Start of changeThis 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.End of change 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). Start of changeIf you do not specify a model name in the NEW command, the New Object List window is displayed.End of change

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.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//mobjlst.htm