Modify pubset-specific user attributes of user ID
Component: | SRPMNUC |
Functional area: | User management Pubset and MRSCAT management |
Domain: | USER-ADMINISTRATION |
Privileges: | STD-PROCESSING |
Routing code: | $ |
Function
This command modifies the pubset-specific user attributes of a user ID in the user catalog of the specified pubset. It is primarily intended for SM pubsets, but with various restrictions can also be used for SF pubsets.
Every user ID set up with the ADD-USER command from the beginning has pubset-specific user attributes. These are mostly default resource management attributes.
If an entry is created in a user catalog of an imported pubset, pubset-specific information must be stored. Systems support must define an upper limit for the user up to which the user may occupy storage space on this pubset. In addition, it can grant the user permission to exceed this limit. These new declarations, however, take effect only after the user logs on again, not for current tasks.
The default value *UNCHANGED in the corresponding operands means that the previously valid definition still applies. The term “hierarchical quota differentials” as used in this description refers to the fact that a given value must be included within the value above it in the hierarchy. Thus, for example, the value for VERY-HIGH-PERF-SPACE must always be <= the value in HIGH-PERF-SPACE, which in turn must be <= the value in S0-LEVEL-SPACE, and this must be <= the value in TOTAL-SPACE. If quota differentials are not maintained, command processing is aborted.
Restriction
The only nonprivileged users (STD-PROCESSING privilege) authorized to issue this command are those designated as group administrators. The actions a group administrator can take are defined by systems support. For information on setting up and managing user groups see the “SECOS” manual [35].
Format
MODIFY-USER-PUBSET-ATTRIBUTES | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
USER-IDENTIFICATION = <name 1..8>
Defines the name of the user ID for which the pubset-specific user attributes are to be modified.
PUBSET = *HOME / <cat-id 1..4>
Identifies the pubset in whose user catalog pubset-specific user attributes are to be modified. This will typically be an SM pubset.
PUBSET = *HOME
The entry is made in the user catalog of the home pubset.
PUBSET = <cat-id 1..4>
Catalog ID of the pubset in whose user catalog the entry is to be made.
FILE-NUMBER-LIMIT = *UNCHANGED / *MAXIMUM / <integer 0..16777215>
Defines the maximum number of files allowed for a user ID.
FILE-NUMBER-LIMIT = *MAXIMUM
The number of files allowed for the user ID is set at 16,777,215.
FILE-NUMBER-LIMIT = <integer 0..16777215>
Specifies the exact number of files for the user ID’s file number limit.
JV-NUMBER-LIMIT = *UNCHANGED / *MAXIMUM / <integer 0..16777215>
Specifies the maximum number of job variables that may be created.
JV-NUMBER-LIMIT = *MAXIMUM
The number of job variables allowed for the user ID is set at 16,777,215.
JV-NUMBER-LIMIT = <integer 0..16777215>
Specifies the exact number of job variables for the user ID’s JV number limit.
DEF-STORAGE-CLASS = *UNCHANGED / *NONE / <structured-name 1..8>
Defines the default storage class for files on SM pubsets.
DEF-STORAGE-CLASS = *NONE
No default storage class is defined.
DEF-STORAGE-CLASS = <structured-name 1..8>
Specifies the name of the default storage class.
CODED-CHARACTER-SET = *UNCHANGED / *STD / <name 1..8>
Specifies which CODED-CHARACTER-SET (CCS) is to be used. A name should only be specified here if the one required differs from the one preset by the system (*STD). The specified CCS should be an EBCDIC character set.
NET-CODED-CHAR-SET = *UNCHANGED / *STD / *ISO / *NO-CONVERSION / <name 1..8>
Defines which Net-Storage-Coded-Character-Set (NETCCSN) is to be used for node files on Net-Storage A character set conversion is only performed for SAM node files.
NET-CODED-CHAR-SET = *STD
The setting of the SSMMILOG system parameter applies.
NET-CODED-CHAR-SET = *ISO
A suitable ISO character set is used. For details on character set conversion see the CREATE-FILE command or the “Introductory Guide to DVS” manual [13].
NET-CODED-CHAR-SET = *NO-CONVERSION
There is no code conversion for SAM node files.
NET-CODED-CHAR-SET = <name 1..8>
Name of the character set to be used. It should be an ASCII character set.
RIGHTS = *UNCHANGED / *PARAMETERS(...)
Defines the pubset-specific rights of a user ID.
RIGHTS = *PARAMETERS(...)
Specifies which pubset-specific rights are to be modified.
DMS-TUNING-RESOURCES = *UNCHANGED / *NONE / *CONCURRENT-USE /*EXCLUSIVE-USE
Specifies which performance measures may be utilized, and the form in which they may be used.
DMS-TUNING-RESOURCES = *NONE
No tuning measures may be utilized.
DMS-TUNING-RESOURCES = *CONCURRENT-USE
The user is allowed to reserve preferred resources, but in doing so competes with all other users who have the same authorization.
DMS-TUNING-RESOURCES = *EXCLUSIVE-USE
The user may make exclusive reservations of preferred resources.
Permitted performance measures for the home and data pubsets
PUBSET = *HOME | ||||
|---|---|---|---|---|
DMS-TUNING- | Resident ISAM | Resident | File attribute PERFORMANCE | |
= HIGH | =*VERY-HIGH | |||
NONE: | no | no | no | - |
*CONCURRENT-USE | yes | no | - | - |
*EXCLUSIVE-USE | yes | yes | - | - |
PUBSET = <data pubset> | ||||
DMS-TUNING- | Resident ISAM | Resident | File attribute PERFORMANCE | |
= HIGH | =*VERY-HIGH | |||
NONE: | - | - | no | no |
*CONCURRENT-USE | - | - | yes | no |
*EXCLUSIVE-USE | - | - | yes | yes |
Home pubset | Data pubset | Permitted performance measures |
|---|---|---|
NONE: | NONE: |
|
*CONCURRENT-USE | NONE: |
|
*EXCLUSIVE-USE | NONE: |
|
NONE | *CONCURRENT-USE |
|
NONE | *EXCLUSIVE-USE |
|
*CONCURRENT-USE | *CONCURRENT-USE |
|
*CONCURRENT-USE | *EXCLUSIVE-USE |
|
*EXCLUSIVE-USE | *CONCURRENT-USE |
|
*EXCLUSIVE-USE | *EXCLUSIVE-USE |
|
NET-STORAGE-USAGE = *UNCHANGED / *NOT-ALLOWED / *ALLOWED
Specifies whether the user may occupy space on Net-Storage volumes.
NET-STORAGE-USAGE = *NOT-ALLOWED
The user is not permitted to use a Net-Storage volume.
NET-STORAGE-USAGE = *ALLOWED
The user is permitted to use a Net-Storage volume.
PHYSICAL-ALLOCATION = *UNCHANGED / *NOT-ALLOWED / *ALLOWED
Governs whether the user is allowed to perform absolute space allocation (direct allocation).
PHYSICAL-ALLOCATION = *NOT-ALLOWED
The user is no longer allowed to perform physical space allocation.
PHYSICAL-ALLOCATION = *ALLOWED
The user is allowed to perform physical space allocation.
PUBLIC-SPACE-EXCESS = *UNCHANGED / *NOT-ALLOWED / *TEMPORARILY-ALLOWED / *ALLOWED
Defines whether the user may if necessary exceed the defined space limits on the pubset.
PUBLIC-SPACE-EXCESS = *NOT-ALLOWED
The space limits may not be exceeded.
PUBLIC-SPACE-EXCESS = *TEMPORARILY-ALLOWED
While a process is executing, the space limit imposed on the user may be exceeded temporarily.
PUBLIC-SPACE-EXCESS = *ALLOWED
The space limits imposed on the user are removed.
PERM-SPACE-LIMITS = *UNCHANGED / *PARAMETERS(...)
Defines the permanent space granted to a user ID on a pubset. The operand is primarily intended for SM pubsets. If it is specified for an SF pubset, only the S0-LEVEL-SPACE value has any effect.
PERM-SPACE-LIMITS = *PARAMETERS(...)
The permanent storage space available is to be defined.
TOTAL-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM / *UNLIMITED /
<integer 0..2147483647 2Kbyte>
Defines the maximum number of PAM pages for the user ID’s permanent space. The specified value must be <= 2147483647.
TOTAL-SPACE = *AUTOMATIC-ADAPT
The number of PAM pages in the user ID’s permanent space is to adapt automatically. The hierarchical quota differentials are maintained.
TOTAL-SPACE = *MAXIMUM
The number of PAM pages in the user ID’s permanent space is to be set at 2,147,483,647.
TOTAL-SPACE = *UNLIMITED
The number of PAM pages in the user ID’s permanent space is unlimited.
TOTAL-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as permanent storage space.
S0-LEVEL-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
<integer 0..2147483647 2Kbyte>
Defines the maximum number of PAM pages for the user ID’s S0-LEVEL-SPACE. The value specified must be <= the value specified for TOTAL-SPACE. On SF pubsets the value specified for this operand corresponds to that of the PUBLIC-SPACE-LIMIT operand.
S0-LEVEL-SPACE = *AUTOMATIC-ADAPT
The number of PAM pages in the user ID’s S0-LEVEL-SPACE is to adapt automatically. The hierarchical quota differentials are maintained.
S0-LEVEL-SPACE = *MAXIMUM
The number of PAM pages in S0-LEVEL-SPACE is to be set at the highest possible logical value allowed by the value above it in the hierarchy (in this case TOTAL-SPACE).
S0-LEVEL-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as S0-LEVEL-SPACE.
HIGH-PERF-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
<integer 0..2147483647 2Kbyte>
Defines the maximum number of PAM pages for the user ID’s permanent high-performance space. The value specified must be <= the value specified for TOTAL-SPACE.
HIGH-PERF-SPACE = *AUTOMATIC-ADAPT
The number of PAM pages in the user ID’s HIGH-PERF-SPACE is to adapt automatically. The hierarchical quota differentials are maintained.
HIGH-PERF-SPACE = *MAXIMUM
The number of PAM pages in HIGH-PERF-SPACE is to be set at the highest possible logical value allowed by the value above it in the hierarchy (in this case S0-LEVEL-SPACE).
HIGH-PERF-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as HIGH-PERF-SPACE.
VERY-HIGH-PERF-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
<integer 0..2147483647 2Kbyte>
Defines the maximum number of PAM pages for the user ID’s permanent very-highperformance space. The value specified must be <= the value specified for TOTAL-SPACE.
VERY-HIGH-PERF-SPACE = *AUTOMATIC-ADAPT
The number of PAM pages in the user ID’s VERY-HIGH-PERF-SPACE is to adapt automatically. The hierarchical quota differentials are maintained.
VERY-HIGH-PERF-SPACE = *MAXIMUM
The number of PAM pages in VERY-HIGH-PERF-SPACE is to be set at the highest possible logical value allowed by the value above it in the hierarchy (in this case HIGH-PERF-SPACE).
VERY-HIGH-PERF-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as VERY-HIGH-PERF-SPACE.
HIGH-AVAILABLE-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
<integer 0..2147483647 2Kbyte>
Defines the maximum number of PAM pages for the user ID’s permanent high-availability space. The value specified must be <= the value specified for TOTAL-SPACE.
HIGH-AVAILABLE-SPACE = *AUTOMATIC-ADAPT
The number of PAM pages in the user ID’s HIGH-AVAILABLE-SPACE is to adapt automatically. The hierarchical quota differentials are maintained.
HIGH-AVAILABLE-SPACE = *MAXIMUM
The number of PAM pages in HIGH-AVAILABLE-SPACE is to be set at the highest possible logical value allowed by the value above it in the hierarchy (in this case S0-LEVEL-SPACE).
HIGH-AVAILABLE-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as HIGH-AVAILABLE-SPACE.
TEMP-SPACE-LIMITS = *UNCHANGED / *PARAMETERS(...)
Defines the temporary space granted to a user ID on a pubset. The operand is primarily intended for SM pubsets. If it is specified for an SF pubset, only the TOTAL-SPACE value has any effect.
TEMP-SPACE-LIMITS = *PARAMETERS(...)
The temporary storage space available is to be defined.
TOTAL-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
*UNLIMITED / <integer 0..2147483647 2Kbyte>
Defines the total number of PAM pages for the user ID’s temporary space. The specified value must be <= 2147483647.
TOTAL-SPACE = *AUTOMATIC-ADAPT
The total number of PAM pages in the user ID’s temporary space is to adapt automatically. The hierarchical quota differentials are maintained.
TOTAL-SPACE = *MAXIMUM
The number of PAM pages in the user ID’s total temporary space is to be set at 2,147,483,647.
TOTAL-SPACE = *UNLIMITED
The number of PAM pages in the user ID’s total temporary space is unlimited.
TOTAL-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as total temporary storage space.
HIGH-PERF-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
<integer 0..2147483647 2Kbyte>
Defines the maximum number of PAM pages for the user ID’s temporary high-performance space. The value specified must be <= the value specified for TOTAL-SPACE.
HIGH-PERF-SPACE = *AUTOMATIC-ADAPT
The number of PAM pages in the user ID’s temporary high-performance space is to adapt automatically. The hierarchical quota differentials are maintained.
HIGH-PERF-SPACE = *MAXIMUM
The number of PAM pages in HIGH-PERF-SPACE is to be set at the highest possible logical value allowed by the value above it in the hierarchy (in this case TOTAL-SPACE).
HIGH-PERF-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as temporary high-performance space.
VERY-HIGH-PERF-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
<integer 0..2147483647 2Kbyte>
Defines the number of PAM pages for the user ID’s temporary very-high-performance space. The value specified must be <= the value specified for TOTAL-SPACE.
VERY-HIGH-PERF-SPACE = *AUTOMATIC-ADAPT
The number of PAM pages in the user ID’s temporary very-high-performance space is to adapt automatically. The hierarchical quota differentials are maintained.
VERY-HIGH-PERF-SPACE = *MAXIMUM
The number of PAM pages in VERY-HIGH-PERF-SPACE is to be set at the highest possible logical value allowed by the value above it in the hierarchy (in this case HIGH-PERF-SPACE).
VERY-HIGH-PERF-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as temporary very-high-performance space.
WORK-SPACE-LIMITS = *UNCHANGED / *PARAMETERS(...)
Defines the space for work files granted to a user ID on a pubset. The operand is intended for use with SM pubsets only.
WORK-SPACE-LIMITS = *PARAMETERS(...)
The storage space available for work files is to be defined.
TOTAL-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM / *UNLIMITED /
<integer 0..2147483647 2Kbyte>
Defines the total number of PAM pages for the user ID’s work file space. The specified value must be <= 2147483647.
TOTAL-SPACE = *AUTOMATIC-ADAPT
The total number of pages in the user ID’s work file space is to adapt automatically. The hierarchical quota differentials are maintained.
TOTAL-SPACE = *MAXIMUM
The number of PAM pages in the user ID’s total work file space is to be set at 2,147,483,647.
TOTAL-SPACE = *UNLIMITED
The number of PAM pages in the user ID’s total work file space is unlimited.
TOTAL-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as total work file space.
HIGH-PERF-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
<integer 0..2147483647 2Kbyte>
Defines the proportion of high-performance work file space for the user ID (proportion of the total work file space).
The value specified must be <= the value specified for TOTAL-SPACE.
HIGH-PERF-SPACE = *AUTOMATIC-ADAPT
The number of pages in the user ID’s high-performance work file space is to adapt automatically. The hierarchical quota differentials are maintained.
HIGH-PERF-SPACE = *MAXIMUM
The number of PAM pages in HIGH-PERF-SPACE is to be set at the highest possible logical value allowed by the value above it in the hierarchy (in this case TOTAL-
SPACE).
HIGH-PERF-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as highperformance work file space.
VERY-HIGH-PERF-SPACE = *AUTOMATIC-ADAPT / *UNCHANGED / *MAXIMUM /
<integer 0..2147483647 2Kbyte>
Defines the proportion of very-high-performance work file space for the user ID (proportion of the high-performance work file space). The value specified must be <= the value specified for HIGH-PERF-SPACE.
VERY-HIGH-PERF-SPACE = *AUTOMATIC-ADAPT
The number of PAM pages in the user ID’s very-high-performance work file space is to adapt automatically. The hierarchical quota differentials are maintained.
VERY-HIGH-PERF-SPACE = *MAXIMUM
The number of PAM pages in VERY-HIGH-PERF-SPACE is to be set at the highest possible logical value allowed by the value above it in the hierarchy (in this case HIGH-PERF-SPACE).
VERY-HIGH-PERF-SPACE = <integer 0..2147483647 2Kbyte>
Defines the exact maximum number of PAM pages to be granted to the user ID as very high-performance work file space.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | SRM6001 | Command executed with a warning |
1 | SRM6010 | Syntax error | |
32 | SRM6020 | System error during command processing | |
64 | SRM6040 | Semantic error | |
130 | SRM6030 | Command cannot temporarily be executed |