Delete Directory (QHFDLTDR) API


  Required Parameter Group:

1 Path name Input Char(*)
2 Length of path name Input Binary(4)
3 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Delete Directory (QHFDLTDR) API deletes a single, empty directory. It cannot contain any directory entries. If this job or another job has already opened the directory with a deny none or deny write lock, it cannot be deleted.


Authorities and Locks

None.


Required Parameter Group

Path name
INPUT; CHAR(*)

The path name of the directory being deleted. The last element of the path name must be a directory name. You cannot use a one-element path name specifying only the file system.

Path name length
INPUT; BINARY(4)

The length of the path name, in bytes.

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
CPF1F0A E Delete directory operation not allowed.
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.
CPF1F41 E Severe error occurred while addressing parameter list.
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 ]