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.

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