Power Flow Services High Level Messages and Command Line Options
DMSService accepts high level messages for Power Flow data maintenance, model inspection, troubleshooting, and supported study operations. This section also lists its startup options, including emulator startup options. Emulator-specific high level messages are documented separately in the Power Flow Emulator High Level Messages section. Apply the mode and session prerequisites for each command. The common Service and Network Service messages also apply unless DMSService overrides them.
Start the runtime service with -run DMSService before its service-specific options. Configure this launch command in the appropriate system.dat program or instance entry. Startup-option changes require a restart; high level messages are sent to an already running instance.
Send a request to the running service with:
Action any.DMSService <command> [arguments]
Use the configured process name if it differs from DMSService. The service target can contain a wildcard; select the intended service when changing state. Command names are normalized to lowercase; argument case follows the individual command. Output normally appears in the target service log. An acknowledgement can precede completion of the requested operation.
In the syntax below, angle brackets identify required values, square brackets identify optional values, and an ellipsis permits repetition. Enter values without the brackets and preserve the spelling and case shown.
Caution: Consult Oracle Support before first using diagnostic or maintenance commands, particularly in production. Commands can modify data, interrupt processing, or generate substantial output. Use sms-stop for routine service shutdown rather than the deprecated stop message.
DMSService
The common service entries also apply, except where overridden below.
clear_scada
Clear cached SCADA measurement updates.
Use: Oracle Support diagnostics.
Caution: Changes measurement state used by power-flow processing.
consumer_timing [milliseconds]
Report or change the consumer timing threshold. Accepted values are 0 through 300000 milliseconds.
Use: Oracle Support diagnostics.
debug [<level> | <facility> <level> ...]
Set global or facility-level power-flow diagnostics using the common debug syntax. Facility names are case-sensitive.
Use: Oracle Support diagnostics.
Notes: When only FLA is licensed, DMSService mirrors its FLA debug level to FLISR diagnostics.
• DBS: database activity; DELTAS: model deltas; DEMO: demonstration behavior.
• DSE, ESTIMATOR: state estimation; EASI: EaSi engine data.
• EMULATOR: training emulator; FLA: fault location; FLISR, FLISR_DUMPS: restoration and restoration dumps.
• FLM, FLM_DUMPS, FLM_PROGRESS: load-management processing, dumps, and progress.
• FLOW: nominal flow directions; HEARTBEAT: heartbeat processing; JOBS: power-flow jobs.
• LOADPROFILE: load profiles; MATRIX: solver matrices; MBS: model-build interaction; MEASURES: measurements.
• MEMSTATS: memory statistics; MESH: mesh networks; MIPSOLVE, MIPOPF, OPF, MPS: optimizer diagnostics.
• MODEL: model import/build/update; MESSAGES: message handling; PFSOLVE, SCADA_SOLVE: power-flow solves.
• SEGMENT: island rebuilding; SOLUTION_DETAILS, SOLUTION_DETAILS_DBS: solution details; SOLVE: topology solves.
• SS, SS_DUMPS: Suggested Switching and its dumps; STATS: statistics; TIMING: function timing.
• VV, VV_RT_SUMMARY: Volt/VAr processing and summaries; NCA: contingency analysis.
• DERMS: DER management; UC: unit commitment; REST: REST interface; PROTECTION_SCHEMES: protection processing; CHECK_ISLANDS: island checks.
Example:
Action any.DMSService debug FLISR 2 PROTECTION_SCHEMES 2 MESSAGES 1
dse_what <device>
Print Distribution State Estimation results for a device.
Use: Oracle Support diagnostics.
dump [resource] [arguments]
Print power-flow state. With no resource, print configuration rules.
• measures \[emulator|emu\]: SCADA measurements in real-time or emulator context.
• memstats, threadstats: memory or thread statistics.
• derms: DERMS and weather-zone information.
• nsm \[session\]: network-state-manager statistics.
• island \<handle\>, feeder \<handle\>: island or feeder contents.
• flows \<handle\>: nominal feeder flows.
• feederstatus: feeder status.
• profile \<device\>: shared-memory load profile.
• island_info \<device\>: shared-memory island solution.
• locks, tasks: synchronization or task diagnostics.
dump_model <device> [session] [dse]
Write a topology/model dump for the island containing a device. The optional dse mode also runs state estimation.
Use: Oracle Support diagnostics.
Caution: Performs a model solve while holding the selected session lock and can create substantial diagnostic output. Processing may be delayed. Use under Oracle Support direction.
Notes: Acknowledgement precedes device validation and the solve. Check the target log for the selected island/session, missing devices, unavailable DSE, and solve diagnostics. For the current MIP engine, replay artifacts are written below replay_runs/\<timestamp\>_\<source\>_\<caller\>_run_\<number\> relative to the service working directory; normal and DSE callers are named DumpModel and DumpModelDSE. If replay-directory creation fails, the engine falls back to timestamped filenames in the working directory. Additional OpenDSS output is controlled by dump_opendss. The dump flag is reset after this solve; no persistent dump mode is enabled.
• device: a valid object handle or alias. The handler selects the first island source associated with it, rather than dumping every source.
• session: numeric session ID, default 0 (real-time). Standard sessions are 1 (tracking), 2 (nominal), and 3 (emulator). Use only sessions initialized in this environment; session 3 requires the emulator.
• dse: optionally run state estimation instead of the normal power-flow solve. The DSE license and an available solution engine are required.
Example:
Action any.DMSService dump_model <device-handle> 0
Action any.DMSService dump_model <device-handle> 0 dse
dump_opendss [0|1]
Include OpenDSS output with model dumps. Omit the value to toggle the setting.
Use: Oracle Support diagnostics.
dump_slow_islands <seconds>
Dump islands whose solves exceed the threshold. Use 0 to disable dumps; other values below 2 are raised to 2 seconds.
Use: Oracle Support diagnostics.
feeder_ca <start [minutes]|stop>
Start N-1 feeder contingency analysis for the requested duration, or stop the analysis.
Default: 60 minutes when start has no duration.
feeder_da <start [minutes]|stop>
Start feeder data analysis for the requested duration, or stop the analysis.
Default: 60 minutes when start has no duration.
flisr <subcommand> [arguments]
Inspect or control Fault Location, Isolation, and Service Restoration.
Prerequisites: FLISR license.
Caution: Changing mode, device availability, or rerunning an event affects FLISR operation. Use only under the approved operating procedure.
• status: report FLISR operating status.
• dump: print FLISR state.
• alarms: generate daily reminders for disabled devices.
• ties: generate the tie summary.
• mode \<disable|manual|auto|automatic\>: select the system-wide FLISR mode.
• device_disable \<device_handle\> \<user\>: disable a device for FLISR processing.
• device_enable \<device_handle\> \<user\>: enable a device for FLISR processing.
• enable_violations or disable_violations: change generation of FLISR violations.
• rerun \<device\> \<event\>: rerun analysis for the specified tripped device and event under Oracle Support direction.
• kva_tolerance: deprecated; configure flisrKvaTolerance in SRS rules instead.
• base_flows and check: deprecated; report deprecation only.
flisr_threads [count]
Acknowledge and log a requested background-thread count. The current handler does not apply the count.
Status: Obsolete.
Notes: Do not rely on this command to reconfigure thread pools.
flm <subcommand> [arguments]
Inspect or control Feeder Load Management forecasting.
Prerequisites: FLM license.
• reforecast \[handle ...\]: rerun future forecasts, optionally scoped to devices or feeders. Supplied but invalid handles do not trigger an unrestricted forecast.
• kvaforecast: rerun future kVA forecasts.
• hourlyTimer: execute top-of-hour tasks. Preserve the capital T.
• stop or start: disable or enable forecasting.
• status: return 1 only when FLM is licensed and forecasting is enabled; otherwise return 0.
• islands: print islands and feeders.
• rdbms: print forecast database details.
force_derms_event_removal
Cancel active DERMS events and associated switching sheets.
Use: Oracle Support diagnostics.
Caution: Changes active events and switching sheets.
force_derms_forecast <objective_name>
Run the DERMS optimizer for the named objective using the cyclic trigger path.
Use: Oracle Support diagnostics.
force_derms_realtime <objective_name>
Run the DERMS optimizer for the named objective using the device-operation trigger path.
Use: Oracle Support diagnostics.
force_doe <all|upper|lower>
Run the DERMS Dynamic Operating Envelope optimizer for both limits or the selected limit.
Use: Oracle Support diagnostics.
grid_derms_scada_points_changed <group_id>
Reload the target SCADA association cache for one DER group.
Use: Oracle Support diagnostics.
grid_derms_vpp_changed
Invalidate the Grid DERMS virtual power plant runtime cache before the next VPP-aware solve.
Use: Oracle Support diagnostics.
help
Print the available power-flow diagnostic command help to the service log.
Aliases: commands.
island_report
Print a status report of island solutions.
locking_timing [milliseconds]
Report or change the lock timing threshold. Accepted values are 0 through 300000 milliseconds.
Use: Oracle Support diagnostics.
messagestat <print|reset>
Print DMSService message-processing counters or reset them to zero.
nominal_flows <device>
Print nominal flow and topology information for the selected device.
Use: Oracle Support diagnostics.
np_emulate [on|off|0|1]
Enable or disable Network Protector emulation. With no recognized mode, toggle the current mode.
Use: Oracle Support diagnostics.
process_der_management_update
Reload GRID_DERMS_MANAGEMENT and clear schedules that no longer match management configuration.
Use: Oracle Support diagnostics.
process_dms_feeders
Reload DMS feeder-status configuration.
process_protection_schemes
Reload protection-scheme mappings.
processcatalogs
Reload device-rating catalogs.
processintervaldata
Reload load and distributed-generation interval/profile data.
prot_scheme <device>
Force a protection-scheme check for the feeder containing the device.
Use: Oracle Support diagnostics.
Notes: PFS_DEBUG builds have a separate derived diagnostic handler.
purge_fca
Delete existing Feeder Contingency Analysis results.
Caution: Removes saved FCA results.
purge_fda
Delete existing Feeder Data Analysis results.
Caution: Removes saved FDA results.
recache_measures
Recache SCADA measurements.
Use: Oracle Support diagnostics.
refactor [on|off|0|1]
Change solver refactor mode; omit the value to toggle it.
Use: Oracle Support diagnostics.
reload
Reload power-flow configuration rules.
Aliases: reload_rules.
reload_op_count
Reload regulation-device operation counts.
reload_tftypes
Reload transformer-type configuration.
reset_dgs
Clear temporary distributed-generation conditions.
Use: Oracle Support diagnostics.
resolve [device_handle|alias]
Resolve the current power-flow solution, optionally restricted to the selected device island.
Use: Oracle Support diagnostics.
show_scada <device> [session]
Print cached SCADA measurements for a device in the selected session.
Notes: Prints cached measurements in the DMSService log for the selected device/session, or No measurements if that cache is empty. It does not poll the field SCADA system. Acknowledgement precedes lookup/output; an invalid device produces no measurement dump.
• device: valid object handle or alias.
• session: numeric session ID, default 0 (real-time); 1 is tracking, 2 nominal, and 3 emulator. Select an existing initialized session; emulator context requires the emulator.
Example:
Action any.DMSService show_scada <device-handle> 0
solve_island <device> [kva|mipkva|dse|fla] [arguments]
Solve the island containing the specified device.
Use: Oracle Support diagnostics.
Caution: Runs a solution while holding real-time and tracking session locks. It can delay other processing and changes solution results rather than merely reporting them. Use under Oracle Support direction.
Notes: Acknowledgement precedes validation and completion. Consult the DMSService log for Starting and Completed solve messages and the solution result. Successful non-FLA solves update capacities and violations; normal/DSE operation can also record solution details. FLA uses tracking state, while the other modes use real-time state.
• device: valid object handle or alias with an island source. The handler selects the first source associated with the device.
• No mode: use the normal solution engine on the real-time island. kva: use the legacy engine. mipkva: use the current MIP engine.
• dse \[user\]: run state estimation on the real-time island, optionally associating solution details with the supplied user. Requires the DSE license and an available engine.
• fla \<fault_type\>: solve the tracking-session island for one of SLG_A, SLG_B, SLG_C, LL_AB, LL_BC, LL_CA, DLG_AB, DLG_BC, DLG_CA, or TLG_ABC. Prints fault currents and enables model dumps for that solve.
Example:
Action any.DMSService solve_island <device-handle> dse
Action any.DMSService solve_island <device-handle> fla SLG_A
solve_unit_commitment <group_id> <target_kw> <num_forecasts>
Run DERMS unit commitment for a DER group and write a CSV result. The short form uses the default 24-hour horizon.
Use: Oracle Support diagnostics.
Notes: Acknowledgement precedes solving. Inspect the service log for solve status, warnings, and the CSV file path.
• Explicit horizon: solve_unit_commitment \<group_id\> \<target_kw\> \<start_time\> \<end_time\> \<num_forecasts\>.
• Named form: solve_unit_commitment group_id=\<id\> target_kw=\<kw\> \[start_time=\<epoch\>\] \[end_time=\<epoch\>\] num_forecasts=\<count\>.
• Times are epoch seconds. target_kw is a flat target expanded over the forecast intervals.
stop
Stop DMSService.
Status: Deprecated.
Caution: Use sms-stop for routine shutdown.
toggle_dump_island <device> [on|off|0|1]
Change automatic solve dumps for the island source. Omit the mode to toggle it.
Use: Oracle Support diagnostics.
validate_island <device>
Validate the island containing the device.
Use: Oracle Support diagnostics.
validate_network force
Validate the entire power-flow model.
Use: Oracle Support diagnostics.
Caution: Can make the system unavailable for many minutes. The force argument is required.
vvo_current
Initiate the Volt/VAr current (fast-cycle) execution.
Use: Oracle Support diagnostics.
vvo_hourly
Initiate the Volt/VAr hourly (slow-cycle) execution.
Use: Oracle Support diagnostics.
vvo_update_plan <event_handle>
Force an update of the specified Volt/VAr plan.
Use: Oracle Support diagnostics.
watchdog_enabled <0|1>
Enable or disable the DMSService resource watchdog for excessive mutex and lock holds.
Default: Disabled.
Caution: Enabling monitoring adds diagnostic bookkeeping and can affect performance.
Notes: Exactly one value, 0 or 1, is required. Invalid input is rejected. A transition from disabled to enabled starts a fresh monitoring interval; repeating the current state has no effect.
watchdog_limit_time <seconds>
Set the excessive lock-hold threshold to a positive integer number of seconds.
Default: 60 seconds.
Notes: Exactly one positive integer is required. The watchdog polls every 5 seconds; this threshold does not release locks or change their timeout.
watchdog_silent_time <seconds>
Set the minimum interval between resource-watchdog diagnostic batches to a positive integer number of seconds.
Default: 120 seconds.
Notes: Exactly one positive integer is required. Reports include lock diagnostics. DMSService starts nms-get-process-info --no-isis-dump --live-stack asynchronously and writes processdump-DMSService-\<pid\>.\<timestamp\>.log in its working directory. A running collector prevents another collector from being started concurrently.
Network Service Messages
These messages apply to MTService and DMSService, in addition to the common service messages. Service-specific messages take precedence.
dump_caches [filename]
Write network caches to a diagnostic file.
Use: Oracle Support diagnostics.
dump_network force
Print the entire real-time electrical network.
Use: Oracle Support diagnostics.
Caution: The model is locked during output. Processing can be unavailable for many minutes; force is required.
study_what [session] <handle|alias> [handle|alias ...]
Print topology information in the selected study session. With one device argument, use the tracking session. Invalid or unknown session IDs fall back to tracking.
what <handle|alias> [handle|alias ...]
Print real-time topology information for the listed devices.
Command-line options are supplied when a service starts, usually through the program or instances entries in system.dat. Restart the affected service to apply changed startup options. Angle brackets identify required values; square brackets identify optional values; an ellipsis permits repetition. Preserve the spelling and case shown, especially argument values.
DMSService Command Line Options
The common service entries also apply, except where overridden below.
--emulator
Enable the training measurement emulator.
Use: Oracle Support diagnostics.
Caution: Use in the intended training/test environment.
Notes: Use the double hyphen exactly as shown. Put normal DMSService-specific options before --emulator and emulator-specific options after it; the emulator changes subsequent option dispatch.
-allowAutoFlisrStartup [delay_minutes]
Allow FLISR to enter automatic mode after the startup delay when the configured mode is auto or automatic.
Default: Automatic startup disabled; when enabled without a delay, use 10 minutes.
Prerequisites: FLISR licensing and a configured automatic FLISR mode.
-authorization <value>
Set the authorization value for the emulator REST interface.
Use: Oracle Support diagnostics.
Prerequisites: --emulator must precede this option. Required when -url is supplied.
-db_emulation
Use database-based emulation rather than file-based emulation.
Use: Oracle Support diagnostics.
Prerequisites: --emulator must precede this option.
-dumpDetails
Include OpenDSS files when a solve requests model dumps.
Use: Oracle Support diagnostics.
-flisrCopyOnReset
Reset FLISR using a copy of the real-time network state in tracking.
Use: Oracle Support diagnostics.
-inputDir [directory]
Set the directory where the emulator writes measurement/control files for RTAdapter.
Use: Oracle Support diagnostics.
Default: $NMS_SCADA_SCAN_FILE_DIR.
Prerequisites: --emulator must precede this option.
-modelCheck
Load and check model/configuration, then exit without normal service operation.
Use: Oracle Support diagnostics.
-no_alarms
Suppress system alarms generated by Feeder Load Management for abnormal feeder conditions.
Default: Alarming enabled.
-no_doe_forecast
Disable automatic DOE forecast generation in the emulator.
Use: Oracle Support diagnostics.
Prerequisites: --emulator must precede this option.
-no_nca_forecast
Disable automatic NCA forecast generation in the emulator.
Use: Oracle Support diagnostics.
Prerequisites: --emulator must precede this option.
-outputDir [directory]
Set the directory scanned for inbound RTAdapter controls.
Use: Oracle Support diagnostics.
Default: $NMS_ROOT/scada_out.
Prerequisites: --emulator must precede this option.
-refactor
Enable solver refactor mode at startup.
Use: Oracle Support diagnostics.
-restfulTarget <host:port>
Set the emulator REST destination host and port.
Use: Oracle Support diagnostics.
Prerequisites: --emulator must precede this option.
-run DMSService [options]
Select normal DMSService operation in the service launcher.
Prerequisites: -run must be the first argument after the executable; DMSService is the following mode token. Put service options after that token.
Caution: The top-level executable does not implement -help. Startup initializes shared state before mode dispatch, and an invocation without the required mode can terminate its process group.
Example:
DMSService -run DMSService -no_alarms -dbname dms --emulator -scadaId RTAdapter -inputDir ${NMS_SCADA_SCAN_FILE_DIR} -outputDir ${NMS_ROOT}/scada_out
-scadaId [name]
Select the RTAdapter identifier whose devices are emulated.
Use: Oracle Support diagnostics.
Default: RTAdapter when specified without a name.
Prerequisites: --emulator must precede this option.
-timeOffset <seconds>
Set the emulator time offset from the absolute numeric value.
Use: Oracle Support diagnostics.
Prerequisites: --emulator must precede this option.
-url <path>
Set the emulator REST request path.
Use: Oracle Support diagnostics.
Prerequisites: --emulator must precede this option; supply -authorization.