Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Usage

uctl COMMAND HOST [LOCAL] [USER] [OPTIONS...]

...

Long Form

Short Form

Description

-start compname

n/a

Name of the component that is to be started.

-stop compid

-s compid

ID of the component that is to be terminated.


-refresh [compname]

-R [compname]

Name of the component to be refreshed. If no compname is specified, send a REFRESH command to a Universal Broker to instruct it to re-read its configuration parameters and re-read its component definitions.

-file file

-f file

Name of a file from which UCTL options are read.

-encryptedfile file

-x file

Name of an encrypted file from which UCTL options are read. Encrypted UCTL option files are creating using Universal Encrypt.

-key key

-K key

Key that was passed to Universal Encrypt when the UCTL option file was encrypted.

...

Long Form

Short Form

Description

-userid user

-u user

Remote user ID with which the command runs.

-pwd password

-w password

Remote user ID's password.

OPTIONS [ {-help | -version} | [-cmdid] [-crl] [-lang] [-level] [-delay] [-codepage] [-ctl_ssl_cipher_list] [-default_cipher] [-cert -private_key [-private_key_pwd] ] [saf_key_ring [-saf_key_ring_label] ] [-ssl_implementation] [-ca_certs [-verify_host_name] [-verify_serial_number] ]

Long Form

Short Form

Description

-ca_certs   file

n/a

Name of a PEM-formatted file containing the X.509 certificates for trusted Certificate Authorities (CAs).

-cert   file

n/a

Name of a PEM-formatted file containing an X.509 certificate used to identify UCMD to the Broker.

-cmdid   id

-C   id

Identity of the started component.

-codepage <codepage>

-t <codepage>

Code page used to translate text on the local host.

-crl  file  /   ddname

n/a

File name / ddname of the PEM-formatted file containing the Certificate Revocation List (CRL) issued by the trusted Certificate Authority.

-ctl_ssl_cipher_list   ciphers

n/a

SSL/TLS cipher suites (one or more, in their preferred order) for control SSL/TLS connections.  ciphers  is a comma-separated list of cipher suite names.

Valid values are AES256-GCM-SHA384,AES256-SHA,AES128-GCM-SHA256,AES128-SHA,ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES128-GCM-SHA256,RC4-SHA,RC4-MD5,DES-CBC3-SHA.

-delay   seconds

-d   seconds

Maximum delay for transmitting data that may be expected due to network conditions.

-help

-h

Write help file.

-lang   language

-L   language

Message and text language.

-level   level

-l   level

Message level: error, warn, info, audit, or trace.

-private_key   file

n/a

Name of a PEM-formatted file containing the RSA private key corresponding to the X.509 certificate specified by   -cert.

-private_key_pwd   password

n/a

Password for the private key file specified by   -private_key.

-saf_key_ring   name

n/a

SAF (RACF is a SAF implementation) certificate key ring name that Universal Control should used for its certificate.

-saf_key_ring_label   label

n/a

Label of the certificate in the SAF (RACF is a SAF implementation) certificate key ring that Universal Control should use for its certificate.

-ssl_implementation  option  Z

n/a

SSL/TLS implementation to be used for network communications.

Valid values for  option  are:

  • openssl: OpenSSL SSL/TLS library is used.
  • system: z/OS system SSL library is used.

-verify_host_name   host

n/a

Specification that the Broker's X.509 certificate must identify a host name that matches <host>.

-verify_serial_number   number

n/a

Specification that the Broker's X.509 certificate must have a serial number that matches   number. Hexadecimal format is specified with a prefix of 0x or 0X.

-version

-v

Write program version information and exit.

Z  Available for use on z/OS operating systems only.



...