All pages
Powered by GitBook
1 of 1

Loading...

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

Controls when your active Sym connection should automatically disconnect.

Default Value
Available Values

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

Batch related configuration options specific to the SSH connection type.

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

Default Value
Available Values

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

Default Value
Available Values

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 setting.

Default Value
Available Values

Controls where batch reports are displayed.

Default Value
Available Values

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

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

Default Value
Available Values

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

Plus Shows incorrect variable assignments and invalid data type declarations as errors for PowerOn files.

Default Value
Available Values

Plus Warns when a constant is reassigned in PowerOn files.

Default Value
Available Values

Plus Shows undefined variables or procedures as errors for PowerOn files.

Default Value
Available Values

Plus Validates operator and operand type compatibility in expressions for PowerOn files.

Default Value
Available Values

Plus Validates field mnemonics against their record types. For example, using a SHARE field mnemonic in a context that expects an ACCOUNT field will be flagged as an error.

Default Value
Available Values

Plus Validates function names and parameter counts. Unknown function names and incorrect numbers of arguments will be flagged as errors.

Default Value
Available Values

Plus Validates FMPERFORM and TRANPERFORM statements, including record type compatibility, allowed operations, TARGETFILE keyword usage, and transaction codes.

Default Value
Available Values

Plus Shows syntax errors detected by the PowerOn parser. These are structural issues in your PowerOn code such as missing keywords, unexpected tokens, or malformed statements.

Default Value
Available Values

Plus Shows unused variables as dimmed for PowerOn files.

Default Value
Available Values

Plus Shows an N references CodeLens above defined variables and procedures.

Default Value
Available Values

Configuration options for the PowerOn code formatter.

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

Default Value
Available Values

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

Default Value
Available Values

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

Default Value
Available Values

Automatically format PowerOn files when saving.

Default Value
Available Values

Number of spaces per indentation level (or tab width when useTabs is enabled).

Default Value
Available Values

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

Default Value
Available Values

Maximum consecutive blank lines to preserve within divisions.

Default Value
Available Values

Maximum line length for PowerOn code before wrapping.

Default Value
Available Values

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

Default Value
Available Values

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

Default Value
Available Values

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

Default Value
Available Values

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

Default Value
Available Values

Use tabs instead of spaces for indentation.

Default Value
Available Values

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

Default Value
Available Values

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

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

Default Value
Available Values

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

Default Value
Available Values

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

Plus Enables analyzer-driven semantic syntax highlighting with distinct tokens for variables, records, fields, procedures, constants, and literals.

Default Value
Available Values

Plus The number of files to download simultaneously when using SFTP sync (used by Remote Syms and Reports).

Default Value
Available Values

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

Default Value
Available Values
  • sftp: Use SFTP for synchronization (no external dependencies required)

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

Configuration options for the Symitar Explorer Reports feature.

Plus Background sync interval in minutes for reports. Set to 0 to disable background syncing.

Default Value
Available Values

Plus Number of days of reports to keep locally synced.

Default Value
Available Values

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
WITH
) always have spaces.

off

off, prompt, or silent

never

never, 1 hour, 4 hours, 8 hours, or 12 hours

off

off or onsave

15

Between 1 and 60

0

Between 0 and 3

first

first, prompt, or override

editor

output, editor, or poweron-pro

30

Between 5 and 120 seconds

false

true or false

false

true or false

true

true or false

true

true or false

true

true or false

true

true or false

true

true or false

true

true or false

true

true or false

true

true or false

true

true or false

false

true or false

false

true or false

false

true or false

false

true or false

1

Between 0 and 8

upper

upper, lower, or preserve

1

Between 1 and 3

80

Between 40 and 200

1

Between 0 and 5

false

true or false

false

true or false

--

Comma-separated list of statement types

false

true or false

false

true or false

[]

List of any local directory paths

--

Any local directory path

true

true or false

upper

upper, lower, or camel

true

true or false

20

Between 1 and 50

sftp

sftp or rsync

5

Between 0 and 60

15

Between 1 and 360

22

Any available port

Auto Disconnect Sym

Auto Validate PowerOn

Batch

Fetch Report Timeout (SSH)

Queue Override (SSH)

Queue Selection (SSH)

Report Viewer

CLI Worker Timeout

Debug

Diagnostics

Data Types

Constant Reassignment

Defined Variables

Expression Validation

Field Validation

Function Validation

Statement Validation

Syntax Errors

Unused Variables

CodeLens References

Formatter

Align Defines

Align Logical Operators

Expand Parentheses

Format On Save

Indent Size

Keyword Case

Max Blank Lines

Print Width

Section Spacing

Space After Delimiter

Space Around Operators

Space Around Operators Exclude

Use Tabs

Uppercase Identifiers

Include Paths

Local Symitar Path

Offline Validation

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

Semantic Tokens

Remote Sym SFTP Concurrency

Remote Sym Sync Method

Reports

Background Sync Interval

Retention Days

SSH Port

Queue Override
Remote Syms