Your browser does not allow this site to store cookies and other data. Some functionality on this site may not work without them. See Privacy Policy for details on how we would use cookies.

SSH

Running the SOCKS Proxy

The SOCKS Proxy component consists of two processes:

ssh-socks-proxy

The Tectia SOCKS Proxy process that needs to be running before transparent tunneling connections can be made. The Tectia SOCKS Proxy started task can be controlled with the Tectia SSH Assistant ISPF application and with console modify commands. The process can also be started under USS or by using a JCL script.

For more information on the command-line options of ssh-socks-proxy, see the description of ssh-broker-g3 in Tectia Server 6.6 for IBM z/OS User Manual Appendix Command-Line Tools and Man Pages. (Running ssh-socks-proxy will actually run ssh-broker-g3 in the SOCKS Proxy mode, using the ssh-socks-proxy-config.xml configuration files and with connection caching disabled.)

ssh-socks-proxy-ctl

Control process for the SOCKS Proxy. It can be used, for example, to view the status of the SOCKS Proxy, to reconfigure or stop the SOCKS Proxy, or to load private keys to memory.

For more information on the ssh-socks-proxy-ctl options and commands, see the description of ssh-broker-ctl in Tectia Server 6.6 for IBM z/OS User Manual Appendix Command-Line Tools and Man Pages.

In the Tectia SSH Assistant ISPF application you can control the SOCKS Proxy (ssh-socks-proxy) via submenu 4.3 TSXP.

Tectia SSH Assistant ISPF application - Tasks: Socks Proxy Server (4.3 TSXP)

Figure 8.3. Tectia SSH Assistant ISPF application - Tasks: Socks Proxy Server (4.3 TSXP)

Table 8.1 contains a summary of the modify commands and Tectia SSH Assistant options for controlling the SOCKS Proxy. They are described in more detail in the following sections.

Table 8.1. Controlling the SOCKS Proxy server

CommandConsoleISPF
StartS SSHSP4.3.1 TSXPS
StopF SSHSP,STOP or P SSHSP4.3.2 TSXPP
RestartF SSHSP,RESTART4.3.3 TSXPR
Query versionF SSHSP,VERSION4.3.5 TSXPQV
Set trace levelF SSHSP,DEBUG <debug-level>4.3.6 TSXPTR
Set options for startingS SSHSP,OPTS='<options>'4.3.7 TSXPOP
Get status informationF SSHSP,STATUS/ST4.3.9 TSXPST
Get cryptographic algorithms informationF SSHSP,STATUS/ST ALGORITHMS/ALGS4.3.10 TSXPAL
List open channelsF SSHSP,LIST-CHANNELS/LIST-CH/LCH4.3.11 TSXPLCH
List open connectionsF SSHSP,LIST-CONNECTIONS/LIST-CO/LC4.3.12 TSXPLC
Get the status of a connectionF SSHSP,CONNECTION-STATUS/CONNECTI/CS4.3.13 TSXPCS
Close a connectionF SSHSP,CLOSE-CONNECTION/CLOSE-CO/CC4.3.14 TSXPCC

The console messages generated by the SOCKS Proxy are listed in Table E.2.