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.
- Setting up USS for the first time
- Language environment
- OMVS segment
- Address space region size
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
If you have not enabled USS for your z/OS environment before, the Zowe SMP/E distribution of Zowe provides a number of JCL jobs to assist with this purpose.
To ensure that Zowe has enough memory, the recommended HEAP64 site should be large enough.
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
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:
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
Note: Running a shell script via TSO OMVS will run the shell in the TSO address space, unless you specify
_BPX_SHAREAS=NOwhen invoking OMVS. If you are using TSO OMVS to install Zowe, you will need
export _BPX_SHAREAS=NOto make the ASSIZEMAX change effective.
SIZE parameter of TSO segment
Set SIZE operand of TSO segment to the value of
Note: If you set
export _BPX_SHAREAS=YESin your shell setup as recommended, Java will run in the TSO address space and the SIZE change will work.
The maximum address space size for the process should be at least 250 M, in units of 1024 bytes. For example,
ulimit -A 250000.
ulimit -adisplays the current process limits.