XCOMU0298E Unable to allocate... Txpi 211, return value 111

Products

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

Issue/Introduction

XCOMU0298E Unable to allocate remote transaction program: Txpi  211: Socket connect error return value = 111

Tried to reinstall XCOM as well and bounce it. Also there is no firewall in between source and destination server. 

Environment

Release : 11.6

Resolution

1. On Linux the XCOM listener is run under an OS service xinetd. For details see doc page: Remote Session Control Parameters
For error "XCOMU0298E Unable to allocate remote transaction program: Txpi  211: Socket connect error return value = 111", the return value of 111 means ERRCONNREFUSED i.e. the connection was refused to the XCOM Listener.
If there is no firewall restriction it indicates that there is a likely problem with xinetd service configuration. 

2. By default the XCOM Listener listens on 2 IPv4 ports (8044, 8045) and 2 IPv6 ports (8046, 8047).
a. It was confirmed that these 4 txpi* files and the 4 symbolic links to them existed:
# ls -al $XCOM_HOME/txpi/*
===
-rwxr-----. 1 root xcomadm 499 Aug  5  2013 /opt/CA/XCOM/txpi/txpi
-rwxr-----. 1 root xcomadm 522 Aug  5  2013 /opt/CA/XCOM/txpi/txpi6
-rwxr-----. 1 root xcomadm 521 Aug  5  2013 /opt/CA/XCOM/txpi/txpis
-rwxr-----. 1 root xcomadm 526 Aug  5  2013 /opt/CA/XCOM/txpi/txpis6
===
# ls -al  /etc/xinetd.d/txpi*
===
lrwxrwxrwx. 1 root root 22 Oct 22 14:14 /etc/xinetd.d/txpi -> /opt/CA/XCOM/txpi/txpi
lrwxrwxrwx. 1 root root 23 Oct 22 14:14 /etc/xinetd.d/txpi6 -> /opt/CA/XCOM/txpi/txpi6
lrwxrwxrwx. 1 root root 23 Oct 22 14:14 /etc/xinetd.d/txpis -> /opt/CA/XCOM/txpi/txpis
lrwxrwxrwx. 1 root root 24 Oct 22 14:14 /etc/xinetd.d/txpis6 -> /opt/CA/XCOM/txpi/txpis6
===
b. However there was no output from this command: 
# netstat -na | grep 804 | grep LISTEN
It should show:
===
tcp        0      0 0.0.0.0:8044            0.0.0.0:*               LISTEN
tcp        0      0 0.0.0.0:8045            0.0.0.0:*               LISTEN
tcp6       0      0 :::8046                 :::*                    LISTEN
tcp6       0      0 :::8047                 :::*                    LISTEN
===

Advised to restart the xinetd service using command:
# systemctl restart xinetd
That resolved the problem. The netstat output showed expected results and XCOM file transfers from the remote server were then successful.