7.2.9 acuserve -unlock

"acuserve -unlock" unlocks and closes files held open by acuserve. To use "-unlock" you must be logged onto a UNIX server as root or superuser or onto a Windows NT/Windows 2000 server from the Administrator account or from an account that belongs to the Administrators group.

Before using "-unlock", use "acuserve -info" to get a current listing of all open files.

WARNING: If "acuserve -unlock [server] -a" is entered, all open files will immediately be closed. No confirmation prompt is output. See Section 7.5 Closing Stranded Files.

When "acuserve -unlock [server]" is entered without any other options, the unlock facility enters into an interactive mode. In interactive mode you will be prompted for the FID, client name, user name and PID. Enter only the information needed to effect removal. Leave the other fields blank. acuserve will redisplay your selection information and prompt for confirmation before closing any files. For more details and examples, see Section 7.5 Closing Stranded Files.

Optional arguments to "-unlock" include:

Option
Description
[server]
Specifies the name of the AcuServer server. If no server is specified, the server is assumed to be the local host.
-a
Causes all open files on the server to be immediately closed. "-a" does not ask the user for confirmation before closing all files.
-f FID
Causes the file associated with the specified FID to be unlocked and closed. "-f" must be followed by a space and the FID of an open file.
-c client
When "-c" is used with no other options, acuserve unlocks and closes all files held open for the named client on the current host. "-c" must be followed by a space and the name of an AcuServer client. Use "-c" in combination with the server option to specify a server other than the current host. "-c" can be qualified by the "-u" or "-p" options.
-u user
Used as a qualifier to the "-c" option. "-u" must be followed by a space and the name of an AcuServer user. The "-c client -u user" combination causes acuserve to close all files associated with the named user on the named client.
-p PID
Used as a qualifier to the "-c" option. "-p" must be followed by a space and the PID of a client process. The "-c client -p PID" combination causes acuserve to close all files associated with the specified PID on the named client.
-n port
Identifies a particular instance of the acuserve program by port number. The "-n" must be followed by a space and then an integer, e.g., "6524". This option causes only those files associated with the specified instance of the acuserve program to be unlocked and closed. If no port number is specified, then files for the default port are unlocked and closed.

Option	Description
[server]	Specifies the name of the AcuServer server. If no server is specified, the server is assumed to be the local host.
-a	Causes all open files on the server to be immediately closed. "-a" does not ask the user for confirmation before closing all files.
-f FID	Causes the file associated with the specified FID to be unlocked and closed. "-f" must be followed by a space and the FID of an open file.
-c client	When "-c" is used with no other options, acuserve unlocks and closes all files held open for the named client on the current host. "-c" must be followed by a space and the name of an AcuServer client. Use "-c" in combination with the server option to specify a server other than the current host. "-c" can be qualified by the "-u" or "-p" options.
-u user	Used as a qualifier to the "-c" option. "-u" must be followed by a space and the name of an AcuServer user. The "-c client -u user" combination causes acuserve to close all files associated with the named user on the named client.
-p PID	Used as a qualifier to the "-c" option. "-p" must be followed by a space and the PID of a client process. The "-c client -p PID" combination causes acuserve to close all files associated with the specified PID on the named client.
-n port	Identifies a particular instance of the acuserve program by port number. The "-n" must be followed by a space and then an integer, e.g., "6524". This option causes only those files associated with the specified instance of the acuserve program to be unlocked and closed. If no port number is specified, then files for the default port are unlocked and closed.