Parameter: LDF1_FILE_NAME
Definition
Description and Use
This system parameter defines the file path, the file name, and the file extension of the files from logging destination #1. By default, the rotated log files are numbered and a sequence number is inserted between the file name and the file extension. A rotation occurs when the maximum size is reached for a destination file (see the LDF1_FILE_SIZE parameter).
Note
The rotation mechanism is not available if you customize the filename with a single generated key (see %u) or if this destination is set with only one file in the set (see the LDF1_FILESET_SIZE parameter).
Caution
If no value is set for this parameter, the value of the "ld.file1.name" system property located in
the startup configuration file (jstart.config) of the instance is used instead.
If this system property is not set, the "work/log/@INSTANCE_ID@_LDF1.log" value is used instead.
Syntax and Constraints
Some variables can be used to set up this parameter:
-
@INSTANCE_ID@: The identifier of the instance in the SAP CC Core Server system (Example: updater#1, rater#2 ...) -
@INSTANCE_TYPE@: The type of instance of the system (Example: updater, rater ...) -
@IP_ADDRESS@: An IP address of the machine hosting the instance of the SAP CC Core Server system -
@CURRENT_DATE@: The date/time (ISO format) of the last startup of the instance of the SAP CC Core Server system -
%h: The home directory (value of the system property: 'user.home') -
%t: The system temporary directory (value of the system property: 'java.io.tmpdir') (Example: C:\temp\) -
%u: A single key generated to make the file name unique. To make sure that no naming conflict will occur.
Special values:
-
/: The local file name separator -
%%: The percentage sign -
%g: The sequence number of the file. You can specify the location of the sequence number in the filename.
Recommendation
- End a log file with an extension '.log' and a trace file with an extension '.trc'
Examples
-
work/log/@INSTANCE_ID@_LDF1.logandwork/log/@INSTANCE_ID@_LDF2.trc -
%t/log-%g-file.log
See Also
- Activation of the destination: LDF1_ENABLED
- File output format: LDF1_FORMATTER
- Maximum file size before rotation: LDF1_FILE_SIZE
- Number of files available for the rotations: LDF1_FILESET_SIZE
Additional Information
See the LDF1_ENABLED system parameter for more information and user assistance.
Technical Details
For more information, consult this section.
| Name | LDF1_FILE_NAME
|
|
| Category | Parameter | |
| Type | String | |
| Access (RO/RW) |
RW(-): Dynamic Read / Static Write
An immediate change is not possible.
For a deferred and permanent change, use the |
|
| Groups | ||
| Instance Types |
This system parameter is available in the following types of instances in a running SAP CC Core Server system:
|
|