UNIX System Services considerations for Zowe

The Zowe z/OS component runtime requires USS to be configured. As shown in the Zowe architecture, a number of servers run under UNIX System Services (USS) on z/OS. Review this topic for knowledge and considerations about USS when you install and configure Zowe.

• What is USS?
• Setting up USS for the first time
• Language environment
• OMVS segment
• Address space region size
• Temporary files management
  • How to customize
    • In STC
    • In zowe.yaml

What is USS?

The UNIX System Services element of z/OS® is a UNIX operating environment, which is implemented within the z/OS operating system. It is also known as z/OS UNIX. z/OS UNIX files are organized in a hierarchy, as in a UNIX system. All files are members of a directory, and each directory in turn is a member of another directory at a higher level in the hierarchy. The highest level of the hierarchy is the root directory. The z/OS UNIX files system is also known as zFS.

For more information on USS, see the following resources:

• Introduction to z/OS UNIX for z/OS 2.2
• Introduction to z/OS UNIX for z/OS 2.3
• Introduction to z/OS UNIX for z/OS 2.4

Setting up USS for the first time

If you have not enabled USS for your z/OS environment before, the SMP/E distribution of Zowe provides a number of JCL jobs to assist with this purpose. You can consult with your USS administrator if you need more information such as the USS file system.

Language environment

To ensure that Zowe has enough memory, the recommended HEAP64 site should be large enough.

HEAP64(4M,4M,KEEP,1M,1M,KEEP,0K,0K,FREE)

OMVS segment

Users who install Zowe to run Zowe scripts need to have an OMVS segment. If the user profile doesn't have OMVS segment, the following situations might occur:

• When you access USS through TSO OMVS, you will see the following message:

  FSUM2057I No session was started. This TSO/E user ID does not have access to OpenMVS.+FSUM2058I Function = sigprocmask, return value = FFFFFFFF, return code = 0000009C, reason code = 0B0C00FB
  Action: Create an OMVS segment with a UID.

• When you access USS through SSH, you will see the following message:

  Access denied with SSH

Address space region size

Java as a prerequisite for Zowe requires a suitable z/OS region size to operate successfully while you install and configure Zowe. It is suggested that you do not restrict the region size, but allow Java to use what is necessary. Restricting the region size might cause failures with storage-related error messages such as the following one:

JVMJ9VM015W Initialization error for library j9gc29(2)Error: Could not create the Java Virtual Machine.Error: A fatal exception has occurred. Program will exit

You can fix the storage-related issue by making one of the following changes:

• ASSIZEMAX parameter

  The ASSIZEMAX parameter is the maximum size of the process's virtual memory (address space) in bytes.

  To specify the JVM maximum address space size on a per-user basis, set the ASSIZEMAX configuration parameter to the value of 2147483647.

  Note: Running a shell script via TSO OMVS will run the shell in the TSO address space, unless you specify _BPX_SHAREAS=NO when invoking OMVS. If you are using TSO OMVS to install Zowe, you will need export _BPX_SHAREAS=NO to make the ASSIZEMAX change effective.

• SIZE parameter of TSO segment

  Set SIZE operand of TSO segment to the value of 2096128.

  Note: If you set export _BPX_SHAREAS=YES in your shell setup as recommended, Java will run in the TSO address space and the SIZE change will work.

• ulimit -A

  The maximum address space size for the process should be at least 250 M, in units of 1024 bytes. For example, ulimit -A 250000.

  Note: Running ulimit -a displays the current process limits.

Temporary files management

Zowe server components require the use of temporary files. By default, these temporary files are written to the global /tmp directory in the USS file system. This section describes options to customize the destination directory for all Zowe server components.

How to customize

There are three environment variables that control the directory used to place these temporary files:

• TMPDIR
  This is the main environment variable, it controls the directory used for most USS operations.
• TEMP_DIR
  This variable controls some installation specific files, such as the location to perform transformations on zowe.yaml.
• CATALINA_TMPDIR
  This variable controls the destination directory of Tomcat java servers used in some core components.

In STC

Global environment variables can be customized directly in the Zowe STC, zowe.setup.security.stcs.zowe in zowe.yaml is the Zowe started task name. The default value is ZWESLSTC.

To add environment variables, follow these steps:

1. Open the STC

2. Find STDENV DD inline statements

3. Add a new line for each environment variable.
   Example:

   TMPDIR=<path to directory>

In zowe.yaml

Edit your installation zowe.yaml file and add values under property zowe.environments.

Example:

zowe: environments:   TMPDIR: <path to directory>   TEMP_DIR: <path to directory>   CATALINA_TMPDIR: <path to directory>

Note: If the variable is defined in both the zowe.yaml and the STC member, the definition from zowe.yaml has priority.