Performance preferences

You can configure how much data P4V processes during a session to minimize server load for large data transfers and commands that run frequently:

Check server for updates every n minutes

Specifies how often P4V checks P4 Server for updated file information. Frequent checks enable P4V to display current file status but increase the workload on P4 Server.

This corresponds to Refresh.

Maximum number of files displayed per changelist

 

Specifies the maximum number of files displayed in a changelist. This setting affects only the display of changelists and does not limit the number of files that a changelist can contain.

If the number of file exceeds this maximum, the Submit, Shelve, Unshelve, Revert, and Resolve dialogs display the files in a plain-text list. You can filter the list of files and remove any files you want to remove from the changelist. You can also undo one or more removals of files from the changelist:

For example, if you want to submit a changelist, when the list of files is filtered to show only the files that you want to submit, click Submit.

This area displays the number of files in the changelist and reflects how many files you removed from the changelist.

In the dialogs that display files in a plain-text list, the action, such as submit or resolve, applies to all the files that have not been filtered out of the list.

To see file history, right-click any file in the list:


Maximum size of file to preview (excludes audio and video files) Limits the size of image files displayed in the Preview tab on the Files pane, to limit the amount of image data sent from P4 Server to P4V.
Number of changelists, jobs, branch mappings or labels to fetch at a time Specifies the number of specifications read in each batch fetched, to minimize server load and maximize P4V performance. To retrieve all entries, specify 0
Number of files per directory fetched at a time in the Depot tree

If set to 0, P4V takes the time necessary to fetch all files. For directories with thousands of files, the user might notice the waiting time.

If set to a value like 500, can improve performance by providing the first batch of files more quickly. When the user opens a depot directory, P4V retrieves only the specified number of files. Similarly, when the user scrolls down in the Depot tree, P4V retrieves the next batch of files according to this value.

Maximum number of files to display in Dashboard Workspace Folder View Limits the number of files displayed in the Dashboard view.
Disable parallel sync Disables concurrent transfer of files for all P4V connections. There is no configuration in P4V to turn on parallel sync. Instead, parallel sync is enabled automatically when the net.parallel.threads config parameter is set in a server. Parallel sync can greatly reduce the amount of time it takes to update a workspace, especially when connecting across a high latency network. To learn more, see Using parallel processing for submits and syncs in the P4 Server Administration Documentation. Starting with the P4V 2025.2 release, parallel sync will be enabled by default for new users.
Disable parallel submit Disables concurrent transfer of files when submitting to a P4 Server. Similar to parallel sync, parallel submit can greatly reduce the amount of time required to submit by transferring multiple files across the network at the same time. For information on the server configurables pertaining to parallel submit, see net.parallel.submit.threads and net.parallel.max in the P4 CLI Reference. Parallel transfer mode only occurs if you set net.parallel.max to a value larger than 0. Starting with the P4V 2025.2 release, parallel submit will be enabled by default for new users.
Disable parallel shelve Disables file transfer in parallel mode. Parallel shelving is enabled when the net.parallel.shelve.threads config parameter is set in a server (2017.2 or later). By default, this setting is turned on. For more information on the server configurable, see net.parallel.shelve.threads in the P4 CLI Reference. Starting with the P4V 2025.2 release, parallel shelve will be enabled by default for new users.
Enable parallel reconcile using client threads

Enables reconcile commands to run using multiple client-side threads. This feature significantly improves the performance of reconcile commands, particularly when reconciling file moves, renames, and edits. By default, this setting is turned on and its value is set to Maximum.

The parallel reconcile command functions together with the file move detection setting that determines if a file that has been added or deleted should be taken into account when parallel reconcile commands are run or not. For more information on the file move detection setting, see Behavior preferences.

To use this feature, a 2025.1 or newer P4 Server is required. When connected to an older server version, reconcile automatically falls back to single-threaded mode, regardless of the user preference set to use parallel reconcile.

Use the drop-down to select the number of client-side threads that P4V may use for parallel reconcile commands. Options include:

  • The lowest thread count you can select will always be 2.

  • The highest thread count you will see as an option will be the smaller of these two values:

    • The P4 API for C/C++'s maximum supported threads (currently 32).

    • The total number of threads available to P4V on the client machine.

  • If you select a specific number from the drop-down, parallel reconcile will consistently use that exact number of threads.

  • If the client machine's hardware or configuration changes the number of available threads, selecting Maximum will automatically adjust the number of threads used by parallel reconcile to the new maximum.

  • The Maximum option will dynamically use all available threads on the client machine. This is the default value.