CDC Guide for z/OS

10.4.0 HotFix 1
- 10.5.8
- 10.5.6
- 10.5.5
- 10.5.4
- 10.5.3
- 10.5.2
- 10.5.1
- 10.5
- 10.4.1
- 10.4.0

Back Next

Configuring AGENTCTL Parameters

The PowerExchange installation process generates the AGENTCTL member that contains the PowerExchange Agent AGENTCTL parameters. This topic describes these parameters.

The EDMSCTL DD statement in the PowerExchange Agent JCL points to the AGENTCTL parameters.

After installation, you can edit the AGENTCTL parameters by editing the AGENTCTL member in the RUNLIB library. If the AGENTCTL member does not exist, view the EDMSCTL DD statement in the PowerExchange Agent JCL to find the member with these parameters.

You must restart the PowerExchange Agent for any change to the AGENTCTL parameters to take effect.

The following table describes the AGENTCTL parameters:

Parameter	Description	Default Value	Valid Values
AgentID	Required. The name of the PowerExchange Agent. You can use the same AgentID for different PowerExchange Agents, if the agents are on different z/OS systems. This value must match the value of the AGENTID parameter in the EDMSDIR module.	EDMA	Four characters, beginning with a letter, #, @, or $. A value that does not conflict with a z/OS subsystem.
CCVACTIVE	Optional. Specifies whether to activate the Batch VSAM ECCR during startup of the PowerExchange Agent.	No	Yes. Activates the Batch VSAM ECCR during startup. No. Does not activate the Batch VSAM ECCR during startup.
CmdAuthCheck	Optional. Specifies whether to check authorization by issuing a RACROUTE authorization macro when a PowerExchange Agent command is issued.	No	Yes. The PowerExchange Agent checks authorization. No. The PowerExchange Agent does not check authorization.
CmdPrefix	Optional. An MVS command prefix to use for all PowerExchange Agent commands. This value must not conflict with existing MVS or PowerExchange Agent commands.	Value of AgentID parameter.	One to eight characters. The first must be a letter or one of the following symbols: ¢ . < ( + \| & ! $ * ) - / % _ > ? : # @ ' = "
InitAuthCheck	Optional. Whether to check authorization by issuing a RACROUTE authorization macro whenever anyone makes a request to initialize a PowerExchange Agent service.	No	Yes. The PowerExchange Agent checks authorization. No. The PowerExchange Agent does not check authorization.
LogBuffLimit	Optional. The data space size to allocate as an integration area for EDMSLOG messages. PowerExchange stores the message log in a data space and not in common storage. Estimate the space in terms of number of messages. For each message, allow 216 bytes.	2000	A number from 1000 through 10000.
LogClass	Required. The EDMSLOG SYSOUT class.	-	Any valid SYSOUT class.
LogHold	Optional. Specifies whether the EDMSLOG SYSOUT data is allocated with HOLD=YES.	No	Yes. Uses HOLD=YES. No. Does not use HOLD=YES.
LogLimit	Optional. The EDMSLOG line limit. When this limit is reached, the PowerExchange Agent allocates another log.	10000	A number from 5000 through 100000.
Refreshsscvt	Optional. Causes the system to build a SSCVT. The parameter specifies the current SSCVT address that you want to refresh because it is no longer usable. Use this parameter if all of the following conditions occur: PowerExchange issues message PWXEDM172020E. The STARTUP parameter is set to COLD. You do not need to IPL because of the failure.	-	An eight-character hexadecimal address that you get from message PWXEDM172020E.
RepositoryDSN	Required. The data set name that the PowerExchange Agent repository uses for either the AGENTREP data set or CCT data set.	-	A valid cataloged data set name.
RepositoryMode	Required. The type of repository.	-	Valid values are DETAIL or EDP. Use DETAIL for PowerExchange CDC.
Startup	Optional. Whether, during startup, the PowerExchange Agent creates a data space or uses an existing data space, if one exists.	WARM	WARM. Reuses a data space if one exists. COLD. Create a data space.
TaskLimit	Optional. The amount of data space storage used as an integration area for concurrent PowerExchange Agent tasks. Specify this limit in terms of the maximum number of concurrent task control blocks (TCBs) that can request services from the PowerExchange Agent. Allow 128 bytes for each control block.	500	A number from 150 through 1500.

Rename Saved Search

Table of Contents

CDC Guide for z/OS

CDC Guide for z/OS

Configuring AGENTCTL Parameters

Configuring AGENTCTL Parameters