IBM E027SLL-H - Tivoli Monitoring - PC, Troubleshooting Manual

Page: 80 / 310

When you have enabled the new logging facility, the Tivoli Enterprise Monitoring
Server writes a new log file:
install_dir/itmLogs/itmc_hostname_kms.log
. The
Tivoli Enterprise Portal Server also writes to a new file:
install_dir/itmLogs/
itmc_hostname_kcq.log
.
The properties file (
install_dir/itmLogs/itmc_kms.properties
for the Tivoli
Enterprise Monitoring Server and the
install_dir/itmLogs/itmc_kcq.properties
file for the Tivoli Enterprise Portal Server) determines the maximum size and the
number of rolling log files. The default is 100000 bytes per file and 3 files.
You can modify these values by changing these parameters in the properties file:
fh.maxFileSize=1000000 fh.maxFiles=3
. When the log file exceeds the maxFileSize,
the file moves to a new name, for example,
itmc_hostname_kms1.log
, and new
messages are then written to the original file name, for example,
itmc_hostname_kms.log
. The process continues for the number of maxFiles.
z/OS systems
About this task
To use the new logging facility for the Tivoli Enterprise Monitoring Server, modify
the RKANPARU member. Add the following line to the file:
MSG_MODE=kms
To disable the new logging facility and return to original logging, either remove
this line in the file or change it to:
MSG_MODE=MSG2
The number of log datasets is determined by how many datasets are defined in the
Tivoli Enterprise Monitoring Server JCL procedure. The amount of data that can be
written to each dataset depends on the amount of space allocated at the time each
dataset is created.
To use IBM Tivoli Monitoring Operations Logging on z/OS systems, complete the
following procedure:
1. Create the log datasets. You must create at least one to use the new logging
facility, but it is best to create three. The only limit to the number of datasets
that you create is the limit imposed by the system (typically, about 70). Each
dataset must reside on a disk device. The DCB attributes are DSORG=PS,
RECFM=VB, LRECL=256. The BLKSIZE specification must be at least 260, but
you can allow it to default to the system-determined value for best
performance. The amount of space allocated to the datasets is not critical.
Allocating five 3390 cylinders allows space for about 50000 log records. (The
number varies, depending on the lengths of the messages.)
Note: Do not specify secondary allocations. Any secondary allocations are
ignored.
2. Edit your Tivoli Enterprise Monitoring Server JCL procedure (typically named
CANSDSST, but can be named otherwise). For each of your datasets, add a DD
statement with the DDNAME "RKMSLGnn" that points to the dataset with
DISP=SHR. The first dataset should use "RKMSLG00" as the DDNAME, with
"nn" incrementing by one for each additional dataset.
Note: DO NOT SKIP VALUES of "nn." If any values are skipped, subsequent
OpsLog DD statements are ignored.
62
IBM Tivoli Monitoring: Troubleshooting Guide