Connection logs

MQIPT provides a connection log facility that contains lists of all successful and unsuccessful connection attempts.

An entry is written to the connection log for each connection received or made by an MQIPT route, and for each administrative command received by MQIPT. The connection log is controlled by using the ConnectionLog and MaxLogFileSize properties. See MQIPT global properties for more information.

Each time MQIPT is started, a new connection log is created. For identification, the filename includes the current time stamp, for example: 
mqiptYYYYMMDDHHmmSS.log
where

  • YYYY is the year
  • MM is the month
  • DD is the day
  • HH is the hours
  • mm is the minutes
  • SS is the seconds

When a connection log reaches the maximum size as determined by the MaxLogFileSize property, a backup file, mqipt001.log, is created. A maximum of two backup files are maintained (mqipt001.log and mqipt002.log).

An entry in the connection log represents each part of a connection request. A connection request that is received by MQIPT and the resulting new connection that MQIPT makes to the destination address appears as two log entries, and subsequently two further entries when each connection is ended.

Here is the connection log for a successful connection request: 
Wed May 15 13:13:51 BST 2013 conn accept 127.0.0.1(3842) 127.0.0.1(5000) OK 5000-0
Wed May 15 13:13:51 BST 2013 conn conn   127.0.0.1(3843) localhost(3500) OK 5000-0
Wed May 15 13:13:52 BST 2013 conn close  127.0.0.1(3842) 127.0.0.1(5000) OK 5000-0
Wed May 15 13:13:52 BST 2013 conn close  127.0.0.1(3843) localhost(3500) OK 5000-0
Here is a connection log for a failed connection request: 
Wed May 15 14:56:40 BST 2013 conn accept 127.0.0.1(4138) 127.0.0.1(7000) OK    7000-0
Wed May 15 14:56:40 BST 2013 conn close  127.0.0.1(4138) 127.0.0.1(7000) ERROR 7000-0
 Unrecognized SSL handshake request '54'


Connection log entries

Each connection log entry contains the following information:

  • The time when the entry was created.
  • The type of entry. The value can be one of the following values:

      admin
      Administrative command

      conn
      Route connection

  • The event that occurred. The value can be one of the following values:

      accept
      Connection request received

      close
      Connection closed

      conn
      Connection request to route destination

      dspipt
      Display MQIPT command received

      nodata
      No data received from caller

      ping
      Ping request received

      status
      Display status command received

      refr
      Refresh command received

      stop
      Stop command received

  • The source network address and port number. The value LOCAL is displayed for administrative commands issued locally without using the command port.
  • The destination network address and port number. This is not displayed for administrative commands issued locally without using the command port.
  • The completion code. The value can be either OK or ERROR.
  • The MQIPT thread identifier.
  • An optional error message.

Parent topic: Configure IBM MQ Internet Pass-Thru