A fix is available
APAR status
Closed as new function.
Error description
ERROR DESCRIPTION: This APAR will deliver enhancements to OMEGAMON XE for CICS on z/OS including: Enhancements to the Resource Limiting feature. The ability to use OMEGAMON Kill for tasks from the Enhanced 3270UI. The ability to Kill all ICEs and AIDs for a Terminal/Transaction from the Enhanced 3270UI.
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: All OMEGAMON XE for CICS on z/OS users. * **************************************************************** * PROBLEM DESCRIPTION: OMEGAMON XE for CICS on z/OS product * * enhancements. * **************************************************************** * RECOMMENDATION: Apply the PTF. * **************************************************************** This sysmod will deliver enhancements to OMEGAMON XE for CICS on z/OS.
Problem conclusion
Temporary fix
Comments
The following features are being provided: - Enhanced Resource limiting feature allows for the detection of tasks that are in a long wait or actively using CPU but not issuing EXEC CICS requests, such as tasks using DB2. - The ability to use OMEGAMON KILL facility from the Enhanced 3270 User Interface. OMEGAMON KILL and FORCE KILL can often be successful when other mechanisms have failed. - Enhanced ability to KILL Terminal AIDs or CICS Interval control elements (ICEs), Allowing the removal of all for a terminal or transaction ID with one action from the Enhanced 3270 UI. - An intuitive indication has been added to Task History to alert the user that, to protect from excessive response and resource usage, the rowset is incomplete prossibly due to the scan limit being reached. This can be dynamically overridden. The following error messages have been added to the Troubleshooting Guide: KCPAC4500E Text: KILL command parameter is invalid. Explanation: The command being parsed by the KILL processor is invalid. System action: None. User response: Check the RKLVLOG for message KRAIRA002; correct the command and retry. If problem persist collect all logs and contact IBM Software Support. KCPAC4501E Text: Task number in KILL command parameter is invalid. Explanation: Task number in the command being parsed by the KILL processor is invalid. System action: None. User response: Check the RKLVLOG for message KRAIRA002; correct the command and retry. If problem persist collect all logs and contact IBM Software Support. KCPAC4502E Text: Recovery environment (ESTAEX) could not be established. Explanation: KILL processor failed to establish the necessary recovery environment for execution. System action: The KILL command fails. User response: Collect all logs and contact IBM Software Support. KCPAC4504W Text: This task is scheduled to DL/I. Tasks killed while in DL/I processing may abend DL/I as well as CICS. Must use force option to kill this task. Explanation: KILL processor determined that the task was scheduled to DL/I. System action: None. User response: Tasks scheduled to DL/I must be killed using the force option. KCPAC4505W Text: This task has performed DB2 processing. Tasks killed while in DB2 processing may abend DB2 as well as CICS. Must use force option to kill this task. Explanation: KILL processor determined that the task was processing a DB2 request. System action: None. User response: Tasks in DB2 must be killed using the force option. KCPAC4506W Text: This task is in a VSAM wait. Tasks killed while in a VSAM wait may not terminate. Must use force option to kill this task. Explanation: KILL processor determined that the task was in a VSAM wait. System action: None. User response: Tasks in a VSAM wait must be killed using the force option. KCPAC4507W Text: This task is currently executing a program whose name starts with DFH. Must use force option to kill this task. Explanation: KILL processor determined that the task was running in a CICS program. System action: None. User response: Tasks running under CICS programs must be killed using the force option. KCPAC4508W Text: This task is a CICS system task. Must use force option to kill this task. Explanation: KILL processor determined that the task was a CICS system task. System action: None. User response: CICS system tasks must be killed using the force option. KCPAC4509W Text: This task is currently executing KOCOME00. Must use force option to kill this task. Explanation: KILL processor determined that the task was running in OMEGAMON program KOCOME00. System action: None. User response: OMEGAMON tasks must be killed using the force option. KCPAC4510E Text: No kill performed, target CICS region was not found or terminating RC=xxxxxxxx. Explanation: KILL processor determined that CICS address space was not available. System action: The KILL command fails. User response: Collect all logs and contact IBM Software Support. KCPAC4511E Text: No kill performed, IEAMSCHD macro failure CC=cccccccc AC=aaaaaaaa RS=rrrrrrrr. Explanation: KILL processor determined that SRB could not be scheduled in the target CICS address space. System action: The KILL command fails. User response: Collect all logs and contact IBM Software Support. KCP1052I Text: KILL HAS ATTEMPTED TO MARK THE TASK FOR ABEND S0C6 IN FILE CNTL. Explanation: A task was selected to be killed, but the task is running under CICS File Control. System action: An attempt will be made to kill the task by forcing a S0C6 abend once control of the task is returned to CICS. User response: None. KCP1053I Text: KILL HAS ATTEMPTED TO MARK THE TASK FOR ABEND S0C6. Explanation: A currently dispatched task was selected to be killed. System action: An attempt will be made to kill the task by forcing a S0C6 abend. User response: None. KCP1054I Text: KILL HAS ATTEMPTED TO MARK THE TASK FOR ABEND EIKI. Explanation: A task which is not currently dispatched was selected to be killed. System action: An attempt will be made to kill the task with EIKI abend once the task is dispatched again. User response: None. KCP8904I Text: HH:MM:SS BYPASSED ABEND RLaa DUE TO xxxxxxxxxxxxxxxx: TRANS=tttt, TASKNO=nnnnnnn, USER=uuuuuuu - SYSTASK. Explanation: The CICS task has exceeded the xxxxxxxxxxxxxxx resource KILL threshold and RESOURCE_LIMITING_SYSTEM_TASKS is set to YES; however CICS has identified this task as a system task and therefore OMEGAMON will not abend it. The xxxxxxxxxxxxxxxx value is a text string explaining the threshold. These are the abend codes and their associated texts: RLAD ADABAS requests RLCP CPU time usage RLDB DB2 requests RLDC DATACOM requests RLDL DL/I requests RLDS DSA HWM storage RLED EDSA HWM storage RLEL elapsed time RLFC file requests RLID IDMS requests RLMQ MQ requests RLSU SUPRA requests RLU1 USREVNT1 requests System action: The task will not be killed by Resource limiting and this message will not be issued again for this task. User response: Determine if a limit is appropriate for the task identified. KCP8905E Text: XRL ESTAEX MACRO FAILURE. RC=rc Explanation: The External task Resource limiting component received a non-zero return code from the ESTAEX macro; this is usually caused by a shortage of LSQA. System action: The External task Resource limiting component stops processing. User response: The return code rc value for the ESTAEX macro is described in the IBM Macro Reference manual. If the error was caused by a shortage of available storage, decrease the CICS region size and restart the CICS region. If problems persist, contact IBM Software Support. KCP8906I Text: HH:MM:SS UNABLE TO ABEND RLaa DUE TO xxxxxxxxxxxxxxxx: TRANS=tttt, TASKNO=nnnnnnn, USER=uuuuuuu - RUNNING. Explanation: The CICS task has exceeded the xxxxxxxxxxxxxxx resource KILL threshold ; however the task is not in a state where RLIM is able to ABEND the task. The xxxxxxxxxxxxxxxx value is a text string explaining the threshold. These are the abend codes and their associated texts: RLAD ADABAS requests RLCP CPU time usage RLDB DB2 requests RLDC DATACOM requests RLDL DL/I requests RLDS DSA HWM storage RLED EDSA HWM storage RLEL elapsed time RLFC file requests RLID IDMS requests RLMQ MQ requests RLSU SUPRA requests RLU1 USREVNT1 requests System action: The task will be killed by RLIM when the next opportunity arises. This will result in the message OC8903I also being issued for the same task. User response: The message serves as a notification that the task has exceeded the threshold even though RLIM cannot ABEND it. You may use this message to automate actions to notify operators that external action may be required. KCP8907E Text: UNEXPECTED ABEND DURING EXTERNAL TASK RESOURCE LIMITING PROCESSING Explanation: The process which runs externally to CICS tasks to identify if Resource limits have been exceeded has experienced an ABEND. System action: A system dump is taken. External task Resource limiting will no longer occur until OMEGAMON in the CICS region is restarted. User response: Collect the produced SVC dump and any logs of the CICS region and contact IBM Software Support.
APAR Information
APAR number
OA49899
Reported component name
OMEG XE CICS Z/
Reported component ID
5698A5800
Reported release
530
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2016-02-16
Closed date
2016-02-18
Last modified date
2016-03-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA80759
Modules/Macros
KCPAIDAP KCPAIDS KCPAIDSC KCPICEAP KCPICES KCPICESC KCPTAHPX KCPTASAP KCPTASAX KCPTASD KCPTASH KCPTASS KCPTASSX KCPVER KC5ACT@S KC5TASDA KOCASK00 KOCASRD0 KOCASTD0 KOCILIDA KOCILL00 KOCILR0A KOCMCR0A KOCMST0A KOCNDV0A KOCOMM00 KOCRUEDA KOCTASDA KOCXENDA
Fix information
Fixed component name
OMEG XE CICS Z/
Fixed component ID
5698A5800
Applicable component levels
R530 PSY UA80759
UP16/02/23 P F602
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSLSDR","label":"Tivoli OMEGAMON XE for CICS on z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"530","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
03 March 2016