Change Directory Entry Attributes (QHFCHGAT) API


  Required Parameter Group:

1 Path name Input Char(*)
2 Path name length Input Binary(4)
3 Attribute information table Input Char(*)
4 Length of the attribute information table Input Binary(4)
5 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Change Directory Entry Attributes (QHFCHGAT) API changes the attributes of a specified directory entry for an existing file or directory. As long as no other job has opened the directory in which the file or directory is located with a deny write lock, your application can add, change, or delete directory entry attributes.


Authorities and Locks

None.


Required Parameter Group

Path name
INPUT; CHAR(*)

The path name of the directory or file whose attributes you want to change. The directory or file must exist, and the path name must have more than one element. You cannot change the directory entry attributes of a file system.

Path name length
INPUT; BINARY(4)

The length of the path name, in bytes.

Attribute information table
INPUT; CHAR(*)

The table specifying the directory entry attributes to change. The file system determines which standard and extended attributes you can specify. For descriptions of the standard attributes, see HFS Directory Entry Attributes. For the format of the table, see HFS Attribute Information Table.

Length of the attribute information table
INPUT; BINARY(4)

The length of the attribute information table.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPF1F01 E Directory name not valid.
CPF1F02 E Directory not found.
CPF1F06 E Directory in use.
CPF1F07 E Authority not sufficient to access directory.
CPF1F08 E Damaged directory.
CPF1F21 E File name not valid.
CPF1F22 E File not found.
CPF1F26 E File in use.
CPF1F27 E Authority not sufficient to access file.
CPF1F28 E Damaged file.
CPF1F41 E Severe error occurred while addressing parameter list.
CPF1F42 E Attribute information table not valid.
CPF1F43 E Attribute name not valid.
CPF1F44 E Attribute value is not valid.
CPF1F46 E Use of reserved attribute name not allowed.
CPF1F48 E Path name not valid.
CPF1F52 E Error code not valid.
CPF1F61 E No free space available on media.
CPF1F62 E Requested function failed.
CPF1F63 E Media is write protected.
CPF1F66 E Storage needed exceeds maximum limit for user profile &1.
CPF1F71 E Exception specific to file system occurred.
CPF1F72 E Internal file system error occurred.
CPF1F73 E Not authorized to use command.
CPF1F74 E Not authorized to object.
CPF1F75 E Error occurred during start-job-session function.
CPF1F81 E API specific error occurred.
CPF1F82 E Function not supported.
CPF1F83 E File system name &1 not found.
CPF1F85 E Not authorized to file system &1.
CPF1F87 E Missing or damaged exit program &2.
CPF1F97 E File system &1 in use.
CPF3C90 E Literal value cannot be changed.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V2R1

[ Back to top | Hierarchical File System APIs | APIs by category ]