USER Profile Records › OMVS Profile Data Records

OMVS Profile Data Records

OMVS records are normally used only on CA ACF2 for VM for z/OS systems. For OpenExtensions on VM, see the OEVM record. For CA PAM for Linux for System z support see the LINUX record.

Previously, the OMVS profile data record was only used in VM for CA PAM for Linux for System z support. CA PAM for Linux for System z r8.0 and above is designed to use the information in the new fields of the Linux records instead of using the OMVS record. For compatibility, CA PAM for Linux for System z r8 still allows the use of OMVS records if linuxdata OMVS is included in the CA PAM for Linux for System z configuration file.

Note: The CPUTIME, ASSIZE, FILEPROC, PROCUSER, THREADS, and MMAPAREA values are only valid at z/OS and OS/390 2.8 and above. You might set them at any level, but they will not be recognized until that level. These fields are not used in VM, but are supported by the ACF command for compatibility for users using the Database Synchronization Component.

Field Descriptions

recid

The CA ACF2 for VM logonid. This value cannot be masked.

UID(uid)

A required numeric field that accepts values from zero to 2,147,483,647. A value of zero indicates that this user is a superuser. The NO‑OMVS attribute on the logonid nullifies the user profile record and BPX.DEFAULT.USER for this user. NO‑OMVS is equivalent to NOUID in RACF.

HOME(home‑directory)

A field that defines the pathname of the initial directory used when a user enters the OMVS command or enters the ISPF shell. Specify from one to 1023 upper‑case or lower‑case characters. If HOME is not defined, UNIX System Services (USS) sets root as the initial directory.

OMVSPGM(program)

An optional field that defines the user's UNIX System Services shell program started when the OMVS command is entered or when a UNIX System Services batch job is started using the BPXBATCH program. Specify from one to 1023 upper‑case or lower‑case characters. If OMVSPGM is not defined, UNIX System Services gives control to the default shell program.

CPUTIME(max‑cputime‑for‑a‑dubbed‑process)

This field overrides the MAXCPUTIME parameter in the BPXPRMxx member of PARMLIB for this user. The value can be from 7 to 2,147,483,647. This field is not set when the record is inserted. If the field is not set, a RACROUTE EXTRACT will return a length of 4 and a value of X'FFFFFFFF'. Unix System Services takes the system defaults set in BPXPRMxx when this field is not set. You can remove this field from the record by changing it to a null value (change user CPUTIME()). CPUTIME is only valid for z/OS and OS/390 2.8 and above.

ASSIZE(max‑address‑space‑size)

This field overrides the MAXASSIZE parameter in the BPXPRMxx member of PARMLIB for this user. The value can be from 10,485,760 to 2,147,483,647. This field is not set when the record is inserted. If the field is not set, a RACROUTE EXTRACT will return a length of 4 and a value of X'FFFFFFFF'. Unix System Services takes the system defaults set in BPXPRMxx when this field is not set. You can remove this field from the record by changing it to a null value (change user ASSIZE()). ASSIZE is only valid for z/OS and OS/390 2.8 and above.

FILEPROC(max‑files‑per‑process)

This field overrides the MAXFILEPROC parameter in the BPXPRMxx member of PARMLIB for this user. The value can be from 3 to 65,535. This field is not set when the record is inserted. If the field is not set, a RACROUTE EXTRACT will return a length of 4 and a value of X'FFFFFFFF'. Unix System Services takes the system defaults set in BPXPRMxx when this field is not set. You can remove this field from the record by changing it to a null value (change user FILEPROC()). FILEPROC is only valid for z/OS and OS/390 2.8 and above.

PROCUSER(max‑number‑of‑processes)

This field overrides the MAXPROCUSER parameter in the BPXPRMxx member of PARMLIB for this user. The value can be from 3 to 32,767. This field is not set when the record is inserted. If the field is not set, a RACROUTE EXTRACT will return a length of 4 and a value of X'FFFFFFFF'. Unix System Services takes the system defaults set in BPXPRMxx when this field is not set. You can remove this field from the record by changing it to a null value (change user PROCUSER()). PROCUSER is only valid for z/OS and OS/390 2.8 and above.

THREADS(max‑number‑of‑pthread_created‑threads)

This field overrides the MAXTHREADS parameter in the BPXPRMxx member of PARMLIB for this user. The value can be from 0 to 100,000. This field is not set when the record is inserted. If the field is not set, a RACROUTE EXTRACT will return a length of 4 and a value of X'FFFFFFFF'. Unix System Services takes the system defaults set in BPXPRMxx when this field is not set. You can remove this field from the record by changing it to a null value (change user THREADS()). THREADS is only valid for z/OS and OS/390 2.8 and above.

MMAPAREA(max‑data‑space pages‑for‑HFS‑mappings)

This field overrides the MAXMMAPAREA parameter in the BPXPRMxx member of PARMLIB for this user. The value can be from 1 to 16,777,216. This field is not set when the record is inserted. If the field is not set, a RACROUTE EXTRACT will return a length of 4 and a value of X'FFFFFFFF'. Unix System Services takes the system defaults set in BPXPRMxx when this field is not set. You can remove this field from the record by changing it to a null value (change user MMAPAREA()). MMAPAREA is only valid for z/OS and OS/390 2.8 and above.

Commands

If you insert or change a user profile record, then you must issue a REBUILD command to activate the changes.

ACFSERVE RELOAD PROFILE OEVM USER

Examples

The following example shows how to define an OMVS user:

SET PROFILE(USER) DIV(OMVS)

INSERT OMVSUSR UID(199) HOME(/u/omvsusr) OMVSPGM(/bin/sh)