RENAME_FILE_SPECIFICATION - UEMLoad configuration option

Description

The RENAME_FILE_SPECIFICATION option specifies the file name that the UEM Server should use when both:

  • An 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

Specification Method

Parameter / Value

IBM i

HP NonStop

UNIX

Windows

z/OS

Command Line, Short Form

n/a






Command Line, Long Form

-rename_filespec renamefile



(tick)

(tick)


Definition File Keyword

rename_filespec renamefile



(tick)

(tick)


Value

renamefile is the file name to be used by the UEM Server.

Valid values for renamefile 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 simply is renamed. The renamed file will reside in the same location as the original file.

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


UNIX

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

Variables

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

  • $(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)
    Sequence number that is initialized to 0 when the demand-driven UEM Server is started, and is then incremented by 1 for each file renamed.

If RENAME_FILE_SPECIFICATION is not used, the specified (or default) value of the UEM Server RENAME_FILE_SPECIFICATION option is used.