FM_CREATE_FAIL_NODIR - UAG configuration option

Description

The FM_CREATE_FAIL_NODIR option specifies whether or not a Universal Controller File Monitor task with a Monitor Type of Create will fail if the directory specified in the file(s) to monitor does not exist.

 

Note

Starting with UAGSRV 5.2.0.0, the default behavior of Create File Monitor tasks was changed to fail if the directory provided in the file path did not exist. This behavior is incompatible with pre-5.2.0.0 releases.

UAGSRV 5.2.0.11 (delivered with the Universal Agent 5.2.0.11 maintenance release) restored the default behavior that existed prior to 5.2.0.0, which allows a File Monitor task to continue executing and to wait (if necessary) for the complete path to be created.

For any Create File Monitor task you may have implemented since 5.2.0.0 - where the task is expected to fail if the directory does not exist - UAGSRV 5.2.0.11 provided FM_CREATE_FAIL_NODIR to restore pre-5.2.0.11 behavior.

The behavior delivered with UAGSRV 5.2.0.11 will continue to be the default, and any new Create File Monitor tasks should be designed with this in mind.

Usage

Method

Syntax

IBM i

HP NonStop

UNIX

Windows

z/OS

Configuration File Keyword

fm_create_fail_nodir option

(tick)

(tick)

(tick)

Values

option specifies whether or not a Create File Monitor task will fail if the specified directory does not exist when the task begins execution.

Valid values for option are:

  • yes
    Task will fail if the specified directory does not exist when the task is launched.
  • no
    Task will continue to execute if the specified directory does not exist when the task is launched.

Default is no.