First time start of AS400 agent fails due to using ISF naming rules

Document ID : KB000084585
Last Modified Date : 14/04/2018
Show Technical Document Details
Issue:
Error Message :
=======================================================================================
CALL PGM(UC4/UCXJO41) PARM('UC4/INI(UCXJO41)')
Start Agent from INI 'UC4/INI(UCXJO41)'.
Fichier TMP créé dans la bibliothèque UC4.
Membre UCEX_LOG00 ajouté au fichier TMP de UC4.
Unable to open Log file '/QSYS.LIB/UC4.LIB/TMP.FILE/UCEX_LOG00.MBR'.
CPFA0A7 - Le nom de chemin est trop long.
Objet modifié.
=======================================================================================

After the installation of an AS400 Agent on AS400 systems running versions V7R1 or V7R2, the agent fails to start during the first start attempt.

Specific messages can be found in the spool outpout of the Agent job (DSPJOBLOG generated at the startup of the agent process).


 
Environment:
OS: IBM AS/400
OS Version: V7R1 and V7R2
Cause:
Cause type:
Defect
Root Cause: The agent process uses the IFS name of the log file instead of the name. The IFS name exceeds the authorized length for this parameter which brings the program to a stop.

In this situation the log file member is designed by '/QSYS.LIB/UC4.LIB/TMP.FILE/UCEX_LOG00.MBR' instead of UC4/TMP(UCEX_LOG##).
Resolution:
Update to a fix version listed below or newer version if available.

 

Fix Status: In Progress

Fix Version(s):
Automation Engine 12.2.0 - Planned release date: 2018-06-19
Automation Engine 12.1.2 - Available
Automation Engine 12.0.5 - Planned release date: 2018-05-07
Additional Information:
Workaround :
Reduce the value that determines the name of the log file member in the configuration file of the agent (Parameter Logging in GLOBAL section of the INI member.

Example:
Change
logging=UC4V121/TMP(UCEX_LOG##) to logging=UC4V121/TMP(U_LOG##)in the INI file.