pstat_delete

This command allows you to delete a Process Status File (PSTAT) from the PSTAT blackboard safely. This tool only deletes a PSTAT file, it does not intentionally kill any processes associated with the PSTAT. For this reason, pstat_delete should ONLY be used as a blackboard cleanup tool. Use this with great care - if you happen to remove a PSTAT for an active process, you will likely cause the process to terminate in error.

The path, OPUS process id, process name, and node on which the process is running are be provided on the command line. Status, name, and node are optional. If no status value is specified, pstat_delete will ONLY remove PSTATs in the absent or starting state.

Enough information should be provided so that a single PSTAT may be uniquely identified, otherwise the command will fail.

Usage:

%pstat_delete -p path -i id [-n node] [-o process name] [status]

Switches

p :: path in which the process is running. The path value must match that in the PSTAT to be deleted. [No default.]
i :: OPUS process id of the observation (the PID part of the PSTAT). [No default.]
n :: node on which the process is running (the NODE part of the PSTAT). [No default.]
o :: the OPUS name of the process (the PROCESS part of the PSTAT). [No default.]
status :: (Optional) status value of the PSTAT to be deleted (the PROC_STAT field of the PSTAT). [Default value: matches absent or starting.]

Examples

Imagine the following frozen process in your PMG:

   pid   process       proc_stat         start time    path    node      proc_cmd  class
0019a150 rsvxxx    1116365900179_u 2002 06/10 11:47:24 otfr odoalpha3      halt     otf

The command

%pstat_delete -p otfr -i 0019a150 -n odoalpha3 1116365900179_u

Deletes the Process Status File (PSTAT)

0019a150-rsvxxx___-1116365900179_u.3d04ca0c-otfr_____-odoalpha3___________-halt

from the otfr path. Since "proc_stat" field was not absent or starting, the status parameter must be provided. Otherwise you will see an error, like the following:

:11: sherbert@odoalpha3> pstat_delete -p otfr -i 0019a150 -n odoalpha3
2002162141001-W-MISUSE pstat_delete - PSTAT status not absent or starting. Will not delete. (1)