Skip to content

Open Settings in VS Code and search for @ext:libum.poweron-pro. You can also open PowerOn Pro: Show Menu and choose Edit Settings…. Search for a full setting ID below to find a specific option.

Choose User settings for your usual defaults or Workspace settings for a project. Settings marked Machine apply to the machine running the extension, such as local paths and connection startup timeouts. Resource settings can vary by workspace folder or file resource. Window settings apply across the current VS Code window.

Defaults below describe a fresh configuration. Existing user or workspace overrides can differ. Use Reset Setting in VS Code to restore a setting's default. A purple Plus tag identifies settings for features requiring Plus.

PowerOn Pro setting search with User and Workspace tabs and the Reset Setting menu PowerOn Pro setting search with User and Workspace tabs and the Reset Setting menu
Find a setting and choose where its value applies.

Connection & synchronization

Auto Reconnect

Automatically retry lost connections, waiting longer between attempts.

poweronPro.autoReconnect

Default Values Scope
false true, false Window

Idle Disconnect

Disconnect after this much inactivity. Background checks and syncs do not reset the timer. Set to 0 to disable. (min)

poweronPro.idleDisconnect

Default Values Scope
60 0–720 (whole numbers) Window

SSH Port

SSH port used by all connections, Remote Syms, and Reports. Change this if your organization uses a nonstandard port. Reconnect to apply.

poweronPro.sshPortOverride

Default Values Scope
22 1–65535 (whole numbers) Window

SSH Connect Timeout

Time allowed for SSH connector startup, in seconds. For a slow host, try 60 and reconnect. This does not change command timeouts.

poweronPro.sshConnectTimeoutSeconds

Default Values Scope
30 1–120 (whole numbers) Machine

Sync Method

Plus · Transfer method for synchronizing Remote Syms and Reports. sftp is the default and needs no local Rsync tools. rsync requires local rsync and sshpass, plus Rsync on the host; Windows also requires WSL. See Setting up Rsync. Takes effect on the next synchronization.

poweronPro.syncMethod

Default Values Scope
"sftp" "sftp", "rsync" Window

SFTP Concurrency

Plus · Maximum simultaneous file transfers when synchronizing Remote Syms and Reports using SFTP. Does not apply to rsync. Takes effect on the next synchronization.

poweronPro.sftpConcurrency

Default Values Scope
4 1–20 (whole numbers) Window

Remote Syms

Local Symitar Path

Plus · Folder for new Remote Sym workspaces. Use the folder picker in Settings or the Remote Syms view. Changing this folder does not move existing workspaces.

poweronPro.localSymitarPath

Default Values Scope
"" Local directory path Machine

Synchronize on Open

Plus · Sync once when a Remote Sym workspace opens and its connection is ready. Keeps local changes for manual review without opening dialogs or switching views.

poweronPro.remoteSyms.syncOnOpen

Default Values Scope
true true, false Window

Save & deploy

On Save

Choose what happens when saving a PowerOn. Work Locally always saves only. Set this per workspace to control whether saving contacts or changes the host.

poweronPro.onSave

Default Values Scope
"off" "off", "validate", "validateAndDeploy" Resource
Value Behavior
"off" Save only — Save locally without contacting Symitar.
"validate" Validate — Validate standalone PowerOns using temporary copies of local sources and includes. Deployed originals stay unchanged.
"validateAndDeploy" Validate and Deploy — Deploy the saved file. Validate standalone PowerOns against remote includes; include fragments deploy without standalone validation. Never installs.

The validateAndDeploy action changes host files and never installs them. Formatting on save is controlled separately by poweronPro.formatter.formatOnSave.

Auto Deploy Include Files

Choose how changed local includes are handled when deploying a PowerOn. Applies independently of On Save; temporary validation is unaffected.

poweronPro.autoDeployIncludeFiles

Default Values Scope
"off" "off", "prompt", "silent" Resource
Value Behavior
"off" Off — Never upload dependencies. Stop deployment when a resolved local include differs from its remote copy; update that include separately.
"prompt" Prompt — Compare changed includes and choose whether to deploy each local version or keep its remote version.
"silent" Automatic — Automatically deploy changed local includes before the main PowerOn.
On Save choices: Save only, Validate, and Validate and Deploy On Save choices: Save only, Validate, and Validate and Deploy
Include deployment choices: Off, Prompt, and Automatic Include deployment choices: Off, Prompt, and Automatic
Configure save actions separately from include deployment.

Batch & reports

Batch Queue

Queue selection when running a Batch PowerOn.

poweronPro.batch.queue

Default Values Scope
"firstAvailable" "prompt", "0", "1", "2", "3", "firstAvailable" Window
Value Behavior
"prompt" Ask which queue to use each time.
"0" Always use queue 0.
"1" Always use queue 1.
"2" Always use queue 2.
"3" Always use queue 3.
"firstAvailable" Use the first empty queue; if all are occupied, ask which queue to use.

Open Reports on Completion

Automatically open batch output and all associated reports when a submitted batch finishes. Reports are downloaded immediately. When disabled, the completion notification offers Open reports; Free users can open temporary reports from that notification.

poweronPro.batch.openReportOnCompletion

Default Values Scope
true true, false Window

Retention Days

Plus · Report sync lookback. Rebuilding the cache also removes older local reports. (days)

poweronPro.reports.retentionDays

Default Values Scope
15 1–360 (whole numbers) Window

Background Sync Interval

Plus · Interval between updates to the selected report cache while connected. Set to 0 to disable. (min)

poweronPro.reports.backgroundSyncInterval

Default Values Scope
5 0–60 (whole numbers) Window

Language tools

Preferred Case

Controls the case of keywords, functions, variables, and records

poweronPro.preferredCase

Default Values Scope
"upper" "camel", "upper", "lower" Window

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.

poweronPro.includePaths

Default Values Scope
[] Array of absolute directory paths Window

Semantic Highlighting

Color variables, fields, and procedures based on their meaning. This setting is separate from the Realtime diagnostics subscription feature.

poweronPro.semanticHighlighting

Default Values Scope
true true, false Window

Realtime Diagnostics

Plus · Enable Realtime diagnostics as you type, without on-host validation. Symitar validation results remain visible with Free.

poweronPro.diagnostics.enabled

Default Values Scope
true true, false Window

Diagnostics Rules

Plus · Choose which Realtime diagnostic checks run. All supported rules are enabled by default, including experimental type checks. Requires poweronPro.diagnostics.enabled to be enabled. Use Reset Setting to restore the defaults.

poweronPro.diagnostics.rules

Default Values Scope
All supported rules enabled Rule IDs mapped to true or false Window

Use a rule ID as the object key when changing individual checks in settings JSON. For example:

JSON
{
  "poweronPro.diagnostics.rules": {
    "unused-variable": false
  }
}

All rule defaults below are true. The Experimental tag identifies type checks marked experimental by the extension. These checks analyze types locally; use host validation to confirm findings. You can disable an individual rule without turning off other diagnostics.

Rule ID Check
syntax-error Syntax error.
undefined-variable Undefined variable.
undefined-procedure Undefined procedure.
duplicate-definition Duplicate definition.
variable-name-too-long Variable name too long.
string-literal-too-long Warn when a string literal exceeds 132 characters, excluding line breaks.
invalid-variable-name Invalid variable name.
array-size-exceeded Array size exceeded.
symbol-limit-exceeded Symbol limit exceeded.
unused-variable Unused variable.
unused-constant Unused constant.
unused-procedure Unused procedure.
type-mismatch Experimental Type mismatch.
invalid-type Experimental Invalid type.
operator-type-mismatch Experimental Operator type mismatch.
condition-type-mismatch Experimental Condition type mismatch.
division-by-zero Division by zero.
dead-branch Dead branch.
unreachable-code Unreachable code.
constant-reassignment Constant reassignment.
invalid-mnemonic Invalid field names, numbers, or subfields.
unknown-function Unknown function.
invalid-param-count Invalid param count.
invalid-record-type Invalid record type.
invalid-operation Invalid operation.
missing-targetfile Missing targetfile.
unnecessary-targetfile Unnecessary targetfile.
invalid-transaction-code Invalid transaction code.
invalid-fm-set-field Invalid fm set field.
invalid-fm-set-value-type Experimental Invalid fm set value type.
invalid-tran-token Invalid tran token.
invalid-tran-token-value-type Experimental Invalid tran token value type.
missing-required-token Missing required token.
invalid-for-record-type Invalid for record type.
for-variable-type-mismatch Experimental For variable type mismatch.
conflicting-pre-target Conflicting pre target.
Enabled Realtime diagnostics and individual rules, including type-mismatch and invalid-type Enabled Realtime diagnostics and individual rules, including type-mismatch and invalid-type
Choose which Realtime diagnostics run while editing.

CodeLens References

Plus · Show reference counts above defined variables and procedures.

poweronPro.codeLens.references

Default Values Scope
true true, false Window

Formatter

Indent Size

Plus · Indentation size per level, or tab width when useTabs is enabled. (spaces)

poweronPro.formatter.indentSize

Default Values Scope
1 0–8 Resource

Use Tabs

Plus · Use tabs instead of spaces for indentation

poweronPro.formatter.useTabs

Default Values Scope
false true, false Resource

Keyword Case

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

poweronPro.formatter.keywordCase

Default Values Scope
"upper" "upper", "lower", "preserve" Resource

Plus · Maximum line length for PowerOn code before wrapping. (characters)

poweronPro.formatter.printWidth

Default Values Scope
132 40–200 Resource

Space Around Operators

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

poweronPro.formatter.spaceAroundOperators

Default Values Scope
false true, false Resource

Space Around Operators Exclude

Plus · Comma-separated list of statement types to exclude from space-around-operators formatting for the = operator (e.g., COL,DATASIZE)

poweronPro.formatter.spaceAroundOperatorsExclude

Default Values Scope
"" Comma-separated statement types, or "" Resource

Space After Delimiter

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

poweronPro.formatter.spaceAfterDelimiter

Default Values Scope
false true, false Resource

Align Defines

Plus · Align = signs in DEFINE sections for table-like readability

poweronPro.formatter.alignDefines

Default Values Scope
false true, false Resource

Section Spacing

Plus · Spacing between major divisions (TARGET, DEFINE, SETUP, SELECT, SORT, PRINT, TOTAL, PROCEDURE). (blank lines)

poweronPro.formatter.sectionSpacing

Default Values Scope
1 0–5 Resource

Max Blank Lines

Plus · Maximum consecutive spacing to preserve within divisions. (blank lines)

poweronPro.formatter.maxBlankLines

Default Values Scope
1 1–3 Resource

Uppercase Identifiers

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

poweronPro.formatter.uppercaseIdentifiers

Default Values Scope
false true, false Resource

Expand Parentheses

Plus · Expand parenthesized expressions onto multiple lines with opening/closing parentheses on their own lines and content indented.

poweronPro.formatter.expandParentheses

Default Values Scope
false true, false Resource

Align Logical Operators

Plus · Align logical operators (AND, OR) vertically at the end of each line in multi-line conditions. Forces line breaks at each operator.

poweronPro.formatter.alignLogicalOperators

Default Values Scope
false true, false Resource

Do On Same Line

Plus · Place the DO keyword on the same line as THEN, FOR EACH, WHILE, etc. (e.g. IF X THEN DO ... END) instead of putting DO on its own indented line.

poweronPro.formatter.doOnSameLine

Default Values Scope
false true, false Resource

Format On Save

Plus · Automatically format PowerOn files when saving.

poweronPro.formatter.formatOnSave

Default Values Scope
false true, false Resource
Current formatter settings: two-space indentation, preserved keyword casing, and spaces around operators Current formatter settings: two-space indentation, preserved keyword casing, and spaces around operators
LB.POWERON.PO before formatting LB.POWERON.PO before formatting
Before formatting
LB.POWERON.PO after formatting, with aligned definitions LB.POWERON.PO after formatting, with aligned definitions
After formatting
See how indentation, spacing, and casing affect your PowerOn.

OnDemand & workspace

Manage remembered API access through PowerOn Pro: Manage OnDemand API Approvals in the Command Palette. See OnDemand API approvals for the approval and revocation workflow.

OnDemand HTML Resource Paths

Additional local folders for OnDemand HTML resources, searched before Quest's default HTML folder. Use absolute paths. Reopen the PowerOn to apply changes.

poweronPro.onDemand.htmlResourcePaths

Default Values Scope
[] Array of absolute directory paths Machine

OnDemand Open Developer Tools

Automatically open VS Code developer tools when an active OnDemand view opens. Tools open once per view; use the element picker to select rendered content. Developer tools show the full VS Code window, rather than automatically selecting the OnDemand iframe.

To open tools manually, right-click inside the OnDemand view and choose Open Developer Tools. This action is available in the context menu, not the editor title bar or Command Palette.

poweronPro.onDemand.openDeveloperTools

Default Values Scope
false true, false Window

Seasonal Animations

Show autumn leaves in September and November, spiderwebs in October, and snow after US Thanksgiving through December. Uses your local date. Turn off for a plain background. Changes apply immediately.

poweronPro.seasonalAnimations

Default Values Scope
true true, false Window

Debug

Show Symitar library debug logs in the PowerOn Pro output channel, marked with [symitar:*]. Changes apply immediately, including active connections and synchronizations.

Protocol traces come from the primary session only, so background workers do not flood the output. Filter for [symitar:connector:poweron] trace to follow that session. In trace 38 +81117ms, 38 is the trace entry number and +81117ms is time since that session's trace began. Credentials are masked, but logs can still contain host and application data; review them before sharing. See Collect connection diagnostics.

poweronPro.debug

Default Values Scope
false true, false Window

Older configuration names

The options above are the currently exposed settings. If you have older settings JSON, review these replacements rather than adding retired keys:

Older option Current setting or behavior
Auto Disconnect Sym poweronPro.idleDisconnect, in minutes; 0 disables idle disconnection.
Auto Validate PowerOn / Offline Validation poweronPro.onSave. Temporary validation and deployment are distinct actions.
Remote Sym Sync Method poweronPro.syncMethod.
Remote Sym SFTP Concurrency poweronPro.sftpConcurrency; default 4, range 1–20.
Semantic Tokens poweronPro.semanticHighlighting.
Individual diagnostic categories poweronPro.diagnostics.enabled and poweronPro.diagnostics.rules.
Batch Queue Selection / Queue Override poweronPro.batch.queue.
SSH Port poweronPro.sshPortOverride.

Auto Associate PowerOn Workspace, CLI Worker Timeout, Fetch Report Timeout, and Report Viewer are no longer exposed as current settings. Do not add their old keys to configure the extension.