COMMAND_FILE_ENCRYPTED - UCTL Manager configuration option

Description

The COMMAND_FILE_ENCRYPTED option specifies the data set (for z/OS) or file containing encrypted values for command line option parameters.

Command files specify an additional source of command line options. Storing options in a file can be used in situations where it is not desirable to explicitly specify them on the command line. The options read from the file are processed exactly like options specified on the command line. The options must be in their respective command line formats.

Universal Control Manager can process command files that are either encrypted or in plain text (see the COMMAND_FILE_PLAIN option). Encrypted command files are an excellent place to store sensitive data such as user IDs and passwords. Command files (encrypted or not) that contain sensitive data should be protected from unauthorized read access with a security system, such as RACF.

Use the Universal Encrypt utility to encrypt a plain text command file. If a key was used to encrypt the file, the same key must be supplied using the ENCRYPTION_KEY option.

Note

If a data set / file is specified in this option, it should not be specified additionally in the COMMAND_FILE_PLAIN option. If it is, the data set / file specified in COMMAND_FILE_PLAIN will be used.

Usage

Method

Syntax

IBM i

UNIX

Windows

z/OS

Command Line, Short Form

-x ddname or filename


(tick)

(tick)

(tick)

Command Line, Long Form

-encryptedfile ddname or filename


(tick)

(tick)

(tick)

Environment Variable

UCTLENCRYPTEDFILE=filename

(tick)

(tick)

(tick)


Configuration File Keyword

n/a





STRUCT Parameter

ECMFILE(filename) [UTIL:ECMMBR(member)]

(tick)




Value

ddname or filename is the name of the data set or file, respectively, containing the encrypted command parameter values.