IWS/z Server for AAI Fails with AIT.SA10S Error After Upgrade

Products

• Automation Analytics & Intelligence

Issue/Introduction

After upgrading the IWS/z Server for AAI to version 24.2.2 (or later), the started task fails to initialize with the following error messages in the log:

AIT.SA01I: IWS/z Server for AAI starting on [date] at [time]AIT.SA05I: IWS/z Server for AAI validating the existence of execution datasetsAIT.SA10S: Allocation of SADDCOM file has failed - Server terminatingAIT.TM02S: IWS/z Server for AAI has failed at line 241 - Review LOG messages

Environment

• Product: Automation Analytics & Intelligence (AAI)
• Component: IWSz Server for AAI (Mainframe Data Provider)
• Version: R24.2.2 and above
• Delivery Method: SFTP

Cause

The zFS Data Path parameter (AIZULOC) in the server configuration (SRVRSCFG) is incorrectly set to the zFS dataset name instead of the Unix System Services (USS) directory mount point.

In newer versions of the AAI Mainframe Data Provider, the server requires a valid USS directory path to create internal temporary files (like SADDCOM) used during the data delivery process. If this field points to a dataset name, the allocation fails because the server expects a filesystem path.

Resolution

To resolve this issue, update the instance configuration to point to the correct USS directory path where the zFS volume is mounted.

Step 1: Verify the USS Mount Point

From the mainframe console (SDSF) or a USS session, verify where the zFS dataset is mounted:

• Console Command: D OMVS,F (Look for the dataset name and its corresponding mount point).
• USS Command: df -v

Note: Ensure the directory path (e.g., /opt/broadcom/aai/data) is recorded exactly as shown.

Step 2: Update the Instance Configuration

1. Access the AAI Instance Management System ISPF panels (typically by executing the AIZCPRIM member in your CUSTLIB).
2. Type U (Update) next to the affected instance, then C (Configure).
3. Select Option 3 – Define IWSz Server for AAI Settings.
4. Navigate to the zFS Data Path ===> field.
5. Replace the zFS dataset name with the USS directory path identified in Step 1.
6. Save the configuration changes.

Step 3: Verify Permissions

Ensure that the User ID assigned to the AAI started task has full Read/Write/Execute (RWX) permissions for the USS directory specified in the zFS Data Path field.

Step 4: Restart the Server

Restart the IWS/z Server for AAI started task. The server should now successfully allocate the required files and complete activation.