Log4j400

Log4j400: Log4j appenders for AS/400 message queues and data queues.

News

2004/09/08 - New version! 0.2.0 now available for download. The new release features a restructure of the base code, new/changed properties and support for layouts. NOTE: Version 0.2.0 and up require different properties, see new configuration below, changes are denoted in RED.

2004/09/08 - John Ross of Netshare400.com has supplied me with a free open source account for AS/400 testing.

2004/08/27 - New site updates, watch for a new release soon.

2004/08/25 - Log4j400 has been revived under a new developer.

Introduction

Log4j400 includes MessageQueue and DataQueue Appenders for the IBM AS/400 (aka iSeries, aka i5 Server).

Getting Log4j400

The binary (log4j400.jar) and source distributions (log4j400-src.jar) can be downloaded from the project homepage.

System Requirements

To use Log4j400 you will need:

Setup

You need to include the following JARs in the classpath:

  1. log4j400.jar
  2. log4j.jar
  3. jt400.jar

Configuring Log4j400

Configuration to send logging events to MessageQueueAppender.

#####################################
# Message Queue Appender
#####################################
log4j.rootCategory=DEBUG, MQ

log4j.appender.MQ=net.sf.log4j400.MessageQueueAppender

# Layout is now required
log4j.appender.MQ.layout=org.apache.log4j.SimpleLayout

# System name of the AS/400. e.g. 192.168.1.27
# System name MUST be specified if not running locally on the AS/400.
# If running locally, you can omit this property, default value is localhost.
log4j.appender.MQ.systemName=192.168.1.27

# Valid AS/400 user Id. e.g. JAVAUSER
# If running locally on the AS/400, you omit this property, default value is *CURRENT.
log4j.appender.MQ.userId=JAVAUSER

# Password for the user.
# If running locally on the AS/400, you omit this property, default value is *CURRENT.
log4j.appender.MQ.password=USERPASS

# Message queue library. NOTE: The library must exist.
# If omited, the library list is used.
log4j.appender.MQ.messageQueueLib=QUSRSYS

# Message queue name. NOTE: The message queue must exist.
# If omited, the current user's message queue is used.
log4j.appender.MQ.messageQueueName=JAVAUSER

Configuration to send logging events to DataQueueAppender.

#####################################
# Data Queue Appender
#####################################
log4j.rootCategory=DEBUG, DQ

log4j.appender.DQ=net.sf.log4j400.DataQueueAppender

# Layout is now required
log4j.appender.DQ.layout=org.apache.log4j.SimpleLayout

# System name of the AS/400. e.g. 192.168.1.27
# System name MUST be specified if not running locally on the AS/400.
# If running locally, you can omit this property, default value is localhost.
log4j.appender.MQ.systemName=192.168.1.27

# Valid AS/400 user Id. e.g. JAVAUSER
# If running locally on the AS/400, you omit this property, default value is *CURRENT.
log4j.appender.MQ.userId=JAVAUSER

# Password for the user.
# If running locally on the AS/400, you omit this property, default value is *CURRENT.
log4j.appender.MQ.password=USERPASS

# Data queue library. NOTE: The library must exist.
# If omited, the library list is used.
log4j.appender.DQ.dataQueueLib=JAVAUSER

# Data queue name. NOTE: The non-keyed data queue must exist.
log4j.appender.DQ.dataQueueName=USERDTAQ

License

Log4j400: Log4j appenders for AS/400 message queues and data queues.

Copyright (C) 2003 Siddharth, Copyright (C) 2004 rupshall.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

SourceForge.net Logo        Netshare400.com Logo