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

Technote (troubleshooting)


Problem(Abstract)

User can use the CICS Supplied CACQ transaction to ACQURE the IPIC connection from local TXSeries region to a remote TXSeries or CICS TS region. Once the first CACQ transaction request is successfully made, an IPIC connection is acquired between the two regions. This connection remains acquired while both regions are active and it can carry many concurrent intersystem requests flowing in either direction.

Symptom

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



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

TXSeries
CICS

Software version:

7.1

Operating system(s):

AIX, HP Itanium, HP-UX, Solaris, Windows

Reference #:

1619553

Modified date:

2013-01-08

Translate my page

Machine Translation

Content navigation