Statements and parameters for BPXPRMxx

For information about selecting values for the statements, see Customizing z/OS UNIX in z/OS UNIX System Services Planning.

ALTROOT FILESYSTEM('fsname') PARM('parameter') MOUNTPOINT('pathname')

Specifies the alternate sysplex root file system that automatically replaces the current one when it becomes uncrowned. It is mutually exclusive with ALTROOT NONE.

When the replacement occurs, the alternate sysplex root file system is unmounted. It is mounted again as the current sysplex root on all systems in the shared file system configuration. If the replacement is successful, the failed sysplex root is unmounted.

The alternate sysplex root file system is always mounted in READ mode and designated as AUTOMOVE=YES when it becomes the current sysplex root file system. The previous mount mode and AUTOMOVE settings of the alternate sysplex root and the failed sysplex root are ignored. The mount parameters are preserved when the alternate sysplex root file system becomes the current sysplex root file system.

To manually replace the failed or failing sysplex root file system, use the MODIFY OMVS,NEWROOT operator command with the COND=FORCE option. To validate the syntax of the ALTROOT statement, use the SETOMVS SYNTAXCHECK operator command. For instructions on how to replace the failed or failing sysplex root, see Steps for dynamically replacing the sysplex root file system in z/OS UNIX System Services Planning.

FILESYSTEM('fsname'): The name of the alternate sysplex root file system.
PARM('parameter'): The parameter to be passed directly to the file system type.
MOUNTPOINT('pathname'): The absolute path name, or a symbolic link that resolves to the path name of the directory onto which the file system is to be mounted. MOUNTPOINT must be specified in the ALTROOT statement. The mount point for the alternate sysplex root file system must be in the root directory of the current sysplex root file system, or the mount of the ALTROOT will fail. The absolute path name can be up to 64 characters.

ALTROOT NONE

Removes the ALTROOT support and deletes any outstanding eventual action messages. It is mutually exclusive with ALTROOT FILESYSTEM. It does not unmount the file system that was established by using the ALTROOT FILESYSTEM statement. The alternate file system is left unmounted as a regular file system.

AUTHPGMLIST('/etc/authfile')| NONE)

Specifies the path name of a z/OS® UNIX file that contains the lists of APF-authorized path names and program names. If you do not specify a value for AUTHPGMLIST, or if you specify NONE, invocations of APF-authorized and program-controlled programs are not checked against a list of authorized programs or authorized path names. If you specify a path name for the AUTHPGMLIST parameter, the system checks this list during loadhfs, exec, and spawn processing. If the target program of an exec or spawn has an authorization code of 1 (AC=1), then that program name must appear in the authorized program list.

Use the SETOMVS or SET OMVS command to dynamically change the value. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

Start of change NONE is the default. End of change

AUTOCVT(ALL|ON|OFF)

Activates and deactivates automatic conversion of I/O data using coded character sets for the program and its associated files. The coded character set identifiers (CCSIDs) are specified by the program or by setting the appropriate environment variables at run time. The system AUTOCVT indicator can be overridden by individual programs at a thread or file descriptor level. AUTOCVT is a controlling global switch only for existing programs that do not explicitly establish their own conversion environment.

ALL: Enables Unicode Services to automatically convert data during both read and write I/O operations.
ON: Enables Enhanced ASCII conversion of data during read and write I/O operations. Conversion is limited to the EBCDIC (1047) and ASCII (819) code pages.
OFF: Automatic conversion is not enabled.

OFF is the default.

Use the SETOMVS or SET OMVS commands to change the value of AUTOCVT between ALL, ON, and OFF. Changing this conversion mode does not affect conversion of opened files for which I/O has already started.

Tip: When AUTOCVT(ALL) or AUTOCVT(ON) is set, every read and write operation for a file must be checked to see whether conversion is necessary. This check incurs a performance penalty, even if no conversion occurs. If possible, keep AUTOCVT(OFF) and enable each program for conversion by setting the compile or runtime environment variables that control conversion or using programmable function. For more information, see Converting files between code pages in z/OS UNIX System Services Planning.

Automatic conversion can also be controlled individually by a program that has either the ThliCvtOn or ThliCvtOn flag in the thread Thli control block (BPXYTHLI)

The ThliCvtOn flag activates automatic conversion for this thread.
The ThliCvtOff flag deactivates automatic conversion for this thread.

Both bits must not be on at the same time.

Automatic conversion is accomplished between programs and files that are tagged with different CCSIDs when a conversion table exists for that CCSID pair in the system. CCSID values are defined in Character Data Representation Architecture. For more information about supported Unicode Services CCSIDs, see z/OS Unicode Services User's Guide and Reference.

CTRACE(parmlib_member_name)

Specifies the parmlib member that contains the initial tracing options to be used for the z/OS UNIX component. Use CTRACE to provide tracing while the kernel is starting and to avoid having to issue a TRACE operator command to set tracing options.

CTIBPX00 is the default.

FILESYSTYPE TYPE(type_name) ENTRYPOINT(entry_name) PARM('parm') ASNAME(proc_name[,'start_parms'])

Specifies the type of file system that is to be started. BPXPRMxx can contain more than one FILESYSTYPE statement.

When SYSPLEX(YES) is specified, each FILESYSTYPE in use within the participating shared file system group must be defined for all systems that are participating in a shared file system. The easiest way to accomplish this is by having a single BPXPRMxx member that contains file system information for each system that is participating in the shared file system. If you decide to define a BPXPRMxx member for each system, the FILESYSTYPE statements must be identical on each system. For more information about shared file systems, see Customizing BPXPRMxx for a shared file system in z/OS UNIX System Services Planning.

Any facilities that are required for a particular FILESYSTYPE must be initiated on all systems that are participating in a shared file system. For example, NFS requires TCP/IP, so if you specify an NFS FILESYSTYPE, you must also initialize TCP/IP on NFS initialization.

Use the SETOMVS RESET command to dynamically specify new FILESYSTYPE statements. To make a permanent change, edit the BPXPRMxx member that is used for IPLs. For more information, see Dynamically adding FILESYSTYPE statements in BPXPRMxx in z/OS UNIX System Services Planning.

TYPE(type_name)

Specifies the name of the file system type that is to control the file system. TYPE is a required parameter. The name is 1 to 8 characters; the system converts the name to uppercase. In the FILESYSTYPE statement, you can specify a supported file system type.

For a complete list of supported file types, see the following table:

Table 1. Types of file systems. The table lists the file system type and the corresponding module name.
File system type	Description	Module name
AUTOMNT	Handles automatic mounting and unmounting of file systems. The AUTOMNT file system is mounted as AUTOMOVE(YES). However, if the parent file system has the automove unmount attribute, then the automount file system will have that attribute instead of AUTOMOUNT(YES).	BPXTAMD
CINET	Handles requests for the AF_INET and AF_INET6 family of sockets. This enables many different AF_INET or dual AF_INET/AF_INET6 physical file systems to be active on the system. If you want to use CINET, you must be using z/OS Communications Server (TCP/IP Services). If you use CINET, you cannot use INET.	BPXTCINT
DSFS	Handles DSFS requests	IDFFSCM
INET	Handles requests for the AF_INET and AF_INET6 family of sockets. You must be using z/OS Communication Services (TCP/IP Services). If you use INET, you cannot use CINET.	EZBPFINI
NFS	Handles Network File System requests for access to remote files. For NFS Client, you must create a procedure to run a PFS in a colony address space.	GFSCINIT
PROC	Manages files that contain process and system information.	BPXUPINT
TFS	Handles requests to the temporary file system (TFS).	BPXTFS
UDS	Handles socket requests for the AF_UNIX address family of sockets.	BPXTUINT
UFS	Obtains merged view of two or more directories.	BPXUNINT
ZFS	Handles z/OS File System requests.	IOEFSCM

For planning information, see FILESYSTYPE in z/OS UNIX System Services Planning.

ENTRYPOINT(entry_name)

Specifies the name of the load module entry point that the system calls to initialize the PFS during system startup or when the file system is mounted.

PARM('parm')

Provides a parameter to be passed directly to the file system type. The parameter format and content are specified by the file system type.

PARM is an optional parameter. The parameter is up to 1024 characters long; the characters can be in uppercase, lowercase, or both. The parameter must be enclosed in single quotation marks.

For information about specifying the TFS configuration parameters, see Parameter key options for the FILESYSTYPE statement in z/OS UNIX System Services Planning. For example:

-ea count: The TFS file system automatically grows count times.
-em count: The TFS file system manually grows count times.

If the physical file system specified does not expect a PARM operand, it ignores all PARM operands.

PRM=(aa, bb, ..., zz) is valid for the z/OS File System (zFS).

Start of change If a syntax error is found in FSFULL, the system issues an error message and sets the parameters to the default values. End of change

PRM=(aa, bb, ..., zz)

Defines the IOEPRMyy members of the logical parmlib concatenation for specifying zFS configuration parameters, where aa, bb, ..., zz specifies the suffixes of the IOEPRMxx parmlib members in the order in which they are to be concatenated. Up to 32 suffixes can be specified. Suffixes must be in uppercase. Defining an IOEFSPRM configuration file with an IOEZPRM DD card in the zFS procedure overrides the PRM specification (that is, cause it to be ignored). For more information, see Specifying the IOEPRMxx concatenation.

FSFULL(threshold,increment)

FSFULL(threshold,increment) is supported by TFS and z/OS File System (zFS). End of change

threshold specifies the percentage of the file system capacity at which an operator message is generated. The default is 100%.
increment specifies the percentage of change above the file system capacity at which an operator message is generated. Messages are generated by either an increase or decrease greater than increment. The default is 5%.

You can specify threshold and increment values for the file system. The values can also be set on the MOUNT command for a specific file system. Parameters on the MOUNT command override parmlib values. If no values are specified in either place, no threshold checking is done. If a threshold value is specified but no increment is given, the increment defaults to 5%. The increment value applies both to upgrading the message when the file system continues to fill and to removing the message when more space becomes available when files are deleted. It also applies to extending the file system. The values are in terms of percent full. The values that are applied to a file system can be changed only when the file system is mounted.

zFS restriction: The MOUNT statement for zFS must have values provided for both threshold and increment when FSFULL is specified. The default value is not provided if either parameter is omitted. If you omit the entire FSFULL parameter line, the default values (threshold=100%, increment=5%) will apply in zFS.

ASNAME(proc_name[,'start_parms'])

proc_name specifies the name of a procedure in SYS1.PROCLIB that is to be used to start the address space that is initialized by the physical file system (PFS). Specify ASNAME for any PFS that does not run in the kernel address space. The name that you specify is also used for the name of the address space.

start_parms is an optional quoted string that is to be appended to the proc_name when the address space is started. The string can be up to 100 characters long. The start_parms are not validated; they are passed to the system when the address space is started with an internal command. Refer to the START command in z/OS MVS System Commands or the ASCRE macro in z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN.

By default, the address space started with ASNAME runs under JES. You can modify the startup behavior by including the additional start_parms SUB=MSTR.

ASNAME is an optional parameter. proc_name is 1 to 8 characters; the system converts the name to uppercase. If you do not specify ASNAME, or specify proc_name as the name of the kernel address space, the PFS is initialized in the kernel address space.

Refer to the documentation for the specific physical file system for valid ASNAME operands.

FORKCOPY(COPY)

Specifies that fork() immediately copies the parent storage to the child, whether or not the suppression-on-protection (SOP) hardware feature is available. Use this option to avoid any additional ESQA use in support of fork.

Use the SETOMVS or SET OMVS command to dynamically change the value. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

IPCMSGNIDS(nnnnn)

Specifies the maximum number of unique system-wide message queues.

The value range Is a decimal value from 1 to 20000. The default is 500.

You can increase but not decrease the value, as described in Dynamically changing certain BPXPRMxx values in z/OS UNIX System Services Planning. Use the SETOMVS or SET OMVS command to change the value of IPCMSGNIDS dynamically. The new minimum is the current value. The new maximum is calculated as follows:

MIN(initial maximum,MAX(4096,3*initial value))

IPCMSGQBYTES(nnnnn)

Specifies the maximum number of bytes in a single message queue.

The value range is a decimal value from 0 to 2147483647. The default is 2147483647 (2 G). The high end of this range is not obtainable due to storage constraints. The actual maximum range varies due to storage allocation and system usage.

Use the SETOMVS or SET OMVS command to change the value dynamically.

IPCMSGQMNUM(nnnnn)

Specifies the maximum number of system-wide messages for each queue.

The value range is a decimal value from 0 to 2147483647. The default is 10000. The high end of this range cannot be obtained due to storage constraints. The actual maximum range varies due to storage allocation and system usage.

Use the SETOMVS or SET OMVS command to change the value dynamically.

IPCSEMNIDS(nnnnn)

Specifies the maximum number of unique system-wide semaphore sets.

The value range is a decimal value from 1 to 20000. The default is 500.

Use the SETOMVS or SET OMVS command to change the value dynamically.

IPCSEMNOPS(nnnnn)

Specifies the maximum number of operations for each semop call.

The value range is a decimal value from 0 to 32767. The default is 25. This is a system-wide limit.

Use the SETOMVS or SET OMVS command to change the value dynamically.

IPCSEMNSEMS(nnnnn)

Specifies the maximum number of semaphores for each semaphore set.

The value range is a decimal value from 0 to 32767. The default is 1000.

Use the SETOMVS or SET OMVS command to change the value dynamically.

IPCSHMMPAGES(nnnnn)

Specifies the maximum number of pages for shared memory segments.

The value range is a decimal value from 1 to 4 petabytes (that is, 4 * 1 125 899 906 842 624). The default is 25600.

If you obtain memory segments below the 2-gigabyte address range, then a realistic maximum is about 1.5 gigabytes; the actual maximum range varies due to storage allocation and system usage. If you obtain memory segments above the 2-gigabyte address range, the maximum depends on the IEASYS HVSHARE parameter, which specifies the size of the high virtual shared area.

The denomination value is retained and used within a subsequent D OMVS command.

Use the SETOMVS or SET OMVS command to change the value dynamically.

IPCSHMNIDS(nnnnn)

Specifies the maximum number of unique system-wide shared memory segments.

The value range is a decimal value from 1 to 20000. The default is 500. You can increase but not decrease the value, as described in Dynamically changing certain BPXPRMxx values in z/OS UNIX System Services Planning.

Use the SETOMVS or SET OMVS command to change the value dynamically. The new minimum is the same as the current value. The new maximum is calculated as follows:

MIN(initial maximum,MAX(4096,3*initial value))

IPCSHMNSEGS(nnnnn)

Specifies the maximum number of attached shared memory segments for each address space.

The value range is a decimal value from 0 to 1000. The default is 500.

Use the SETOMVS or SET OMVS command to change the value dynamically.

IPCSHMSPAGES(nnnnn)

Specifies the maximum number of system-wide shared pages that are created by calls to the fork and 31-bit shmat functions.

You can increase, but not decrease, the value, as described in Dynamically changing certain BPXPRMxx values in z/OS UNIX System Services Planning. Shared memory segments that are obtained above the 2-gigabyte range in 64-bit programs do not affect this limit.

The value range is a decimal value from 0 to 2621440. The default is 262144. You can increase but not decrease the value, as described in Dynamically changing certain BPXPRMxx values in z/OS UNIX System Services Planning.

You can set a denomination (or multiplier) value when you define this value. The C suffix can have a one-character value as presented in Table 1, but must not exceed the parameter-specific upper limit. The denomination value is retained and is used again within a subsequent D OMVS command.

Use the SETOMVS or SET OMVS command to dynamically change the value. The new minimum is the same as the current value. The new maximum is calculated as follows:

MIN(initial maximum,MAX(4096,3*initial value))

Because each page of shared storage requires associated consumption of extended system queue area (ESQA) storage, limiting shared storage usage provides a way to limit ESQA usage by z/OS UNIX users. If you use the __IPC_MEGA or __MAP_MEGA options, then the shared pages limits are not affected because MEGA does not affect the system ESQA overhead.

LIMMSG(NONE|SYSTEM|ALL

Specifies how to display console messages that indicate when parmlib limits are reaching critical levels.

NONE

Console messages are not displayed when any of the parmlib limits are reached.

SYSTEM

Console messages are displayed for all processes that reach system limits. In addition, messages are displayed for each process limit of a process if any of the following conditions are met:

The process limit or limits are defined in the OMVS segment of the owning user ID.
The process limit or limits were changed with a SETOMVS PID=pid,process_limit.

ALL

Console messages are displayed for both the system limits and the process limits, regardless of which process reaches a process limit.

SYSTEM is the default.

LOSTMSG(ON|OFF)

LOSTMSG(ON) detects lost and duplicate XCF messages in a shared file system configuration. It is ignored if the file system does not have a shared file system configuration; for example, when SYSPLEX(NO) is specified. While LOSTMSG can be specified differently for each member in the sysplex, the same LOSTMSG setting should be specified throughout the sysplex. To disable the detecting of lost and duplicate messages, specify LOSTMSG(OFF).

Do not use LOSTMSG(ON) when z/OS UNIX sysplex traffic is high, such as when many file systems that are not sysplex-aware are being accessed remotely because performance might be affected.

ON is the default.

MAXASSIZE(nnnnn)

Specifies the RLIMIT_AS resource values that are established as the initial values for new processes. RLIMIT_AS indicates the address space region size. For more information about RLIMIT_AS, see setrlimit (BPX1SRL, BPX4SRL) — Set resource limits in z/OS UNIX System Services Programming: Assembler Callable Services Reference.

The value range is a decimal value from 10485760 (10 megabytes) to 2147483647 (2 gigabytes). The default is 209715200.

The MAXASSIZE value limits the amount of storage below 2 GB, including both above and below the 16 MB line.

The soft limit is obtained from MVS; if it is greater than the MAXASSIZE value, the soft limit is set to the hard limit. This value is also used when processes are initiated by a daemon process using an exec() after setuid(). In this case, both the RLIMIT_ AS hard and soft limit values are set to the MAXASSIZE specified value.

When processes are initiated by a daemon process using an exec() after setuid(), this value is used. Therefore, MAXASSIZE is the region size for all processes that are created through rlogin or telnet. In this case, both the RLIMIT_AS hard and soft limit values are set to the MAXASSIZE value.

A superuser can override this value by specifying a new region size in the spawn inheritance structure on __spawn(). Or you can change the value of MAXASSIZE dynamically by using the SETOMVS or SET OMVS command. This change only affects the new processes that are created after the change was made.

The IEFUSI user exit can modify the region size of an address space. Users are discouraged from altering the region size of address spaces in the OMVS subsystem category.

Use the SETOMVS or SET OMVS command to dynamically increase or decrease the value of MAXASSIZE. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

The MAXASSIZE value limits the combined size of above and below the 16 M line storage. If MAXASSIZE is greater than LDALIMIT (the <16M limit), then the LDAELIM (the >16M limit) is set to MAXASSIZE - LDALIM.

For planning information, see MAXASSIZE in z/OS UNIX System Services Planning.

MAXCORESIZE(nnnnn)

Specifies the RLIMIT_CORE soft and hard resource values that are established as the initial values for new processes. RLIMIT_CORE indicates the maximum core dump file size in bytes that a process can create. It also specifies the limit when they are initiated by a daemon process using an exec() after a setuid(). For more information about RLIMIT_CORE, see setrlimit (BPX1SRL, BPX4SRL) — Set resource limits in z/OS UNIX System Services Programming: Assembler Callable Services Reference.

The value range is a decimal value from 0 to 2147483647 (2 gigabytes). The default is 4194304 (4 megabytes). Specifying a value of 2147483647 (2 gigabytes) indicates an unlimited core file size.

When you define the MAXCORESIZE value, you can set a denomination (or multiplier) value. The C suffix can have a one-character value as presented in Table 1, but must not exceed the parameter-specific upper limit. The denomination value is retained and is used again within a subsequent D OMVS command.

Use the SETOMVS or SET OMVS command to dynamically increase or decrease the value of MAXCORESIZE. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

MAXCPUTIME(nnnnn)

Specifies the RLIMIT_CPU resource values that are established as the initial values for new processes. RLIMIT_CPU indicates the CPU time in seconds that a process can use. For more information about RLIMIT_CPU, see setrlimit (BPX1SRL, BPX4SRL) — Set resource limits in z/OS UNIX System Services Programming: Assembler Callable Services Reference.

If the soft limit value from MVS is greater than the MAXCPUTIME value, the soft limit is set to the hard limit. This value is also used when processes are initiated by a daemon process using an exec() after setuid(). In this case, both the RLIMIT_CPU hard and soft limit values are set to the MAXCPUTIME value.

A superuser can override this value by specifying a new time limit in the spawn inheritance structure on __spawn().

For processes that are running in or forked from TSO or BATCH, the MAXCPUTIME value has no effect. The TIME limit is inherited from the parent. If a TIME parameter is specified on the JCL for the started task, then that value is used. If not, then the TIME value is taken from the default time value for JES.

For processes created by the rlogind command or other daemons, MAXCPUTIME is the time limit for the address space.

Specifying a MAXCPUTIME or CPUTIMEMAX of 86400 seconds disables the JWT, SWT, or TWT timeout the same way that JCL TIME=1440 does. See Statements and parameters for SMFPRMxx for details on the JWT, SWT, and TWT parameters.

maxcuputime is a decimal value from 7 to 2147483647 seconds. The default is 1000.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

For planning information, see MAXCPUTIME in z/OS UNIX System Services Planning.

MAXFILEPROC(nnnnn)

Specifies the maximum number of descriptors for files, sockets, directories, and any other file system objects that a single process can have concurrently active or allocated. MAXFILEPROC is the same as the OPEN_MAX variable in the POSIX standard.

The value range is a decimal value from 3 to 524287. The default is 64000.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

On the ADDUSER command, you can increase the maximum number of open descriptors on a per-process basis. The FILEPROCMAX parameter on the ADDUSER command overrides the MAXFILEPROC parameter in the BPXPRMxx profile.

For planning information, see MAXFILEPROC in z/OS UNIX System Services Planning.

MAXFILESIZE(nnnnn|NOLIMIT)

Specifies the RLIMIT_FSIZE soft and hard resource values that are established as the initial values for new processes. RLIMIT_FSIZE indicates the maximum file size (in 4 KB increments) that a process can create. It also specifies the limit when they are initiated by a daemon process using an exec() after a setuid(). For more information about RLIMIT_FSIZE, see setrlimit (BPX1SRL, BPX4SRL) — Set resource limits in z/OS UNIX System Services Programming: Assembler Callable Services Reference.

The value range is a decimal value from 0 to 2147483647, which indicates an unlimited file size. The default is NOLIMIT.

If MAXFILESIZE is not specified or MAXFILESIZE(NOLIMIT) is specified, there is no limit to the size of files created, except for the architectural limit of the system.

You can set a denomination (or multiplier) value when defining this value. The C suffix can have a one-character value as presented in Table 1, but must not exceed the parameter-specific upper limit. The denomination value is retained and is used again within a subsequent D OMVS command.

If you specify 0, the process does not create any files. Omitting this statement indicates an unlimited file size.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used in IPLs.

MAXIOBUFUSER(nnnnn)

Specifies that maximum amount of persistent I/O virtual storage that z/OS UNIX obtains on behalf of a user when a process performs I/O in a Unicode Services conversion environment (that is, the AUTOCVT setting is ALL). This storage remains allocated for the life of an open file. The amount that is allocated for each open depends on the CCSID of the file and the size of a read or write requests that are used by the process. The limit does not apply to UID 0 processes.

The value range is 2 to 2 G, representing the number of megabytes of storage. Thus, 2 G represents 2G x 1M = 2P (petabytes) of storage. The default is 2048, which is equivalent to 2 G of storage).

MAXMMAPAREA(nnnnn)

Specifies the maximum amount of data space storage space (in pages) that can be allocated for below-the-bar memory mappings of z/OS UNIX files. Storage is not allocated until the memory mapping is active.

Using memory map services causes a large amount of system memory to be consumed. For each page (4 KB) that is memory-mapped, 96 bytes of ESQA are consumed when a file is not shared with any other users. When a file is shared by multiple users, each user after the first causes an additional 32 bytes of ESQA to be consumed for each shared page. Assuming that the default of 40960 pages is taken, and assuming that no sharing is done by mmap() users, a maximum of 3840 KB of ESQA could be consumed. The ESQA storage is consumed when the mmap() function is invoked rather than when the page is accessed by the memory mapping application program.

If you have applications using the __MAP_MEGA option, you can map large files without the system overhead in ESQA. For more information, see Using extended system queue area (ESQA) in z/OS UNIX System Services Planning.

The value range is a decimal value from 1 to 16777216. The default is 40960.

You can change the value of MAXMMAPAREA dynamically using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

For planning information, see MAXMMAPARE in z/OS UNIX System Services Planning.

MAXPIPEUSER(nnnnn)

Specifies the maximum number of z/OS UNIX named or unnamed pipes that a real UID can open concurrently. The value only applies to non-UID=0 users. For UID=0 users, the MAXPIPERUSER limit of 8730 is always enforced.

The value range is a decimal value from 256 to 8730. The default is 8730.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

For planning information, see MAXPIPEUSER in z/OS UNIX System Services Planning.

MAXPROCSYS(nnnnn)

Specifies the maximum number of processes that the system allows.

The value range is a decimal value from 5 to 32767. The default is 900.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs. If you are using SETOMVS or SET OMVS to change the value, the new value must be within a certain range, or you get an error message. The range that you can use has a minimum value of 5; the maximum value is based on the following calculation:

MIN(32767,MAX(4096,3*initial value))

The initial value is the MAXPROCSYS value that was specified during BPXPRMxx initialization. You cannot use a value less than 5. To use a value greater than the current maximum (as calculated by the formula) but lower than the initial maximum (32767), you must change the value in BPXPRMxx and re-IPL. For an example of how to calculate the maximum value in the range, see Dynamically changing certain BPXPRMxx values in z/OS UNIX System Services Planning.

MAXPROCUSER(nnnnn)

Specifies the maximum number of processes that a single z/OS UNIX user ID can have concurrently active, regardless of how the processes were created. MAXPROCUSER is the same as the CHILD_MAX variable in the POSIX standard.

The value range is a decimal value from 3 to 32767. The default is 25. A value of 25 is required for FIPS 151-2 compliance and a value of 16 is required for POSIX.1 (ISO/IEC 9945-1:1990[E] IEEE Std 1003.1-1990) standard compliance.

The number of processes is tracked by user ID (UID). When a user attempts to create a new process, the limit value for the user (defined by either the user profile or the default OPTN value) is compared to the value maintained for the user's UID. If the user maximum is larger than the current process count for the UID, the user can create another process. If not, the user is not allowed to create a new process. For example, if user A, with a user-defined limit of 10, tries to create a process and the UID limit is already 12, user A cannot create the new process. Since only 12 processes are created, user B, with a user-defined limit of 20, is allowed to create a new process.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

There are certain cases when a new process can be created with a UID that has already reached the MAXPROCUSER number of processes. Super users (with UID=0) and processes blind dubbed with the default OMVS segment are not limited by MAXPROCUSER.

For planning information, see MAXPROCUSER in z/OS UNIX System Services Planning.

MAXPTYS(nnnnn)

Specifies the maximum number of pseudoterminals (pseudo-TTYs or PTYs) for the system.

The value range is a decimal value from 1 to 10000. The default is 800.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

If you are using SETOMVS or SET OMVS to change the value, the new value must be within a certain range. If it is outside the range, you get an error message. To use a value that is outside this range, you must change the MAXPTYS specification in BPXPRMxx and re-IPL. The range's minimum value is 1 and the maximum is based on the following calculation:

MIN(10000,MAX(256,2*initial value)

The initial value is the MAXPTYS value that was specified during BPXPRMxx initialization. For an example of how to calculate the maximum value in the range, see Dynamically changing certain BPXPRMxx values in z/OS UNIX System Services Planning.

For planning information, see MAXPTYS in z/OS UNIX System Services Planning.

MAXQUEUEDSIGS(nnnnn)

Specifies the maximum number of signals that z/OS UNIX allows to be concurrently queued within a single process.

The value range is a decimal value from 1 to 100000. The default is 1000.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for future IPLs.

MAXTHREADS(nnnnn)

Specifies the maximum number of pthread_created threads, including running, queued, and exited but undetached, that a single process can have concurrently active. Specifying a value of 0 prevents applications from using pthread_create.

maxthreads is a decimal value from 0 to 100000. The default is 200.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

For planning information, see MAXTHREADS in z/OS UNIX System Services Planning.

MAXTHREADTASKS(nnnnn)

Specifies the maximum number of MVS tasks that a single process can have concurrently active for threads created by pthread_create.

maxthreadtasks is a decimal value from 0 to 32768. The default is 1000.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

For planning information, see MAXTHREADTASKS in z/OS UNIX System Services Planning.

MAXUSERMOUNTSYS(nnnnn)

Specifies the maximum number of nonprivileged user mounts for the system or for the shared file system configuration environment. The MAXUSERMOUNTSYS limit applies only to nonprivileged users and does not affect privileged mounts.

The value range is a decimal value from 0 to 35000 that indicates the maximum number of nonprivileged user mounts allowed in the system. For those using a shared file system configuration, this value is the maximum number of nonprivileged user mounts allowed in the shared file system environment. The most recent specification prevails for all of the systems that are participating in a shared file configuration.

The default is 0.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs. If MAXUSERMOUNTSYS is not specified, default values are used. The default value indicates that user mounts are not allowed in the system.

For planning information, see MAXUSERMOUNTSYS in z/OS UNIX System Services Planning.

MAXUSERMOUNTUSER(nnnnn)

Specifies the maximum number of nonprivileged user mounts allowed for each nonprivileged user.

For a single system, the default value is 0. For the first IPLed system in the shared file system configuration, the default value is 0. For a subsequently IPLed system in the shared file system configuration, the default value is what other systems have at the time when the subsequent system is IPLed.

For planning information, see MAXUSERMOUNTUSER in z/OS UNIX System Services Planning.

MOUNT FILESYSTEM('fsname') or DDNAME(ddname) TYPE(type_name) MOUNTPOINT('pathname') MODE(access) PARM('parameter') SETUID |NOSETUID SECURITY|NOSECURITY TAG(NOTEXT|TEXT,ccsid AUTOMOVE[(INCLUDE,sysname1,sysname2,...,sysnameN|*)] [(EXCLUDE,sysname1,sysname2,...,sysnameN)]|NOAUTOMOVE|UNMOUNT SYSNAME(sysname) MKDIR('pathname')

MOUNT specifies a file system that z/OS UNIX is to logically mount onto the root file system or another file system. Mount statements are processed in the sequence in which they appear. If they are cascading, the system mounts the first file system first. Make sure that a mount point exists before the file system is mounted. If you mount a file system over an existing directory that contains files, you cover up the existing files.

The MOUNT statement is optional; the BPXPRMxx member can contain one or more MOUNT statements.

FILESYSTEM('fsname')

The name of the file system. The name must be unique in the system.

In the FILESYSTYPE statement, you can mount the following file systems:

zFS for a z/OS File System (zFS). See Mount in z/OS File System Administration.
NFS for accessing remote files. See Mount processing parameters in z/OS Network File System Guide and Reference.
TFS for a temporary file system (TFS). See Mounting the TFS in z/OS UNIX System Services Planning.
UFS for the union file system. See Mounting a union file system in z/OS UNIX System Services Planning.
PROC for the PROC file system. See Managing the PROC file system in z/OS UNIX System Services Planning.

Either FILESYSTEM or DDNAME is required; do not specify both. The name is 1 to 44 characters; the characters can be in uppercase, lowercase, or both. Case sensitivity is preserved; file names are not automatically converted to uppercase. The name must be enclosed in single quotation marks.

DDNAME(ddname)

The ddname on the JCL DD statement that defines the file system. To use the DDNAME parameter, a DD statement for the HFS data set containing the mountable file system should be placed in the OMVS cataloged procedure. Either FILESYSTEM or DDNAME is required; do not specify both. The name is 1 to 8 characters; the system converts the ddname to uppercase.

Restriction: Because zFS does not support DDNAME, the FILESYSTEM keyword must be used.

TYPE(type_name)

Specifies the name of a file system type that is identified in a FILESYSTYPE statement. The TYPE(type_name) parameter must be the same as the TYPE(type_name) parameter on a FILESYSTYPE statement. TYPE is a required parameter. The name is 1 to 8 characters; the system converts the name to uppercase.

MOUNTPOINT('pathname')

Specifies the absolute path name, or a symbolic link that resolves to the path name of the directory onto which the file system is to be mounted.

Mount point restrictions are as follows:

The mount point must be a directory.
Any files in the directory are not accessible while the file system is mounted.
Only one mount can be active at any time for a mount point.
A file system can be mounted at only one directory at any time.

MOUNTPOINT is required and must specify an absolute path name. The path name is up to 1023 characters long; the characters can be in uppercase, lowercase, or both.

MODE(access)

Specifies access to the mounted file system by all users. With READ access, users can read only the file system that is being mounted. With RDWR access, users can read and write in the file system that is being mounted.

RDWR is the default.

PARM('parameter')

Provides a parameter to be passed directly to the file system type. The parameter format and content are specified by the file system type.

PARM is an optional parameter. The parameter is up to 500 characters long; the characters can be in uppercase, lowercase, or both. The parameter must be enclosed in single quotation marks.

For information about specifying the TFS configuration parameters, see Parameter key options for the FILESYSTYPE statement in z/OS UNIX System Services Planning. For example:

-ea count: Enables the TFS file system to automatically grow count times.
-em count: Enables the TFS file system to manually grow count times.

If the physical file system specified does not expect a PARM operand, it ignores all PARM operands. Refer to the documentation for the specific physical file system for valid entry point names.

FSFULL(threshold,increment)

FSFULL(threshold,increment) is supported by TFS and z/OS File System (zFS). End of change

threshold specifies the percentage of the file system (TFS) capacity at which an operator message is generated. The default is 100%.
increment specifies the percentage of change above the file system capacity at which an operator message is generated. Messages are generated by either an increase or decrease greater than increment. The default is 5%.
You can specify threshold and increment values for all file systems. The values can also be set on the MOUNT command for a specific file system. Parameters on the MOUNT command override parmlib values. If no values are specified in either place, no threshold checking is done. If a threshold value is specified but no increment is given, the increment defaults to 5%. The increment value applies both to upgrading the message when the file system continues to fill and to removing the message when more space becomes available due to either deleting files, or to extending the file system. The values are in terms of percent full. The values that are applied to a file system can be changed only when the file system is mounted.

SETUID|NOSETUID

SETUID specifies that the setuid() and setgid() mode bit on an executable file is supported.

NOSETUID specifies that the setuid() and setgid() mode bit on an executable file is not supported. The UID or GID is not changed when the program is executed and the APF and Program Control extended attributes are ignored. The entire file system is uncontrolled.

SETUID is the default.

SECURITY|NOSECURITY

SECURITY specifies that security checks should be performed. NOSECURITY specifies that security checks are not performed.

SECURITY is the default.

AUTOMOVE[(INCLUDE|EXCLUDE,sysname1,sysname2,...,{sysnameN| *})]|

NOAUTOMOVE|UNMOUNT

The AUTOMOVE, NOAUTOMOVE, and UNMOUNT parameters apply only in a sysplex where systems are participating in shared file system. The parameters indicate what happens if the system that owns a file system goes down.

AUTOMOVE indicates that ownership of the file system automatically changes to another system that is participating in shared file system. You can specify AUTOMOVE on its own to allow the system to randomly select a new owner for the file system. You can direct the system how to choose a new owner for the file system by using the indicators INCLUDE (I) or EXCLUDE (E).

Specify INCLUDE with a system list to provide a prioritized list of systems to which the file system can be moved if the owning system goes down. For example, AUTOMOVE(INCLUDE,SYS1,SYS4,SYS9) tells the system that the file system can be moved to SYS1, SYS4, or SYS9, in that order, or AUTOMOVE(INCLUDE,SYS1,SYS4,*) tells the system that the file system can be moved to SYS1 or SYS4, in that order, then to any other available system. This selection is not totally random; rather, MVS attempts to move the file system to a new server system in which the file system is actively in use.

Restriction: If specified, the asterisk must be listed last or listed as the only system name in the INCLUDE system list.

Specify EXCLUDE with a system list to provide a list of systems to which the file system cannot be moved. For example, AUTOMOVE(EXCLUDE,SYS3,SYS5,SYS7) tells the system that the file system can be moved to any system except SYS3, SYS5, and SYS7. If the file system cannot be moved as you directed in the system list, the file system is unmounted when the owning system goes down.

NOAUTOMOVE indicates that ownership of the file system is not moved in some situations; as a result, the file system becomes inaccessible.

When specifying NOAUTOMOVE, although the file system becomes inaccessible when the owning system unexpectedly goes down, it still exists in the file system hierarchy. The file system remains unowned until the original owning system re-IPLs. Changing the AUTOMOVE value in BPXPRMxx of an unowned file system before re-IPLing does not change the AUTOMOVE value of this file system since it is already mounted. To change the AUTOMOVE value, the file system must be unmounted before the IPL.

UNMOUNT indicates that the file system should be unmounted in certain situations.

For more information about the behavior of the AUTOMOVE options, see Managing the movement of data in z/OS UNIX System Services Planning.

Note:

Use AUTOMOVE for the version file system and the sysplex root file system.
For file systems that are associated with a single system, specify UNMOUNT. The file systems include /etc,/tmp, /var, /dev, and the system-specific file system. For descriptions of the sysplex root, system-specific, and version file systems, see Sharing file systems in a sysplex in z/OS UNIX System Services Planning.

The default is AUTOMOVE.

MKDIR('pathname')

Specifies the name of a directory that the system creates dynamically after the file system is mounted. This function allows the system to create mount points that subsequent MOUNT statements can reference. MKDIR is an optional keyword.

You can specify more than one MKDIR keyword on each ROOT or MOUNT statement. The directories are created in the order they are listed. The maximum number of MKDIR statements that is allowed for each ROOT or MOUNT statement is 50.

A relative path name must be specified; the path name cannot start with a slash (/). Enclose the path name in single quotation marks.

The path name is relative to the file system mount point specified on the MOUNTPOINT keyword.

The path name can contain intermediate directories, but these intermediate directories must exist in the file system hierarchy. If these intermediate directories do not exist, you can use additional MKDIR keywords to create the necessary intermediate directories.

The directory to be created must be in a file system that was mounted as RDWR. The permission bits for the created directory are 755. The UID and GID are inherited from this directory's parent. These attributes are overlaid when this directory is used as a mount point.

Do not use the MKDIR keyword for file systems that mount asynchronously, such as the NFS file system. When a file system is mounted asynchronously, message BPXF025I is issued to the system log. Similarly, do not use MKDIR with the SYSNAME keyword, when SYSNAME identifies a remote system to perform the mount. The results are unpredictable.

A failure to create a directory does not cause a failure of the mount. A message is written to the system log when a problem occurs during the creation of the directory. If the directory exists, no message is written.

For more information, see mount - Logically mount a file system in z/OS UNIX System Services Command Reference.

NETWORK DOMAINNAME(sockets_domain_name)DOMAINNUMBER(sockets_domain_number)MAXSOCKETS(number)TYPE(type_name)INADDRANYPORT(starting_port_number)INADDRANYCOUNT(number_of_ports_to_reserve)

Prepares a socket physical file system domain for use. The TYPE in this statement matches the TYPE on the previous FILESYSTYPE statement.

Use the SETOMVS RESET command to dynamically change the MAXSOCKET value or add a new NETWORK. To make a permanent change, edit the BPXPRMxx member that is used for IPLs. For more information, see Dynamically adding FILESYSTYPE statements in BPXPRMxx in z/OS UNIX System Services Planning.

Provide a NETWORK statement for each socket file system domain to be initialized.

For AF_UNIX file systems, always include a FILESYSTYPE statement that specifies ENTRYPOINT(BPXTUINT) and a NETWORK statement with a matching TYPE, usually UDS, on both.
For TCP/IP sockets, always include a FILESYSTYPE statement that specifies ENTRYPOINT(EZBPFINI) and a NETWORK statement with a matching TYPE, usually INET, on both.
To activate an Internet Protocol Version 6 (IPv6) socket on a system, you must configure both the AF_INET domain and the AF_INET6 domain. You cannot code a NETWORK statement for domain name AF_INET6 without coding a NETWORK statement for domain name AF_INET.
For CINET sockets, include a FILESYSTYPE statement with ENTRYPOINT (BPXTCINT) and a NETWORK statement with a matching TYPE, usually TYPE(CINET), that specifies INADDRANYPORT and INADDRANYCOUNT. For more information, see Specifying INADDRANYPORT and INADDRANYCOUNT in z/OS UNIX System Services Planning .

DOMAINNAME(sockets_domain_name)

The 1 - 16 character name by which this socket file system domain is to be known.

DOMAINNUMBER(sockets_domain_number)

A number that matches the value that is defined for this domain name. The currently supported values for this field are:

1: AF_UNIX
2: AF_INET
19: AF_INET6

Table 2 shows some supported domain names, domain numbers, and their associated entry point names. See the documentation for the physical file system you are using to get the correct entry point name.

Table 2. Supported domains
Domain name	Domain number	Entry point
AF_UNIX	1	BPXTUINT
AF_INET	2	EZBPFINI, BPXTCINT
AF_INET6	19	EZBPFINI, BPXTCINT

MAXSOCKETS(nnnnn)

Specifies the maximum number of sockets that are supported by this file system for this address family. You can specify a value from 0 to 16777215. This is an optional parameter. The maximum value for this field is defined by each domain. If a value larger than the maximum is specified, an informational message is issued and the value that is used is the maximum.

Ensure that this number is large enough for socket connections for all applications using your z/OS UNIX environment. This upper limit is set when the NETWORK statement is processed during IPL. It can only be changed if the NETWORK statement is changed using the SETOMVS RESET command.

When the Common Event Adapter (CEA) is active, each CEA client requires two socket connections for communication with the CEA server.

For AF_UNIX, MAXSOCKETS will be ignored if it is specified. The maximum number of AF_UNIX sockets is 10000.

When activating IPv6 on a system, you can specify separate MAXSOCKETS values for domains AF_INET and AF_INET6. If you do not specify a MAXSOCKETS value for the AF_INET6 domain, the default is the MAXSOCKETS value specified or defaulted to for the AF_INET domain.

Table 3 shows the maximum and default values for MAXSOCKETS by domain.

Table 3. Maximum and default values for MAXSOCKETS by domain
Domain name	MAXSOCKETS maximum	MAXSOCKETS default
AF_UNIX	10000	10000
AF_INET	16777215	64000
AF_INET6	16777215	Same as the current value for AF_INET

TYPE(type_name)

Specifies the name of a file system type that is identified in a FILESYSTYPE statement. The type(type_name) must be the same as the TYPE(type_name) parameter on a FILESYSTYPE statement. TYPE is a required parameter. The name is 1 to 8 characters; the system converts the name to uppercase.

INADDRANYCOUNT(number_of_ports_to_reserve)

Specifies the number of ports that the system reserves, starting with the port number specified in the INADDRANYPORT parameter. This value is only needed for CINET.

number_of_ports_to_reserve is a decimal value from 1 to 8000.

If INADDRANYPORT or INADDRANYCOUNT is not specified, the default for INADDRANYCOUNT is 1000. Otherwise, no ports are reserved (0).

INADDRANYPORT(starting_port_number)

Specifies the starting port number for the range of port numbers that the system reserves for use with PORT 0, INADDR_ANY binds. This value is only needed for CINET.

starting_port_number is a decimal value from 1024 to 65534. Ports 1 — 1023 are well-known ports that cannot be reserved for use with PORT 0, INADDR_ANY binds.

If INADDRANYPORT or INADDRANYCOUNT is specified, the default for INADDRANYPORT is 63000. Otherwise, no ports are reserved (0).

If you do not want to support INADDRANY with CINET, you should specify INADDRANYPORT(xx), where xx is a valid value, without specifying INADDRANYCOUNT.

If you are activating IPv6 on a system, the INADDRANYPORT is shared across domains. The INADDRANYPORT value is taken from the NETWORK statement for the AF_INET domain. Any INADDRANYPORT value that is specified for the AF_INET6 domain is ignored.

NONEMPTYMOUNTPT(NOWARN|WARN|DENY)

Specifies how the system is to mount any file system on a mount point when it is a nonempty directory. If NONEMPTYMOUNTPT is not specified, default values are used.

NOWARN: Enables the system to mount any file system on mount point without any warning message when the mount point is a nonempty directory. The contents of that directory are hidden for the duration of the mount.
WARN: Enables the system to mount any file system on mount point with a warning message when the mount point is a nonempty directory. The contents of that directory are hidden for the duration of the mount.
DENY: Prevents the system from mounting any file system when the mount point is a nonempty directory.

NOWARN is the default.

PRIORITYGOAL(service_class_name1,...service_class_name40)|NONE

Specifies a list of 1 to 40 service class names of 8 characters or less separated by commas, which are used in association with the setpriority, nice and chpriority callable services when the system is running in goal mode. These functions allow a program to alter the priority of one or more processes.

Generally, it is recommended that you do not set PRIORITYGOAL unless the nice(), setpriority() or chpriority() values are enabled.

If the list has fewer than 40 entries, the system propagates the last service class specified into the remaining unspecified entries in the table. For example:

PRIORITYGOAL(CICS4,CICS4,CICS4,CICS3,CICS2,CICS1,TSO2,TSO1,BAT3,BAT2)

If you do not specify this statement, arrays are not created for it. All service classes that are specified on the PRIORITYGOAL statement must also be specified in your workload management service policy.

PRIORITYGOAL(NONE) means that there are no values. If you do not specify PRIORITYGOAL, that means that there are no values.

If you do not want to allow users to increase the priority but still want to enable the nice() and setpriority() functions, define a range of service classes with priority increments on a base that is normal for the users. Using these functions lets the user order the priority of processes, but will not let a user improve performance over that of other users.

service_class_name is a 1 - 8 character value.

NONE is the default.

Use the SETOMVS or SET OMVS command to dynamically change the value. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

PWT(SMF|SMFENV|ENV)

Allows installations to time out z/OS UNIX processes that are waiting on terminal activity. The timeout value applies to all z/OS UNIX processes that are waiting on terminal activity. To override that value for a specific process, the _BPXK_TIMEOUT environment value can be set for an individual process. The PWT value can be changed with the SETOMVS PWT operator command. Unless a BPXK_TIMEOUT value is set, timeouts do not occur.

SMF: Honors the SMPFPRMxx JWT|TWT|SWT values for the timeout value. The _BPXK_TIMEOUT environment value is ignored. An individual process cannot override the system settings.
SMFENV: Honors the SMFPRMxx JWT|TWT|SWT value and to allow the _BPXK_TIMEOUT settings to override the setting.
ENV: Allows the _BPXK_TIMEOUT variable be set. Only processes setting the _BPXK_TIMEOUT value are timed out.

ENV is the default.

RESOLVER_PROC(nnnnn|DEFAULT|NONE)

Specifies how the resolver address space is processed during z/OS UNIX initialization. The resolver is used by TCP/IP applications for name-to-address or address-to-name resolution. In order to create a resolver address space, a system must be configured with an AF_INET or AF_INET6 domain.

nnnnn: The name of the address space for the resolver and the procedure member name in the appropriate proclib. procname is one to eight characters long. The procedure must reside in a data set that is specified by the MSTJCLxx parmlib member's IEFPDSI DD card specification.
DEFAULT: Starts an address space named RESOLVER using the system default procedure IEESYSAS. The address space is started with SUB=MSTR so that it runs under the MASTER address space instead of the JES address space.
NONE: Specifies that no address space is to be started. If you are using z/OS Communications Server IP, the resolver must be started before TCP/IP can be started. TCP/IP does not initialize until the resolver address space is started.

REXXPARSE(SHELL|TSO)

Uses either the z/OS UNIX shell or TSO criteria to determine whether an executed file is a REXX program.

SHELL

The REXX program must begin with a comment on the first line with the opening /* followed by any number of spaces, which are immediately followed by the string 'REXX'. The string is not case-sensitive. For example:

/* Rexx */

TSO

The REXX program must begin with a comment on the first line, but the string 'REXX' can be anywhere in the first line after any other character. The string is not case-sensitive. For example:

/* This is a Rexx program */

SHELL is the default.

Use the SETOMVS or SET OMVS command to dynamically change the value of REXXPARSE. To make a permanent change, edit the BPXPRMxx member that is used for IPLs. If REXXPARSE is not specified, the default value is used.

ROOT FILESYSTEM('fsname') or DDNAME(ddname) TYPE(type_name) MODE(access) PARM('parameter') SETUID|NOSETUID AUTOMOVE|NOAUTOMOVE SYSNAME(sysname) TAG(NOTEXT|TEXT,ccsid) MKDIR('pathname')

Specifies a file system that z/OS UNIX is to logically mount as the root file system. It is optional. If it is not specified, a TFS file system is mounted as the root.

To change the value of the ROOT statement without having to re-IPL, use the TSO/E MOUNT and UNMOUNT commands.

The root file system can be unmounted using the TSO/E UNMOUNT command or ISHELL. Ensure that you specify the IMMEDIATE option.

The ROOT statement does not support the SYSNAME() keyword.

FILESYSTEM('fsname')

The name of the root file system. The name must be unique in the system. You can specify the following types:

zFS for a z/OS File System (zFS).
NFS for accessing remote files.
TFS for a temporary file system (TFS).

Either FILESYSTEM or DDNAME is required; do not specify both. The name is 1 - 44 characters; the characters can be in uppercase, lowercase, or both. The name must be enclosed in single quotation marks. An HFS data set name must conform to the rules of MVS data set names.

DDNAME(ddname)

The ddname on the JCL DD statement that defines the root file system. To use the DDNAME parameter, put a DD statement for the HFS data set containing the root file system in the z/OS UNIX cataloged procedure.

Either FILESYSTEM or DDNAME is required; do not specify both. The ddname is 1 to 8 characters; the system converts the ddname to uppercase.

zFS restriction: zFS does not support DDNAME; the FILESYSTEM keyword must be used.

TYPE(type_name)

Specifies the name of a file system type that is identified in a FILESYSTYPE statement. The TYPE(type_name) parameter must be the same as the TYPE(type_name) parameter on a FILESYSTYPE statement.

TYPE is a required parameter. The name is 1 - 8 characters; the system converts the name to uppercase.

MODE(access)

Specifies access to the root file system by all users. With READ, users can only read the root file system. With RDWR, users can use and write in the root file system.

RDWR is the default.

PARM('parameter')

Provides a parameter to be passed directly to the file system type. The parameter format and content are specified by the file system type.

PARM is an optional parameter. The parameter is up to 500 characters long; the characters can be in uppercase, lowercase, or both. The parameter must be enclosed in single quotation marks.

If the physical file system specified does not expect a PARM operand, it ignores all PARM operands. Refer to the documentation for the specific physical file system for valid entry point names.

SETUID|NOSETUID

SETUID: Specifies that the setuid() and setgid() mode bit on an executable file will be supported.
NOSETUID: Specifies that the setuid() and setgid() mode bit on an executable file will not be supported. The UID or GID will not be changed when the program is executed and the APF and program control extended attributes are not honored. The entire file system is uncontrolled.

SETUID is the default.

TAG (NOTEXT|TEXT,ccsid)

Specifies whether implicit file tags are assigned to untagged files in the mounted file system. File tagging controls whether a file's data can be converted during file reading and writing. "Implicit" in this case means that the tag is not permanently stored with the file. Instead, the tag is associated with the file during reading and writing, or when stat() type functions are issued. Either TEXT, or NOTEXT, and ccsid must be specified when TAG is specified.

NOTEXT: Specifies that none of the files in the file system are automatically converted during file reading and writing.
TEXT: Specifies that each untagged file is implicitly marked as containing pure text data that can be converted.
ccsid: names the coded character set identifier to be implicitly set for the untagged file. ccsid is specified as a decimal value from 0 to 65536. However, when TEXT is specified, the values of 0 and 65536 are not allowed because those values imply no conversion. Other than this, the value is not checked as being valid and the corresponding code page is not checked as being installed.

For example:

TAG(TEXT,819) identifies text files that contain ASCII (ISO-8859-1) data.
TAG(TEXT,1047) identifies text files that contain EBCDIC ((ISO-1047) data.
TAG(NOTEXT,65536) tags files as containing binary or unknown data.
TAG(NOTEXT,0) is the equivalent of not specifying the TAG parameter.
TAG(NOTEXT,273) tags the file with the German code set (ISO-273) but is not eligible for automatic conversion.

NOTEXT is the default.

AUTOMOVE|NOAUTOMOVE

The AUTOMOVE and NOAUTOMOVE parameters apply only in a sysplex where systems are participating in a shared file system. They indicate what happens to the ownership of the file system when a shutdown, PFS termination, dead system takeover, or file system move occurs.

AUTOMOVE: Indicates that ownership of the file system automatically changes to another system that is participating in the shared file system.
NOAUTOMOVE: Indicates that ownership of the file system is not moved if the owning system goes down; as a result, the file system becomes inaccessible. When you specify NOAUTOMOVE, the file system becomes inaccessible when the owning system goes down. But it still exists in the file system hierarchy. The file system remains unowned until the original owing system reIPLs.

Use AUTOMOVE for the sysplex root file system and the version file system. For file systems that are associated with a single system, specify UNMOUNT. The specification includes /etc, /tmp, /var, /dev, and other system-specific file systems. For descriptions of the sysplex root, system-specific, and version file systems, see Sharing file systems in a sysplex in z/OS UNIX System Services Planning.

The default is AUTOMOVE. To ensure that the root is always available, use AUTOMOVE.

MKDIR('pathname')

Specifies the name of a directory that the system will create dynamically after the file system is successfully mounted. This allows the system to create mount points that can be referenced by subsequent MOUNT statements. MKDIR is an optional keyword.

You can specify more than one MKDIR keyword on each ROOT statement. The directories are created in the order they are listed.

You must specify a relative path name; the path name cannot start with a slash (/). Enclose the path name in single quotation marks.

The path name is relative to the file system mount point specified on the MOUNTPOINT keyword. It can contain intermediate directories, but these intermediate directories must exist in the file system hierarchy. If these intermediate directories do not exist, you can use additional MKDIR keywords to create the necessary intermediate directories.

The directory to be created must reside in a file system that was mounted as RDWR. The permission bits for the created directory is 755. The UID and GID are inherited from this directory's parent. These attributes are overlaid when this directory is used as a mount point.

Do not use the MKDIR keyword for file systems that mount asynchronously, such as the NFS file system. When a file system is mounted asynchronously, message BPXF025I is issued to the system log. Also, do not use MKDIR with the SYSNAME keyword, when SYSNAME identifies a remote system to perform the mount. The results are unpredictable.

A failure to create a directory does not cause a failure of the mount. A message is written to the system log when a problem occurs when the directory is created. If the directory exists, no message is written.

Restriction: MKDIR works only on systems that are at z/OS Version 1 Release 5 level or later. If you are using MKDIR in a sysplex that shares a common BPXPRMxx member, make sure that all systems are at least at the z/OS V1R5 level.

RUNOPTS('string')

Specifies the _CEE_RUNOPTS environment variable that is used when z/OS UNIX initialization invokes /etc/init or /usr/sbin/init. z/OS UNIX passes the _CEE_RUNOPTS value and all programs that are invoked from /etc/rc to the shell.

To change the value of RUNOPTS, edit the BPXPRMxx member and then re-IPL. You cannot use the SET OMVS or SETOMVS command to change the value. After the value is specified in BPXPRMxx, you can use one of the following methods to change this string:

The system is re-IPLed with a new RUNOPTS string.
The user or installation sets _CEE_RUNOPTS in /etc/rc or /etc/init.config.
A program or shell script sets _CEE_RUNOPTS.

If you do not specify a value for RUNOPTS, the RUNOPTS string or _CEE_RUNOPTS environment variable is not provided.

By default, the TSO/E OMVS command uses the specified options as the Language Environment® runtime options.

The setting of RUNOPTS does not affect BPXBATCH jobs.

Specifying the RUNOPTS parameter causes the kernel to set the _CEE_RUNOPTS environment variable when starting /etc/init, or when the TSO/E OMVS command is entered. This environment variable is normally propagated to subsequent processes (such as /etc/init to /bin/sh to /etc/rc to /bin/inetd to /bin/rlogind to /bin/sh for shell users).

To do this, make sure that any other steps in the flow (such as export statements in /etc/rc) do not overwrite the value of _CEE_RUNOPTS. If more runtime options are needed, they should be concatenated to the old value of _CEE_RUNOPTS.

The value is from 1 to 250 characters. There is no default; a RUNOPTS string or _CEE_RUNOPTS environment variable is not provided.

Restrictions:

The string must be enclosed in parentheses and quotation marks ('').
An empty string (' ') is not valid.
Although all characters are allowed, nulls, slashes (/), unbalanced SO/SI, and unbalanced parentheses and quotation marks cause unpredictable problems in areas such as the TSO/E OMVS command.

For more information about specifying RUNOPTS strings, see Customizing the BPXPRMxx member of SYS1.PARMLIB in z/OS UNIX System Services Planning.

SCEXITTABLE('sc_exittable')

Specifies the path name of a z/OS UNIX file. This file is intended to contain a list of z/OS UNIX syscall stubs that a user wants to enable syscall exits for. The stub names must be in all caps. If a null path name is specified, SC_EXITTABLE is reset to null.

You can change the SC_EXITTABLE path name dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that will be used for IPLs.

Changes to the SC_EXITTABLE file are not applied immediately. If a change needs to be activated sooner, use the SETOMVS or SET OMVS command to apply the change immediately.

SERV_LINKLIB('dsname','volser')

Specifies the target service library where the z/OS UNIX modules that are normally loaded from SYS1.LINKLIB into the private area of the OMVS address space are located.

If a null dsname is specified, SERV_LINKLIB is reset to null. It does not matter what is specified for volser if dsname is null.

dsname is a 1-to-44 character value that represents a valid MVS load library data set name. The alphabetic characters in the load library name must be uppercase. volser is a 1-to-6 character value that represents a valid volume serial number for the volume that contains the specified MVS load library. The alphabetic characters in the volume serial number must be uppercase.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that will be used for future IPLs.

SERV_LPALIB('dsname','volser')

Specifies the target service library where the z/OS UNIX modules that are normally built into LPA are located.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that will be used for future IPLs.

If a null dsname is specified, SERV_LNKLIB is reset to null. It does not matter what is specified for volser if dsname is null.

SHRLIBMAXPAGES(nnnnn)

If you specify the SHRLIBMAXPAGES parameter, it is accepted but will not have any impact on the system. The value that you specify will never be reached, because user-shared library objects are no longer supported. This parameter is intended to control the maximum number of pages that can be allocated in the system to contain user shared library modules.

nnnnn is a decimal value between 1 and 16777216 that specifies a number of 4 K pages. The default is 4096.

SHRLIBRGNSIZE(nnnnn)

Specifies the maximum size of the shared library region for address spaces that load system shared library modules. For these address spaces, the size that is specified is allocated from high private storage and is used for the loading of system shared library modules. This storage is not allocated in an address space until it loads a system shared library module. This parameter applies to modules loaded from system shared libraries, which allocate storage on megabyte boundaries.

shrlibrgnsize is a decimal value between 16777216 (16 megabytes) and 1610612736 (1.5 gigabytes). The specified value (if within the range) is rounded up to a megabyte boundary. The default is 67108864.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

Because the shared library region is allocated in megabytes, the value for SHRLIBRGNSIZE must be evenly divisible by 1048576. Otherwise, the D OMVS,L command might show values in the Current Usage and Highwater Usage columns that are larger than the value in the System Limit column.

SMFUPDATE(ON|OFF)

SMFUPDATE(ON) allows users with UPDATE authority to the BPX.SMF.type.subtype FACILITY class to invoke smf_record() without requiring a clean program-controlled environment.

If SMFUPDATE(ON) is not specified in the active BPXPRMxx member, users of smf_record() that are permitted to the BPX.SMF.type.subtype FACILITY class with any access authority will require a clean program-controlled environment.

OFF is the default.

STARTUP_EXEC('dsname(membername)',class)

STARTUP_EXEC names a REXX exec that does application environment initialization for z/OS UNIX. This statement is optional; if it is specified, the BPXOINIT process will not run /etc/init. The startup exec is typically used by an installation that does not have a file system, but is using a TFS for a file system. It can be used to populate the TFS with any directories and files that are needed. It is specified as:

STARTUP_EXEC('Dsname(Membername)',SysoutClass)

where:

Dsname is a 1-to-44-character valid data set name.
Membername is a 1-to-8-character valid REXX exec member.
SysoutClass is 1 character and is alphanumeric and specifies the sysout class that the REXX exec will run under. Specifying SysoutClass is optional.

To change the value of STARTUP_EXEC, edit the BPXPRMxx member and then reIPL. You cannot use the SET OMVS or SETOMVS command to change the value.

STARTUP_EXEC does not have a default value.

STARTUP_PROC(procname)

Specifies a 1-to-8-character name of a started JCL procedure that initializes the kernel. The name must exist on the system before IPL or errors will occur.

Using a started procedure other than OMVS is strongly discouraged. If you want to change the value of STARTUP_PROC, you must edit the BPXPRMxx member and then re-IPL. You cannot use the SET OMVS or SETOMVS command to change the value.

If you decide to use a started procedure other than OMVS:

The replacement started procedure must also be a single job step procedure that invokes the BPXINIT program (EXEC PGM=BPXINIT). If it invokes any other program, the OMVS initialization will fail.
Change the procedure name in the RACF® started procedures table or the definitions in the STARTED Class. For more information, see Preparing for RACF in z/OS UNIX System Services Planning.

Note: Renaming OMVS to another value might affect the setup of other products such as TCP/IP.

The default is STARTUP_PROC(OMVS).

STEPLIBLIST('etc/steplib')

Specifies the path name of the file in the file system that contains the list of MVS data sets to be used as step libraries for programs that have the set-user-id and set-group-id bit set on.

For planning information, see STEPLIBLIST in z/OS UNIX System Services Planning.

SUBFILESYSTYPE NAME(transport_name)TYPE(type_name) ENTRYPOINT(entry_name) PARM('parameter') DEFAULT

Specifies an AF_INET or AF_INET6 physical file system that is to run underneath the CINET socket file system. The TYPE() value is usually CINET and matches the TYPE operand on a previous FILESYSTYPE and NETWORK statement. In the case of TCP/IP, the NAME() value is the procname. The system attaches the EZBPFINI load module during initialization, and this file system should be used as the default INET physical file system.

The SUBFILESYSTYPE statement is associated with its corresponding FILESYSTYPE and NETWORK statements by matching the value that is specified in the TYPE operand.

The value that is specified on all of the TYPE operands must match, but can be any 1- to 8-character value. The value that is specified on the NAME parameter on the SUBFILESYSTYPE statement is the name to be used by the physical file system when it is initialized. The first character of the NAME parameter must be non-numeric.

For IBM Communications Server, the SUBFILESYSTYPE statement must match the TCPIPJOBNAME of that stack. For more information about defining file systems, see Customizing the BPXPRMxx member of SYS1.PARMLIB in z/OS UNIX System Services Planning.

New SUBFILESYSTYPE statements can be added dynamically. However, you cannot dynamically change or delete a value. For more information, see Dynamically adding FILESYSTYPE statements in BPXPRMxx in z/OS UNIX System Services Planning.

NAME(transport_name)

Specifies the name that identifies this file system to the CINET physical file system.

NAME is a required parameter. The name is 1 to 8 characters with the first character non-numeric; the system converts the name to uppercase. The value that is specified by the NAME parameter on the SUBFILESYSTYPE statement is the name that the physical file system uses to identify itself when it is initialized. For example, for TCP/IP, this is the starting procedure name.

TYPE(type_name)

Specifies the name of the CINET file system type that is identified in a FILESYSTYPE statement. The TYPE(type_name) parameter must be the same name that was used for the TYPE(type_name) parameter on the FILESYSTYPE statement for the CINET physical file system. TYPE is a required parameter. The name is 1 to 8 characters; the system converts the name to uppercase.

ENTRYPOINT(entry_name)

Specifies the name of the load module that contains the entry point into the file system type. ENTRYPOINT is a required parameter. The name is 1 to 8 characters; the system converts the name to uppercase.

PARM('parameter')

Provides a parameter to be passed to the transport driver. The parameter format and content are specified by the file system that is receiving the data.

PARM is an optional parameter. The parameter is up to 1024 characters long; the characters can be in uppercase, lowercase, or both. If the characters are not all in uppercase, the parameter must be enclosed in single quotation marks.

If the physical file system specified does not expect a PARM operand, it ignores all PARM operands. Refer to the documentation for the specific physical file system for valid entry point names.

DEFAULT

Identifies this file system as the default CINET file system. DEFAULT is an optional parameter. If it is not specified, the file system that is specified in the first SUBFILESYSTYPE statement found in the parmlib member is designated as the default.

For more information, see SUBFILESYSTYPE in z/OS UNIX System Services Planning.

SUPERUSER(user_name)

The name of the superuser, which must conform to the restrictions for the z/OS user ID. The user name must also be defined to RACF (or another security product) and must have a z/OS UNIX user ID (UID) of 0. For example, in RACF, specify OMVS(UID(0)) on the ADDUSER command.

When a daemon issues a setuid() to set a UID to 0 and the user ID is not known, setuid() uses the user ID from the SUPERUSER statement.

Never permit the user ID BPXROOT to the BPX.DAEMON profile. The BPX.DAEMON profile is described in BPX.DAEMON in z/OS UNIX System Services Planning. This warning applies even if you use a name other than BPXROOT.

The USS_SUPERUSER health check verifies that the SUPERUSER option contains a user ID that is defined to the security product and has an OMVS segment with a UID of 0. For more information about the health check, see USS_SUPERUSER in IBM Health Checker for z/OS User's Guide.

user_name is a 1 - 8 character value. The default is BPXROOT.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

SWA(ABOVE|BELOW)

Specifies whether SWA control blocks should be allocated above or below the 16-megabyte line. The SWA parameter affects only the OMVS address space and its SWA blocks. It has no impact on the colony address spaces.

ABOVE: All SWA control blocks are allocated above the 16-megabyte line.
BELOW: All SWA control blocks are allocated below the 16-megabyte line.

BELOW is the default.

SYSCALL_COUNTS(YES|NO)

Syscall counts are accumulated in internal kernel data areas so that the RMF data gatherer can record the information.

YES: The path length for the most frequently used z/OS UNIX system calls is increased by more than 150 instructions, which makes the reporting of CPU time for z/OS UNIX more accurate. This is reflected in the output from the BPX1TIM, BPX1GPS, BPX1GTH, and BPX1RMG services and from BPXESMF.
NO: The counts for syscall and CPU time are not accumulated.

If you switch between YES and NO for actively running processes, the accumulated data is inaccurate.

The SMF30OST field of the SMF type 30 record can be seen as a negative number when the CPU time used to compute the time value is less than the previous CPU time. In some cases, it can even appear as zero, such as when SYSCALL_COUNTS is set to NO after having been YES for an earlier part of the run. In addition, if SYSCALL_COUNTS=YES, the SMF30OST value is calculated from OCVTSYSTIME (accumulated syscall time for all syscalls issued in the system) rather than from OASBSYSCALLCOUNT (syscalls for the current process).

NO is the default.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that is used for IPLs.

SYSPLEX(YES|NO)

For z/OS UNIX, the SYSPLEX statement specifies whether a system is to join the SYSBPX XCF group to share resources across the sysplex.

YES: The system participates in a shared file system.
NO: The system does not participate in a shared file system. If the SYSPLEX statement is not provided, the default is SYSPLEX(NO)

NO is the default.

For more information about shared file systems, see Sharing file systems in a sysplex in z/OS UNIX System Services Planning. It contains information about parameters specific to the shared file system: SYSPLEX, VERSION, AUTOMOVE, NOAUTOMOVE, and SYSNAME.

You cannot adjust the SYSPLEX field dynamically. There is no SETOMVS, SET OMVS, or SETOMVS RESET=(xx) capability. To change the value of SYSPLEX, you must re-IPL the system.

VERSION('version'[,UNMOUNT|NOUNMOUNT])

The VERSION statement applies only to systems that are exploiting shared file systems. VERSION allows multiple releases and service levels of the binaries to coexist and participate in a shared file system. A directory with the value version specified on VERSION is dynamically created at system initialization under the sysplex root that is used as a mount point for the version file system. However, this directory is only dynamically created if the root file system for the sysplex is mounted as read/write.

Specify UNMOUNT to enable the version auto-unmount option. This setting causes the VERSION_AUTO_UNMOUNT attribute to be set for the version file system if it is mounted on this system. If unspecified, NOUNMOUNT is the default at system initialization. If the version string 'version' is '/' (slash), the version auto-unmount option is set to NOUNMOUNT regardless of what is specified.

Note: version is a case-sensitive character string no greater than 8 characters in length that indicates a specific instance of the version file system. The most appropriate values for version are the name of the target zone, &SYSR1, or another qualifier meaningful to the system programmer. For example, if the system is at V2R9, you can specify REL9 for VERSION.

When SYSPLEX(YES) is specified, you must also specify the VERSION parameter.

The VERSION value is substituted in the content of symbolic links that contain $VERSION. For scenarios that describe the use of the version file system, see Sharing file systems in a sysplex in z/OS UNIX System Services Planning.

If you are testing or changing to a new maintenance level, dynamically change the VERSION value by using the SETOMVS command.

SETOMVS VERSION='string'

You can also dynamically turn on or off the VERSION_AUTO_UNMOUNT attribute by using the SETOMVS command.

SETOMVS VERSION=('string',UNMOUNT|NOUNMOUNT)

Using the SETOMVS command:

If 'string' is specified but not UNMOUNT or NOUNMOUNT, then the current version auto-unmount option is used.
You can specify * instead of ’string’ in order to change only the version auto-unmount option.

You can also change the settings of this parameter by using SET OMVS=(xx) and SETOMVS RESET=(xx) parmlib specifications.

Restriction: Do not change VERSION dynamically if you have any users that are logged on or running applications because replacing the system files for these users might be disruptive.

TTYGROUP(group_name)

Specifies the z/OS UNIX group name that is given to subsidiary pseudoterminals (ptys) and OCS remote terminals (rtys). This group name must be defined to the security product and have a unique group ID (GID). No users should be connected to this group.

The group_name is used by certain setgid() programs, such as talk and write, when writing to another user's pty or rty.

group_name is a 1 to 8-character value. TTY is the default.

You can change the value dynamically by using the SETOMVS or SET OMVS command. To make a permanent change, edit the BPXPRMxx member that will be used for future IPLs.

UMASK(umask)

Specifies a default umask value for all z/OS UNIX users. Use this setting to better control the files and directories that users on your system can access. Existing facilities that set the umask value will continue to override the system default.

For example, the z/OS UNIX shell, /bin/sh, first issues a umask call (BPX1UMK) to initially establish the process umask to 000 to override the umask that is specified in BPXPRMxx. The shell then processes the /etc/profile file. If a umask command is specified, the specified value becomes the process umask value. If /etc/profile does not contain a umask command, the shell will keep the established umask of 000 as the process umask value.

Changing the default umask value might have unexpected results on your applications. A umask value that is consistent with the umask value that is set in /etc/profile might be appropriate.

umask is a 3-to-4 digit octal number that specifies the permission settings of files or directories that are created by users or processes that are not to be allowed.

umask can also be set to NONE to indicate that no system default umask was specified. NONE provides the capability to remove a prior umask specification for new processes. UMASK(NONE) differs from UMASK(000) in that specifying UMASK(NONE) causes OextUmaskConf to be reset, which indicates to applications such as Language Environment that no system umask value is in effect. For more information about how Language Environment handles umask processing, see umask() - Set and retrieve file creation mask in z/OS XL C®/C++ Runtime Library Reference.

In addition, if a umask value is not specified in BPXPRMxx, the default is NONE, which indicates that no umask default is in effect.

Specify the value by ORing together the following bits:

4000: Set-user-ID bit.
2000: Set-group-ID bit.
1000: Sticky bit.
0400: User read.
0200: User write.
0100: User execute.
0040: Group read.
0020: Group write.
0010: Group execute.
0004: Other read.
0002: Other write.
0001: Other execute.

For example, UMASK(007) will give no access to other.