XCOM Windows listener caxcgsrv.exe crashes (xcomd.exe impact)

Products

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

Issue/Introduction

Background:
The XCOM for Windows service xcomdsrv executes xcomd.exe and the listener process caxcgsvr.exe is a separate process that is started.
When an incoming file transfer is received it is the listener process caxcgsvr.exe that creates the local xcomtcp.exe process to execute the transfer that is then processed by the xcomd.exe.
So if the listener fails to create that xcomtcp.exe process the xcomd.exe will never process the transfer.

Issue:
When sending to XCOM Windows the following error messages are displayed because caxcgsrv.exe is no longer running:
XCOMx0298E Unable to allocate remote transaction program Txpi 211: Socket connect error return value = 111
XCOMx0298E Unable to allocate remote transaction program: Txpi 215: Socket send error return value = 9
XCOMx0298E Unable to allocate remote transaction program: Txpi 211: Socket connect error return value = 110

NOTE: The x in each of the above will vary across the OS platform of the XCOM partner involved in the transfer to XCOM for Windows e.g. for UNIX/Linux it will be XCOMU0298E

Environment

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

Resolution

Apply 11.6 SP01 Solution 41 SO04839 ("RESTARTING CAXCGSVR REQUIRES THE XCOMD SERVICE TO BE RECYCLED") or higher which contains the fix for problem 574:
XCPCNT_XCOMPATCH_r11618040_64.exe
XCPCNT_XCOMPATCH_r11618040_32.exe

If SO04839 or higher is applied to prevent problem reoccurrence enabled the XCOMD process to check the listener status and automatically restart it if required:

Set the xcom.glb parameter RESTART_CAXCGSVR=YES
Start and stop xcomd to reload the parameters.

RESTART_CAXCGSVR description:
XCOM DATA TRANSPORT FOR WINDOWS 11.6 SERVICE PACKS > ... > XCOM.GLB Parameters > RESTART_CAXCGSVR
Specifies whether the XCOMD CA XCOM Scheduler Service will monitor and restart the listener process "caxcgsvr" if it ends abnormally. It has two values:
YES: xcomdsrv service will monitor and restart the listener.
NO: xcomdsrv service will not monitor and restart the listener.
Default: NO

If the listener process caxcgsvr.exe goes down XCOMD will automatically restart it and entries for that will appear in the xcom.log file i.e.
XCOMN1015E The CA XCOM caxcgsvr listener process has stopped.
XCOMN1016I The CA XCOM caxcgsvr listener process has restarted.

Additional Information

NOTES:

1. The equivalent patch for 11.6 SP02 that contains the same fix for problem 574 is: SO05626. XCOM patches are cumulative so installing the latest SP02 patch will also contain the required change - see #4 below for access to the XCOM 11.6 Solutions (patches) page.

2. The latest XCOM for Windows Service Pack SP03 and 12.0 now contains the new RESTART_CAXCGSVR parameter feature:

XCPCNT Problem 574: RESTATING CAXCGSVR REQUIRES THE XCOMD SERVICE TO BE RECYCLED
Per the above page, SP03 also fixes a problem with the listener terminating abnormally:
XCPCNT Problem 571: CAXCGSVR PROCESS ENDS WITH SERVER_CREATE_PROCESS_FAILURE

3. SP03 patch SO14039 (r11.6.20061) contains another fix related to failed xcomtcp process creation by the listener which causes it to go down. With the fix, rather than trying only once to start xcomtcp, the listener tries up to 3 times before it goes down and each failed attempt writes one of these return code messages to the xcom.log file. So the 3 attempts may prevent the listener having a fatal problem and also the return codes are useful for diagnosing the root cause if further investigation is required.:
XCOMN1020E CA XCOM TCP/IPV4 listener unable to create process, rc =
XCOMN1021E CA XCOM SSL/IPV4 listener unable to create process, rc =
XCOMN1022E CA XCOM TCP/IPV6 listener unable to create process, rc =
XCOMN1023E CA XCOM SSL/IPV6 listener unable to create process, rc =
XCOM patches are cumulative so after installing the base SP03 install just the latest patch from that page which will include the fix from SO14039 (having the latest patch installed will also avoid encountering any other known problems).

4a. The base XCOM 11.6 SP03 (r11.6.20035) download location is here:

CA XCOM Data Transport for Windows 64-bit 11.6 SP03- Product Package DVD0000000002021.iso

b. The XCOM 11.6 Solutions (patches) page is here:
XCOM for Windows 11.6 Solutions

c. The The XCOM 12.0 Product Package is here XCOMWindows120.iso
XCOM For Windows 12.0 Product Download

d The XCOM 12.0 Solutions (patches) page is here:
XCOM for Windows 12.0 Solutions