IBM Support

SI68294 - Job received CPC1224 (Job ended abnormally by SIGTERM signal

PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

Job received CPC1224 (Job ended abnormally by SIGTERM signal


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
PRE  5770SS1  V7R2M0    SI51590   00/00    0000



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.


APAR Error Description / Circumvention

-------------------------------------------------
Job ended with CPC1224 when the job was running ENDTCP or
ENDTCPSVR *ALL.
CPC1224  Completion  50  02/22/18  01:18:43.184134
Message . . . . :   Job ended abnormally.
Cause . . . . . :   A SIGTERM signal was received for the
job. The action for the signal was to terminate the job.

CORRECTION FOR APAR 'SE69899' :
-------------------------------
1. After apply this fix, a signal handler is set to catch
SIGTERM while ENDTCP or ENDTCPSVR is running.
(1)This signal handler sends CPF9898 with the SIGTERM sender
info to job log if the job is terminated with SIGTERM.
Example of message CPF9898:
SIGNAL SIGTERM GENERATED BY JOB (063079/USER/QZSHSH)
PID(3533) UID(106) ERROR(0) TO TERMINATE JOB
(063142/USER/QPADEV0001) PID(3557) PGID(3557) UID(106)
Side effect:
If the job has any special signal handler of SIGTERM,
ENDTCP or ENDTCPSVR will replace the existing signal
handler with its own.  The original signal handler will
not be restored, CPF9898 "REMOVED THE OLD SIGNAL HANDLER"
will be sent to job log and the signal handler will be
set to the system default at the end of ENDTCP or
ENDTCPSVR.

(2)This signal handler also can ignore SIGTERM if user created
data area QUSRSYS/QTOCSIGNAL with value "1".
Here is the example of the CL commands:
a. CRTDTAARA DTAARA(QUSRSYS/QTOCSIGNAL) TYPE(*CHAR) LEN(5)
b. CHGDTAARA DTAARA(QUSRSYS/QTOCSIGNAL *ALL) VALUE('1')
Side effect:
User can not end the job with SIGTERM (e.g. ENDJOB) while
ENDTCP or ENDTCPSVR is running.

2. User can disable this fix by setting the value of data area
QUSRSYS/QTOCSIGNAL to "X".
Here is the example of the CL commands:
a. CRTDTAARA DTAARA(QUSRSYS/QTOCSIGNAL) TYPE(*CHAR) LEN(5)
b. CHGDTAARA DTAARA(QUSRSYS/QTOCSIGNAL *ALL) VALUE('X')
There is no side effect in this status since the fix won't
set signal handler for ENDTCP and ENDTCPSVR.

CIRCUMVENTION FOR APAR 'SE69899' :
----------------------------------
None.


Activation Instructions

None.




Special Instructions

After the PTF is applied, it requires a re-login to enable the fix in
the new session.

********************************************************************
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
********************************************************************

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI66571 :
=================================================

After the PTF is applied, it requires a re-login to enable the fix in
the new session.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI64642 :
=================================================

If the issue has not been experienced, nothing needs to be done.
If the issue has been experienced and the current behavior needs to be
changed, the optional QIBM_TCP_UPDATE_OLD_HOST_TABLE_FILE environment
variable can be added to update /QIBM/USERDATA/OS400/TCPIP/QTOCHOSTS
but not QUSRSYS/QATOCHOST as follows:
ADDENVVAR ENVVAR(QIBM_TCP_UPDATE_OLD_HOST_TABLE_FILE) VALUE('*NO')
LEVEL(*SYS)

To activate or deactivate the changes with the
QIBM_TCP_UPDATE_OLD_HOST_TABLE_FILE environment variable, either:
a) New sessions must be started
b) Existing sessions must Signoff and signon.
c) Any existing jobs that modifying the HOSTS table must be restarted.

Follow these steps to re-sync data to QUSRSYS/QATOCHOST:
a. RMVENVVAR ENVVAR(QIBM_TCP_UPDATE_OLD_HOST_TABLE_FILE) LEVEL(*SYS)
b. CLRPFM FILE(QUSRSYS/QATOCHOST)
c. Add, change or delete host table entries (after deactivating the
change). Then all data will be re-sync to QUSRSYS/QATOCHOST.

Warning: Any applications that reference the QUSRSYS/QATOCHOST file
directly may not behave properly after this option has been enabled.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI63250 :
=================================================

Before applying/remove this PTF:
exits any job which calls API QtocLstNetIfc to let the PTF take
effective.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI59528 :
=================================================

After applying or removing this PTF, to make the change effective,
please re-signin your session if CL netstat is used.
please restart the application if IPv6 related API is called in the
application.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI67926      MSG TCP8A10 (File processing error) didn't show file name.
   SI67874      If ENDTCP is ended by signal SIGTERM, no message in job log
   SI66571      TCPIP PING WITH HOST NAME FAILS WITH TCP3202
   SI65801      Implement LDAP client trace function
   SI64642      OSP IMPROVE THE PERFORMANCE BUT NOT SYNC DATA TO QUSRSYS/QAT
   SI64727      OSP-OTHER-INCORROUT TRCTCPAPP APP(*HTTP) WITH SYSTEM VALUE Q
   SI63250      TCPIP-OTHER-F/QXML4CINT-T/QXML4CINT-MSGMCH3601 QTOCLSTNETIFC
   SI56293      OSP SEEING TCPIP MESSAGES IN SPANISH AFTER A CHGSYSLIBL TO Q
   SI59528      OSP-COMM-TCPIP-OTHER-F/QTOCIP6INT-T/QTOCIP6INT-MSGMCH3601 AP
   SI51742      F/#HMFREMI-MSGMCH6902 QUMECIMOM JOB FAILS WITH MSGMCH3601 MC
   SI53835      TCPIP-OTHER-MSGTCP3202 IPL LOOPBACK HOST TABLE ENTRY NOT FOU
   SI53677      OSP-COMM-TCPIP-CFG-INCORROUT DBCS CHINESE CHARACTERS NOT DIS
   SI51707      OSP-QTOCALIU Alias Name Not Retrieved If VLAN ID Greater Tha
   SI53470      OSP-UNPRED ITLMAGENT NOT STARTING AT IPL
   SI56583      TCPIP-ACT-F/QLWISTREND-T/QTOCSR-RC500-MSGCPF5C52

Summary Information

System.............................. i
Models..............................
Release............................. V7R2M0
Licensed Program............... 5770SS1
APAR Fixed.......................... View details for APAR SE69899
Superseded by:...................... View fix details for PTF SI70462
Recompile........................... N
Library............................. QSYS
MRI Feature ........................ NONE
Cum Level........................... C9123720


IBM i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

Document information

More support for: i family

Software version: V7R2M0

Operating system(s): OS/400

Reference #: SI68294

Modified date: 16 October 2018