Show TOC

 Select the Files that Are to Be MonitoredLocate this document in the navigation structure

Caution

CCMS agents are no longer required for purely SAP NetWeaver 7.1 landscapes; their functions are performed by SAP NetWeaver Management Agents. More information about when you still require CCMS agents for SAP NetWeaver 7.1: CCMS Agents: Central Monitoring for Components up to SAP NetWeaver 7.0.

Use

You can use CCMS agents to monitor files, for example, for their size, their existence, their last change date, or their content. You define all of this in Log File-Templates, along with information about which files are to be monitored. You do this by setting appropriate parameters in the log file template. These parameters are described below.

A separate subtree is created in the alert monitor for every file that fulfills this naming condition in the log file template. If the condition does not apply to any files, a subtree is also created. However, an alert is only generated in this case if you have set the parameter CHECK_EXISTENCE_ONLY(explained below).

Features

You can use the following parameters of the log file template to determine which files are to be monitored:

DIRECTORY="<directory>"                          (required parameter)

Directory that contains the files that you want to monitor

FILENAME="<file name>"    (required parameter)

Name of the files that are to be monitored; the file name can contain wildcards You can set the maximum number of files that are to be monitored for each file name pattern with the parameter MONITOR_NEWEST_FILES (explained below).

Note

Note also that you can always only set the monitoring settings for one monitored file with one log file template. Therefore, if there is a particular file with a name that fulfills the requirements of the FILENAME parameter in several log file templates, only the monitoring settings of the log file template that the agent processes first will apply for this file.

IGNORE_FILE="<file name>"                      (Default: not set)

Name of the files that are not to be monitored - even if the log file meets the FILENAME condition; this file name can also contain wildcards

Tip

If you want to monitor the trace files of the work process dev_w*, but do not want to monitor the previous version of these trace files, dev_w*.old, set FILENAME=dev_w* and IGNORE_FILE=dev_w*.old.

CHECK_EXISTENCE_ONLY=[0,1]                    (Default = 0)

You can use this parameter to define that only the existence of the monitored file is to be monitored (1). In this case, all parameters for monitoring search patterns (more information: Select the File Content that Is to Be Monitored) are ignored.

Note

Set this parameter if you want to make sure that an alert is generated if no file exists for which the name corresponds to the parameter FILENAME.

MONITOR_NEWEST_FILES=<number>              (Default = 20)

If you specify a file name pattern for the FILENAME parameter that multiple files match, this parameter specifies the maximum number of files that are simultaneously monitored. If more files fulfill the condition, exactly the specified number of files are monitored. The files with the newest change times are those monitored.

Note

This means that different files are monitored over time. If a file is removed from monitoring because other files have a newer change date, its monitoring tree is deleted, and its alerts are reset to avoid storing an unnecessary amount of data in the monitoring infrastructure.

ENCODING=UTF-16                                          (Default: not set)

As of Patch 2007/5, you can monitor files that were created in UTF-16 format on Microsoft Windows platforms. To do so, you require a Unicode agent. To monitor files that were created in UTF-16 format, you need to set the keyword ENCODING=UTF-16 in the log file template.

Activities

If you want to use file monitoring with CCMS agents, create one or more log file templates. Specify this log file template in SAPCCMSR.INI: Configuration File for CCMS Agents.

Note

If you create a log file template, take account of the information in Structure of the Log File Template, which contains a short summary of all possible parameters. Other parameters of log file templates are described by topic in the following sections:

Example