Convert Directory (CVTDIR)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Convert Directory (CVTDIR) command works with the conversion of integrated file system directories from the *TYPE1 format to the *TYPE2 format. Directories in the "root" (/), QOpenSys, and user-defined file systems support *TYPE2 directories. *TYPE2 directories are optimized for performance, size, and reliability as compared to directories having the *TYPE1 format.

The CVTDIR command can provide the current directory format of the file systems, or can change the priority of the convert directory function.

Restrictions:

  1. The user must have all object (*ALLOBJ) special authority to use this command.
Top

Parameters

Keyword Description Choices Notes
OPTION Option *CHECK, *CHGPTY Required, Positional 1
RUNPTY Run priority 1-99, *SAME, *DFT Optional
FILESYS File system *NONE, *ROOT, *QOPENSYS, *UDFS, *ALL Optional
FORMAT Format *TYPE2, *TYPE1 Optional
DETAIL Detail *BASIC, *EXTENDED Optional
ASP Auxiliary storage pool ID 1-32 Optional
Top

Option (OPTION)

Specifies the function to be performed.

*CHECK
The file systems which are currently on the system are checked to determine their current directory format. Message CPIA084 is sent for the "root" (/), and QOpenSys file systems, and for all active auxiliary storage pools on the system identifying their current directory format.
*CHGPTY
Change the run priority of the convert directory function.
Top

Run priority (RUNPTY)

Specifies the new run priority for the convert directory function. This must be specified if OPTION(*CHGPTY) is used.

Note: There may be a delay before the new priority takes effect for the convert directory function.

*SAME
The run priority does not change.
*DFT
The run priority will be reset to the system default.
1-99
Specify the run priority for the convert directory function.
Top

File system (FILESYS)

This parameter is no longer supported and will be ignored. It has been kept strictly for syntactic compatibility with releases prior to Version 5 Release 4 Modification 0 of the i5/OS.

Top

Format (FORMAT)

This parameter is no longer supported and will be ignored. It has been kept strictly for syntactic compatibility with releases prior to Version 5 Release 4 Modification 0 of the i5/OS.

Top

Detail (DETAIL)

This parameter is no longer supported and will be ignored. It has been kept strictly for syntactic compatibility with releases prior to Version 5 Release 4 Modification 0 of the i5/OS.

Top

Auxiliary storage pool ID (ASP)

This parameter is no longer supported and will be ignored. It has been kept strictly for syntactic compatibility with releases prior to Version 5 Release 4 Modification 0 of the i5/OS.

Top

Examples

Example 1: Checking Directory Format Information

CVTDIR   OPTION(*CHECK)

This command displays the current directory formats for the file systems.

Example 2: Changing the Run Priority of the Convert Directory Function

CVTDIR   OPTION(*CHGPTY)  RUNPTY(50)

This command changes the run priority of the convert directory function.

Top

Error messages

*ESCAPE Messages

CPF9890
Function not supported, request rejected.
CPFA099
The requested convert directory option cannot be performed.
CPFA09A
Errors occurred during directory conversion.
Top