I/O Options and Subcase Information Entry
MSGLMT - Output Control
Description
The MSGLMT command can be used in the I/O Options section to limit the number of ERROR, WARNING and INFORMATION messages output, or to elevate a WARNING or INFORMATION message to an ERROR.
Format
MSGLMT (type) = value
MSGLMT, type, value
MSGLMT, mode
MSGLMT (WARNING) = 1000
MSGLMT (101) = 50
Argument |
Options |
Description |
|
type |
<ERROR, WARNING, ID> No default |
ERROR: |
Limits the total number of ERROR messages allowed to the value provided. Once this limit is reached, the run terminates. |
WARNING: |
Limits the total number of WARNING and INFORMATION messages reported in the .out file to the value provided. |
||
ID: |
Limits the number of instances of a message with the given ID reported in the .out file to the value provided. |
||
|
|||
value |
<INTEGER, OFF, NONE, ERROR, ABORT> See comments 1 and 2 for defaults. |
INTEGER: |
If a positive integer is given, the limit is set to this number. |
OFF or NONE: |
“value=NONE” can only be used if “type = ID”. See Comment 3. |
||
ERROR: |
Valid only when the type is ID. Messages with this ID will be treated as ERRORs, that is, continuation at the end of the current stage will be disallowed unless the message is encountered during the solver, where full post-processing of the results will be allowed before termination; optimization runs will terminate as if the limit of allowed iterations had been reached. |
||
ABORT: |
Valid only when type is ID. Messages with this ID will be treated as abort ERRORs, that is, the solver will terminate immediately. If the message is encountered during the solver, no output files will be generated. If it happens during reading or verification of input data, the remaining parts of input will not be processed. |
||
|
|||
mode |
<STRICT, UNREF, BRIEF> Default = <BRIEF> |
STRICT: |
All messages are printed according to MSGLMT. |
UNREF: |
Messages 1931, 1932 and 2010 are suppressed. |
||
BRIEF: |
Messages 741, 742, 1935, 1931, 1932, 2010, 1052, 1305, and 1436 are suppressed. |
1. | By default, the limit for most individual ERROR and WARNING/INFORMATION messages is 10. |
2. | The default limit for the total number of ERROR messages is 10,000 and for the total number of WARNING/INFORMATION messages is 1,000. |
3. | The following table lists some special cases of MSGLMT usage: |
Special Cases |
Effect |
---|---|
MSGLMT(Message ID/WARNING/ERROR) = 1 |
Prevents any information about consecutive occurrences of the specified message to be registered and counted. If WARNING/ERROR is used, only the first WARNING/ERROR is printed. |
MSGLMT(Message ID/WARNING/ERROR) = 0 MSGLMT(Message ID/WARNING/ERROR) = OFF |
Message ID: All occurrences of the specified message will be displayed. WARNING: All Warnings will be displayed. ERROR: All Errors will be displayed. |
MSGLMT(Message ID) = NONE |
The specified message (and multiple occurrences of the same, if any) will not be printed in the output file. Note: 1. If the Message ID belongs to an error, the specified error and multiple occurrences of the same error will not be printed in the output file. However, this will not allow the solver to continue after error suppression. This can sometimes generate an output file which states that an error occurred without any information regarding the nature of the error, since it was suppressed. 2. Suppressed ERROR/WARNING messages still count toward respective limits and are reported in the job summary. 3. Using MSGLMT(Message ID)=NONE for ERROR messages is not recommended. |
MSGLMT(Message ID) = <Negative Integer> |
Negative values are not supported. A “Syntax error” will be displayed, if negative integer values are used. |
4. | MSGLMT may be set in the OptiStruct Configuration File. |
5. | Multiple instances of MSGLMT may occur. If any instances conflict, the last instance will be honored. |
6. | Some messages print lists of ID's, which can be very long, MSGLMT can be used to control the number of ID's that are printed. |
For Example:
MSGLMT, 1692, <Integer> or MSGLMT (1692) =<integer>, prints the first <integer> number of duplicate GRID ID’s:
*** WARNING # 1692
Found duplicate GRID cards, removed 74 item(s) of identical data.
10001 10002 … (up to <integer> number)
MSGLMT, 1692, OFF or MSGLMT (1692) =OFF, prints all duplicate GRID ID’s:
*** WARNING # 1692
Found duplicate GRID cards, removed 86 item(s) of identical data.
10001 10002 10003 10004 10005
See Also: