Create Directory (QHFCRTDR) API
Required Parameter Group:
| 1 | Path name | Input | Char(*) |
| 2 | Length of path name | Input | Binary(4) |
| 3 | Attribute information table | Input | Char(*) |
| 4 | Length of attribute information table | Input | Binary(4) |
| 5 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: No
The Create Directory (QHFCRTDR) API creates a new directory and its directory entry. Except for the directory being created, all directories in the path must exist.
Authorities and Locks
None.
Required Parameter Group
- Path name
- INPUT; CHAR(*)
The path name for the new directory. The last element of the path name specifies the directory being created. For example, specifying /QDLS/A/B creates new directory B and adds a directory entry for B to directory A in file system QDLS.
- Length of path name
- INPUT; BINARY(4)
The length of the path name, in bytes.
- Attribute information table
- INPUT; CHAR(*)
The table specifying the attributes for the new directory. The file system determines which standard and extended attributes you can specify. For detailed descriptions of the standard attributes and the format of the table, see HFS Directory Entry Attributes.
If no attributes are specified, the file system's defaults are used for required information.
- Length of attribute information table
- INPUT; BINARY(4)
The length of the attribute information table, in bytes. Valid values are:
length Use the attributes specified in the table. 0 Use the system defaults for standard attributes instead of using the attributes in the 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. |
| CPF1F04 E | Directory name already exists. |
| CPF1F06 E | Directory in use. |
| CPF1F07 E | Authority not sufficient to access directory. |
| CPF1F08 E | Damaged directory. |
| CPF1F09 E | Use of reserved directory name not allowed. |
| 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 ]