CEKL SET TASK
Requests the cancellation of a user task.
Description
CEKL SET TASK initiates a PURGE, FORCEPURGE, or KILL request. Th command accepts as few characters of a keyword as are needed to identify it uniquely in the request. In the syntax shown, the minimum permitted abbreviation is shown in uppercase characters, and the rest of the keyword is shown in lowercase characters.
Syntax
The syntax of the CEKL SET TASK command is as follows:
CEKL SET TASK >>-CEKL Set Task-(tasknum)--+-Purge------+--------------------->< +-Forcepurge-+ '-Kill-------'
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.
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.
