BPXPRMxx.ini

The BPXPRMxx.ini file defines the configuration for emulated UNIX System Services. The suffixes for the BPXPRMxx.ini files are specified in the OMVS parameter of the IEASYSxx.ini file. However, the OMVS parameter is ignored and the BPXPRMxx.ini configuration files are not read unless the BCP parameter of the IEASYSxx.ini configuration file is set to indicate OS/390 or z/OS.

Each BPXPRMxx.ini file may contain multiple statements and comments. A comment is allowed whenever a blank is allowed. Comments start with /* and end with */. Comments may not be nested.

Each statement must start on a separate line from previous statements. Each statement has a type and may be followed by up to 100 parameters. More than one parameter may be specified on each line of the statement. Parameters may be continued on to a new line by coding the parameter up to column 72 and continuing in column 1 of the next line. Each parameter value must be enclosed in parentheses which must immediately follow the parameter name. The statement types and parameters are:

ROOT

The ROOT statement defines the name of the directory of the host system which will act as the root directory for UNIX Systems Services files. All path names will be relative to this directory. The only parameter is PATH and its value must be the name of a directory. The path name may not be a symbolic expression but it may begin with &SYSDIR, which will be replaced with the name of the path containing the j390 program. The ROOT PATH must be defined in at least one BPXPRMxx.ini file.

USER

Each USER statement specifies the home directory of a potential user. Each USER statement must have one NAME and one HOME parameter. The NAME parameter must be a one to eight upper case alphanumeric value which will correspond to the user ID assigned to the job. The NAME parameter may also be a single asterisk (*) which will provide the home directory for any user not named in a USER statement. The HOME parameter specifies the name of the home directory of the user. This is a UNIX path name and is relative to the ROOT PATH. If no USER statement matches the job’s assigned user ID, the default home directory is /home/<user>, where <user> is replaced by the job’s user ID.

Example BPXPRMxx.ini file:

/* Sample BPXPRM00.ini file */
ROOT PATH(.)
USER NAME(TACHYON) HOME(/)
USER NAME(*) HOME(/home)