Users of the IZSAM Automation Server should NOT set the SHAREOPTIONS of the Automation Server Control Data Set (ASCDS) to (4 4) despite being advised to do so by the IZSAM 8.3 manual and despite that being specified in the HSIASALC JCL sample.
The correct SHAREOPTIONS setting for the 8.3 ASCDS is (4 3).
Background
Historically the ASCDS VSAM cluster has been given the SHAREOPTIONS of (2 3) which was suitable when the only task that updated the ASCDS was the Automation Server itself. IZSAM V8.3 saw the introduction of the Automation Server Utility program HSIAUTL which is an admin and operational utility program to report and update the contents of the ASCDS.
Whether the HSIAUTL program runs in a job submitted by administrators, or runs as a job step in jobs submitted by the Automation Server (most likely to update the job's own record to instruct the Automation Server to perform a retry by resubmitting the job), it means that the ASCDS can be updated by tasks not running in the Automation Server address space. This means that SHR(2 3) is no longer suitable.
SHR(4 4) was incorrectly chosen as the most suitable SHAREOPTIONS value to use in the new situation. The problem with SHR(4 4) is that the cross-system value of 4 means that the High-Used RBA (HURBA) value cannot be changed. This means that when the required space in used control areas (CAs) is not available, a new CA cannot be used, which in turn means that expansion into secondary space or free space within existing DASD extents will not take place.
When a new record cannot be stored into the ASCDS, the Automation Server will produce the following message:
IBM0832S ONCODE=1022 Insufficient space was available for VSAM file CDSDIR.
Switching to SHR(4 3) will allow expansion into new control areas with HURBA being updated accordingly.
Note that SHAREOPTIONS is a component attribute and so the change should be made to both the DATA and the INDEX components.
PTF UJ94886 fixing APAR OA66261 ships an updated HSIASALC sample.
------------------------------
Greg Price
IZSAM Dev & L3
------------------------------