The archive task is receiving errors due to a DUPLICATE DATASET situation.
search cancel

The archive task is receiving errors due to a DUPLICATE DATASET situation.

book

Article ID: 26090

calendar_today

Updated On:

Products

Dispatch Output Mgmt

Issue/Introduction

Various errors such as the following may be received intermittently in the ARCHIVE subtask of CA-Dispatch:

IKJ56893I DATA SET NOT ALLOCATED;
IGD17101I DATA SET NOT DEFINED BECAUSE DUPLICATE NAME EXISTS IN CATALOG RETURN CODE IS 8 REASON CODE IS 38 IGG0CLEH;
IKJ56229I DATA SET <your.dsn.prefix>.D08246.T120111.D01 NOT ALLOCATED, CATALOG ERROR;
IKJ56229I DATA SET NAME CONFLICTS WITH EXISTING DATA SET NAME;
IGD17001I DUPLICATE DATA SET NAME ON VOLUME;
DC970033 Dynamic Allocation Error, RC = 004, Error = 38668, Info 0017101
DC970033 Dynamic Allocation Error, RC = 004, Error = 22280, Info 0000000

Environment

Release: DISPAX00200-11.7-Dispatch
Component:

Cause

When CA-Dispatch archives a report, to create the archive dataset name, it adds a date and time stamp value as qualifiers after the DSN PREFIX specified on the VSGMU215 screen. The above errors occur when CA-Dispatch attempts to archive more than one report within the same system clock second. Since the date and time qualifiers are the same, the archive dataset names are identical for more than 1 report.

 

Resolution

CA-Dispatch provides 2 parameters that can be coded as part of the VSGMU215 screen's DSN PREFIX, that will cause CA-Dispatch to assign the actual REPORT and/or JOBNAME of the data being archived as part of the archive dataset name.

The parameters are &JOBN and &RPTN which can be used to assign either the JOBNAME and/or REPORT name respectively. These parameters as well as other details regarding assignment of the archive dataset name are documented in the CA Dispatch Reference Guide where we document the 'VSGMU215 - Sysgen Archive Task information Screen'.

Use of these parameters can provide multiple benefits. They provide a uniqueness to the archive dataset name that will help alleviate the duplicate dataset name situation. Additionally, they allow identification of data which can be used in a recovery situation. And, the files can be secured outside of CA-Dispatch if desired.

Notes:

  • Security adjustments may be necessary to authorize Dispatch to create datasets with the new names.

  • DFSMS and similar product's ACS routines may need to be updated to recognize the new DSN PREFIX for use by Dispatch archive.

  • Care should be taken not to exceed the maximum dataset name length of 44 characters.