UNLOCK

. UNLOCK --------

- RuleFn RuleFt ---------------------------------------------------------- RuleFn - File name of the rule file to be Unlocked. RuleFt - File type of the rule file to be Unlocked. --

Purpose

Use the UNLOCK command to unlock a SafeSFS rule file that had been previously locked by the GETRULES command.

Authorization

MANAGE authorization over the rule file to be unlocked, SAFADMIN authorization, or ownership of the lock to be removed.

Parameters

RuleFn :

The file name of the rule file to be unlocked.

RuleFT :

The file type of the rule file to be unlocked. It must be one of the following:

ADMIN	Specifies the GLOBAL ADMIN rule file. The RuleFn parameter must be GLOBAL.
GRPADMIN	Specifies the RuleFn GRPADMIN rule file, where RuleFn is the file name of the rule file to be unlocked.
USRADMIN	Specifies the RuleFn USRADMIN rule file, where RuleFn is the file name of the rule file to be unlocked.
USRDFLT	Specifies the RuleFn USRDFLT rule file, where RuleFn is the file name of the rule file to be unlocked.
GRPDFLT	Specifies the RuleFn GRPDFLT rule file, where RuleFn is the file name of the rule file to be unlocked.
DEFAULT	Specifies the GLOBAL DEFAULT rule file. The RuleFn parameter must be GLOBAL.
MANAGE	Specifies the SAFESFS MANAGE rule file. The RuleFn parameter must be SAFESFS.

Return Codes

Return Code	Meaning
0	Rule file unlocked.
4	Not authorized.
8	Command failed. Rule file is not unlocked.
113	Invalid parameter.
114	Invalid option.
115	Invalid rule file type.
116	Invalid rule file name.

Usage Notes

1. Use the UNLOCK command to unlock rule files that were retrieved by GETRULES, but are not going to be replaced by REPRULES.



2. Use the UNLOCK command carefully to unlock rule files that may have been left locked due to a system outage. Rule files that are actively being updated should not be unlocked.