/pri

Specify the types of messages sent to the message frame or log file.

/pri=MessageLevel

Parameters

MessageLevel—integer representing the sum of the message codes for the desired message types. If the sum of the codes is 0, no information is placed in the message frame. For more information, see I/O Message Levels.

Description

This switch specifies the types of messages sent to the message frame or log file. For example:

  • Use 0 to suppress I/O messages from Uniface; in this case, the message frame is never cleared.
  • Use 127 (=1+2+4+8+16+32+64) to request all messages except calls to global objects and descriptors.

The given Value overrides the entry in the application shell definition.

The ability to select the messages appearing in the message frame can be very useful during the development process. However, generating this information reduces the performance of the application, so it is recommended that you disable the messages in a production environment. Use messages only when you are experiencing particular difficulties.

The message level set with /pri is applied immediately upon startup. In contrast, the message level set by the $IOPRINT setting is applied only after the assignment file is read, and overrides the value set by /pri.

If an application is started with /pri=64 or higher, messages that occur before the assignment file is read, such as assignment file and network connection errors, are logged in the application's default log file. If no fatal errors are encountered, the log file and message level are reset to the values specified by $PUTMESS_LOG_FILE and $IOPRINT in the assignment file (if they are present). If $PUTMESS_LOG_FILE is specified, the default log file is closed and the specified log file is then used. Otherwise the default log file continues to be used.

Example: /pri

The following example requests that all Store sequence messages (code=1), connector function calls (code=2), Fetch and Select return values (code=4) and Open description blocks (code=8) be shown in the message frame. The sum of the desired codes (1+2+4+8) is used for the requested Value. 

/pri=15

Related Topics