swirl
Guide to OmniMark 8   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
  Related Syntax   Related Concepts   Other Library Functions  
function  

mq-set-logging-level

 
 

Library: MQSeries access (OMMQI) legacy
Include: ommqi.xin

Declaration

define function mq-set-logging-level
       value                integer           logging-level

Argument definitions

logging-level
is an integer value representing the desired logging level.


Purpose

Use mq-set-logging-level to set the logging level, which determines whether warnings and/or errors are logged to the OmniMark log stream.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "ommqi.xin"

The logging-level parameter must be set to one of the allowable values (else external exception OMMQI0016).

Possible values of the logging parameter are:

Usage Notes

When the logging level is set to mq-log-none no text is sent to the log stream.

When the logging level is set to mq-log-warnings only MQSeries calls that return a completion code of MQCC_WARNING are logged.

When the logging level is set to mq-log-all MQSeries calls that return a completion code of MQCC_WARNING or MQCC_FAILURE are written to the log stream.

The format of the logged messages is as follows: Function: <function-name> CompCode: <comp-code> Reason: <reason>

where:

Example

set the logging level to mq-log-warnings

  process
    mq-set-logging-level mq-log-warnings

    Related Syntax
   mq-get-logging-level
 
Related Concepts
   ommqi Error Handling
 
Other Library Functions
   mq-backout
   mq-close
   mq-commit
   mq-connect
   mq-connection
   mq-connectx
   mq-disconnect
   mq-get
   mq-get-entire-return-status
   mq-get-function-status
   mq-get-logging-level
   mq-get-throw-on-warnings
   mq-inquire
   mq-inquire-names
   mq-object
   mq-open
   mq-put
   mq-put1message
   mq-set
   mq-set-logging-level
   mq-set-throw-on-warnings
 
 

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]

OmniMark 8.2.0 Documentation Generated: March 13, 2008 at 3:27:39 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2008.