| 1 | Source file path name | Input | Char(*) |
| 2 | Source file path name length | Input | Binary(4) |
| 3 | Target file path name | Input | Char(*) |
| 4 | Target file path name length | Input | Binary(4) |
| 5 | Error code | I/O | Char(*) |
The Move Stream File (QHFMOVSF) API moves a single stream file from one directory to another and optionally changes the file's name. The file's attributes are not changed.
The QHFMOVSF API only moves stream files to a different path. To rename files within a path, see Rename Stream File (QHFRNMSF) API.
None.
The path name of the file being moved. The file name is the last element of the path name.
The source file must be accessible. You cannot move a file that is already in use by another job.
The length of the source file path name, in bytes.
The path name designating the new location and, optionally, the new name of the file being moved.
The target file cannot already exist. It must reside in a different path from the source file. The file name can be the same as or different from the source file name.
The length of the target file path name, in bytes.
The structure in which to return error information. For the format of the structure, see Error code parameter.
| Message ID | Error Message Text |
|---|---|
| CPF1F01 E | Directory name not valid. |
| CPF1F02 E | Directory not found. |
| CPF1F03 E | New directory name same as old directory name. |
| CPF1F06 E | Directory in use. |
| CPF1F07 E | Authority not sufficient to access directory. |
| CPF1F08 E | Damaged directory. |
| CPF1F2A E | Number of open files exceeds limit. |
| CPF1F2E E | Range of bytes in file in use. |
| CPF1F21 E | File name not valid. |
| CPF1F22 E | File not found. |
| CPF1F24 E | File name already exists. |
| CPF1F26 E | File in use. |
| CPF1F27 E | Authority not sufficient to access file. |
| CPF1F28 E | Damaged file. |
| CPF1F29 E | Use of reserved file name not allowed. |
| CPF1F34 E | Attempted write operation beyond file size limit. |
| CPF1F35 E | Read file operation failed. |
| CPF1F36 E | Write file operation failed. |
| 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. |
| CPF1F84 E | Operation across file systems not allowed. |
| CPF1F85 E | Not authorized to file system amp;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. |
[ Back to top | Hierarchical File System APIs | APIs by category ]