Domain: | SECURITY-ADMINISTRATION |
Privileges: | STD-PROCESSING, GUARD-ADMINISTRATION |
This command creates a guard and assigns it the type UNDEF. Normal users can create guards only for their own user IDs. The guard administrator can create guards for any user ID.
A guard created with this command does not yet contain any protection mechanism and cannot therefore perform any protective function.
CREATE-GUARD |
GUARD-NAME = <filename 1..24 without-gen-vers> ,SCOPE = *USER-ID / *USER-GROUP / *HOST-SYSTEM ,USER-INFORMATION = ' ' / <c-string 1..80 with-low> |
GUARD-NAME = <filename 1..24 without-gen-vers>
Name of the guard to be created. The length of the actual name, without catalog ID and user ID, is 8 characters.
The specification of the system default ID in the guard name, e.g. $<filename> or $.<filename>, is not supported.
SCOPE =
Specifies who may use this guard to protect his/her objects. The administration rights (deleting or modifying a guard) remain the property of the guard’s owner.
The guard administrator is authorized to protect his or her own files with guards owned by someone else without the scope of these guards having to be set to *HOST-SYSTEM and without the need for group membership when SCOPE=*USER-GROUP is specified.
SCOPE = *USER-ID
Only the owner may use this guard.
SCOPE = *USER-GROUP
All members of the owner’s user group may use this guard.
SCOPE = *HOST-SYSTEM
Any user may use this guard.
USER-INFORMATION = <c-string 1..80 with-low>
This permits input of any desired comment text for the guard.
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command successfully executed | |
32 | PRO1001 | An internal error has occurred. A SERSLOG entry has been written for further analysis | |
64 | PRO1002 | Syntax error in the guards name | |
64 | PRO1006 | The specified guard already exists | |
64 | PRO1012 | The specified catalog is not defined or not accessible | |
64 | PRO1013 | The pubset is not known to the GUARDS administration (the guards catalog was probably not opened at IMPORT-PUBSET) | |
64 | PRO1014 | The user is not authorized to execute this function | |
64 | PRO1016 | Error in the MRS communication facility | |
64 | PRO1017 | Unknown user ID | |
64 | PRO1018 | The remote system is not available | |
64 | PRO1020 | No more memory space available | |
64 | PRO1021 | BCAM connection error | |
64 | PRO1022 | The BCAM connection has been interrupted | |
64 | PRO1029 | GUARDS is not available on the remote system | |
128 | PRO1036 | The guards catalog is locked |
Example
|