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