check_messages
This command provides you with a way to monitor an Adams simulation while it is running in batch mode. This is done by querying the Adams message data base using some filter and sorting parameters.
The FAULTS, ERRORS, WARNINGS, and INFO parameters allow you to filter out only the messages that you want to see. All messages will be reported with like messages grouped according to message type, unless the SORT_BY_TIME parameter is set to YES.
The SORT_BY_TIME parameter specifies in what order the messages of all types are to be reported. When SORT_BY_TIME is set to YES, all message types will be merged together and reported in the order in which they occurred during the simulation (i.e. sorted on the base of simulation time).
The FILE_NAME parameter specifies the name of the Adams message file that is to be read. This parameter will default to the message file for the default analysis unless you override it by providing another FILE_NAME with this parameter is specified. The proper extension is ".mdb", the default, but can be overridden by simply supplying a different extension.
You do not need to enclose the file name in quotes if it only contains alpha-numeric characters and starts with a letter. If you want to include other characters, such as a '.' for an extension or '/' or '[]' for directory paths, you must enclose the name in quotes.
Format:
check_messages |
|---|
file_name = | string |
faults = | boolean |
errors = | boolean |
warnings = | boolean |
info = | boolean |
sort_by_time = | boolean |
Example:
check_messages & |
|---|
faults = | yes & |
errors = | yes & |
warnings = | no & |
info = | no & |
sort_by_time = | yes |
When the above command is executed, all the messages related to faults and errors will be displayed in the order in which they occur during the simulation.
Description:
Parameter | Value Type | Description |
|---|
file_name | String | Specifies the name of the Adams message file that is to be read. |
faults | boolean | Specifies that the messages of type PROGRAM FAULT are to be reported. |
errors | boolean | Specifies that the messages of type ERROR are to be reported. |
warnings | boolean | Specifies that the messages of type WARNING are to be reported. |
info | boolean | Specifies that the messages of type INFO are to be reported. |
sort_by_time | boolean | Specifies in what order the messages of all types are to be reported. |
Extended Definition:
1. The FILE_NAME parameter will default to the file for the default analysis unless this parameter is specified. The proper extension is ".mdb", the default, but can be overridden by simply supplying a different extension.
You do not need to enclose the file name in quotes if it only contains alpha-numeric characters and starts with a letter. If you want to include other characters, such as a '.' for an extension or '/' or '[]' for directory paths, you must enclose the name in quotes.
2. All messages of type FAULTS, ERROR, WARNINGS and INFO will be reported together unless the SORT_BY_TIME parameter is set to yes. In this case, all message types will be merged together and reported in the order in which they occurred during the simulation (i.e. sorting based on simulation time).