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 IDDescriptionOutput destination
KFCA01506-IHelp messageStandard output, standard error output
KFCA01533-ESpecified OpenTP1 file was not found.Standard error output
KFCA01536-ESpecification of a command argument is invalid.Standard error output
KFCA01540-ESpecified login name was not found.Standard error output
KFCA01542-ESpecified user ID value is too large.Standard error output
KFCA01570-EFile versions do not match.Standard error output
KFCA01571-EUser does not have access right to the file.Standard error output
KFCA01572-EAn upper bound was exceeded during open processing.Standard error output
KFCA01573-ESpecified OpenTP1 file system area was not found.Standard error output
KFCA01574-ESpecified file name is too long.Standard error output
KFCA01575-ESpecified 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-ESpecified file is not an OpenTP1 file system.Standard error output
KFCA01577-EUser does not have right to execute filchown command.Standard error output
KFCA01578-ELocking the OpenTP1 file system failed.Standard error output
KFCA01582-EMemory is inadequate.Standard error output
KFCA01583-EI/O error occurred.Standard error output
KFCA01599-EError occurred.Standard error output