CEKL SET TASK initiates a PURGE,
FORCEPURGE, or KILL request.
Syntax
The syntax of the CEKL SET TASK command
is as follows:
CEKL SET TASK
Options
Task(tasknum)
The CICS-generated task number. This
is in the range 1–99999.
Forcepurge
The
task is to be terminated. Data integrity is not guaranteed. Before
using forcepurge, you should use purge. In some cases, for example
if a task is forcepurged during backout processing, CICS® terminates abnormally. If you want to terminate
a task but do not want to terminate CICS,
use PURGE instead of FORCEPURGE.
Kill
The
task is to be terminated. System and data integrity is not guaranteed.
The KILL option extends the PURGE and FORCEPURGE options. It should
be used only after an attempt has been made to PURGE or FORCEPURGE
a task. The KILL option does not guarantee integrity of any kind but
in some situations it allows the user to free up a stalled region
enabling the region to continue processing. In some cases, for example,
if a task is killed during backout processing, CICS terminates abnormally.
Purge
The
task is terminated. Task termination occurs only when system and data
integrity can be maintained.
For all options, if the task is associated with
an open TCB in any way, you might experience a short delay before
the task is finally purged.
Sample screen
The following figure shows
the output that is generated after CEKL has been invoked to initially
purge a task, for example CEKL SET TASK(62) PURGE.
If
you attempt to reissue the purge command, the system returns the message
informing you that the task is already being purged and it ignores
your second command. If you consider that the purge has already taken
too long, you can issue a forcepurge command, for example, CEKL
SET TASK(62) FORCEPURGE.
If the task still remains
in the system after an unacceptable length of time, you can issue
the kill command, for example, CEKL SET TASK(62) KILL.
This command always removes the task from your system. You can confirm
this by inquiring about the task, for example by entering CEKL
INQ TASK(62). Figure 1. CEKL SET TASK output
F MEACO22X,CEKL SET TA(62) PUR
+IYK2ZFX3 DFHCQ0252I CEKL SET: PURGE request issued for task number 00062.
+IYK2ZFX3 TAS(00062) PUR SUS QR CEMT USE(CICSUSER) ATT(00270) CPU(*****) RUA(00005)
+IYK2ZFX3 HTI(00271) HTY(ZCIOWAIT) HVA(DFHZARQ1)
F MEACO22X,CEKL SET TA(62) PUR
+IYK2ZFX3 DFHCQ0253I CEKL SET: PURGE request ignored; task number 00062 is being purged
+IYK2ZFX3 TAS(00062) PUR SUS QR CEMT USE(CICSUSER) ATT(00288) CPU(*****) RUA(00005)
+IYK2ZFX3 HTI(00289) HTY(ZCIOWAIT) HVA(DFHZARQ1)
+IYK2ZFX3 DFHCQ0252I CEKL SET: FORCEPURGE request issued for task number 00062.
+IYK2ZFX3 TAS(00062) FOR SUS QR CEMT USE(CICSUSER) ATT(00270) CPU(*****) RUA(00005)
+IYK2ZFX3 HTI(00271) HTY(ZCIOWAIT) HVA(DFHZARQ1)
+IYK2ZFX3 DFHCQ0257I CEKL SET: FORCEPURGE request ignored; task number 00062 is being forcepurged
+IYK2ZFX3 TAS(00062) FOR SUS QR CEMT USE(CICSUSER) ATT(00288) CPU(*****) RUA(00005)
+IYK2ZFX3 HTI(00289) HTY(ZCIOWAIT) HVA(DFHZARQ1)
F MEACO22X,CEKL SET TA(62) KILL
+IYK2ZFX3 DFHCQ0259I CEKL SET: KILL request issued for task number 00062.
+IYK2ZFX3 TAS(00062) KIL SUS QR CEMT USE(CICSUSER) ATT(00394) CPU(*****) RUA(00005)
+IYK2ZFX3 HTI(00395) HTY(ZCIOWAIT) HVA(DFHZARQ1)
F MEACO22X,CEKL I TA(62)
+IYK2ZFX3 DFHCQ0242I CEKL INQUIRE: no tasks matched selection criteria.
