Meaning of error messages XCOMN0288E or XCOMU0288E
search cancel

Meaning of error messages XCOMN0288E or XCOMU0288E

book

Article ID: 16845

calendar_today

Updated On:

Products

XCOM Data Transport XCOM Data Transport - Windows XCOM Data Transport - Linux PC XCOM Data Transport - z/OS

Issue/Introduction

Transfer to XCOM for Windows or UNIX/Linux ends with message:
XCOMN0288E System function failed, RC=nn
or
XCOMU0288E System function failed, RC=nn

Was the transfer successful or not?

Environment

  • XCOM™ Data Transport® for Windows
  • XCOM™ Data Transport® for UNIX/Linux PC

Resolution

An XCOM transfer can fail due to many different reasons, from invalid Userid and Password, Network Problems, Allocation problems, Unicode Conversion trouble and so on.

There are a lot of different Error Messages for these events:

 XCOMN0416E Error writing output file: No such file or directory
 XCOMM0900E UNICODE CONVERSION ERROR - RC=nn REASON=rr
 XCOMN0929E Unicode conversion detected malformed characters.
 XCOMN0298E Unable to allocate remote transaction program: Txpi 211: Socket connect error return value = nnnnn
 XCOMN0302E Unable to open local input file: No such file or directory
 XCOMN0410E Error sending feature negotiation record: Txpi 227 

Messages XCOMN0288E/XCOMU0288E are different:


 XCOMN0288E System function failed, RC=nn
 XCOMU0288E System function failed, RC=nn

These messages appear in two cases:

  1. If transferring a file to Windows or UNIX/Linux and one of the optional pre/post processing (CMD) parameters are enabled in the xcom.glb file which runs a script that does not end successfully i.e. Pre-allocation - XPRECMD, Post-Incoming Transfer - XPPCMD, Post Transfer - XENDCMD, Printing - XLPCMD, Notification - XNOTIFYCMD.
    Use the Preallocation Script
    Use the Processing Scripts
  2. If transferring a batch file script to Windows or UNIX/Linux and that batch script does not successfully execute.

In both cases, the system() function is used to initiate these scripts under the USERID used in the file transfer. It returns an error that is documented in the RC at the end of the message. So the transfer itself went well but the script execution caused a problem. In such cases, the script file needs to be debugged, as the error is outside of the scope of XCOM itself.

Check the xcom.glb file (XCOM_HOME config directory) for any CMD parameter(s) that has been enabled and then look at the contents of the script that the CMD refers to. Add debug information to that script to troubleshoot the problem e.g. redirect all output from commands executed in that script to an output file for review after the error occurs.

Additional Information

Powered by Wolken Software