RENAME_FILE_SPECIFICATION - UEM Server configuration option

Description

The RENAME_FILE_SPECIFICATION option specifies the file name that a Universal Event Monitor Server should use when both of the following occur:

  • Event occurrence for an event with an event type of FILE is set to a triggered state.
  • RENAME_FILE option is set to yes.

Usage

Method

Syntax

IBM i

HP NonStop

UNIX

Windows

z/OS

Configuration File Keyword

rename_filespec renamespecification

(tick)

(tick)

UEM Load Override

-rename_filespec renamespecification

(tick)

(tick)

UEM Manager Override

-rename_filespec renamespecification

(tick)

(tick)

Values

renamespecification is the file name to be used. It can include an absolute path or a path that is relative to the location of the file monitored by UEM. If no path information is provided, the monitored file is simply renamed, and the renamed file will reside in the same location as the original file.

Variables that UEM will substitute with actual runtime values also can be included as part of renamespecification. These variables, and the values that UEM will substitute for them, are listed below.

  • $(compname)
    Component name
  • $(compid)
    Component ID
  • $(date)
    Current date, in the format YYYYMMDD
  • $(time)
    Current time, in the format HHMMSS
  • $(origname)
    Original base file name, minus its last extension
  • $(origext)
    Original file extension
  • $(seqnum)
    A sequence number that is initialized to 0 when a UEM Server is started, and is then incremented by 1 for each file renamed.

If renamespecification contains spaces, it must be enclosed in double ( " ) quotation marks.

UNIX

If renamespecification contains spaces, it must be enclosed in either single ( ' ) or double ( " ) quotation marks.


Default is $(compname).$(compid).$(date).$(seqnum).