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 Deploy `#INCLUDE` Files

Controls how #INCLUDE files are deployed when deploying a PowerOn.

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
5	Between 1 and 15

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

Diagnostics

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

Data Types (Experimental)

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

Undefined Variables

Shows unused variables as dimmed for PowerOn files.

Default Value	Available Values
true	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

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, 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

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