Universal Command Server for zOS - Configuration

Overview

Universal Command Server configuration consists of defining runtime and default values via configuration options.

Manager Override

A UCMD Manager can specify certain UCMD Server configuration options when it makes its request for command execution to the UCMD Server. The UCMD Manager command line option -server (SERVER_OPTIONS) is used to specify UCMD Server options.

Which options are available for manager override depend on the UCMD Server platform and release. UCMD Server configuration options specify a manager override option only if applicable (see Universal Command Server Configuration Options). If override is not specified, no UCMD Manager override is available.

The UCMD Manager is not notified of override errors. The UCMD Server logs the error and continues processing the request.

Configuration File

The configuration file provides the simplest method of specifying configuration options whose values you do not want changed with each command invocation.

The UCMD Server configuration file name is specified in the Universal Command Server component definition. The default name is UCSCFG00. The name refers to a member in the PDS allocated to the Universal Broker ddname UNVCONF.

Note

For any changes to the UCMD Server configuration file to become active, a Universal Broker refresh is required, or the Universal Broker started task must be restarted.

Configuration Options

The following table identifies all UCMD Server for z/OS configuration options. Each Option Name is a link to detailed information about that option.

Option Name

Description

ACTIVITY_MONITORING

Specification for whether or not product activity monitoring events are generated.

ALLOW_SPOOLING

Specification for whether or not spooling is permitted.

CODE_PAGE

Code page used for text translation.

COMMAND_TYPE

Default command type.

DATA_AUTHENTICATION

Specification for whether or not data integrity checks are performed on all standard I/O files.

DATA_COMPRESSION

Specification for whether or not data is compressed on all standard I/O files.

DATA_ENCRYPTION

Specification for whether or not data is encrypted on all standard I/O files.

DATA_SSL_CIPHER_LIST

SSL/TLS cipher list for the control sessions.

DEFAULT_STDIN_ALLOC

Default STC standard input data allocation parameters.

EVENT_GENERATION

Events to be generated and processed as persistent events.

JES_DELETE_SPOOL_FILE

Specification for whether or not selected STC SYSOUT is deleted.

JES_MAX_LINES_READ

Maximum number of records read from selected STC SYSOUT.

JES_REQUEUE_CLAS

JES class in which selected STC SYSOUT is re-queued.

JES_SELECT_CLAS

JES class from which STC SYSOUT is selected.

JOB_RETENTION

Number of seconds that a disconnected server remains active after user process completes.

KEEPALIVE_INTERVAL

Specifies if and how often a keepalive message is sent.

LOGIN

Specifications for setup and login environment.

MESSAGE_LEVEL

Level of messages written.

MIN_SSL_PROTOCOL

Minimum SSL/TLS protocol level that will be negotiated and used for communications channels.

MSG_SUPPRESSION_LIST

List of message IDs representing Universal messages to be suppressed.

NETWORK_FAULT_TOLERANT

Specification for whether or not the server accepts the network fault tolerant protocol.

SCRIPT_TYPE

Script type of the user job being run.

SHELL

Default shell interpreter.

STDIN_ALLOC

STC standard input data set allocation parameters.

STDIN_HLQ

STC standard input data high-level qualifier.

STDIO_TIMEOUT

Wait time for standard I/O to close before the server process exits.

TMP_DIRECTORY

Name of the directory used for temporary files.

TRACE_FILE_LINES

Maximum number of lines to write to a trace file.

TRACE_TABLE

Memory trace table specification.

UCMSCPST_PATH

Absolute path to an external link that resides on the z/OS UNIX file system. The link points to the UCMD Server STC command processor, UCMSCPST.

USER_SECURITY

Specification for whether or not user authentication is active.