Return code 3 when executing xcomtcp

Products

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

Issue/Introduction

We have a new install - XCOM on Linux and are using command xcomtcp to send files to IBM mainframe. xcomtcp returns Return Code 3 and not 0 even if everything seems to look OK.

xcomqm -r xcomqm: XCOM Data Transport r11.6 16083 SP01 64bit 
 
Mainframe side: XCOM remote system ping: XCOMU0882I PING INFO FOR mmmmm 
XCOMU0882I RELEASE= v12.0 SP00 GEN LEVEL 1405 

And now the xcomtcp -command that gives RC=3
$ xcomtcp -c1 -f cfg/send_file.cnf USERID=<userid> PASSWORD=<password> REMOTE_FILE=TESTI LOCAL_FILE=testi.xx FILE_OPTION=REPLACE CODE_FLAG=EBCDIC LOCAL_NOTIFY=xxxxxx NOTIFYL=WRITE

2018/09/13 14:39:03 TID=000049 [testi.xx --> TESTI at mmmmm]
XCOMU0029I Locally initiated transfer started. 2018/09/13 14:39:04 TID=000049 XCOMU0011I Transfer ended; 1 blocks (23 bytes) transmitted in 1 seconds (23 bytes/second)

$ echo $? 3 ========================

Environment

XCOM™ Data Transport® for z/OS
XCOM™ Data Transport® for Linux PC

Cause

If the permissions are incorrect for xcomtcp it can return RC 3. 

Resolution

The RC of 3 per the errno.h indicates "NO SUCH PROCESS".

Make sure that the permissions for "xcomtcp" is set correctly. It has to be owned by root and the group must be xcomadm: -r-sr-sr-x. 1 root xcomadm