OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

filchown (Change an OpenTP1 file owner)

Format

filchown owner OpenTP1-file-system-area-name/OpenTP1-file-name

Function

The filchown command changes the owner of a specified OpenTP1 file.

Only the OpenTP1 administrator and the OpenTP1 file owner can execute the filchown command.

Command arguments

owner

Specifies the new owner's user ID (as decimal digits) or login name in the password file (/etc/passwd).

If the specified character string consists of numeric digits only and the matching login name is not found among the /etc/passwd entries, the specified character string is treated as a user ID expressed in decimal digits.

OpenTP1-file-system-area-name~<path name>

Specifies the name of a character special file or ordinary file containing the OpenTP1 file system.

OpenTP1-file-name~<OpenTP1 file name>

Specifies the name of the OpenTP1 file.

Output messages

Message ID Description Output destination
KFCA01506-I Help message Standard output, standard error output
KFCA01533-E Specified OpenTP1 file was not found. Standard error output
KFCA01536-E Specification of a command argument is invalid. Standard error output
KFCA01540-E Specified login name was not found. Standard error output
KFCA01542-E Specified user ID value is too large. Standard error output
KFCA01570-E File versions do not match. Standard error output
KFCA01571-E User does not have access right to the file. Standard error output
KFCA01572-E An upper bound was exceeded during open processing. Standard error output
KFCA01573-E Specified OpenTP1 file system area was not found. Standard error output
KFCA01574-E Specified file name is too long. Standard error output
KFCA01575-E Specified file is not a character special file or ordinary file; or, specified file was found, but there is no corresponding device. Standard error output
KFCA01576-E Specified file is not an OpenTP1 file system. Standard error output
KFCA01577-E User does not have right to execute filchown command. Standard error output
KFCA01578-E Locking the OpenTP1 file system failed. Standard error output
KFCA01582-E Memory is inadequate. Standard error output
KFCA01583-E I/O error occurred. Standard error output
KFCA01599-E Error occurred. Standard error output