Host Environment Commands › ADDRESS OPSCTL Commands for the COF › COF ACTIVATE—Add Transient Data Queue Names

COF ACTIVATE—Add Transient Data Queue Names

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

This command has the following format:

ADDRESS OPSCTL "COF ACTIVATE 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 and 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 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 ACTIVATE command to activate 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) Indicates the action of the ACTIVATE command is 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 transient data queue destinations that you want to add, as defined in the CICS DCT (destination control table).

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

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

The CA OPS/MVS product maintains the names in your lists in sorted order and eliminates any duplicate names. If the limit of 100 DESTIDS is exceeded as a result of an ACTIVATE command, then the list is sorted first and the last entries in the sorted sequence are discarded.

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

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

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

More information:

Wildcards Used in OPSCTL COF Commands

Keywords Common to All ADDRESS OPSCTL COF Commands