zowe › zjcl-expert › remote-ds🖨️

Wraps an SSH call to JCLX on the remote system to validate the specified remote data set.

Usage

zowe zjcl-expert remote-ds <dsn> [options]

Positional Arguments

• dsn (string)

  • The name of the data set to be analysed on the remote system.

Options

• --output | -o (string)

  • The output format provided upon completion.

    Default value: json
    Allowed values: json, text

• --alias | -a (string)

  • An alias to give the file name during analysis.

• --dsn-check | -c (string)

  • Turn on or off DSN and USS file existence checking during analysis.

    Default value: ON
    Allowed values: ON, OFF

• --rules | -r (string)

  • The absolute path of the remote rules file used to define user site rules during analysis.

• --job-class | -j (string)

  • The default job class to use during JCL analysis if none is provided.

• --log-level | -l (string)

  • The level of diagnostic logging to be performed during analysis. Messages at this level and above are written to stderr if no log file is specified.

    Default value: FATAL
    Allowed values: TRACE, DEBUG, INFO, WARN, ERROR, FATAL

• --log-file | -d (string)

  • The relative path of a local file that log messages are output to. If the file already exists it will be overwritten.

• --remote-home-dir (string)

  • The home directory of IBM Z JCL Expert in USS on your remote system. If this option is not set, the plug-in will rely on the PATH variable in the remote user environment.

• --remote-temp-dir (string)

  • The directory where all temporary files are created and deleted by the IBM Z JCL Expert Zowe CLI plugin. Temporary files are cleaned up after each operation. Defaults to "/tmp" if not specified.

• --language (string)

  • The language to be used by IBM Z JCL Expert when invoked. This option will be ignored if remoteHomeDir is not specified.

    Default value: ENG
    Allowed values: ENG, JPN

• --response-encoding (string)

  • The encoding to translate the remote response from. An empty string value or 'binary' will result in no encoding translation. Defaults to 'utf-8' if not provided.

    Default value: utf-8

Zosmf Connection Options

• --port | -P (number)

  • The z/OSMF server port.

    Default value: 443

• --reject-unauthorized | --ru (boolean)

  • Reject self-signed certificates.

    Default value: true

• --base-path | --bp (string)

  • The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

• --protocol (string)

  • The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

• --cert-file (local file path)

  • The file path to a certificate file to use for authentication

• --cert-key-file (local file path)

  • The file path to a certificate key file to use for authentication

z/OS Ssh Connection Options

• --ssh-port | -S (number)

  • The z/OS SSH server port.

    Default value: 22

• --privateKey | --key | --pk (string)

  • Path to a file containing your private key, that must match a public key stored in the server for authentication

• --keyPassphrase | --passphrase | --kp (string)

  • Private key passphrase, which unlocks the private key.

• --handshakeTimeout | --timeout | --to (number)

  • How long in milliseconds to wait for the SSH handshake to complete.

Profile Options

• --jclx-profile | --jclx-p (string)

  • The name of a (jclx) profile to load for this command execution.

• --zosmf-profile | --zosmf-p (string)

  • The name of a (zosmf) profile to load for this command execution.

• --ssh-profile | --ssh-p (string)

  • The name of a (ssh) profile to load for this command execution.

• --base-profile | --base-p (string)

  • The name of a (base) profile to load for this command execution.

Base Connection Options

• --host | -H (string)

  • Host name of service on the mainframe.

• --user | -u (string)

  • User name to authenticate to service on the mainframe.

• --password | --pass | --pw (string)

  • Password to authenticate to service on the mainframe.

• --token-type | --tt (string)

  • The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

• --token-value | --tv (string)

  • The value of the token to pass to the API.