MSGLMT

I/O Options and Subcase Information Entry 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

Examples

MSGLMT (WARNING) = 1000
MSGLMT (101) = 50

Definitions

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> 1 2
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". 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>
STRICT
All messages are printed according to MSGLMT.
UNREF
Messages 1931, 1932 and 2010 are suppressed.
BRIEF (Default)
Messages 741, 742, 1935, 1931, 1932, 2010, 1052, 1305, and 1436 are suppressed.

Comments

  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 IDs, which can be very long, MSGLMT can be used to control the number of IDs that are printed.
    For example:
    MSGLMT, 1692, <Integer> or MSGLMT (1692) =<integer>
    prints the first <integer> number of duplicate GRID IDs:
    *** 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 IDs:
    *** WARNING # 1692

    Found duplicate GRID cards, removed 86 item(s) of identical data.

    10001      10002      10003      10004      10005