The full-qualified file names of the modules running as processes on the system are matched against a substring. On success, the process gets flagged to end.
Syntax: numberKilled = spKillAll ( [ [action] ,] substring )
Parameters: action – The value 'DKP_PROCESSTREE' is used to kill a process and all its descendant processes. The process must be either the current process, or it must have been directly created by the current process using DosExecPgm with a value of 2 (EXEC_ASYNCRESULT) for execFlag.
'DKP_PROCESS' is used to kill any process. This is the default value.
Aliases for 'DKP_PROCESSTREE': 'PROCESSTREE', 'TREE', 'T'.
Aliases for 'DKP_PROCESS': 'PROCESS', 'P'
substring – Part of the filename. Prepend a backslash to full filenames to prevent the kill of processes which filenames contain substring as suffix, e.g. XFILE.EXE and E.EXE.
Returns: Number of processes killed.
/* killall.cmd (spUtils Example Code) */ /* Kills all processes which run the specified exe file. */ CALL RXFUNCADD 'spKillAll','spUtils','spKillAll ' PARSE UPPER ARG exe rest IF POS('\',exe)=0 THEN exe='\' || exe IF RIGHT(exe,4)\='.EXE' THEN exe=exe || '.EXE' SAY spKillAll(exe) || ' process(es) killed'