CEKL SET TASK

Function

Requests the cancellation of a user task.

Description

CEKL SET TASK initiates a PURGE, FORCEPURGE, or KILL request.

Syntax

The syntax of the CEKL SET TASK command is as follows:

Read syntax diagramSkip visual syntax diagramCEKL 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, you should 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 each of the preceding options if the task is in any way associated with an open TCB (for example, it involves a Java program running on a J8 or J9 mode TCB), you could 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 always removes the task from your system. You can confirm this by entering for example,CEKL INQ TASK(62).

Figure 52. 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.  
[[ Contents Previous Page | Next Page Index ]]