Application support parameters for UNIX

The following table lists the application support configuration parameters for UNIX.

Parameter

Description

APPLICATION_LOCALE

(CJK Encoding)

Determines the CJK encoding used by Control-M/Agent to run jobs. For more information, see Language and Customization.

Valid values: UTF-8, JAPANESE EUC, JAPANESE SHIFT-JIS, KOREAN EUC, SIMPLIFIED CHINESE GBK, SIMPLIFIED CHINESE GB, TRADITIONAL CHINESE EUC, TRADITIONAL CHINESE BIG5

Default: UTF-8

Modifiable by ctmunixcfg: Yes

CM_TEMP_SCRIPTS_DIR

Default path for saving temporary scripts.

Valid values: Any valid path on the Agent computer.

Default: $CONTROLM/runtime

Modifiable by ctmunixcfg: Yes

CTM_PARM_ENC

Character used to enclose job processing parameters passed to jobs by Control‑M/Server. Any character or string can be specified. A blank space (in single or double quotes) is valid.

Valid values: Any character or string can be specified. A blank space (in single or double quotes) is also valid.

Default: Double quotes

Modifiable by ctmunixcfg: No

CTM_PRM_DONT_DELETE

(Temporary Scripts Saving)

By default, temporary scripts generated from jobs are deleted at the end of job execution. If this value is set to YES, temporary scripts are not deleted.

Valid values: Yes and No

Default: No

Modifiable by ctmunixcfg: Yes

CTM_PRM_KSH_FLAGS

(Korn Shell Flags)

Indicates the shell flag that will be used to run the job script.

Valid values: -x, -v, n

Default: -x

Modifiable by ctmunixcfg: Yes

CTM_PRM_SH_FLAGS

(Bourne Shell Flags)

Indicates the shell flag that will be used to run the job script.

Valid values: -x, -v, n

Default: -x

Modifiable by ctmunixcfg: Yes

CTM_SU_PATH

Alternative path that Control‑M/Server will use to look for the su command.

Valid values: Any valid path on the Agent home computer.

Default: /bin/su

Modifiable by ctmunixcfg: No

OUTPUT_NAME

(Output Name)

{JOBNAME | MEMNAME}
If set to JOBNAME, parameter Jobname is used in the OUTPUT file instead of parameter Memname.

Valid values: JOBNAME, MEMNAME

Default: MEMNAME

Modifiable by ctmunixcfg: Yes

PRINTER_NAME

(Default Printer)

Default printer for job output (OUTPUT).

Modifiable by ctmunixcfg: Yes

PROCLOG_MODE

Octal value indicating file access mode of the Proclog (output) file. 777 indicates the highest level of access.

Valid values: XXX, in which X is an integer between 0 an 7.

Default: 644

Modifiable by ctmunixcfg: No

RJX_CONN_MODE

(SSH Connection Mode)

The SSH connection mode used in Agentless jobs.

Valid values:

  • 0 - The agent uses only the SSH protocol to upload and download files and to submit the job to the remote computer.
  • 1 - The agent uses both SFTP and SSH protocols. Only one connection is opened during job execution.
  • 2 - The agent used both SFTP and SSH protocols. Two connections are opened at the beginning of the job, but after a while the SSH connection is closed.

Default: 2

Modifiable by ctmunixcfg: No

RJX_CONN_TRY

(AgentLess Connection Retries)

A maximum number of attempts to be made to restore the connection.

Default: 15

Modifiable by ctmunixcfg: No

RJX_CONN_TOUT

(Time Interval between Restore Connections)

The time interval, in seconds, between attempts to restore the connection.

Default: 120 seconds

Modifiable by ctmunixcfg: No

RJX_DETAILS_TO_OUTPUT

(Print Details to OUTPUT)

Determines whether to include details related to the remote connection in the job OUTPUT of jobs executed on a remote host.

Valid values: Y, N

Default: Y

Modifiable by ctmunixcfg: No

RJX_OVMS_DEFAULT_QUEUE

(Default Queue for OpenVMS Remote Host)

For a Control-M/Agent submitting jobs to an OpenVMS remote host, the default batch queue to which the Control-M/Agent submits jobs.

If this parameter is not specified, the Control-M/Agent submits jobs to sys$batch (the system’s default batch queue).

Valid values: String consisting of 1 to 31 characters, including any uppercase and lowercase alphanumeric digits, the dollar sign ($), the underscore (_), and including at least one alphabetic character.

Default: sys$batch

Modifiable by ctmunixcfg: No

RJX_OVMS_SETVERIFY

(Save Commands in the OUTPUT in OpenVMS Remote Host)

For a Control-M/Agent submitting jobs to an OpenVMS remote host, this parameter specifies whether or not to print commands in the OUTPUT of a job.

Valid values:

  • Y – Implements SET VERIFY, which prints commands in the job OUTPUT
  • N – Implements SET NOVERIFY, which does not print commands in the job OUTPUT
  • E – Specifies that the verification value is taken from the environment (account’s LOGIN.COM or SYLOGIN_VERIFY logical name)

Default: Y

Modifiable by ctmunixcfg: No

RJX_OUTPUT_DIR

(AgentLess Temporary Directory)

A directory to store temporary files

These files are automatically removed to Control-M/Agent when the jobs end and the network connection is available or restored.

Default: period (.), which means that the files are stored in the user home directory of the job’s owner in the remote host.

Modifiable by ctmunixcfg: No

SMTP_PORT_NUMBER

(Port Number)

The port number on which the SMTP server communicates.

Valid values: 1024-65535

Default: 25

Modifiable by ctmunixcfg: Yes

SMTP_REPLY_TO_EMAIL

(Reply-To Email)

The e-mail address to which to send replies. If this field is left empty, the sender e-mail address is used.

Valid values: Text can not exceed 99 characters.

Modifiable by ctmunixcfg: Yes

SMTP_SENDER_EMAIL

(Sender Email)

The e-mail address of the sender.

Valid values: Text can not exceed 99 characters.

Default: control@m

Modifiable by ctmunixcfg: Yes

SMTP_SENDER_FRIENDLY_NAME

(Sender Friendly Name)

The name or alias that appears on the e-mail sent.

Modifiable by ctmunixcfg: Yes

SMTP_SERVER_NAME

(SMTP Server (Relay) Name)

The name of the SMTP server.

Modifiable by ctmunixcfg: Yes

SSH_VER_CMD

SSH command to verify platform version.

Valid values: A valid command

Default: cmd.exe /c ver

Modifiable by ctmunixcfg: No

TRANSLATE_$0

(Replace $0 by File Name)

Valid values:

  • Y - Reserved variable $0 specifies whether instances of $0 in the job script should be replaced before the script is run.
  • N - Functionality is disabled

Modifiable by ctmunixcfg: Yes

Parent Topic

Control-M/Agent parameters