Domain: | SECURITY-ADMINISTRATION |
Privileges: | STD-PROCESSING, GUARD-ADMINISTRATION |
This command copies a guard. Users can only copy their own guards. Users with the privilege GUARD-ADMINISTRATION may copy other users’ guards into their own user IDs or under other user IDs. All other users may copy another user’s guard only into their own user ID, and then only if this is permitted by the SCOPE attribute of the guard (specified during definition of the attributes).
This command may be used under RFA if the source and destination guards are locally accessible on the same computer.
COPY-GUARD |
FROM-GUARD = <filename 1..24 without-gen-vers> ,TO-GUARD = <filename 1..24 without-gen-vers> ,REPLACE-OLD-GUARD = *NO / *YES / *BY-DIALOG |
FROM-GUARD = <filename 1..24 without-gen-vers>
Name of the guard to be copied (source guard).
The specification of the system default ID in the guard name, e.g. $<filename> or $.<filename>, is not supported.
TO-GUARD = <filename 1..24 without-gen-vers>
Name of the destination guard into which the source guard is to be copied. Only users with the privilege GUARD-ADMINISTRATION may copy guards between different user IDs.
The specification of the system default ID in the guard name, e.g. $<filename> or $.<filename>, is not supported.
REPLACE-OLD-GUARD =
Specifies what is to happen if an existing guard is specified as the destination.
REPLACE-OLD-GUARD = *NO
An existing guard is never overwritten; the source guard is not copied.
REPLACE-OLD-GUARD = *YES
An existing guard is overwritten by the source guard without further questions.
REPLACE-OLD-GUARD = *BY-DIALOG
In interactive mode, this option permits the user to decide whether or not an existing guard is to be overwritten. If this option is used in batch mode, the command behaves as if REPLACE-OLD-GUARD = *NO had been specified.
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command successfully executed | |
2 | 0 | PRO1011 | The command was aborted at the user’s request. |
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 | PRO1007 | The specified guard does not exist | |
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 | PRO1024 | Use of the guard is not permitted | |
64 | PRO1025 | Remote copy is not possible | |
64 | PRO1029 | GUARDS is not available on the remote system | |
128 | PRO1009 | The specified guard is locked by another task | |
128 | PRO1036 | The guards catalog is locked |
Example
The guard GUARDEXA is to be copied into the existing guard EXAGUARD. The dialog control is set to *BY-DIALOG in order to permit interactive confirmation:
|