RESCONTROL,
Action, Ldstep,
Frequency, MAXFILES,
--, MAXTotalFiles
Controls file writing for multiframe restarts.
ActionCommand 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 |
LdstepSpecifies 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. |
FrequencyFrequency 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 |
MAXFILESMaximum 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
MAXTotalFilesTotal 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.