Host Environment Commands › ADDRESS OPSCTL Commands for the COF › COF DEFINE—Create Transient Data Queue Name List

COF DEFINE—Create Transient Data Queue Name List

The COF DEFINE command creates a list of CICS transient data queue names. For the CICS region identified by the JOBNAME keyword, STEPNAME keyword, or both the CICS XTDOUT exit selects the destinations on this list and passes them to the AOF for rule processing. If a current list exists that was not defined, but rather built, from the default list by the first message intercepted by the XTDOUT exit, the old connection list will be deleted by the new defined list. Duplicate DEFINEs for the same CICS JOBNAME/STEPNAME combination are not allowed. The old definition must be deleted first.

This command has the following format:

ADDRESS OPSCTL "COF DEFINE keywords"
  {JOBNAME(jobname)}
  [STEPNAME(stepname|taskid)]
  [DESTIDS(destidlist)]
  [OUTPUT|NOOUTPUT]
  [SYSTEM(sysname)]
  [SYSWAIT(seconds)]

JOBNAME(jobname)

Defines the one- to eight-character job name of the CICS region.

Position: This required keyword must be first in the command syntax.

STEPNAME(stepname|taskid)

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

Position: It must follow the required JOBNAME keyword and precede the optional DESTIDS keyword.

This optional 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.

If you specify the STEPNAME keyword in the definition of a transient data queue name list, you must also specify it in any other COF commands (ACTIVATE, DEACTIVATE, DELETE, LIST) to select the transient data queues on that list.

For example, suppose that you issue this command to define a CICS connection:

ADDRESS OPSCTL "COF DEFINE JOBNAME(CICSTOR)",
"STEPNAME(TOR) DESTIDS(CSMT,CSSL)"

The following COF LIST command will not select the CICS connection defined above, because the COF LIST command does not include the STEPNAME keyword:

ADDRESS OPSCTL "COF LIST JOBNAME(*)"

But this COF LIST command will select the CICS connection:

ADDRESS OPSCTL "COF LIST JOBNAME(*) STEPNAME(*)".

DESTIDS(destidlist)

(Optional) Defines a list of transient data queue destinations, as defined in the CICS DCT (destination control table).

Position: This optional keyword must follow the optional STEPNAME keyword (if used).

You can specify as many as 100 destination names in a list; each name can contain from one to four characters.

CA OPS/MVS maintains the names in your lists in sorted order and eliminates any duplicate names.

OUTPUT, NOOUTPUT, SYSTEM(sysname), and SYSWAIT(seconds)

(Optional) You may specify the common keywords described in Keywords Common to All ADDRESS OPSCTL COF Commands in this chapter.

Position: Place these optional keywords at the end of the command.