Host Environment Commands › ADDRESS OPSCTL Commands for the COF › COF DEACTIVATE—Delete Transient Data Queue Names

COF DEACTIVATE—Delete Transient Data Queue Names

This command deletes the specified transient data queue names from any destination list that matches the selection criteria you specify.

This command has the following format:

ADDRESS OPSCTL "COF DEACTIVATE keywords"
  {JOBNAME(jobname)}
  [STEPNAME(stepname|taskid)]
  [STATUS(ACTIVE|INACTIVE)]
  [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.

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

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 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 DEACTIVATE command to deactivate any transient data queue names whose definitions included the STEPNAME keyword.

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

STATUS(ACTIVE|INACTIVE)

(Optional) Specifies the action of the DEACTIVATE command as either ACTIVE or INACTIVE lists.

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

ACTIVE

Specifies the lists in use by a CICS region.

INACTIVE

Specifies the lists not currently in use by a CICS region.

DESTIDS(destidlist)

(Optional) Defines the one- to four-character transient data queue destinations that you want to delete.

Position: This optional keyword must follow the optional keywords STEPNAME and STATUS (if they are used).

When specifying destination names to be deleted, you may use the wildcard suffix.

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.

More information:

Wildcards Used in OPSCTL COF Commands