How to set up the Queue File (QFILE) for CA Disk DMSAR manager in a multi-system environment

Document ID : KB000124260
Last Modified Date : 10/01/2019
Show Technical Document Details
Introduction:
The customer ran into a deadlock situation because the same Queue File was used on 2 systems.
However, a Queue File cannot be shared among systems.
This is documented in chapter "Configuration Data Sets (non-SMP/E)" under link - 
https://docops.ca.com/ca-vantage-storage-resource-manager/14-0/en/installing/post-smp-e-installation-requirements 
Environment:
CA Disk with Auto-Restore Manager (ARM) active on multiple-systems.
Instructions:
At first, check parameter DSNPFX in the VKGPARMS member and allocate separate Queue Files with the LPAR name as suffix: dsnpfx.QUEUE.lpar
Use the sample JCL in member J01QFILE of the vantage.CCTUSAMP library to allocate these Queue Files.
 
Then define the Queue File name via parameter QUEUE in the VKGPARMS member:  
QUEUE (%%DSNPFX%%.QUEUE.&SYSNAME.)
The variable &SYSNAME. will be resolved by the LPAR name.
Note: QUEUE (%%DSNPFX%%.QUEUE) is the default.


The resolved Queue File name will be shown during Vantage start-up in messages: 
VAN1111I QUEUE ! %%DSNPFX%%.QUEUE.&SYSNAME. ! dsnpfx.QUEUE.lpar 
and
KNG0470I Queue File OK, DSN=dsnpfx.QUEUE.lpar