JCLCheck REST API call on Swagger returns Dynalloc of JCKOPTS failed with error code 540, info code 0. Reason = EDC5000I

Products

• JCLCheck Workload Automation

Issue/Introduction

Calling the JCLCheck REST API from Swagger gets error:

Fail:  caz1zsvr:643 Dynalloc of JCKOPTS failed with error code 540, info code 0. Reason = EDC5000I No error occurred.

This happens only on one system. 

Cause

A dynamic allocation error reason code of 540 is...

(540)

Meaning: Device name specified is undefined. (dsname allocation) Application programmer action: Correct the device name subparameter and resubmit the allocation request. If the device name subparameter correctly identifies a device in the current configuration and a dynamic configuration change has just occurred, resubmit the request. System programmer action: If the problem recurs, search the problem reporting data bases for a fix. If none exits, contact the IBM Support Center. Corresponding message: IKJ56241I

Resolution

JCLCheck dynamically allocates JCKOPTS DD (used for runtime options) with the following parameters: 

       DISP=(NEW,DELETE,DELETE),UNIT=VIO,DSORG=PS,SPACE=(CYL,(1,1)),RECFM=FB,LRECL=80,BLKSIZE=8000

In this case, the reason code indicates it doesn't like a UNIT of VIO because the failing system does not have VIO configured.

Once VIO is allowed/configured on this system, the error no longer occurs.