Totalview® Reference Guide : PART I CLI Commands : Chapter 2 CLI Commands : dcheckpoint
dcheckpoint
Creates a checkpoint image of processes (IBM RS6000 only)
Format 
Creates a checkpoint on IBM RS6000 machines.
dcheckpoint [ -by process_set ] [ -delete | -halt ]
Arguments 
-by process_set
This option can take two possible values:
pe
Checkpoint the Parallel Environment job. This value is the default.
pid
Checkpoint the focus process.
-delete
Processes exit after the checkpoint occurs.
-halt
Processes halt after the checkpoint occurs.
Description 
The dcheckpoint command saves program and process information to a file. This information includes process and group IDs. Later, use the drestart command to restart the program.
NOTE >> This command does not save TotalView breakpoint information. To save breakpoints, use the dactions command.
By default, TotalView checkpoints the Parallel Environment job. To checkpoint a particular process, make that process the focus and use the pid argument to -by. If the focus is a group that contains more than one process, the CLI displays an error -message.
By default, the checkpointed processes stop, allowing you to investigate a -program’s state at the checkpointed position. You can modify this behavior with the -delete and -halt options.
When you request a checkpoint:
TotalView temporarily stops (that is, parks) the processes that are being checkpointed. Parking ensures that the processes do not run freely after a dcheckpoint or drestart operation. (If they did, your code would begin running before you could control it.)
The CLI detaches from processes before they are checkpointed. After checkpointing, the CLI automatically reattaches to them.
Examples 
dcheckpoint
Checkpoints the Parallel Environment job. All associated processes stop.
f3 dcheckpoint -by pid
Checkpoints process 3. Process 3 stops.
dcheckpoint -by pe -halt
Checkpoints the Parallel Environment job. All associated processes halt.
 
Related Topics
Tools > Create Checkpoint Command
Tools > Restart Checkpoint Command
drestart Command