z/OS Agent crashes with System Completion Code SC01, when a user tries to open a report stored on Agent

Document ID : KB000084970
Last Modified Date : 14/04/2018
Show Technical Document Details
Issue:
Error Message :
U01002413 Unknown structure ' U02000033 Could not find routine 'GETFILE'.

SYSTEM COMPLETION CODE=0C1 REASON CODE=00000001

In the Report window of a JOBS object, there is a Directory tab. In case the Report is kept in the file (and is not stored in the Automation Engine database) it’s possible to view the Report by clicking the Open button.

0EMb0000001Qk4h.png

This does not work for z/OS Jobs, because this feature is not available on this platform.

However, nothing happens in the User Interface (UI) when the Open button is selected.  There is no error message nor pop-up window displayed.
The following error message is written to the z/OS agent's log and the agent crashes.
U01002413 Unknown structure ' <?xml ve ', module ' UC11.BUILD.C(MSGCONV2):2750 '.U02000033 Could not find routine 'GETFILE'.
 
In the JES Message Log (JESMSGLG) of the Agent Started Task (STC) or in the System Log (SYSLOG), the following System Completion Code is logged.

 
  13:18:31  SYSTEM COMPLETION CODE=0C1  REASON CODE=00000001  13:18:31   TIME=13.17.40  SEQ=15692  CPU=0000  ASID=00A6  13:18:31   PSW AT TIME OF ERROR  078D0400   80000002  ILC 2  INTC 01  13:18:31     NO ACTIVE MODULE FOUND  13:18:31     NAME=UNKNOWN  13:18:31     DATA AT PSW  00000000 - 000A0000  000130E1  00000000  13:18:31     AR/GR 0: 00000298/00000000_137F89A3   1: 00000000/00000020_00185420  13:18:31           2: 00000000/00000000_57D680C4   3: 00000000/00000000_000127AC  13:18:31           4: 00000000/00000000_1372F110   5: 00000000/00000000_00014670  13:18:31           6: 00000000/00000000_00185460   7: 00000000/00000000_13722038  13:18:31           8: 00000000/00000000_13A548F0   9: 00000000/00000000_00185454  13:18:31           A: 00000000/00000000_0000001C   B: 00000000/00000000_00000000  13:18:31           C: 00000000/00000000_001840C0   D: 00000000/00000000_00185388  13:18:31           E: 00000000/00000000_800128F4   F: 00000000/7F69B000_00000000  13:18:31   END OF SYMPTOM DUMP
 
0EMb0000001Qk4r.png

Investigation

BEWARE:  This will cause the z/OS Agent to crash.
  1. Run any z/OS Job and keep the Report in the File – select option File (and not Database) in the z/OS tab of the job object.
  2. Try to open the report via the Open button - see screenshot above.
  3. The z/OS agent will crash.

 
Environment:
OS: MVS
Cause:
Cause type:
Defect
Root Cause: The request sending the report to the UI, was not correctly handled by the Agent.
Resolution:
Update to a fix version listed below or a newer version if available.

With the releases listed below, a message or pop-up window will be implemented to inform the user that this feature is not available. The Agent will not crash.


Fix Status: Released

Fix Version(s):
Component(s): Agent MVS

Automation Engine 12.1.0 - Available
Automation Engine 12.0.2 - Available
Automation Engine 11.2.4 - Available
Automation Engine 11.1.6 - Available
Additional Information:
Workaround :
N/A