RESCONTROL,
Action
, Ldstep
,
Frequency
, MAXFILES
,
--
, MAXTotalFiles
Controls file writing for multiframe restarts.
Action
Command action. Valid options are:
DEFINE | — | Issuing the command specifies how
frequently the . |
FILE_SUMMARY | — | Issuing the command prints
the substep and load step information for all . |
STATUS | — | Issuing the command lists the current status in the tables of restart controls specified previously by RESCONTROL. If this option is specified, all other arguments are ignored. |
NORESTART | — | Issuing the command cleans up
some of the restart files after a Distributed ANSYS solution. The host process
will not have the following files in the working directory at the
end of the run: .ESAV, .OSAV, . This option is useful for cleaning up files written by all of the Distributed ANSYS processes, particularly when you know that these restart files will not be needed later on. If this option is specified, all other arguments are ignored. If this option is used in shared-memory parallel ANSYS, most of the restart files in the working directory are removed. It has the same effect as issuing RESCONTROL,,NONE. |
LINEAR | — | Issuing the command specifies the
same actions as |
DELETE | — | Delete the restart control specification
corresponding to the |
Ldstep
Specifies how the .Xnnn
files are
written for the specified load steps. This option also affects how
often the load history information is written to the .LDHI file.
ALL | — | Write the . |
LAST | — | Write the . |
| — | Number that indicates how often the . Input a positive number to write the . Input a negative number (- If |
NONE | — | No multiframe restart files (.RDB [restart database file], .LDHI [load history file], . For nonlinear static, linear static, and full transient analyses, this option allows a restart to be done at the last or abort point using the same procedure as in ANSYS 5.5 or earlier (using the .EMAT, .ESAV or .OSAV, and .DB files). For mode-superposition transient analyses, this option allows a restart from the last point using the .RDSP file and the .DB file. |
Frequency
Frequency at which the .Xnnn
files are written at the substep level.
NONE | — | Do not write
any . |
LAST | — | Write the . |
| — | If In nonlinear static and full transient analyses, negative In mode-superposition analyses, negative |
MAXFILES
Maximum number of .Xnnn
files to
save within a load step.
-1 | — | Overwrite existing . |
0 | — | Do not overwrite any existing . |
| — | The maximum number of . |
--
Unused field
MAXTotalFiles
Total number of restart files to keep (default is 999). This option is only valid when
MAXFILES
= -1 (which is the default).
The MAXTotalFiles
specification cannot be less than 1 or
greater than 999. Once the total number of restart files exceeds
MAXTotalFiles
, the program resets the .Xnnn
file numbering back to 1 and continues to write
.Xnnn
files; it keeps the newest
restart files and overwrites the oldest restart files.
The MAXtotalFiles
value you set applies to all subsequent load
steps. To reset it to the default (999), reissue the command with
MAXTotalFiles
set to zero or a negative value. If
MAXTotalFiles
is set to different values at different load steps,
and if the value of MAXTotalFiles
specified in the prior load step
is larger than that of the current load step, the program can only overwrite the current
number of maximum restart files up to the number MAXTotalFiles
currently specified (which is smaller than the previous number).
The recommended way to control the maximum number of restart files is to specify
MAXTotalfiles
at the first load step and not vary it in
subsequent load steps. Also, MAXTotalfiles
is best used when
Ldstep
= -N
or
ALL.
If the RESCONTROL command is not issued during a structural analysis, the .RDB and .LDHI files will be written as described in Restarting an Analysis in the Basic Analysis Guide.
In nonlinear static and full transient analyses, the default
behavior is multiframe restart (command default is RESCONTROL,DEFINE,LAST,LAST). The .Rnnn
file is written at the last substep of the last load
step by default. An .Rnnn
file is also written at the iteration prior to the abort
point of the run if a Jobname.ABT file was used
in batch mode or the button was pressed
in the GUI, or if the job terminated because of a failure to reach
convergence or some other solution error. No information at the aborted
substep is saved to the .Rnnn
file.
Multiframe restart files are indicated here as .Xnnn
files. They correspond to .Rnnn
files for nonlinear static
and full transient analyses, and .Mnnn
files for mode-superposition analyses. The total number
of restart files for any analysis cannot exceed 999 (for example, Jobname.R001 to Jobname.R999).
This command sets up the restart parameters for a multiframe
restart, which allows you to restart an analysis from any load step
and substep for which there is an .Xnnn
file. You can perform a multiframe
restart for static and transient (full or mode-superposition method)
analyses only. For more information about multiframe restarts and
descriptions of the contents of the files used, see Restarting an Analysis in the Basic Analysis Guide.
If you have many substeps for each load step and are writing
.Xnnn
files frequently, you may
want to use MAXFILES
to limit the number of .Xnnn
files saved, since these files can fill up your
disk quickly. You can specify MAXFILES
and
Frequency
for individual load steps. These arguments will take on
the default value or the value defined by
RESCONTROL,,ALL,Frequency
,MAXFILES
if they are not explicitly defined for a specific load step. When .Xnnn
files are written over many load steps, you may
want to further limit the number of .Xnnn
files by setting MAXTotalFiles
.
You can specify a maximum of ten load steps; that is, you can issue the RESCONTROL,,N command a maximum of ten times. Specified load steps cannot be changed in a restart.
The program accepts only one occurrence
of RESCONTROL with a negative Ldstep
value (RESCONTROL,,N
where N
is a negative number). Therefore,
if you issue RESCONTROL multiple times with a negative Ldstep
value, the last specification overwrites the
previous one.
The program accepts only one occurrence
of RESCONTROL with Ldstep
= LAST. Therefore, if you issue RESCONTROL,,LAST,Frequency
,MAXFILES
multiple
times, the last specification overwrites the previous one.