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.

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.