LIST

Function

List one or more object records of a specified object type from the target CICS region control file.

Syntax

Read syntax diagramSkip visual syntax diagram
LIST commands

>>-LIST APPGROUP(groupname)------------------------------------><

Read syntax diagramSkip visual syntax diagram
>>-LIST APPLIST(listname)--------------------------------------><

Read syntax diagramSkip visual syntax diagram
>>-LIST FILE(filename)-----------------------------------------><

Read syntax diagramSkip visual syntax diagram
>>-LIST PROGRAM(progname)--------------------------------------><

Read syntax diagramSkip visual syntax diagram
>>-LIST REGION(applid)-----------------------------------------><

Read syntax diagramSkip visual syntax diagram
>>-LIST TDQUEUE(tdqid)-----------------------------------------><

Read syntax diagramSkip visual syntax diagram
>>-LIST TRANSID(transid)---------------------------------------><

Description

You can use the LIST command to list any, or all, object records of a specified resource type from a target CICS region control file. You can use the generic asterisk (*) character to list more than one object record of the specified resource type or, if you use the generic character on its own, list all the object records of the specified type. For example:
LIST REGION(*)        to list the CICS region properties from its control file
LIST FILE(*)          to list all file object reecords from the control file.
LIST APPGROUP(TEST*)  to list all application groups beginning with the string TEST
LIST TDQUEUE(TDQ1)    to list the TD queue named TDQ1.

The results of the LIST command are written to CBKPRINT.

Parameters

APPGROUP(name| * )
APPLIST(listname| * )
FILEfilename| * )
PROGRAMprogname| * )
REGION(applid| * )
TDQUEUE(tdqid| * )
TRANSID(transid| * )
Specifies the name of the object type for which you want to list the specified object record or records. If you specify only the generic asterisk character, the file maintenance utility lists from the target CICS region control file all the object records for the named object type.

For an explanation of the various field names and data returned by the LIST command, see the corresponding parameters on the ADD and UPDATE commands.