This statement modifies the attributes of the specified library. These attributes are:
protection attributes,
the preferred storage form and
the recording of the access date
*UNCHANGED means that the respective library attributes remain unchanged.
MODIFY-LIBRARY-ATTRIBUTES | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
Specifies the library whose protection attributes are to be modified.
LIBRARY = *STD
The library opened by OPEN-LIBRARY.
LIBRARY = <filename 1..54 without-vers>
Name of the library whose protection attributes are to be modified.
LIBRARY = *LINK(...)
The library assigned via the link name.
LINK-NAME = <structured-name 1..8>
Link name of the library; this name was defined by means of a /ADD-FILE-LINK command prior to calling LMS.
STORAGE-FORM = *UNCHANGED / *NONE / *STD / *FULL / *DELTA
Permissible storage form for members of the library, provided that nothing different is required for the member type by MODIFY-TYPE-ATTRIBUTES. Also, all members of the same type and name must have the same storage form.
STORAGE-FORM = *NONE
Same effect as STD.
STORAGE-FORM = *STD
Both full storage and delta storage are permitted.
STORAGE-FORM = *FULL
Only full storage is permitted.
STORAGE-FORM = *DELTA
Only delta storage is permitted.
WRITE-CONTROL = *UNCHANGED / *NONE / *DEACTIVATE / *ACTIVATEAttribute for controlling additional checks.
WRITE-CONTROL = *NONE
No additional checks are performed when generating or overwriting versions.
WRITE-CONTROL = *DEACTIVATE
No additional checks are performed when generating or overwriting versions.
WRITE-CONTROL = *ACTIVATE
A version can be written only
if the USERID of the user wanting to write it is entered as the HOLDER in the relevant base version and
if either a new version is generated or the base version is overwritten.
For the first version of a name, no base yet exists; it can be generated only by persons with ADMIN authorization. Whenever versions are generated or overwritten, LMS automatically adds a type-2 record documenting the HOLDER=author and the DATE and TIME of the operation. In addition, the STATE and HOLDER attributes and all rights are applied to the new version, provided the current statement does not require different values.
ACCESS-DATE = *UNCHANGED / *NONE / *KEEP
Attribute for recording the access date.
ACCESS-DATE = *NONE
No access dates for the members are recorded in the library.
ACCESS-DATE = *KEEP
Access dates for members are recorded in the library. Only after this point in time can a member have an access date and time.
ADMINISTRATION = *UNCHANGED / *NONE / *BY-GUARD(...) / *PARAMETERS(...)
Administer authorization. The circle of those with administer authorization for the library is specified explicitly. Only these persons may create, delete and rename members.
ADMINISTRATION = *NONE
No administer authorization is granted.
ADMINISTRATION = *BY-GUARD(...)
The administer authorization of the specified library is controlled by means of a guard.
GUARD-NAME = <filename 1..18 without-cat-gen-vers>
Name of the guard.
ADMINISTRATION = *PARAMETERS(...)
Specifies the user circle and, where applicable, a password for management of the specified library.
USER = *UNCHANGED / *NONE / *ALL / list-poss(3): *OWNER / *GROUP / *OTHERS
The circle of those with management authorization is explicitly listed.
USER = *NONE
None may manage (empty list).
USER = *ALL
All may manage (full listing).
USER = *OWNER
Only the owner of the library file may manage it.
USER = *GROUP
Those belonging to the group of the owner of the library file may manage.
USER = *OTHERS
All others may manage.
PASSWORD =*UNCHANGED / *SECRET / *NONE / <c-string 1..4> / <x-string 1..8> /<integer -2147483648..2147483647>
The circle of authorized persons is further restricted. In addition to the necessary access right, the correct password is required. Specifying 0 or X’00000000’ does not result in any change of the last value.
Specifying *SECRET or ^ allows the desired password to be entered invisibly. If the “secret” value is entered as a c-string, it must be enclosed in apostrophes. If it is entered as an x-string, it must similarly be enclosed in apostrophes and also be prefixed by
an X.
INIT-ELEM-PROTECTION = *UNCHANGED / *NONE / *PARAMETERS(...)
INIT-ELEM-PROTECTION = *NONE
No initial protection for the members contained in the library is defined.
INIT-ELEM-PROTECTION = *PARAMETERS(...)
Specifies the protection rights that the newly created members are to receive.
READ = *UNCHANGED /*NONE / *BY-GUARD(...) / *PARAMETERS(...) An initial read authorization is explicitly specified.
READ = *NONE
No further access restriction is provided.
READ = *BY-GUARD(...)
Specifies the read guard.
GUARD-NAME = <filename 1..18 without-cat-gen-vers>
Name of the guard.
READ = *PARAMETERS(...)
Specifies the user circles for the read authorization.
USER = *UNCHANGED / *NONE / *ALL / list-poss(3): *OWNER / *GROUP / *OTHERS
The circle of those with read authorization is explicitly listed.
USER = *NONE
None may access in the specified manner.
USER = *ALL
All may access in the specified manner (full listing).
USER = *OWNER
The owner of the library file may access.
USER = *GROUP
Those belonging to the group of the owner of the library file may access.
USER = *OTHERS
All others may access.
PASSWORD = *UNCHANGED / *SECRET / *NONE / <c-string 1..4> /
<x-string 1..8> / <integer -2147483648..2147483647>
The circle of authorized persons is further restricted. In addition to the necessary access right, the correct password is required.
Specifying 0 or X’00000000’ does not result in any change of the last value.Specifying *SECRET or ^ allows the desired password to be entered invisibly. If the “secret” value is entered as a c-string, it must be enclosed in apostrophes. If it is entered as an x-string, it must similarly be enclosed in apostrophes and also be prefixed by an X.
WRITE = *UNCHANGED /*NONE / *BY-GUARD(...) / *PARAMETERS(...)
An initial write authorization is explicitly defined.
The description of the operands is analogous to that for READ
EXEC = *UNCHANGED /*NONE / *BY-GUARD(...) / *PARAMETERS(...)An initial execute authorization is explicitly defined.
The description of the operands is analogous to that for READ
HOLD = *UNCHANGED /*NONE / *BY-GUARD(...) / *PARAMETERS(...) Grants the hold authorization for the member.
The operands are analogous to those described for READ.
Statement return code
(SC2) | Maincode | Meaning |
0 | CMD0001 | No error |
Required access rights
Read and write authorization for LIBRARY
Only the owner of the library file can modify attributes of the library.