event manager directory user
To specify a directory name for storing user library files or user-defined Embedded Event Manager (EEM) policies, use the event manager directory user command in XR Config mode. To disable the use of a directory for storing user library files or user-defined EEM policies, use the no form of this command.
event manager directory user {library path | policy path}
no event manager directory user {library path | policy path}
Syntax Description
library |
Specifies a directory name for storing user library files. |
path |
Absolute pathname to the user directory on the flash device. |
policy |
Specifies a directory name for storing user-defined EEM policies. |
Command Default
No directory name is specified for storing user library files or user-defined EEM policies.
Command Modes
XR Config modeCommand History
Release |
Modification |
---|---|
Release 6.0 |
This command was introduced. |
Usage Guidelines
Cisco IOS XR software supports only the policy files that are created by using the Tool Command Language (TCL) scripting language. The TCL software is provided in the Cisco IOS XR software image when the EEM is installed on the network device. Files with the .tcl extension can be EEM policies, TCL library files, or a special TCL library index file named tclindex. The tclindex file contains a list of user function names and library files that contain the user functions (procedures). The EEM searches the user library directory when the TCL starts to process the tclindex file.
User Library
A user library directory is needed to store user library files associated with authoring EEM policies. If you do not plan to write EEM policies, you do not have to create a user library directory.
To create user library directory before identifying it to the EEM, use the mkdir command in XR EXEC mode. After creating the user library directory, use the copy command to copy the .tcl library files into the user library directory.
User Policy
A user policy directory is essential to store the user-defined policy files. If you do not plan to write EEM policies, you do not have to create a user policy directory. The EEM searches the user policy directory when you enter the event manager policy policy-name user command.
To create a user policy directory before identifying it to the EEM, use the mkdir command in XR EXEC mode. After creating the user policy directory, use the copy command to copy the policy files into the user policy directory.
Task ID
Task ID |
Operations |
---|---|
eem |
read, write |
Examples
This example shows how to set the pathname for a user library directory to /usr/lib/tcl on disk0:
RP/0/RP0/CPU0:router(config)# event manager directory user library disk0:/usr/lib/tcl
This example shows how to set the location of the EEM user policy directory to /usr/fm_policies on disk0:
RP/0/RP0/CPU0:router(config)# event manager directory user policy disk0:/usr/fm_policies