drestart

Restarts a checkpoint (SGI only)

Format:

drestart [ process-state ] [ -no_unpark ] [ -g gid ] [ -r host ]
    [ -ask_attach_parallel | -no_attach_parallel ]
    [ -no_preserve_ids ] checkpoint-name

Arguments:

process_state

Defines the state of the process both before and after the checkpoint. If you do not specify a process state, parallel processes are held immediately after the place where the checkpoint occurred. The CLI attaches to these created parallel processes. You can use one of the following options:

-detach

While TotalView starts checkpointed process, it does not attach to them.

-go

TotalView starts checkpointed parallel processes and attaches to them.

-halt

TotalView stops checkpointed processes after it restarts them.

-no_unpark

Indicates that the checkpoint was created outside of TotalView or you that you used the dcheckpoint command's -no_park option when you created the checkpoint file.

-g gid

Names the control group into which TotalView places all created processes.

-r host

Names the remote host upon which the restart will occur.

-ask_attach_parallel

Asks if the CLI should automatically attach to the parallel processes being created. This is most often used in procedures.

-no_attach_parallel

Tells TotalView to attach only to the base process. That is, the CLI will not attach to the parallel processes being created.

-no_preserve_ids

Tells TotalView that it should use new IDs after it restarts the processes. If you omit this option, TotalView causes the process to use the same process, group, session, or ash IDs after restarting.

checkpoint-name

The name used when the checkpoint file was saved.

Description:

The drestart command restores and restarts all of the checkpointed processes. By default, the CLI will attach to the base process. Here are some of your choices.

• If there are parallel processes related to this base process, TotalView will attach to them.
   
• If you do not want the CLI to automatically attach to these parallel processes, use the -no_attach_parallel option.
   
• If you do not know if there are parallel processes or want the user to decide or if you are using this command within a Tcl procedure, you should use the -ask_parallel_process option.

Examples:

drestart check1

Restarts the processes checkpointed in the check1 file. The CLI automatically attaches to parallel processes.

drestart -no_unpark check1

Restarts the processes checkpointed in the check1 file. This file was either created outside of TotalView or it was created using the -no_park option.