Description

The USER_FILE_ENCRYPTED option specifies a file that contains the parameters and encrypted values for the USER_ID and/or USER_PASSWORD options.

Storing these parameters and values in a file can be used in situations where it is not desirable to specify them explicitly on the command line. These parameters must be specified in their respective command line formats.

Any file specified by this USER_FILE_ENCRYPTED option must be encrypted with the Universal Encrypt utility.

It is strongly recommended that any user file (including those that are encrypted) which contains sensitive data should be further protected from unauthorized access using file level security.

UEM Server uses this information to execute an event handler process in the security context of the specified user account. An event-driven UEM Server requires this information to be stored in an event handler record if the USER_SECURITY option is enabled in the UEM Server configuration. This is the only means by which an event-driven UEM Server can access this information. Because an event-driven UEM Server is started without user interaction, it cannot prompt for user account information if it is required but not provided.

To simplify database administration, the file specified in USER_FILE_ENCRYPTED is stored in the event handler record. If this file contains a user ID and password, the UEMLoad utility saves those values in the event handler's USER_ID and USER_PASSWORD fields, respectively.

However, UEM does not rely strictly on the values stored in those fields. UEM re-reads the encrypted file stored in USER_FILE_ENCRYPTED, just before executing the event handler process, in order to obtain any changes made to the account information stored in the file. This makes it possible to update account information for several event handler processes without having to change the event handler records themselves.

Usage

Specification Method	Parameter / Value	IBM i	HP NonStop	UNIX	Windows	z/OS
Command Line, Short Form	-x filename
Command Line, Long Form	-encryptedfile filename
Definition File Keyword	encryptedfile filename

Value

filename is file containing the encrypted values.

filename can contain either:

• Complete path
• Path that is relative to the directory from which the UEMLoad utility is invoked

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