Convert To Folder (CVTTOFLR)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Convert To Folder (CVTTOFLR) command converts a virtual disk into a folder and PC documents. The files and directories on the virtual disk are copied into the specified folder, which becomes the root directory.
Note: Do not precede an entry with an asterisk unless that entry is a "special value" that is shown (on the display itself or in the help information) with an asterisk.
Error messages for CVTTOFLR
*ESCAPE Messages
- IWS1613
- Virtual disk converted. Errors occurred.
- IWS1614
- Unable to convert virtual disk to folder.
*STATUS Messages
- IWS1621
- Converting virtual disk to folder.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FROMVDSK | From virtual disk | Qualified object name | Required, Positional 1 |
| Qualifier 1: From virtual disk | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| TOFLR | To folder | Character value | Required, Positional 2 |
| REPLACE | Replace documents | *NO, *YES | Optional, Positional 3 |
| Top |
From virtual disk (FROMVDSK)
Specifies the name and library of the virtual disk that is converted.
This is a required parameter.
The possible library values are:
- *LIBL
- The library list is used to locate the virtual disk.
- *CURLIB
- The current library for the job is used to locate the virtual disk. If no current library entry exists in the library list, QGPL is used.
- library-name
- Specify the library where the virtual disk is located.
| Top |
To folder (TOFLR)
Specifies the name of the folder that the virtual disk is converted to. This can be a fully qualified path name.
All the files and directories in the virtual disk are converted. All folders except the last folder in the path must already exist. If the last folder does not exist, it is created.
This is a required parameter.
| Top |
Replace documents (REPLACE)
Specifies if an existing document should be replaced when a file on the virtual disk has the same name as the document.
- *NO
- It is not replaced.
- *YES
- The existing document is replaced by the file from the virtual disk.
Warning:
All documents that have the same name as files on the virtual disk will be replaced without any error messages being sent.
| Top |
Examples
None| Top |
Error messages
*ESCAPE Messages
- IWS1613
- Virtual disk converted. Errors occurred.
- IWS1614
- Unable to convert virtual disk to folder.
*STATUS Messages
- IWS1621
- Converting virtual disk to folder.
| Top |