Start of Content Area

Function documentation Select the Time Periods for the File Monitoring  Locate the document in its SAP Library structure

Use

You can use SAP NetWeaver management 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. You can also restrict the time periods in which a file is to be monitored. You do this by specifying a corresponding configuration file in the log file template. In this way, you can restrict the file monitoring to particular week days, days, months, or times.

This function therefore allows you, for example, to check whether a particular file was newly-created at a point in time.

Example

You expect that a new file will be created every day between 10:00 and 11:00. If the file does not yet exist at a certain path at 11:00 (or is more than an hour old at this time), you want an alert to be generated.

In this case, you should restrict the monitoring period to a short time after 11:00 (such as 11:00 – 11:05), and also use the parameter CHECK_EXISTENCE_ONLYto check its existence (see Select the Files that Are to Be Monitored) and the parameter MONITOR_FILE_AGE_MINUTES=65 to monitor the age of the file (more information: Select the General File Properties that Are to Be Monitored).

Features

You can use the following parameters of the log file template to determine the periods in which a file is to be monitored:

TIME_FRAME_CONFIG_FILE=<file>              (Optional parameter)

Specify a configuration file here with which you can restrict the file monitoring to particular time periods.

Structure of the Configuration File

The configuration file is based on the structure of the crontab used on UNIX platforms for time-controlled execution of commands or scripts. It also contains a duration in minutes in the sixth column.

Every row of the configuration file specifies a time period with a particular period. The time period is determined by six entries, where an entry can be a number of the wildcard character (*):

<column 1> < column 2> < column 3> < column 4> < column 5> < column 6>

Column

Meaning

Possible Values

1

Minute

0 – 59

2

Hour

0 – 23

3

Day

1 – 31

4

Month

1 – 12

5

Day of the week

0 – 7 (Sunday = 0)

6

Duration in minutes

1 - …

The first five entries specify the time (the wildcard character acts as a joker). The sixth entry gives the duration in minutes.

Example

Some possible entries are shown below, with the time periods explained in plaintext:

Entry

Description

01

*

*

*

*

5

Every hour as of xx:01 for 5 minutes

30

23

*

*

0

20

Every Sunday as of 23:30 for 20 minutes

0

0

25

*

*

10

Every 25th of a month as of 0:00 for 10 minutes

0

17

24

12

*

240

Every 24/12 as of 17:00 for 4 hours

0

2

*

*

*

60

Every day as of 02:00 for an hour

Activities

If you want to use file monitoring with SAP NetWeaver management agents, create one or more log file templates. Specify this log file template in Configuration File SAPCCMSR.INI.

Note

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

        Select the Files that Are to Be Monitored

        Select the File Content that Is to Be Monitored

        Select the General File Properties that Are to Be Monitored

        Defining the Node Properties for File Monitoring

Example

See Example Log File Templates

This graphic is explained in the accompanying text Infrastructure of the SAP NetWeaver Management Agents Start Page

 

 

End of Content Area