Command-Line Options for Command-Line Clients

The names of the command-line clients have changed between releases 5.x and 6.x. In version 5.x, the command-line clients were ssh2, sftp2, and scp2. In version 6.x, they are called sshg3, sftpg3, and scpg3. However, the old command names can be used with SSH Tectia client tools for z/OS and ConnectSecure 6.x normally. For example, running ssh2 automatically uses sshg3.

Some of the available command-line options have changed between releases 5.x and 6.x. These changes might affect scripts and batch jobs. Check all scripts and batch jobs that use ssh2, sftp2, or scp2 and if they use any outdated options, modify them to use the new command-line options, instead.

The following tables compare the command-line options between versions 5.5 and 6.x.

Table 4.4. ssh2 and sshg3 command-line options comparison

`ssh2` command-line option	Equivalent `sshg3` command-line option
`-1[ti]`	Not available, SSH1 protocol is not supported.
`-4`	Not available, IPv4 is always used.
`-6`	Not available, IPv6 not supported.
`-a`	`-a` or `--no-agent-forwarding`
`+a`	`+a`
`-c` `cipher`	`-c` `cipher`
`-C`	Not available.
`+C`	Not available.
`-D` `debug_level`	`-D` `debug_level`
`-e` `escape_char`	`-e` `escape_char`
`-E` `provider`	Not available, must be set in the Connection Broker configuration.
`-f[o]`	`-f`, argument `'o'` not available
`-F` `file`	Not available.
`-g`	`-g` or `--gateway`
`+g`	`+g`
`-h`	`-h` or `--help`
`-i` `file`	`-i` `file`
`-I` `initstring`	Not available, must be set in the Connection Broker configuration.
`-K` `keyfile`	`-K` `keyfile`
`-l` `username`	`-l` `username`
`-L` `listen-port:dst-host:dst-port`	`-L` `listen-port:dst-host:dst-port`
`-m` `mac`	`-m` `mac`
`-n`	`-n`
`-o` `option`	`-o` `ForwardAgent\|ForwardX11\|AllowedAuthentications`
`-p` `port`	`-p` `port`
`-q`	`-q`
`-R` `listen-port:dst-host:dst-port`	`-R` `listen-port:dst-host:dst-port`
`-s`	`-s` or `--subsytem`
`-S`	`-S` or `--no-session-channel`
`-t`	`-t` or `--tty`
`-v`	`-v` or `--verbose`
`-V`	`-V` or `--version`
`-x`	`-x` or `-X` or `--no-x11-forwarding`
`+x`	`+x, +X`
`--password=``PASSWORD`\| `file://PASSWORDFILE` (this required also `BatchMode=yes`)	`--password=``PASSWORD`\| `file://``PASSWORDFILE`\| `extprog://``program`
	New command-line options in `sshg3`
	`-B` or `--batch-mode`
	`-w`
	`+w`
	`-z` `broker_log_file`
	`--abort-on-failing-tunnel`
	`--allowed-authentications=``methods`
	`--compressions=``methods`
	`--exclusive`
	`--identity=``id`
	`--identity-key-id=``id`
	`--identity-key-hash=``id`
	`--remote-environment-name=``value`
	`--remote-environment-format=``value`

Table 4.5. scp2 and scpg3 command-line options comparison

`scp2` command-line option	Equivalent `scpg3` command-line option
`-1`	Not available, SSH1 is not supported.
`-4`	Not available, IPv4 is always used.
`-6`	Not available, IPv6 not supported.
`-a[arg]`	`-a[arg]`
`-b` `buffer_size`	`-b` `buffer_size_bytes`
`-B`	`-B` or `--batch-mode`
`-c` `cipher`	Not available, must be set in the Connection Broker configuration.
`-d`	`-d`
`-D` `debug_level`	`-D` `debug_level` `--debug=``"level"`
`-h`	`-h` or `--help`
`-I`	`-I` or `--interactive`
`-N` `max_requests`	`-N` `max_requests`
`-o` `option_to_ssh2`	Not available. `scpg3` uses the Connection Broker.
`-p`	`-p`
`-P` `port`	`-P` `port`
`-q`	`-q`
`-Q`	`-Q`
`-r`	`-r`
`-S` `ssh2_path`	Not available, this option is not needed as `scpg3` uses the Connection Broker.
`-u`	`-u` or `--unlink-source`
`-v`	`-v` or `--verbose`
`-V`	`-V` or `--version`
`-W`	`-W` or `--whole-file`
`--checksum[=no]`	`--checksum[=yes\|no\|md5\|sha1\|md5-force\|sha1-force\|checkpoint]`
`--force-lower-case`	`--force-lower-case`
`--overwrite[=no]`	`--overwrite[=yes\|no]`
	New command-line options in `scpg3`
	`--append`
	`--binary`
	`--checkpoint=s<seconds>`
	`--checkpoint=b<bytes>`
	`--dst-site``=PARAM`
	`--fips`
	`-m fileperm [:dirperm]`
	`-O` or `--offset=r<offset>\|w<offset>\|l<length>\|t<length>`
	`--password``=PASSWORD`\| `file://``PASSWORDFILE`\| `extprog://``PROGRAM`
	`--plugin-path``=PATH`
	`--prefix=``PREFIX`
	`--src-site``=PARAM`
	`--statistics[=yes\|no\|simple]`
	`--streaming[=yes\|no\|force\|ext]`

Table 4.6. sftp2 and sftpg3 command-line options comparison

`sftp2` command-line option	Equivalent `sftpg3` command-line option
`-4`	Not available, IPv4 is always used.
`-6`	Not available, IPv6 not supported.
`-b` `buffer_size`	`-b` `buffer_size_bytes`
`-B` `batch_file`	`-B` `batch_file`
`-c` `cipher`	Not available, must be set in the Connection Broker configuration.
`-D` `debug_level`	`-D` `debug_level``--debug=``"level"`
`-h`	`-h` or `--help`
`-m` `mac`	Not available, must be set in the Connection Broker configuration.
`-N` `max_requests`	`-N` `max_requests`
`-o` `option_to_ssh2`	Not available. `sftpg3` uses the Connection Broker.
`-P` `port`	`-P` `port`
`-S` `ssh2_path`	Not available, this option is not needed as `sftpg3` uses the Connection Broker.
`-v`	`-v` or `--verbose`
`-V`	`-V` or `--version`
	New command-line options in `sftpg3`
	`--fips`
	`--password=``PASSWORD`\| `file://``PASSWORDFILE`\| `extprog://``PROGRAM`
	`--plugin-path=``PATH`