Usage of CACQ transaction to acquire the IPIC connection from local TXSeries region to remote region.

Method to configure the CACQ transaction in TXSeries region:

1. Add a program definition (PD) entry in your local region with program name ‘DFHCACQX’.

cicsadd –r <region_name> -c pd DFHCACQX PathName=” DFHCACQX“

2. Add a transaction definition (TD) entry 'CACQ' in your local region

cicsadd –r <region_name> -c td CACQ ProgName=”DFHCACQX“

Method to acquire the IPIC connection from local region to remote region:

1. Install a local region terminal and execute the CACQ transaction

2. Syntax:

CACQ SYSID{=sysId} A

Options:

sysId
The four-character key of the Communications Definitions (CD) entry that is used to acquire the IPIC connection to a remote region

A
Option ‘A’ specifies the local region trying to acquire the remote region connection.

Example:

To acquire the remote region IPIC connection whose local CD definition is called REG1:

CACQ SYSID=REG1 A

3. You will get below message in terminal, if the IPIC connection is successfully acquired

"29/10/12 04:52:04 ACQUIRED SUCCESSFULLY WITH SYSID 'REG1'"

Method to check the status of IPIC connection from local region

1.Install a local region terminal and execute the CACQ transaction

2.Syntax:

CACQ SYSID{=sysId}

Options:

sysId

The four-character key of the Communications Definitions (CD) entry that used to acquire the IPIC connection from remote region

Example:

To check the status of IPIC connection whose local CD definition is called REG1:

CACQ SYSID=REG1

3. You will get below message in terminal, if the IPIC connection is already acquired

“05/11/12 03:30:23 SYSTEM IS ALREADY IN ACQUIRED STATUS WITH SYSID 'REG1'"

Note: The CACQ transaction is supported from TXSeries 7.1 Fixpack 4