Table of Contents

Search

  1. Preface
  2. Part 1: PowerExchange Change Data Capture Introduction
  3. Part 2: CDC Components Configuration and Management
  4. Part 3: CDC Sources Configuration and Management
  5. Part 4: Change Data Extraction
  6. Part 5: Monitoring and Tuning
  7. Appendix A: CDC for z/OS Troubleshooting
  8. Appendix B: DTL__CAPXTIMESTAMP Time Stamps

Customizing the PowerExchange Agent JCL

Customizing the PowerExchange Agent JCL

The PowerExchange Agent runs as a started task. You must customize the JCL for your installation and copy it to a system procedure library (PROCLIB) for started tasks.
PowerExchange provides sample JCL for the PowerExchange Agent. The XIZZZ998 cleanup job in the RUNLIB library, which runs during PowerExchange installation, moves the PowerExchange Agent JCL to the PowerExchange PROCLIB library.
The name of the PowerExchange Agent JCL member in the PROCLIB library is the value that was specified in the
Agent / Logger Prefix
field in the z/OS Installation Assistant followed by the letter A. Based on the default
Agent / Logger Prefix
value of PWX, the default member name for the PowerExchange Agent JCL in the PROCLIB library is PWXA.
The following table describes the PowerExchange Agent JCL statements and parameters:
JCL Statements
Description
EXEC
The PGM parameter in the EXEC statement must specify the PowerExchange Agent module name EDMSTART.
START
Controls how the PowerExchange Agent starts.
Include the STARTUP symbolic parameter to control whether the PowerExchange Agent WARM or COLD starts. This parameter overrides the installation option for warm or cold starting the PowerExchange Agent. For a cold start, specify:
START
agent_proc_name
,STARTUP=COLD}
The variable
agent_proc_name
is the name that was assigned to the PowerExchange Agent procedure at installation.
If you start the PowerExchange Agent without the STARTUP parameter, it starts with the options that you specified during installation. For a WARM start, the PowerExchange Agent uses an existing Agent environment, if one exists. For a COLD start, the Agent creates a new Agent environment and completes startup processing that is the same as for a first-time start. Use the following syntax to start the PowerExchange Agent with all of the installation options:
START
agent_proc_name
To start the PowerExchange Agent with all of the installation options except the option that determines whether the Agent COLD or WARM starts, use the following syntax:
START
agent_proc_name
,STARTUP={COLD|WARM}
STEPLIB or JOBLIB DD
Includes the PowerExchange load libraries,
hlq
.LOAD and
hlq
.LOADLIB.
This statement is required even if you specify the load libraries in the LNKLST concatenation. The PowerExchange Agent loads certain modules from the STEPLIB or JOBLIB.
EDMPARMS DD
Specifies the name of the user library,
your
.USERLIB, that contains the EDMSDIR options module that is associated with the PowerExchange Agent.
If you do not include an EDMPARMS DD statement, or if you specify a library that does not contain the options module, PowerExchange uses the STEPLIB concatenation to get the configuration options.
EDMSCTL DD
Specifies the data set that contains the PowerExchange Agent startup parameters. Informatica recommends that you also include the FREE=CLOSE statement so that this data set is deallocated after it is read.
SYSPRINT DD
Specifies the output data set for MVS system messages.

0 COMMENTS

We’d like to hear from you!