Error RC 12 in AIS7XEVT: CA 7 Server for AAI fails to allocate LOG history GDG on Tape

Products

• Automation Analytics & Intelligence

Issue/Introduction

The CA 7 Server for AAI task fails with Return Code 12 when attempting to read history log tapes. ​​​​​‌​

ERROR MESSAGE: "A17.MC06W: Call to AIS7XEVT for event data file generation failed. RC=12 Server will terminate."

 

SYMPTOMS:

• Task CA7AAIS fails during the event data delivery cycle.

• Allocation on LOG History GDG fails with dyncmd=ALLOC FI(HLOG).

• The task terminates immediately after the allocation failure.

• Similar tasks on other systems may function correctly with the same log files.

CONTEXT: The issue occurs during the main cycle event data delivery when the system checks the LOG History GDG for recovery data.

 

Environment

 

• Automation Analytics & Intelligence
• AAI CA7 Mainframe Data Provider

• OS: z/OS

• Product Release: 24.2

• Scheduling: CA 7

• Security: RACF (implied)

 

Cause

The user ID assigned to the CA7AA* Started Task lacked a TSO segment and the necessary RACF mount permissions required to access Generation Data Groups (GDG) stored on tape.

Resolution

PREREQUISITES:

• Access to RACF (or equivalent security software) to modify user profiles.

• Identification of the User ID assigned to the CA7AAIS Started Task (STC).

STEPS:

1. VERIFY USER TSO SEGMENT: Check if the user account running the STC has a defined TSO segment.

   Command: LU [USERID] TSO

   EXPECTED: The command should return TSO segment information. NOTE: If no TSO segment is shown, it must be added to allow tape mounting.

2. ADD TSO SEGMENT (IF MISSING): Issue the following command to add the required segment to the User ID.

   Command: ALTUSER [USERID] TSO(ACCT([account#]) SIZE(65536))

   EXPECTED: User profile is updated successfully.

3. GRANT MOUNT PERMISSIONS: Ensure the user has explicit permission to mount tapes.

   Command: PERMIT MOUNT CLASS(TSOAUTH) ID([USERID]) ACCESS(READ)

   EXPECTED: RACF PERMIT command completes successfully.

4. RESTART TASK: Start the CA7AAIS task to verify it can now allocate and read the History GDG on Tape.

VERIFY SUCCESS:

• Review the JES2 job log for successful allocation of the HLOG file.

• Confirm the task reaches "active" status and catches up with live data.

 

Additional Information

If use ACF2 the mount permission commands will be different:

SET RESOURCE(MOUNT)

RECKEY ADD(UID(USERID) SERVICE(READ) ALLOW)