Configuring the logging.properties File

The logging.properties file specifies the type of error logging that is turned on for program debugging.

logging.properties File Structure shows its structure, which is designed to allow more transforms to be added in the future.

logging.properties File Structure

The logging.properties file configures the operation of the AFP2PDF Plus logging facility. It consists of these three sections:

Global logging properties

handlers=classname[,classname]
Specifies the set of global logging handlers to be loaded upon startup. This comes preset to java.util.logging.FileHandler,java.util.logging.ConsoleHandler. The end user should not change this value.

Package loggers

com.ricoh.ips.transform=INFO | WARNING | SEVERE | ALL | OFF
Specifies the logging level for the AFP2PDF Plus transform. The default is ALL. The end user should not change this value.

Console and file handlers

The console and file handlers operate independently of each other. For example, critical messages could go directly to the console, while other messages are written to the log file.

The console handler has these entries:

java.util.logging.ConsoleHandler.level=INFO | WARNING | SEVERE | ALL | OFF
Indicates the global logging message override setting. The default is SEVERE. Change this setting to the level of detail you want to appear on the console.

This value overrides the global logging level, whose default is INFO

java.util.logging.ConsoleHandler.formatter=classname
This comes preset to java.util.logging.SimpleFormatter. The end user should not change this value.

The file handler has these entries:

java.util.logging.FileHandler.level=INFO | WARNING | SEVERE | ALL | OFF
Indicates the global logging message override setting. The default is WARNING. Change this setting to the level of detail you want to appear in the log file.

This value overrides the global logging level, whose default is INFO

java.util.logging.FileHandler.append=true | false
Indicates whether trace information is appended to the end of the log file. The default is true.
java.util.logging.FileHandler.formatter=classname
This comes preset to java.util.logging.SimpleFormatter. The end user should not change this value.
java.util.logging.FileHandler.pattern=filename
Specifies the fully qualified AFP2PDF Plus log file name. It comes preset to ./Afp2Pdf.log. You can change this value.
java.util.logging.FileHandler.limit=n
Indicates the maximum size of the log file. When the log file reaches this size, it wraps.
java.util.logging.FileHandler.count=n
Indicates the number of log files to cycle through by appending an integer to the base file name.