The DFHCSDUP LIST command

Produces listings of the current status of the CSD file.

LIST syntax

Read syntax diagramSkip visual syntax diagramLIstAllGroup(groupname)LIst(listname)ObjectsSigsumm

Description

The listings are sent to the SYSOUT data set, with the messages issued by the command processing. The contents of all the qualifying groups or lists are printed.

The listings contain output to help you confirm the release information for the CSD. The heading CREATED BY RELEASE: shows the release in which the CSD was created. If present, it may be followed by UPGRADED TO RELEASE: if the CSD has been upgraded, and, to what release.

If, maintenance has been applied to the CSD, then an additional heading appears; LAST CSD MAINTENANCE UPGRADE USED filename AT PTF ptfnumber LEVEL. For example, maintenance applied using a DFHCSDUP UPGRADE USING (DFHCURDM) command will indicate the PTF level of the DFHCURDM used.

Options

Group(groupname)
Specifies only those resource definitions in the named group. You can specify a generic group name.
LIst(listname)
Specifies only those resource definitions in the groups that are contained in the named list. You can use a generic list name only if you are not using the OBJECTS option. The only command for which a generic list name is not acceptable is LIST LIST(listname) OBJECTS.
Objects
Specifies the level of detail required for each resource definition. You can extract resource definition data at two levels of detail:
  • Without the OBJECTS option, the command extracts either the names of all the groups in a specified list or the names of all the resource definitions in a specified group.
  • With the OBJECTS option, all the resource definition attributes are also extracted, including the definition signature fields.
Sigsumm
Shows the definition signature for each of the resource definitions displayed.

Examples

The listings produced by the various commands are as follows:
  • LIST ALL
    • Names of defined lists and groups
    • Summary of lists
    • Summary of groups

    The LIST ALL command prints summaries of all the definitions of lists and groups that are on the CSD file.

  • LIST ALL OBJECTS
    • Names of defined lists and groups
    • Summary of lists
    • Summary of groups
    • Objects in groups

    The LIST ALL OBJECTS command prints summaries of all the definitions of lists and groups that are on the CSD file, with the properties of the resources in all the groups.

  • LIST GROUP(groupname)
    • Summary of groups
    • Group name can be generic

    The LIST GROUP command summarizes the names of all the resources in one or more groups. They are organized in each group into resource type categories; for example: map sets, and programs.

  • LIST GROUP(groupname) OBJECTS
    • Summary of groups
    • Objects in groups
    • Group name can be generic

    With this command, you can tabulate the properties of the resources, organized according to resource type. The creation time for each resource is given, with all its attributes, as originally set up by using DEFINE and ALTER commands or by migrating it from a CICS® table. The properties of transactions and profiles are arranged in the same subcategories that appear on the CEDA DEFINE screen.

  • LIST GROUP(groupname) SIGSUMM
    • Group name can be generic

    Use this command to tabulate the definition signature of the resources, organized according to resource type.

  • LIST LIST(listname)
    • Summary of lists
    • List name can be generic

    The contents of one or more group lists are tabulated. The groups are displayed in the same sequence as their position in the list. This order is set by the commands ADD and APPEND, which were used in the CEDA transaction to build the list.

  • LIST LIST(listname) OBJECTS
    • Summary of lists
    • Objects of groups in list
    • Generic list name is not allowed

    Use this command to tabulate the properties of all the resources to be defined in a CICS system at startup time. They are identified by one or more list names specified in the GRPLIST=(list1,list2,list3,list4) system initialization parameter. The names of all the groups in the list appear in the summary of lists. Then, for each group that is contained in the list, the properties of the individual resources in the group are tabulated.

    The Objects in Groups in Lists tabulation arranges the groups in the same order as they were added to the group list. This order is important if duplication occurs, when definitions of the same resource might be in more than one group. If a list of this type is used at system startup time, the resource definitions used when there is duplication are those belonging to the group that is latest in the list.