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