RC 65(65) despite valid Datacom DD
search cancel

RC 65(65) despite valid Datacom DD

book

Article ID: 103576

calendar_today

Updated On:

Products

Datacom DATACOM - AD CIS COMMON SERVICES FOR Z/OS 90S SERVICES DATABASE MANAGEMENT SOLUTIONS FOR DB2 FOR Z/OS COMMON PRODUCT SERVICES COMPONENT Common Services CA ECOMETER SERVER COMPONENT FOC Easytrieve Report Generator for Common Services INFOCAI MAINTENANCE IPC UNICENTER JCLCHECK COMMON COMPONENT Mainframe VM Product Manager CHORUS SOFTWARE MANAGER CA ON DEMAND PORTAL CA Service Desk Manager - Unified Self Service PAM CLIENT FOR LINUX ON MAINFRAME MAINFRAME CONNECTOR FOR LINUX ON MAINFRAME GRAPHICAL MANAGEMENT INTERFACE WEB ADMINISTRATOR FOR TOP SECRET Xpertware

Issue/Introduction

/* This works:
//PREINIT EXEC DB15UTL
//CSA954 DD DSN=DATACOM.DB954.CSA.TEST1,DISP=(,CATLG),
....
//DBUTL.SYSIN DD *
PREINIT AREA=CSA,DBID=954,BLKSIZE=32720

/* This does not:
//PREINIT EXEC DB15UTL
//CSA0954 DD DSN=DATACOM.DB954.CSA.TEST2,DISP=(,CATLG),
.....
//DBUTL.SYSIN DD *
PREINIT AREA=CSA,DBID=954,BLKSIZE=32720

/* The result of the latter:
.....
- PXX START DB15#PRE 76274 65(065) OPEN -0- D-1 DBUTLTY PREINIT
DB02406I - PXX END - DD STATEMENT MISSING
DB00501E - OPEN ERROR - RETURN CODE 65 (065) CXX=DBTEST WXX
DB10045E - ABNORMAL TERMINATION DUE TO ERROR(S)

The extra zero in "//CSA0954 DD " is the only difference.
Also, not sure where the dataset id of 'WXX' in the error message came from.

Environment

z/os, CA Datacom/DB 14.0 and higher

Cause

 When used, the format of the DDNAME for an AREA, in the DBUTLTY JCL, should be:
  • ABCnnn when nnn is between 1 and 999
  • ABCnnnn when nnnn is higher than 999
ABC is the 3 AREA name characters.
Other formats can lead to errors like rc 65 (065) - DD Statement Missing.  
Three characters DDNAME finishing with XX is reserved to Datacom software (like CXX, LXX….). 

The following format:
ABC0nnn will generate a rc 65(065).

Error will occur during DBUTLTY function INIT or PREINIT when DDNAME does not follow the above rule.  
It may generate other errors when not appropiately used. 
 

Resolution

Documentation has been updated.

see Example JCL:
https://docops.ca.com/ca-datacom/15-1/en/reference/dbutlty-reference/utility-function-summary/init-cxx-fxx-ixx-lxx-wxx-data-area/init-data-area-format-data-area 

Additional Information

 If you saw a term WXX that is because all PREINIT executions are internally handled as a WXX uses for RRS but with a 'special' DDNAME.