Host Environment Commands › ADDRESS OPSCTL Commands for the COF › COF LIST—Display Transient Data Destination List

COF LIST—Display Transient Data Destination List

The COF LIST command displays the contents of any transient data destination list that matches the selection criteria you specify.

This command has the following format:

ADDRESS OPSCTL "COF LIST keywords"
  {JOBNAME(jobname,[SUMMARY])}
  [STEPNAME(stepname|taskid)]
  [STATUS(ACTIVE|INACTIVE)]
  [OUTPUT|NOOUTPUT]
  [SYSTEM(sysname)]
  [SYSWAIT(seconds)]

The optional keyword SUMMARY must follow the jobname value, and a comma must separate it from the jobname value as follows:

JOBNAME(TESTJOB,SUMMARY)

JOBNAME

Defines the one- to eight-character job name of the CICS region. If you include the SUMMARY positional parameter, the COF LIST command returns only one record per matching CICS connection, rather than one record for each destination name in the destination name list.

When specifying the job name, you may use the wildcard suffix.

STEPNAME

(Optional) Defines the one- to eight-character step name of the CICS region (or task ID for a started task).

This keyword is intended for sites that use a shared CICS JCL PROC to start CICS regions. Since all CICS regions have the same job name at such sites, use the STEPNAME keyword to differentiate the various regions.

You must include the STEPNAME keyword in your COF LIST command to list any transient data queue names whose definitions included the STEPNAME keyword.

When specifying the step name, you may use the wildcard suffix.

STATUS

(Optional) Limits the action of the LIST command to either ACTIVE or INACTIVE lists:

ACTIVE

Lists in use by a CICS region

INACTIVE

Lists not currently in use by a CICS region

OUTPUT, NOOUTPUT, SYSTEM, and SYSWAIT

(Optional) You may specify the keywords common to all ADDRESS OPSCTL COF commands.

More information:

Wildcards Used in OPSCTL COF Commands

Keywords Common to All ADDRESS OPSCTL COF Commands