Your browser does not allow storing cookies. We recommend enabling them.

SSH

Environment Variables for Client Applications

The environment variables _BPXK_AUTOCVT, _BPX_SHAREAS, and _BPX_BATCH_UMASK must be set as shown in SSHENV and sshsetenv when running Tectia client tools for z/OS programs (see below).

The NAME=VALUE format (as in SSHENV) is used when the client or server programs are run under MVS, and the Bourne shell format (as in sshsetenv) is used when the programs are run from a USS command line.

[Note]Note

The environment files must not contain line numbers or reading them will fail.

SSHENV:

_BPXK_AUTOCVT=ON 1
_BPX_SHAREAS=NO 2
_BPX_BATCH_UMASK=0022 3
SSH_DEBUG_FMT="%W(72)(2) %Dd/%Dt/%Dy %Dh:%Dm:%Ds:%Df %m/%s:%n:%f %M" 4
SSH_MVS_CONSOLE=YES 5
_BPXK_JOBLOG=STDERR 6
_EDC_ADD_ERRNO2=1 7
1

(Required)_BPXK_AUTOCVT=ON activates automatic text conversion of tagged UNIX file system files. If the variable is not set correctly, ssh-broker-g3 fails to start.

2

(Required)_BPX_SHAREAS=NO defines that ssh-broker-g3 and the client processes are run in separate address spaces.

3

(Required)_BPX_BATCH_UMASK defines the permissions for newly created files.

4

(Optional)SSH_DEBUG_FMT can be used to specify the format of the debug messages.

5

(Optional) Setting SSH_MVS_CONSOLE=YES will cause error messages to be logged to the console, in addition to stdout.

6

(Optional) Setting _BPXK_JOBLOG=STDERR will cause job log messages to be written to the STDERR data set specified in the BPXBATCH job.

7

(Optional) Setting _EDC_ADD_ERRNO2=1 will cause errno2 to be shown in debug and error messages.

sshsetenv:

export _BPXK_AUTOCVT=ON
export _BPX_BATCH_UMASK=0022
export _BPX_SHAREAS=NO
export SSH_DEBUG_FMT="%W(72)(2) %Dd/%Dt/%Dy %Dh:%Dm:%Ds:%Df %m/%s:%n:%f %M"
export _EDC_ADD_ERRNO2=1

(For a description of the variables, see SSHENV above.)


 

 
What to read next:

  • Reduce Secure Shell risk. Get to know the NIST 7966.



    The NISTIR 7966 guideline from the Computer Security Division of NIST is a direct call to action for organizations regardless of industry and is a mandate for the US Federal government.
    Download now
  • ISACA Practitioner Guide for SSH



    With contributions from practitioners, specialists and SSH.COM experts, the ISACA “SSH: Practitioner Considerations” guide is vital best practice from the compliance and audit community.
    Download now