Settings

Discover how to personalize your PowerOn Pro user experience.

PowerOn Pro ships with a number of configurable settings to personalize your VS Code experience as you develop.

Auto Associate PowerOn Workspace

If more than 50% of your active workspace has known PowerOn file extensions, a file association for poweron on the path will be added automatically.

Default Value	Available Values
true	true or false

Auto Deploy `#INCLUDE` Files

Controls how #INCLUDE files are deployed when deploying a PowerOn (only for non-Remote Syms).

Default Value	Available Values
off	off, prompt, or silent

Auto Disconnect Sym

Controls when your active Sym connection should automatically disconnect.

Default Value	Available Values
never	never, 1 hour, 4 hours, 8 hours, or 12 hours

Auto Validate PowerOn

Controls when the language server runs PowerOn validation. Useful if you like to validate your PowerOn file each time you save.

Default Value	Available Values
off	off or onsave

Batch

Batch related configuration options specific to the SSH connection type.

Fetch Report Timeout (SSH)

The maximum time to wait (min) for the completion of a batch PowerOn run.

Default Value	Available Values
15	Between 1 and 60

Queue Override (SSH)

The batch queue number to use when poweronPro.batch.queueSelection is set to override.

Default Value	Available Values
0	Between 0 and 3

Queue Selection (SSH)

Controls how the batch queue is selected for a batch PowerOn run. The available options will either use the first available queue, prompt you to select a queue, or use the override value set by the Queue Override setting.

Default Value	Available Values
first	first, prompt, or override

Report Viewer

Controls where batch reports are displayed.

Default Value	Available Values
editor	editor or output

Report Viewer Retention

The number of days to keep batch reports in storage when poweronPro.batch.reportViewer is set to editor.

Default Value	Available Values
10	Between 1 and 30

CLI Worker Timeout

The maximum time (sec) to wait for the initialization of the Symitar CLI workers which is only used with an SSH connection type to Symitar.

Default Value	Available Values
30	Between 5 and 120 seconds

Debug

Enables debug logging for the @libum-llc/symitar library. The logs will appear in the PowerOn Pro output channel.

Default Value	Available Values
false	true or false

Diagnostics

Real-time diagnostics configuration options which are triggered when the PowerOn changes in an active text editor.

Data Types (Experimental)

Plus Shows incorrect variable assignments as errors for PowerOn files.

Refinement coming soon...

In order to get real-time data type diagnostics accurately, we need to complete Abstract Syntax Trees (ASTs) to accurately interpret the PowerOn language. This is in-progress.

Default Value	Available Values
false	true or false

Defined Variables

Shows undefined variables or procedures as errors for PowerOn files.

Default Value	Available Values
true	true or false

Unused Variables

Plus Shows unused variables as dimmed for PowerOn files.

Default Value	Available Values
true	true or false

Formatter

Configuration options for the PowerOn code formatter (Experimental).

Align Defines

Align = signs in DEFINE sections for table-like readability.

Default Value	Available Values
false	true or false

Indent Size

Number of spaces per indentation level in PowerOn code.

Default Value	Available Values
1	Between 0 and 8

Keyword Case

Casing for PowerOn keywords, database records, and fields (e.g., TARGET, ACCOUNT, CLOSEDATE).

Default Value	Available Values
upper	upper, lower, or preserve

Max Blank Lines

Maximum consecutive blank lines to preserve within divisions.

Default Value	Available Values
1	Between 1 and 3

Print Width

Maximum line length for PowerOn code before wrapping.

Default Value	Available Values
80	Between 40 and 200

Section Spacing

Number of blank lines between major divisions (TARGET, DEFINE, SETUP, SELECT, SORT, PRINT, TOTAL, PROCEDURE).

Default Value	Available Values
1	Between 0 and 5

Space After Delimiter

Add space after comma delimiters in function parameters (e.g., FUNC(a, b) vs FUNC(a,b)).

Default Value	Available Values
false	true or false

Space Around Equals

Add spaces around the = operator in assignments (e.g., x = 5 vs x=5).

Default Value	Available Values
false	true or false

Space Around Operators

Add spaces around arithmetic (+, -, *, /) and comparison (<>, <, >, <=, >=) operators. Logical operators (AND, OR, WITH) always have spaces.

Default Value	Available Values
false	true or false

Uppercase Identifiers

Uppercase all identifiers (variable names, procedure names). PowerOn is case-insensitive; some shops prefer all-caps for mainframe consistency.

Default Value	Available Values
false	true or false

Include Paths

Additional absolute directory paths to search for #INCLUDE files. These directories will be searched in addition to the directory of the PowerOn file being processed.

Default Value	Available Values
[]	List of any local directory paths

Local Symitar Path

Plus The root path where your local Sym directories are synchronized. This is a required field for the Remote Syms feature and it's recommended to set as a path not directly in a typical folder structure for projects.

Default Value	Available Values
--	Any local directory path

Offline Validation

Controls whether a randomly named PowerOn is created, uploaded for validation, then deleted.

Default Value	Available Values
true	true or false

Just an FYI. Disabling this feature will automatically "publish" your PowerOn with each validation. We believe you shouldn't have to commit something to Symitar in order to check whether it's valid, that's why we defaulted this setting to true.

Preferred Case

Controls the case of keywords, functions, variables, and records. Additionally, you'll see this reflected in other relevant areas such as hovers and snippets.

Default Value	Available Values
upper	upper, lower, or camel

Remote Sym SFTP Concurrency

Plus The number of files to download simultaneously when using SFTP sync for Remote Syms.

Default Value	Available Values
20	Between 1 and 50

Remote Sym Sync Method

Plus Controls how Remote Syms are synchronized with the Symitar server.

Default Value	Available Values
sftp	sftp or rsync

• sftp: Use SFTP for synchronization (no external dependencies required)

• rsync: Use rsync for synchronization (requires WSL on Windows, rsync and sshpass installed)

SSH Port

The port to use when connecting to the Symitar host. For almost all cases this should be 22 but if you have port-forwarded and need the flexibility to use SSH over a different port, this is how you'd do it.

Default Value	Available Values
22	Any available port