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.
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. |
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:
{
"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. |
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 |
Print Width
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 |
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.