Technical Description

WINMAG plus

SIAS – Overview of Commands

P03126-15-0G0-02
Subject to change
2011-02-16 without notice
2 SIAS Overview of Commands - WINMAG plus
SIAS Overview of Commands - WINMAG plus 3

Contents

SIAS-Editor
SIAS syntax
SIAS commands
Alarm types
Comments
Operators
Controls
Variables
Assistants
Terms

This document is based on the SIAS Online Help, that you can call by pressing the function key 1 or the menu
„Help / Help Topic “ in the SIAS editor.

SIASEDIT is an editor to create and manage SIAS programs.

SIASEDIT is based on the Microsoft Wordpad Editor and now includes special functions (insertion of SIAS
commands, assistants, translation of SIAS programs).

SIAS programs are user-specific programs that run within the WINMAGplus hazard management system.
These programs can be executed when events occur (e.g. faults, alarms), per time order, manually from lists or
via References with symbols.

WINMAGplus is a modular control centre program for hazard detection systems.

WINMAGplus enables comfortable, PC-supported operation and control of connected alarm systems with
individual message evaluation, alarm signaling and message editing.

SIASEDIT edits files with the extensions .eff and .efm

Compilation (Menu BUILD/COMPILE) results in .wxe / wxm – files, that can be edited with WINMAG and
WINMAGplus.

General

Program versions:
Program types

Standard programs in the action window with the extensions .eff / .wxe
Popup programs in windows of a defined size with the extensions .eff / .wxe
Macros (=background programs) with the extensions .efm / .wxm
4 SIAS Overview of Commands - WINMAG plus

SIAS Editor
The SIAS editor supports the operator when creating user-specific sequences.

General:
All user-specific sequences and trigger off conditions are filed in the run time files in the sub-directory
"WINMAGEX".
The basis are RTF files, that can be edited by the SIAS editor.
These files may contain SIAS commands, formatted texts, graphics, other objects, e.g. sounds....

All SIAS commands are enclosed in '<<<' and '>>>'. These are automatically set when new commands are
inserted and may include several lines (e.g. in the file "ausbed.eff").

Trigger off conditions can also be found in the run-time file. The name at the time of delivery is already defined as
"ausbed.eff / .wxe”.

Creating a program:
A WINMAGplus program is created via the SIAS editor by:

1 Creating a program file in the SIAS editor via File/New

2 Editing the program file using existing files or the menu item "INSERT"

Virtually all SIAS commands are contained in "INSERT". In the event of more complex commands, entry is
supported by assistants (e.g. in the command "call", the assistant queries the corresponding program names in
the menu).

3 Creating an active WINMAG file via the menu "BUILD"

By selecting the menu item "Compile", the code is checked and translated.
If faults are detected, fault messages are displayed and an active file is not created. After successful translation,
the source file and the run-time file are filed in the WINMAG sub-directory "WINMAGEX".
The source file has the extension ".eff", for macros ".efm"
The run-time file has the extension ".wxe", for macros ".wxm"
SIAS Overview of Commands - WINMAG plus 5

SIAS Syntax
SIAS commands are an integral part of WINMAG program files that are saved in the editing form as RTF files.

SIAS command are marked by 3 characters to distinguish from normal texts.

<<< SIAS command .... >>>

The >< characters can set at the beginning and end of one or several lines.
>> must also appear in front of a Non-SIAS command (e.g. formatted text) to denote the end of the command

Example:
This line is a text
<<< beep
call (detector name) >>>
This line is a text again

Syntax description
SIAS commands appear without the enclosing characters at the beginning and end as follows:

SIAS command name with parameters

Description of required parameters
Description of command in text form.
Example for correct syntax with explanation
Referrals to similar commands

Optional commands are enclosed in square brackets ("[" "]"), alternatives are marked by a vertical line (" |" ).
e.g. var data type variable name
[= (Value | System variable | Variable name)]

Sequence of key words

The implemented SIAS commands are listed in alphabetical order and briefly explained.
If parameters are required, they will be listed under parameters, references refer to similar commands or
commands that are related to one another.
In the event of commands including parameters, an example will be given.

All commands are in English to facilitate recognition in the program sequence.

Controls
In addition to texts and SIAS commands, a SIAS file can also contain "Components". These are embedded
independent programs that have their own functionality and that communicate with the SIAS application.
6 SIAS Overview of Commands - WINMAG plus

Program types
Programs can run in different modes:

- Standard program in the program window

The entire scope of WINMAG is used for representing the program and can also be used for representing texts
and graphics.
An entry in the stack of orders is included for every program. The execution of the program is subject to stack
control that can also be influenced manually.
A maximum of 10 programs can be edited simultaneously.

{bmc ~tmpbit.bmp}%Alarmprogramm Alarm program%Alarmprogramm

- Popup program in own window
A popup program appears in its own window and when started has a width and height in pixels.
Only one popup program can be displayed.
The program is executed immediately and is not subject to stack control.
Open popup windows are closed when a new popup window is opened.

- Macro in the background without window

A macro runs in the background without a window. As no other window is displayed, no outputs can be made
directly on the screen.
A macro is not subject to stack control, it is executed immediately after invoking.
A random number of macros can be executed simultaneously.
For editing purposes the SIAS editor compiles the macros in a separate category. The source files have the file
extension .efm, the files that can be executed, the file extension .wxm.

Special programs:
ausbed.eff
Contains the executing/triggering conditions and one-time assignment.
The file is automatically started by WINMAG and runs as a loop similar to a macro. The program monitors the
networks and reacts to incoming messages.

alarm.eff
Standard alarm program that represents an application example for command commands. A copy of the delivery
file exists under alarm_original.

manual.eff
Program with the list of programs that can be started manually

zeit.eff
Program with the programs that have to be started with time argument

toolhandlerx.efm (x = 1 to 10)
Macro that is executed when the tool function is selected via menu or button.

dtmf_menu.eff
Contains the menu structure for DTMF operation
SIAS Overview of Commands - WINMAG plus 7

Database
WINMAGplus employs different Microsoft Access databases.
The two most important databases are:

The system database with the name WINMAG.MDB.

It contains all system data and user-defined data, e.g.:
Network data
Object data
I/O points
I/O point types
Symbol descriptions
Tree structure
Operator data
Alarm types

The protocol databases with the name WINMAGPRjjmmtt.MDB.

They contain system protocol inputs.

The databases do not contain:

WINMAG flow chart programs
Program flow logs
Drawings
Layer images
8 SIAS Overview of Commands - WINMAG plus

SIAS commands – alphabetical list

ack
act_utc_time
alarm_reason_counter
alarm_type_counter
autoclose
back_color(R,G,B)
beep
bell
call(program/variable)
call_macro(macroname)
cascade
check_notification_ack(id)
check_notification_sent(id)
cls
confirm"text"
dec variable[(wert)]
delay_ms(msec)
delay(sec)
disable "net","obj_name","mp_name","state_name"
disable_layer_by_id
disable_layer_by_name
dismanual"text"
display
display_image ("zeichnung"[,zoom)
display_rtf
dtmf_menu(name, on_key_1()"text")
email_notification(to,supject,message)
enable
enable_layer_by_id
enable_layer_by_name
exec (program,prio[,typ])
exec_autoclose (program,prio[,typ])
exec_default_prog
exec_macro (macroname)
exec_popup_prog (programm)
exit
fax_notification(telephone,message)
file_append
file_delete
file_exists
file_read
file_read_line
file_write
find
finish
finish_at_change(prio)
freeze_controls
generate_wav_file
get_fkt_nr
get_graphic_text
SIAS Overview of Commands - WINMAG plus 9

get_graphic_xpos
get_graphic_ypos
get_integer wert
get_mp_nr_from_id
get_mp_text_data
get_obj_nr_from_id
get_parent_picture_id
get_playbacktime
get_system_property
gettime"text"
hardcopy(Nr,Drucker)
has_popup_alarm_parameter
if (Bedingung) then...else...endif
inc variable[(wert)]
insert
is_message_in_stack
is_message_removed
is_mp_in mandant
left_substring(string,separator)
length
lock_tile_off
lock_tile_on
login
logout
manual(program,prio,typ,"text"[parameter])
maximize
maximizepicture(nr)
maximizeprog
message ("text",Nr)
minimize
mp_exists
newpage
on_close_exec_macro(macro)
on_control_exec_macro(variable,macro)
on_open_exec_macro(macro)
pager_call
parent_var typ name [=wert]
picture(Nr[,"Name"/ID])
picture_id
popup_autoclose
popup_pin
popup_pin_parent
popup_pos(x,y)
popup_size (x,y)
print_graphic
priority (wert)
prog_width (wert)
prot_off
prot_on
put_graphic_pos(mp,x,y)
put_graphic_text
put parameter
10 SIAS Overview of Commands - WINMAG plus

reload_database
remove
replace
replace_in_page
reply"text"
report
restart_driver
right_substring
run("program","parameter")
run_no_window("program","parameter")
screenshot
search parameter
search_alarm_reason (nr)
search_alarm_type (nr)
seek "net","obj_name","mp_type_name","state_name"="fkt_name"
seek_alarm_reason (nr)
seek_alarm_type (nr)
send_prog_to_group
send_prog_to_station
set_control_text
set_title_popup
simulate
simulate_text
simulate_value
single_symbol_on/off
sms_notification(telephone,message)
sound"Name"[,loop]
speak (message)
stack_color(R,G,B)
substring
system_var typ name [=wert]
tile
tilepicture
top
url(Adress)
url_secure[(mp_nr)]
use_popup_alarm_parameter
var typ name [=wert]
voice_channel(name,menu)
voice_notification(telephone,message)
wait(min)
waitforkey
winmag_exit
while (bedingung) ... endwhile
word_wrap_off
word_wrap_on
SIAS Overview of Commands - WINMAG plus 11

SIAS commands

ack
"ack" changes the status of the program from "in Arbeit" to "quittiert, in Arbeit".
This status change affects:
Status information in the stack overview
Flashing symbols and image links.
Whether symbols and relevant image links continue to flash after acknowledging can be set in the WINMAGplus
system configuration.

Example:
<<< ack >>>
SIAS commands – alphabetical list

act_utc_time
Returns the time as seconds elapsed since midnight, January 1, 1970, or -1 in the case of an error.

Example:
<<< var integer TestInteger >>>
<<< TestInteger = act_utc_time >>>

alarm_reason_counter(alarm reason number)

Query of internal Alarm reason counter.
The query is answered by a numerical value.

Required parameter:
Alarm reason number = Number of the queried alarm reason
The alarm reasons assigned to the current function values are counted.
Only initialized I/O points are taken into account.

Examples:
<<< var integer ausgeloeste_Melder >>>
<<< var integer Brandalarme >>>
<<< ausgeloeste_Melder = alarm_reason_counter(23) >>>
<<< Brandalarme = alarm_reason_counter(10)+ alarm_reason_counter(11)+ alarm_reason_counter(100)+
alarm_reason_counter(101)+ alarm_reason_counter(102)+ alarm_reason_counter(103)>>>

1. The contents of the counter for Alarm reason 23 (=reason) is assigned to the variables "ausgeloeste_Melder".

2. The total of various alarm reason counters is assigned to the variables "Brandalarme".

References:
Alarm reasons
SIAS commands – alphabetical list
12 SIAS Overview of Commands - WINMAG plus

alarm_type_counter(alarm type number)

Query of the internal Alarm type counter.
The query is answered by a numerical value.

Required parameter:
Alarm type number = Number of the queried alarm type

The alarm reasons of an alarm type assigned to the current function values are counted.
Only initialized I/O points are taken into account.

Examples:
<<< var integer typ_Brand >>>
<<< var integer typ_Einbruch >>>
<<< typ_Brand = alarm_type_counter(1) >>>
<<< typ_Einbruch = alarm_type_counter(2) >>>

1. The contents of the counter for alarm type 1 are assigned to the variables "typ_Brand".

2. The contents of the counter for alarm type 2 are assigned to the variables "typ_Einbruch".

References:
Alarm reasons
alarm_reason_counter
SIAS commands – alphabetical list

autoclose
Closes an alarm program undergoing execution via stack control.
To immediately close when resetting the reason, the command must already have been executed at the time of
resetting.

Required parameters: None

Examples:
...
<<< autoclose >>>
...
<<< waitforkey >>>

The program is closed, as soon as the reason is no longer impending / is reset.

References:
exec autoclose(program,prio[,typ])
alarm_reason_counter ......................
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 13

back_color(R,G,B)
Sets the background color of a program window by entering the color values

Required parameters:
R (Red value) in the range 0 - 255
G (Green value) in the range 0 - 255
B (Blue value) in the range 0 - 255

Examples:
<<< back_color(255,0,0) >>>
sets the program background at red

References:
stack_color(R,G,B)

SIAS commands – alphabetical list

beep
Continuous signal output. The signal is stopped by
- activating the sound-off button
- activating a button
A sound card is required to output the signal, as the sound is often unsatisfactory due to the system acoustics.

Examples:
<<< beep >>>

References:
bell
sound
SIAS commands – alphabetical list

bell
Brief signal lasting approx. 1 second.
A sound card is required to output the signal.

Examples:
<<< bell >>>

References:
beep
sound
SIAS commands – alphabetical list
14 SIAS Overview of Commands - WINMAG plus

call(Program / Variable)
Call of a sub-program

Required parameter alternatives:

Program = Name of an SIAS program without extension
Variable = Name of a defined SIAS variable
An SIAS program can call any further SIAS programs.
The called SIAS program is executed as part of the called program using "call",
It does not create its own stack input or its own protocol inputs.

The following can be used as parameters

- the name of an SIAS program
- a SIAS variable, e.g. mp_name, state_name, state_nr ...
- a self-defined string variable

If the stated program cannot be found, a fault message appears in the text window stating the file name that has
not been found.

Examples:
<<< call (melderna)>>>
calls an SIAS program with the name "Melderna.wxe"
<<< call (mp_name)>>>
calls as SIAS program with the name of the value contained in the variable mp_name, e.g. "Gruppe1.wxe"

References:
exec
run
SIAS commands – alphabetical list

call_macro(macroname)
Calling a macro as a part of a running program.

Required parameters :
Macroname = Name of a SIAS-macro
A SIAS-programm may call a SIAS-macros.
With "call_macro" the called SIAS-macro will runn as a part of the running program.
It does not create its own stack input or its own protocol inputs.

If the stated program cannot be found, a fault message appears in the text window stating the file name that has
not been found.

Example:
<<< call_macro(ausbed_macro)>>>
ruft das SIAS-Makro mit dem Namen "ausbed_macro" auf

References:
exec
run
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 15

cascade
Command for screen designing
The windows opened in WINMAG plus are cascaded, so that the header and right edge are visible.
By clicking the header, the relevant window in the stack of windows is placed on top of the stack and is thus visible.

Required parameters: - None

Examples:
<<< cascade >>>

References:
maximize
maximizeprog
maximizepicture(nr)
minimize
tile
tilepicture
SIAS commands – alphabetical list

check_notification_ack(id)
Answers with "true", if the notification message was acknowledged with the stated ID
Acknowledgement is made either via Esafetynet, DTMF signals or the SIAS command ack_notification(id).

Required parameters:
id = Identification number of the notification message

Examples:
<<< var integer notification_id >>>
<<< system_var string Ziel >>>
<<< notification_id = sms_notification (Ziel, alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>>
<<< delay(50)>>>
<<< if check_notification_ack (notification_id) then >>>
...
<<< endif >>>

sends a message composed of event-related variables to a global telephone number defined under Ziel. After 50
seconds the message is checked for acknowledgement.

Reference:
check_notification_sent(id)
fax_notification(telephone,message)
sms_notification(telephone,message)
voice_notification(telephone,message)
SIAS commands – alphabetical list
16 SIAS Overview of Commands - WINMAG plus

check_notification_sent(id)
answers with "true", if the notification message with the stipulated ID was sent.
Required parameters:
id = Identification number of the notification message
Examples:
<<< var integer notification_id >>>
<<< system_var string Ziel >>>
<<< notification_id = sms_notification (Ziel,alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>>
<<< delay(5)>>>
<<< if check_notification_sent (notification_id) then >>>
...
<<< endif >>>
sends a message composed of event-related variables to a global telephone number defined under “Ziel”. After
5 seconds the message is checked to acknowledge dispatch.
References:
check_notification_ack(id)
fax_notification(telephone,message)
sms_notification(telephone,message)
voice_notification(telephone,message)
SIAS commands – alphabetical list

cls
A new page of the text window is started. On the previous page the program control bar can be reached by clicking
the red "zurück" arrow.
Required parameters: - None

Example:
<<< cls >>>

References:
Newpage
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 17

confirm "Text"
Yes / No – show request dialogue
Required parameters:
"Text" = the stipulated text is displayed as a question text in the dialogue window.
{bml CONFIRM.BMP}
In the example, the text "Meldung rückstellen ?" was inserted.
The operator can only exit the dialogue by selecting either the button "Yes" or "No".
The answer can be queried in an if-command.
Question text and answer are logged.

Examples:
<<< confirm "Geht es Ihnen gut ?" >>>
<<< if (confirm "Meldung rückstellen ?") then ...>>>

References:
if (condition) then...else...endif
waitforkey
SIAS commands – alphabetical list

dec variable [(Wert)]

Decreases the Integer-"variable" by "Wert"

Required parameters
Variable = Name of the variables defined in the program
Value = numerical value [optional]
The function can only be used for integer variables
If no "Value" is stipulated, the command uses the value 1

Examples:
<<< var integer counter >>>
counter is defined with the value 0
<<< dec counter
decreases the counter by 1, counter now has the value 1
<<< dec counter (5) >>>

decreases the counter by 5, counter now has the value 6

References:
inc variable[(wert)]
Variablen
var typ name[=wert]
SIAS commands – alphabetical list
18 SIAS Overview of Commands - WINMAG plus

delay_ms(msec)
Interrupts the program flow for "msec" milliseconds

Required parameters:
msec = stipulated waiting time in milliseconds
Value range 1-100000 milliseconds
The delay_ms command interrupts the program execution for the stipulated number of milliseconds. By activating
the „Weiter-arrow“ or the enter key, the waiting time can be shortened.
During the waiting time, the program remains visible on the screen.

Examples:
<<<delay_ms(500)>>>
waits 500 milliseconds (=1/2 second) for the program to continue

References:
delay(sec)
wait(min)
waitforkey

SIAS commands – alphabetical list

delay(sec)
Interrupts the program flow for "sec" seconds

Required parameters:
sec = stipulated waiting time in seconds
Value range 1-1000 seconds

The delay command interrupts the program execution for the stipulated number of seconds. By activating the
„Weiter-arrow“ or the enter key, the waiting time can be shortened.
During the waiting time, the program remains visible on the screen.

Examples:
<<<delay(2)>>>
waits 2 seconds for the program to continue

References:
delay_ms(msec)
wait(min)
waitforkey

SIAS commands – alphabetical list

SIAS Overview of Commands - WINMAG plus 19

disable "net"::"obj_name":"mp_name"."state_name"
Disable transmission of a state from the terminal device via the network

Required parameters:
net = Network name
obj_name = Object name
mp_name = I/O point name
state_name = state name
The transmission of data can be influenced by "Filters". The data that requires transmitting by the terminal device
can be determined during initialization down to state level.
The command "disable" enables an activated transmission to be disabled and the filter reactivated.
Thus the number of messages in the network can be influenced.

Example:
<<< disable "IGIS Netz 1"::";MB 100":"PIR Haupteingang"."Zustand" >>>
deactivates the transmission of the physical state of the PIR main input port.
Alarms continue to be transmitted

References:
enable "net","obj_name","mp_name","state_name"
SIAS commands – alphabetical list

Disable_layer_by_id
Disabling of the graphic layer with the stipulated ID during the run time of the SIAS program

Required parameters:
ID of the layers
An enabled graphic layer can be disabled for a specific time or during the entire run time of the SIAS program
using this command.

Examples:
<<< disable_layer_by_id (Id) >>>

References:
Disable_layer_by_name
Enable_layer_by_id
Enable_layer_by_name
SIAS commands – alphabetical list
20 SIAS Overview of Commands - WINMAG plus

Disable_layer_by_name
Disabling of the graphic layer with the stipulated name during the run time of the SIAS program

Required parameters:
Name = Name of the layer
An enabled graphic layer can be disabled for a specific time or during the entire run time of the SIAS program
using this command.

Example:
<<<< disable_layer_by_name ("Name") >>>

References:
Disable_layer_by_id
Enable_layer_by_id
Enable_layer_by_name
SIAS commands – alphabetical list

dismanual (“Program name”)

Cancels the definition of an SIAS program that can be started manually

Required parameters:
"Text" = Character chain that was employed to define a manual program.

Examples:
<<< dismanual("Brandmeldezentrale 664 stoppen") >>>

Cancels the definition of the manual program with the input "Brandmeldezentrale 664 stoppen".

References:
manual
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 21

display “string”,variable,text.txt
Display of text, variables or text files within a message program.
A display command can contain several parameters that are separated by a comma.
Character chains must be enclosed in quotation marks (e.g. "Alarm !").
Character chains can also be written in the SIAS file outside a SIAS block (<<<,>>>).
The following can be used as variables
- All SIAS variables, e.g. mp_name, time,...
- Variables defined in the program e.g.var integer Alarme)
- I/O points Meldepunkt as e.g. "Network"::"Object":"I/O point"."State" or
mp_name."State" as a special form with set message parameters.
Text files must be filed in the WINMAG sub-directory " TEXT". The file must have the extension ".txt". If you
wish to call the file, do not add quotation marks or the path.

Texts cannot be formatted in the display instructions. The text format depends on the last format stipulated before
the display command.
The format determines:
- Font (e.g. ARIAL)
- Font size (e.g. 12)
- Character type (B = bold, I = italics, U = underline)
- Color (e.g. "red")
of the text.

Examples:
Character chain display:
<<< display "Hallo World" >>>

Variable display:
<<< display "Meldungszeit:",arrival>>>
<<< display "Meldung: "net," ",,obj_name," ",mp_name," ",state_name," ",fkt_name>>>
<<< display "Igis 1"::"MB100":"Blitzlampe"."Sabotage" >>>
<<< display mp_name."Zustand"

Text file:
<<< display text.txt>>>

References:
Assistant
display_image ("zeichnung"[,zoom)
find
insert
length
remove
replace
substring
get_mp_text_data
Variablen
SIAS commands – alphabetical list
22 SIAS Overview of Commands - WINMAG plus

display_image(filename(Zoomfaktor))
Displays a wmf, bmp, jpg, png, ico file in the SIAS message programm.
Zoom factor can be 1 to 300 %

Example:
<<< display_image(kueche.bmp(50))

The picture “kueche.bmp“ is displayed in the SIAS program with the zoom factor of 50%.

References:
Assistent
display
display_rtf
find
insert
length
remove
replace
substring
get_mp_text_data
Variablen
SIAS commands – alphabetical list

display_rtf(filename)
Displays a rtf file in the SIAS message program.

Example:
<<< display_rtf(Text.rtf)

The RTF file “Text.rtf“ is displayed in the SIAS program

References:
Assistent
display
display_image
find
insert
length
remove
replace
substring
get_mp_text_data
Variablen
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 23

dtmf_menu(name,on_key_x(menu/macro,m_name),"helptext")
Creates a menu that can be controlled by DTMF signals. The menu can call further sub-menus or macros for
controlling purposes.
The first menu must have the name "start".
The program option DTMF control possibility must be enabled and the notification installed and configured.

Required parameters:
name = Name of the menu input. The first menu must have the name "Start".
von_key_x = key assignment on the telephone keys 1 to 9 e.g. on_key_1 for key 1
Several keys can be defined in the menu command.
menu,m_name = Name of a subsequent menu, that is selected via a key
or
macro,m_name = Name of a SIAS macro, that is selected via a key
helptext = Text, that can be used to hear information after pressing the - key on the telephone.
The text should describe the menu functions, e.g. key number and assigned function

After calling the computer, an authorization code is queried, that is filed in the WINMAG operator data. After
entering the code followed by the key, the menus can be selected. Consecutive numbers can be entered e.g. 123
means in Menu 1, key 1, in the following menu, key 2 and in the following menu, key 3. By pressing the key, the
help text filed at the selected menu level is displayed.

Examples:
<<< dtmf_menu (start,on_key_1(menu,Steuerungen),on_key_2(menu,Informationen),"1 Steuerungen, 2
Informationen")>>>

Creates a menu with 2 selection possibilities. Two subsequent menus (composed of a further dtmf_menu
command as described below) "Steuerungen" or "Informationen" can be called. As a help text the text in quotation
marks can be displayed by pressing the - key.

<<< dtmf_menu
(Informationen,on_key_1(macro,voice_alarm),on_key_2(macro,voice_unscharf),on_key_3(macro,voice_scharf),
"Bitte wählen Sie: 1 Alarme, 2 unscharfe Bereiche, 3 scharfe Bereiche")>>>

The information menu calls various macros, that provide information on the telephone via the command
voice_channel.

References:
voice_channel(name,menu)
SIAS commands – alphabetical list
24 SIAS Overview of Commands - WINMAG plus

email_notification ("to" , "subject" ,"message"[,web])

Transmits a notification by email via the WINMAG components "Notification" to a stipulated address.
The message can be composed of variables and constants.

Required parameters:
to = destination address as text or variable
subject = subject of a message
message = text message comprising constant text enclosed in double quotation marks
or
variable = variable with character chain or numerical value
The length of the message should not exceed 255 characters.
web = optional information to transmit the message via the esafetynet portal

Examples:
<<< var integer notification_id >>>
<<< notification_id = email_notification ("[email protected],alarm_reason_name,arrival+" "+obj_name+"
"+mp_name+" "+mp_text)>>>
<<< delay(5)>>>
<<< if check_notification_sent (notification_id) then >>>
...
<<< endif >>>
transmits a message composed of event-related variables to the stipulated email address with the subject
alarm_reason_name. After 5 seconds, transmission of the message is checked.

References:
check_notification_ack(id)
check_notification_sent(id)
fax_notification(telephone,message)
sms_notification(telephone,message)
voice_notification(telephone,message)
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 25

enable "net"::"obj_name":"mp_name"."state_name"
Enables transmission of a state from the terminal device via the network

Required parameters:
net = Network name
obj_name = Object name
mp_name = I/O point name
state_name = State name
The transmission of data can be influenced by "Filter". The data that requires transmitting by the terminal device
can be determined during initialization down to state level.
The command "enable" activates a disabled transmission and the filter is disabled.
The number of messages in the network can thus be influenced.

Example:
<<< enable "IGIS Netz 1"::";MB 100":"PIR Haupteingang"."Zustand" >>>
activates the transmission of the physical state of the PIR main input port.

References:
disable "net","obj_name","mp_name","state_name"
SIAS commands – alphabetical list

Enable_layer_by_id
Enables the graphic layer with the stipulated ID during the run time of the SIAS program

Required parameters:
ID of the layer

A disabled graphic layer can be enabled for a specific time or during the entire run time of the SIAS program using
this command.

Example:
<<< enable_layer_by_id (Id) >>>

References:
Disable_layer_by_id
Disable_layer_by_name
Enable_layer_by_name
SIAS commands – alphabetical list
26 SIAS Overview of Commands - WINMAG plus

Enable_layer_by_name
Enables the graphic layer with the stipulated name during the run time of the SIAS program

Required parameters:
Name = Name of the layer
A disabled graphic layer can be enabled for a specific time or during the entire run time of the SIAS program using
this command.
Example:
<<< enable_layer_by_name ("Name") >>>

References:
Disable_layer_by_id
Disable_layer_by_name
Enable_layer_by_id
SIAS commands – alphabetical list

exec(Program,Prio[,Type,R,G,B])
Call of an independent SIAS program
Required parameters:
Program = Name of an SIAS program without extension
Prio = Program priority with a numerical value between 1 and 30000
Type (optional) of Alarm type category, in which the program should be classified.
If the type is not explicitly stipulated, the type of message will be used. In the I/O point definition, an alarm reason
can be assigned to each function value, which in turn belongs to an alarm type.
RGB value (optional) for alternative stack input color
When using a RGB value, a type must also be stipulated.
{bmc help_b.bmp}%Alarmarten Alarm types%Alarmarten
An SIAS program can call any further SIAS programs.
"exec" is used to start a program that does not depend on the called SIAS program.
The program is entered in the stack with its own priority and executed independently according to the stack control.
Most of the exec commands are contained in the program "ausbed.wxe". Accompanied by conditions, they form
the main control of the WINMAG system.

Examples:
<<< exec(alarm,6000)>>>
calls an SIAS program with the name "alarm.wxe" and the priority 6000. The type is determined by the related
message.
<<< exec(alarm,6000,2,0,0,255)>>>
calls an SIAS program with the name "alarm.wxe" and the priority 6000. The type is set at 2 intrusion.
The stack input has the RGB value 0,0,255 = Blue.

References:
back_color(R,G,B)
call
exec_autoclose
exec_macro (macroname)
exec_popup_prog (programm)
finish_at_change(prio)
manual
priority (wert)
run
stack_color(RGB)
top
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 27

exec_autoclose(Programm,Prio[,Typ,R,G,B])
Call an independent SIAS program
Contrary to the exec command, the program is automatically closed, if the trigger off condition is no longer
impending.

Required parameters:
Program = Name of an SIAS program without extension
Prio = Program priority with a numerical value between 1 and 30000
Type (optional) of Alarm type category, in which the program should be classified.
If the type is not explicitly stipulated, the type of message will be used. In the I/O point definition, an alarm
reason can be assigned to each function value, which in turn belongs to an alarm type.
RGB value (optional) for alternative stack input color
When employing a RGB value, a type must also be stipulated
An SIAS program can call any further SIAS programs.
"exec" is used to start a program that is independent of the calling SIAS program.
The program is entered in the stack with its own priority and executed independently according to the stack
control.

Most exec commands are contained in the program "ausbed.wxe". Accompanied by conditions, they form the
main control of the WINMAG system.

Examples:
<<< exec_autoclose(alarm,6000)>>>
calls an SIAS program with the name "alarm.wxe" and the priority 6000. The type is determined by the related
message.
<<< exec_autoclose(alarm,6000,2,0,0,255)>>>
calls an SIAS program with the name "alarm.wxe" and the priority 6000. The type is set at 2 intrusion.
The stack input has the RGB value 0,0,255 = Blue.

References:
Autoclose
exec (program,prio[,typ])
SIAS commands – alphabetical list
28 SIAS Overview of Commands - WINMAG plus

exec_default_prog
Calls an independent SIAS program, that enters the stack control via the input assigned to an alarm reason.

Required parameters: None

The command must exist in the file “ausbed.eff” in the “while(1)” and enables the standard SIAS program that is
directly assigned to an alarm reason to be started.
For this purpose, the alarm reason in the system configuration "Alarmgründe bearbeiten" must be as follows:
- Use SIAS program activated
- A program priority assigned
- An alarm program assigned

Examples:
...
<<< while (1) >>>
<<< getparameter >>>
...
<<< exec_default_prog>>>
...
<<< endwhile >>>

References:
Call
exec (program,prio[,typ])
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 29

exec_macro (macroname[,0/1])
Calls an SIAS macro

Required parameters:
macroname = Name of an SIAS macro without extension
Macros have the file extension .efm
Enable protocol
0 = no protocol of the macro start/end in the system database
1 = protocol enabled.
Without these parameters a protocol is enabled.
An SIAS macro cannot display in the main program but it can call any other SIAS programs.
"exec_macro" enables a macro independent of the calling SIAS program to be started immediately. The macro is
not subject to stack control.

A macro can be called as an action via a symbol.

Most of the exec commands are contained in the program "ausbed.wxe". Together with conditions, they form the
main control of the WINMAG system.

Examples:
<<< exec_macro(testalarm)>>>
calls an SIAS macro with the name "testalarm.wxm".

<<< exec_macro(counter_aktualisieren,0)>>>
calls an SIAS macro with the name "counter_aktualisieren.wxm". The start/exit of the macro are not recorded in
the system protocol.

References:
exec (program,prio[,typ])
SIAS commands – alphabetical list
30 SIAS Overview of Commands - WINMAG plus

exec_popup_prog(Programm[,"Melder"])
Calls an SIAS program as popup window via the current windows.

Required parameters:
Program = Name of an SIAS program without extension
Detector = I/O point name in the format "Network"::"Object":"I/O point"."State"="Function value"

An SIAS popup runs as a popup window on top of the current background. It can call any other SIAS programs.
"exec_popup" enables a program irrespective of the calling SIAS program to be started immediately, the popup
program is not subject to stack control.

A popup program can be called as an action via a symbol.

Without the stipulated parameters "Melder" (detector), the current parameters of the calling program will be
transmitted to the popup program.
Other parameters can be transmitted in I/O point format.

Most of the exec commands are contained in the program "ausbed.wxe". Together with conditions, they form the
main control of the WINMAG system.

Examples:
<<< exec_popup_prog(melderna_wait)>>>
calls an SIAS popup program with the name "melderna_wait.wxe".

<<< exec_popup_prog (pop_zk_liste,"ZK-Netz"::"Zutrittskontrolle":"Innen"."Anzahl Personen Zehner"="0") >>>

calls an SIAS popup program with the name "zk_liste", irrespective of the current I/O point value, the AC-network
parameter will be transmitted.

References:
back_color(R,G,B)
exec (program,prio[,typ])
exec_macro (macroname)
popup_autoclose
popup_pin
popup_pin_parent
popup_size (x,y)
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 31

exit
Program is exited on reaching the command.

Parameters: - None -

A higher hierarchy of nested programs is not closed.

If the program is called from another program with „call“, already open programs are not closed.

As distinguished from "finish" !

Example:
In the program "Alarm"

call (exit)
...
in the program "ende"

<<< if confirm "Programm "Ende" beenden ? " then >>>

<<< exit >>>
<<< endif >>>
only the program "ende" is exited !

References:
finish
SIAS commands – alphabetical list
32 SIAS Overview of Commands - WINMAG plus

fax_notification(telephone,"text"/variable[+"text"/variable][,web])
Transmits a FAX message via the WINMAG component "Notification" to a stipulated telephone number.
The message can contain both variables and constants.

Required parameters:
telephone = destination telephone number as text or variable
text = constant text enclosed in double quotation marks
or
variable = variable with character chain or numerical value
+ connection of constant text enclosed in double quotation marks
or
variable = variable with character chain or numerical values and variables
The length of the message should not exceed 255 characters.
web = optional information to transmit the message via the esafetynet portal
The message is executed as a function so that the dispatch of the message and its acknowledgement can be
checked.

Examples:
<<< var integer notification_id >>>
<<< system_var string Ziel >>>
<<< notification_id = fax_notification (Ziel,alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>>
<<< delay(5)>>>
<<< if check_notification_sent (notification_id) then >>>
...
<<< endif >>>

Transmits a message composed of event-related variables to a global telephone number defined elsewhere. After
5 seconds transmission is checked.

References:
check_notification_ack(id)
check_notification_sent(id)
email_notification(to,subject,message)
sms_notification(telephone,message)
voice_notification(telephone,message)
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 33

file_append("File","Text"[+variable])
Appends the text stipulated after the comma to an existing file with the name "File" as a new line. The text can be
composed of several parameters.
If the stipulated file does not yet exist, a file is created.

Required parameters:
File = Stipulated file name with path
The stipulated file parameter must contain an absolute path to the file that is to be written !

Text = To be inserted in the file

Examples:
<<< file_append("C:\temp\musterdatei.txt","Alarm "+"mp_name+" / "+arrival>>>
appends to the file "C:\temp\musterdatei.txt" the event-related text, e.g. "Alarm group 12 / 24.12.2003 14:27:32
(new line)

References:
file_write
file_read
SIAS commands – alphabetical list

file_delete("File")
Deletes a file with the name "File".
The stipulated file parameter must contain either an absolute path to the file that requires deleting or a file name
that exists in the sub-directory "Text".

Required parameters:
File = Stipulated file name in text or with absolute path

Examples:
<<< if file_exists ("testdatei.txt") then>>>
<<< file_delete ("testdatei.txt")>>>
<<< endif >>>
Checks whether the file text\testdatei.txt exists and deletes if file exists.

References:
file_exists
file_read
file_write
SIAS commands – alphabetical list
34 SIAS Overview of Commands - WINMAG plus

file_exists("File")
Checks whether a file with the name "File" exists.
This is considerably quicker than actual reading.
The stipulated file parameter must contain either an absolute path to the file that requires reading or a file name
that exists in the sub-directory "Text".
File_exists is a function with a return value, if reading was successful.

Required parameters:
File = File name in text or with absolute path

Examples:
<<< var integer return>>>
<<< return = file_exists ("testdatei.txt") >>>
Checks whether the file text\testdatei.txt exists.
If successful, return has the value 1
If the file was not found, return has the value 0

<<< var string datei>>>

<<< if file_exists ("testdatei.txt") then>>>
<<< file_read ("testdatei.txt", datei)>>>
<<< endif >>>
Checks whether the file text\testdatei.txt exists and if this is the case, reads the file into the variable file.

References:
file_append
file_delete
file_read
file_write
SIAS commands – alphabetical list

file_read("File",variable)
Reads a file with the name "File" into a string variable.
A variable can have a maximum of 65535 characters.
The read-in process is limited to a maximum of 50 read-in lines with 256 characters each.
The stipulated file parameter must contain an absolute path to the file to be read in !

Required parameters:
File = File name with absolute path
Variable = String variable, in which the contents of the file are entered.

Examples:
<<< var string teststring var integer zahl1>>>
<<< file_read ("c:\temp\testdatei.txt", teststring) >>>

<<< zahl1 = get_integer teststring {wandelt String in numerischen Wert um}>>>

References:
file_append
file_write
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 35

file_read_line(Filename, Stringvariable, Linenumber)

Reads a string out of a stipulated file and string-variable out of the given line number.
The character string to be read can be max. 64 K.
The stipulated file parameter must contain an absolute path to the file to be read in !

Required parameters:
Filename = file name with absolute path
Stringvariable = string variable, in which the contents of the file are entered.
Linenumber = number of the line, from which the string shall be read.

Example:
<<< var string Zeile var integer return>>>
<<< return = file_read_line ("testdatei.txt", Zeile,7) >>>
Is reading the 7nd line from the file text\testdatei.txt to the variable "Zeile". On success return has the value 1. If
reading was not possible return has the value 0 (possible reasons: wrong line number, file not found)

<<< var string Zeile >>>

<<< if file_read_line ("testdatei.txt", Zeile,7) then>>>
<<< display Zeile >>>
<<< endif >>>
Is reading the 7nd line from the file text\testdatei.txt to the variable "Zeile". On success the line is shown on the
screen.

References:
file_append
file_read
file_write
SIAS commands – alphabetical list

file_write("File","Text"[+variable])
Writes the text stipulated after the comma in a file with the name "File". The text can be composed of several
parameters. If the stipulated file exists, it will be overwritten!

Required parameters:
File = Stipulated file name with path
The stipulated file parameter must contain an absolute path to the file that requires writing !

Text = Text to be inserted in the file

Examples:
<<< file_write("C:\temp\musterdatei.txt","Alarm "+"mp_name+" "+arrival>>>
writes the file "C:\temp\musterdatei.txt" with an event-related text, e.g. "Alarm Group 12 - 24.12.2008 14:27:32

References:
file_append
file_read
SIAS commands – alphabetical list
36 SIAS Overview of Commands - WINMAG plus

find("string", "value"[, startindex, count])

Find a substring within a text or text variables. A start position and number of strings that require searching can be
stipulated.
The command has the function to display the numerical position that marks the beginning of the characters search.
Counting begins with 0 for the first position.
If the characters are not found, the value -1 is returned.

Possible parameters that are separated by a comma.

string = character chain or variable that requires checking
value = character chain or variable that requires searching for
startindex = start position, for searching a character chain.
Value range is 0 to string length -1, the first position is the value 0.
The value is optional, if not stipulated, the search will apply to the entire string.
count = number of characters that require searching.
Value range is 1 to string length 1.
The value is optional, if not stipulated, the search will apply to the entire string.
The value can only be set, if a start index is stipulated.

Examples:
Find a substring within a text or text variables.
<<< var integer position >>>
<<< position = find ("12345Ziel","Ziel",3)>>>
The position has the value 5 (argument “Ziel” was found after Byte 5, search started after the 3rd digit)

<<< position = find ("12345Ziel","Ziel",6)>>>

The position has the value -1 (argument “Ziel” was not found after Byte 6)
Search started after the 6th digit

<<< position = find ("12345Ziel","Ziel")>>>

The position has the value -1 (argument “Ziel” was not found in entire string)
Start of search was at beginning of string

References:
Insert
left_substring
length
remove
replace
right_substring
substring
Variablen
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 37

finish
Program is finished after reaching the command.

Parameters: - None -

If the program was called from a program with "call", all programs (higher level) will also be finished.

As distinguished from "exit" !

Example:
in the program "Alarm"
...
call (beenden)
...
in the program "ende"

<<< if confirm "Gesamtes Programm beenden ? " then >>>

<<< finish >>>
<<< endif >>>
Both the program "Alarm" and the program "ende" are finished

References:
exit
SIAS commands – alphabetical list
38 SIAS Overview of Commands - WINMAG plus

finish_at_change(prio)
Holds the programm with the stipulated priority in the stack until the condition is no longer fulfilled. The status is set
at "bearbeitet".
Commands containing after finish_at_change will not be executed.

Required parameters:
Prio = Program priority with a numerical value between 1 and 30000, for holding the program in the stack.

Examples:
<<< finish_at_change(60)>>>
keeps the SIAS program with the priority 60 in the stack until the trigger off criterion is no longer impending.

References:
exec (program,prio[,typ])
priority (wert)
SIAS commands – alphabetical list

freeze_controls
For all controls displayed in the program run with multiple input possibility, the current state is frozen.

If no selection was made, no further selection is possible.

If a selection was made, this can no longer be changed.

Example:
<<< freeze_controls >>>

References:
Controls
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 39

generate_wav_file ("file","message")
Generate_wav_file creates a wav file with the stipulated text.

Conditions:
- The option notification must be included in the license
- The PC must have multimedia facilities, in order to output the sound file
- The voice configuration depends on the installed and configured synthetic voice

The created file can be output with the command “sound”.

Required parameters:
file = Parameter, that requires speaking
message = Parameter with the text, that requires saving as a file

Examples:
<<< generate_wav_file ("c:\sprachmeldung1.wav", "Alarm von Melder "+mp_name)>>>
creates a .wav-Datei sprachmeldung1.wav n C: with a message-specific text

References:
sound"Name"[,loop]
speak (message)
SIAS commands – alphabetical list

get_fkt_nr Meldepunkt-Zustand (I/O point state)

Function for converting an I/O point function value into a numerical value

Required parameters
I/Opoint state = Stipulated I/O point state e.g.
Network::Object:I/O point:State or mp_nr:State name

Examples:
<<< var integer zahl1 >>>
<<< var integer zahl2 >>>
...
<<< zahl1 = get_fkt_nr mp_nr.Zustand >>>
<<< zahl2 = get_fkt_nr "Lokale IGIS-Karte 1"::"MB100":"Gruppe 1":"Hauptbereich" >>>
<<< put (net_nr::obj_nr:(35+zahl2)."schalten")="löschen">>>

Number1 is 200, Number2 is 123

References:
get_integer wert
Contrariwise, a numerical value can be assigned to an I/O point variable. The decimal numbers 1 to 8 are
assigned to the 8 states.
e.g.
<<< put "System"::"Variablen":"counter" = 123 >>>
In state value 1 = 3
In the state value 2 = 2
In the state value 3 = 1
40 SIAS Overview of Commands - WINMAG plus

get_graphic_text(net::object:mp)
Function to determine a graphic text assigned to an I/O point that can be displayed via a text symbol with
<graphic_text>.

Required parameters:

net = Network name/number of the I/O point

object = Object name/number of the I/O point
mp = I/O point name/number

The graphic text is filed in the computer memory and must be refreshed after restarting the WINMAG program.
A graphic text can be assigned per I/O point via the command put_graphic_text .
If a graphic text is not assigned, an empty character chain is returned.
The queried I/O point must exist, otherwise a syntax error is displayed for the run time.

Examples:
<<< var string zeile >>>
<<< put_graphic_text(((0)::(3):(501)) = "Test:"+time) >>>
<<< zeile = get_graphic_text(((0)::(3):(501))) >>>
<<< display"Inhalt:",zeile>>>

enters in the network 0 (system) Object 3 (Variables) I/O point 501 a text and then queries the text

References:
put_graphic_text
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 41

get_graphic_xpos(GPSvar,type)
determines East/West coordinates from a GPS string and returns an integer value

Required parameters:
GPSvar = Variable with GPS string, contains x, y and other values
type = Type of GPS string, currently only value 1 is supported

The GPS message must exist as an interpretable position variable with degree and hundredths of a degree in front
of the decimal point and any number of digits after the decimal point.
This value is multiplied by 1000 and shown as an integer value, an accuracy of approx. 1 meter is therefore
possible near the Equator.
Example: 4834.78563 = 48,3478563° 1000 = 4834786

The getgraphicpos command is a function.

Example:
<<< put_graphic_pos((net::obj_nr:mp_nr),get_graphic_xpos(mp_text1,1) , get_graphic_ypos(mp_text1,1)) >>>
determines the x/y coordinates from the position conveyed by a GPS mouse and converts these values
immediately to the symbol.

<<< var integer x>>>

<<< var integer y>>>
<<< popup_size (500, 200) >>>
<<< set_title_popup ("GPS-Position "+mp_name) >>>
<<< display " x =", get_graphic_xpos(mp_text1,1) >>>
<<< display " y =", get_graphic_ypos(mp_text1,1) >>>
The program shows the determined coordinates in a popup window

References:
get_graphic_ypos
put_graphic_pos
SIAS commands – alphabetical list
42 SIAS Overview of Commands - WINMAG plus

get_graphic_ypos(GPSvar,type)
Determines the north/south coordinates from a GPS string and returns an integer value

Required parameters:
GPSvar = Variable with the GPS string with x, y and other values
type = Type of the GPS strings, currently only the value 1 is supported

The GPS message must exist as an interpretable position variable with degree and hundredths of a degree in front
of the decimal point and any number of digits after the decimals points.
This value is multiplied by 1000 and shown as an integer value, an accuracy of approx. 1 meter is therefore
possible near the Equator.
Example: 4834.78563 = 48,3478563° 1000 = 4834786

The getgraphicpos command is a function.

Examples:
<<< put_graphic_pos((net::obj_nr:mp_nr),get_graphic_xpos(mp_text1,1) , get_graphic_ypos(mp_text1,1)) >>>
determines the x/y coordinates from the position conveyed by a GPS mouse and converts these values
immediately to the symbol.

<<< var integer x>>>

<<< var integer y>>>
<<< popup_size (500, 200) >>>
<<< set_title_popup ("GPS-Position "+mp_name) >>>
<<< display " x =", get_graphic_xpos(mp_text1,1) >>>
<<< display " y =", get_graphic_ypos(mp_text1,1) >>>
The program shows the determined coordinates in a popup window

References:
get_graphic_xpos
put_graphic_pos
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 43

get_integer wert
Function to convert a variable or character chain to a numerical value.

Required parameters:
value = Variable or character chain

Examples:
<<< var integer zahl1 >>>
<<< var integer zahl2 >>>
<<< var string str1 = "123" >>>
...
<<< zahl1 = get_integer "200Zustand" >>>
<<< zahl2 = get_integer str1 >>>

zahl1 is 200, zahl2 is 123

References:
get_fkt_nr Meldepunktzustand
SIAS commands – alphabetical list

get_mp_nr_from_id(netz::objekt,id1,id2)
Determines the I/O point number from the I/O point IDs 1 and 2.
The query returns the found detector ID or the value -1.

Required parameters:
net = Network name or number, where the I/O point is to be found
object = Object name or number, where the I/O point is to be found. The object number can also be
determined using the function "get_obj_nr_from_id" .
id1 = Numerical value of the I/O point ID1
id2 = Numerical value of the I/O point ID2
The function serves to determine an I/O point number from specific parameters, e.g. Group number and detector
ID. With the assigned I/O point number, e.g. control commands can be executed.
For reliable and safe identification of an I/O point number within an object, the combination of ID1 and ID2 must be
unambiguous. This is usually the case with Essernet control panels.
If an I/O point number cannot be determined, the value -1 is returned.

Example:
Determine the I/O point number via group and detector ID (set e.g. in an input mask) and enter a control command
for disabling the detector.

<<< var integer Meldepunktnr >>>

<<< Meldepunktnr = GET_MP_NR_FROM_ID ("Netz1"::"Zentrale1",2,3) >>>
<<< if Meldepunktnr > 0 {Meldepunkt gefunden} then >>>
<<< put ("Netz1"::"Zentrale1":(Meldepunktnr)."schalten")="ausschalten" >>>
<<< endif >>>
References:
get_obj_nr_from_id
SIAS commands – alphabetical list
44 SIAS Overview of Commands - WINMAG plus

get_mp_text_data(object,mp_nr,type)
Determines texts from the WINMAG database. All texts of the I/O point can be determined based on the Object I/O
point assignment by stipulating the type(=input number).

Required parameters:
obj = Object name
mp_nr = I/O point number
type = Requested text information

Type Contents
1 Detector name
2 Detector text parameter
3 I/O point ID1
4 I/O point ID2
10-17 Input state text parameters 0-7
20-27 Output state text parameters 0-7
From 1000 Function value texts

The determined value can be shown via a display command or used in queries.
Using these values, outputs and queries can be executed irrespective of the language version or user-specific
adaptations.

Examples:
<<< display get_mp_text_data(obj_nr,mp_nr,1){MP-Name}>>>
<<< display get_mp_text_data(obj_nr,mp_nr,2){MP-Zusatztext}>>>
<<< display get_mp_text_data(obj_nr,mp_nr,3){MP-id1}>>>
<<< display get_mp_text_data(obj_nr,mp_nr,10){State 0 input}>>>
<<< display get_mp_text_data(obj_nr,mp_nr,20){State 0 output}>>>
<<< display get_mp_text_data(obj_nr,mp_nr,1000){State 0 input function value 0}>>>
<<< display get_mp_text_data(obj_nr,mp_nr,1204){State 2 input function value 4}>>>
<<< display get_mp_text_data(obj_nr,mp_nr,2000){State 0 output function value 0}>>>

<<< if ((net)::obj_nr:(mp_nr).(4)) <> get_mp_text_data(net::obj_nr,mp_nr,1400) then>>>

<<<endif >>>
Queries the state 4 for the current I/O point number, if these value is <> the first defined function value, the
commands following the then command will be executed

References:
display"text",variable,text.txt
get_mp_nr_from_id
if (Bedingung) then...else...endif
Variablen
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 45

get_obj_nr_from_id(netz,id1,id2)
Determines the object number from the I/O point IDs 1 and 2.
The query returns the found object number or the value -1.

Required parameters:
net = Network name or number, where the object number is to be found
id1 = Numerical value of the I/O point ID1
id2 = Numerical value of the I/O point ID2
The function serves to determine an object within a network from specific parameters, e.g. group number and
detector ID.
For reliable and safe identification of an object within a network, the combination of ID1 and ID2 must be
unambiguous within the network. This is usually the case with Essernet control panels.
If an I/O point number cannot be determined, the value -1 is returned

Example:
Determines the object and the I/O point number via group and detector ID (set e.g. in an input mask) and enter a
control command for disabling the detector.

<<< var integer panel >>>

<<< var integer Meldepunktnr >>>
<<< panel = get_obj_nr_from_id("Netz1",2,3) >>>
<<< Meldepunktnr = get_mp_nr_from_id("Netz1"::(panel),2,3) >>>
<<< if Meldepunktnr > 0 {Meldepunkt gefunden} then >>>
<<< put ("Netz1"::(panel):(Meldepunktnr)."schalten")="ausschalten" >>>
<<< endif >>>

References:
get_mp_nr_from_id
SIAS commands – alphabetical list
46 SIAS Overview of Commands - WINMAG plus

get_parent_picture_id(ID/picturename)
Determines the parent picture to a known picture name / picture ID
A jump to the level above can thus be made in the picture sequence within the SIAS program.

Required parameters:
ID = ID of the picture input, can be determined via the picture command or the variable picture_id
picture name. This assignment must not be unambiguous, as a picture in the picture tree can be used more
than once.

The first found entry in the database is checked

The determined value can be used in a picture command, to show the corresponding parent picture

Example:
<<< var integer bildid >>>
<<< var integer parent_bildid >>>
<<< picture (1) {Bild suchen über Symboleintrag}>>>
<<< bildid = picture_id >>>
<<< parent_bildid = get_parent_picture_id(bildid) >>>
<<< display "1.Bildid = ",bildid,picture_name1," , Parent Bildid = ", parent_bildid >>>
<<< picture (2, parent_bildid) >>>

shows the picture ID and parent picture ID as well as the parent picture as 2nd picture

References:
picture
SIAS commands – alphabetical list

get_playbacktime(correction time, format)

Determines a correction time for access to a digital recorder.

Required parameters:
correction time = time change in seconds, positive and negative values are possible
format = output format of a time string
0 = conversion of the arrival time into Visioprime format

The determined value can be transmitted to a digital recorder as a text parameter.

Thus playback can be commenced e.g. 30 seconds before the alarm time.

Examples:
<<< url ("Video:107731476/1/3/"+get_playbacktime(-10,0))>>>

Shows a video for network 107731476, Object 1 camera 3 10 seconds before the message time from arrival.
The output has the Visioprime format yyyymmddhhmmss

References:
url
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 47

get_system_property(property)
The function determines system parameters from the WINMAG plus environment, e.g. path name, protocol file
identifiers, metadata directories.

Depending on rights and allocation of the user the returned values may vary. The return value is a character chain.

Data from the following groups are offered:

property = name of system information with the start selection
winmag program information e.g. path winmag@path
graphic grafic-infos e.g. meta directory of the grahpic graphic/id/1@metafilepath
mp I/O informations e.g. I/O name: mp/addr/“+id+“@name
object object informations
net net informations
user user informations
user_group user group informations
station stations informations e.g. name of a station: station/id/1@name
layer overlay pictures of grafics e.g. name layer/id/1@name
message messages to running time of programs e.g. message/mp@metafilepath
sias messages to running time of programs e.g. sias@seek_result
The parameters are sub-divided into the following main themes:
WINMAG WINMAG parameter, e.g. path to the program, networks
SIAS Parameters from SIAS commands, e.g. results of search operations with seek,
MESSAGE Information relating to the current I/O point context. The relationship arises from the
assignment to an I/O point via a program start from executing conditions or as a symbol action
MP Values relating to an I/O point e.g. name, type, object, ID's
GRAPHIC Graphic parameters, e.g. graphic name, ID, type, tree depth, parents, children

The file sias@tmpfilename offers a special feature: This file is automatically removed after the alarm program is
exited, so that there is sufficient space in this file for data relating to the alarm sequence.

The query print is built of <<<Get_system_property(Informationsgroups/parameter@Informationsname)>>>

With these values outputs and queries are possible independant of language versions or user specific adaptions.
Parameter can be used nested and recursive e.g.:
<<< Pfad = get_system_property ("winmag@path")>>>transfers to the variable „Pfad“ the local path to
WINMAGplus.
<<< station = get_system_property ("station/id/"+(get_system_property("winmag@station_id"))+"@name")>>>
finds out the name of a working station via the station-ID and transfers the value to the variable „station“.
<<< display "Melder-Name: ",(get_system_property("message/mp@name")) >>> puts out the name of the I/O
point with display together with the actual message.
<<< display "mp/addr/0::3:1/object/net@name",(get_system_property("mp/addr/0::3:1/object/net @name")) >>>
indicates the name of the network together with the I/O point.

The determined value can be output using a display command or used directly in queries.
If no value is determined or the output is faulty, an empty character chain is returned.

With these values, outputs and queries can be executed irrespective of the language version or user-specific
adaptations.
48 SIAS Overview of Commands - WINMAG plus

Required parameters:
property = Name of the system information e.g.
winmag@path
winmag@master_path
message/mp@metafilepath
message/mp@master_metafilepath
message/mp@graphic_ids
mp/addr/"+id+"@name
graphic/id/1@metafilepath
sias@seek_count
sias@seek_result
sias@tmpfilename

Information names according to groups:

winmag

@graphic_ids List of ID’s of all applied graphics

@layer_ids List of ID’s of all applied graphic layer
@master_path Path to WINMAGplus-Master in multi station systems
@net_ids List of all defined net-ID’S
@path Local path to the running WINMAGplus-application
@station_id Own stations-ID (not corresponding to station_no)
@station_ids List of ID’s of all applied clients
@user_group_id Liste of ID’s of all applied user groups
@user_ids Liste of ID’s of all applied users
SIAS Overview of Commands - WINMAG plus 49

graphic
For graphic you must declare, to which grahic the information should be found out. This occurs by
indication of the ID, e.g. graphic/id/1@name. This command gives back the drawing name of the graphic
with ID 1.
As a further parameter the path can be enhanced by the value „/parent_graphic“. Then the values of the
father-drawing can be queried, e.g. graphic/id/4711/parent_graphic@name
@child_graphic_ids ID’s of all attached continuation graphics
@child_reason_counter List of all in childs included and in the overview monitored alarm reasons
@child_type_counter List of all in childs included and in the overview monitored alarm types
@full_name full name of graphic with path
@id ID of graphic
@is_overlaygraphic Is the graphic an overlay grahic -> true oder false
@is_video Is the graphic a video-page -> true oder false
@is_webpage Is the graphic a webpage -> true oder false
@is_zoomcutout Is the graphic a zoomcutout -> true oder false
@layer_ids List of all graphic-layers
@level Level of graphic -> level 0 is the uppermost graphic
@master_metafilepath Path to the master-metafile at multi station systems
@metafilepath Path to the local metafile of the graphic
@name Name of graphic
@parent_graphic_id ID of the placed above graphic
@reason_counter List of all in overview included and monitored alarm reasons with figure
@tree_type_counter List of all in picture and in childs included and in the overview monitored
alarm reasons
@type_counter List of all included and in the overview monitored alarm types with amount
@url URL of page in webpages
@zoomable Is the graphic zoomable -> true oder false

MP (I/O)
For MP (I/O) you must declare, which I/O point should be used.
over indication of address /addr Netno::Objectnr:mpnr
e.g. /addr/0::3:1 over indication of ID /ID e.g. /id/4711
over reference to message or SIAS-program e.g. message/mp@name
Possible path enhancements: /dez9000, /state
@addr Address of I/O in format Netno::Objektnr:MP-Nr"
@dez9000 DEZ9000-Informations
@graphic_ids Graphics containing the I/O point
@graphic_text Graphic-Text of I/O point
@has_value is value entry existing -> true oder flase
@id ID of I/O point
@id_1 add-on ID1 of I/O point
@id_2 add-on ID2 of I/O point
@in_state_nos List of input states e.g. 0 CRLF 1 CRLF 2 CRLF 3
@master_metafilepath Path to master-metafile at multi station systems
@metafilepath Path to the local metafile of the I/O point
@name Name of I/O point
@no Number I/O point
@out_state_nos List of outputs states e.g. 0 CRLF 1 CRLF 2 CRLF 3
@type I/O point-type of I/O point
@types I/O point-type and family type of I/O point
@value Value entry of of I/O point
state/in/x@name Name of input state with number x
state/out/x@name Name of output state with number x
state/in/x@value_name Current name of input functional value for state x
state/in/x@value_no Current number of input functional value for state x
50 SIAS Overview of Commands - WINMAG plus

object
For object you must declare, which object shall be used.
over indication of address /addr Netno::Objectnr e.g. /addr/0::3
over indication of ID /ID e.g. /id/4711
over reference to message or SIAS-program e.g. message/object@name
Possible path enhancement: /dez9000
@devicetype_id terminal device type - ID of objects e.g. 1004 for object „Variablen“
@devicetype_name terminal device type - name of object
@id ID of object
@is_redundant Is object redundant -> true / false
@master_metafilepath Path to master metafile at multi station systems
@metafilepath Path to local master metafile of object
@mp_ids List of I/O points ID’s in object
@mp_addrs Addresse of object in format netz-No::Objekt-Nr z.B. 0::3
@name Name of object
@no Number of object in the network. e.g. 3
@redundacy_master_id ID of master object of a redundant object
@redundacy_slave_id ID of redundant object

net For net you must declare, which net shall be used.
over indication of address /addr Netno:: Netznr: e.g. /addr/0
over indication of ID /ID e.g. /id/4711
over reference to message or SIAS-program e.g. message/net@name
Possible path enhancements: /mp (I/O)
@addr Address number of net
@is_master Is it a master-net -> true/false
@master_metafilepath Path to master metafile at multi station systems
@metafilepath Path to local master metafile of net
@name net name
@nettype_id Net type-ID
@no Number of net
@no_pc IGIS-Address of connected PCs
@object_addrs List of in the net contained object addresses in the form NetzNr::ObjektNr
@object_ids List of in the net contained object ID´s
@vaddr Virtual address of the net = Event-Protokoll-Adresse
@vaddr_bridge Virtual transmission address

user user information

For user you must declare, for which user informations must be found out. This occurs by indication of the
ID e.g. user/id/1@name gives back the name of the user with ID 1.
@control_priority control authorization of user
@id ID of user
@name Name of users
@program_priority Program-Priority of the user e.g. for manual programs
@user_group_ids List of user groups of the user
SIAS Overview of Commands - WINMAG plus 51

user_group user group informations

For user group you must declare, for which user group informations must be found out. This occurs by
indication of the ID e.g. user_group/id/1@name gives back the name of the user group with ID 1.
@id ID of user group
@name Name of user group

station Station informations e.g. name of a station: station/id/1@name

For station you must declare, for which station informations must be found out. This occurs by indication
of the ID e.g. station/id/1@name gives back the name of the station with ID 1.
@host_address Host-address of the station = name of the computer
@id ID of station
@name Name of station
@no Number of station = Event-Protokoll-Adresse

layer Overlay pictures from graphics e.g. Name layer/id/1@name

For layer you must declare, for which layer informations must be found out. This occurs by indication of
the ID. e.g. layer/id/4711@name gives back the name of the layer with ID 4711.
@id ID of ayer
@name Name of layer
@path Path to layer file

message Messages to the running time of programs

With message informations to the running time of programs can be put out, which refer to the information
groups net, object or mp. After the term message the allocated group name must succeed, e.g.
message/mp@metafilepath
For the sub groups the defined values can be asked.
z.B.: message/net/@name results in name of net to the message program
message/object/@name results in name of object to the message program
message/mp/@name results in name of I/O point to the message program

sias Messages to the running time of programs e.g. sias@seek_result

With sias informations to the runtime of running programs can be put out such as name of program,
temporary metafile names, results of searching operations, .... @full_prog_name program name
with full path
@prog_name Name of program with part path under winmagex
@seek_count number of found I/O points with command seek
@seek_result List of ID’s of with seek found I/O point addresses for editing in the form
netznr::objektnr:meldepunktnr
@tmpfilename Temporary metafile to program (store temporarily)
@user_id User-ID of program
52 SIAS Overview of Commands - WINMAG plus

Examples:
Assignment of parameters to variable, in this case the WINMAG6 path:
<<< a = get_system_property ("winmag@path") >>>

Name of the temporary file that is being processed: <<< display get_system_property ("sias@tmpfilename") >>>

WINMAG:
<<< display "WINMAG@path ",(get_system_property("winmag@path")) >>>
<<< display "WINMAG@master_path ",(get_system_property("winmag@master_path")) >>>
<<< display "WINMAG@net_ids ",(get_system_property("winmag@net_ids")) >>>

SIAS:
Determine file name of the program/sub-program that was just executed with relative (prog_name) or absolute
(full_prog_name) path
<<< display "sias@prog_name ", (get_system_property("sias@prog_name")) >>>
<<< display "sias@full_prog_name ", (get_system_property("sias@full_prog_name")) >>>

Search for all disarmed zones using seek, transfer of search result with seek_result to a variable and display of
number of found inputs via seek_count.
These parameters are temporary and the contents are overwritten by the next seek command.
<<< seek_alarm_reason( 91 ) >>>
<<< result = (get_system_property("sias@seek_result")) >>>
<<< display get_system_property("sias@seek_count") >>>

MESSAGE:
<<< display "net">>>
<<< display "message/net@nettype_id ",(get_system_property("message/net@nettype_id")) >>>
<<< display "message/net@no_pc ",(get_system_property("message/net@no_pc")) >>>
<<< display "message/net@name: ",(get_system_property("message/net@name")) >>>
<<< display "message/net@vaddr: ",(get_system_property("message/net@vaddr")) >>>
<<< display "message/net@vaddr-bridge: ",(get_system_property("message/net@vaddr_bridge")) >>>
<<< display "message/net@mp: ",(get_system_property("message/net@mp")) >>>
<<< display "Object">>>
<<< display "message/object@devicetype_id ",(get_system_property("message/object@devicetype_id")) >>>
<<< display "message/object@devicetype_name ",(get_system_property("message/object@devicetype_name"))
>>>
<<< display "message/object@name: ",(get_system_property("message/object@name")) >>>
<<< display "message/object@addr: ",(get_system_property("message/object@addr")) >>>
<<< display "message/object@id: ",(get_system_property("message/object@id")) >>>
<<< display "message/object@no: ",(get_system_property("message/object@no")) >>>
<<< display "mp">>>
<<< display "message/mp@id ",(get_system_property("message/mp@id")) >>>
<<< display "message/mp@name ",(get_system_property("message/mp@name")) >>>
<<< display "message/mp@no ",(get_system_property("message/mp@no")) >>>
<<< display "message/mp@type: ",(get_system_property("message/mp@type")) >>>
<<< display "message/mp@types: ",(get_system_property("message/mp@types")) >>>
<<< display "message/mp@id_1: ",(get_system_property("message/mp@id_1")) >>>
<<< display "message/mp@id_2: ",(get_system_property("message/mp@id_2")) >>>
<<< display "message/mp@has_value: ",(get_system_property("message/mp@has_value")) >>>
<<< display (get_system_property("message/mp@graphic_ids")) >>>
<<< display (get_system_property("message/mp@metafilepath")) >>>
<<< display (get_system_property("message/mp@master_metafilepath")) >>>
<<< display (get_system_property("message/mp/object/net@name")) >>>

I/O:
The I/O point must be stipulated via the address (e.g. addr/0::3:1) or ID (e.g. id/110040001)
<<< display "mp/addr/0::3:1@id ", (get_system_property("mp/addr/0::3:1@id")) >>>
<<< display "mp/id/110040001@id ",(get_system_property("mp/id/110040001@id")) >>>
<<< display "mp/addr/0::3:1@name ",(get_system_property("mp/addr/0::3:1@name")) >>>
<<< display "mp/addr/0::3:1/object@name ",(get_system_property("mp/addr/0::3:1/object@name")) >>>
<<< display "mp/addr/0::3:1/object/net@name ",(get_system_property("mp/addr/0::3:1/object/net@name")) >>>
<<< display "mp/addr/0::3@metafilepath: ",(get_system_property("mp/addr/0::3@metafilepath")) >>>
... etc. further variables see message
SIAS Overview of Commands - WINMAG plus 53

GRAPHIC:
The values refer to a specific graphic that must be assigned via the ID
<<< display get_system_property("graphic/id/84428627@metafilepath") >>>
<<< display get_system_property("graphic/id/84428627@master_metafilepath") >>>
<<< display "graphic/id/1@id ",(get_system_property("graphic/id/1@id")) >>>
<<< display "graphic/id/1@name ",(get_system_property("graphic/id/1@name")) >>>
<<< display "graphic/id/1@full_name ",(get_system_property("graphic/id/1@full_name")) >>>
<<< display "graphic/id/1@url ",(get_system_property("graphic/id/1@url")) >>>
<<< display "graphic/id/1@level ",(get_system_property("graphic/id/1@level")) >>>
<<< display "graphic/id/1@is_webpage ",(get_system_property("graphic/id/1@is_webpage")) >>>
<<< display "graphic/id/1@is_overlaygraphic ",(get_system_property("graphic/id/1@is_overlaygraphic")) >>>
<<< display "graphic/id/1@is_zoomcutout ",(get_system_property("graphic/id/1@is_zoomcutout")) >>>
<<< display "graphic/id/1@zoomable ",(get_system_property("graphic/id/1@zoomable")) >>>
<<< display "graphic/id/1@is_video ",(get_system_property("graphic/id/1@is_video")) >>>
<<< display "graphic/id/2@parent_graphic_id ",(get_system_property("graphic/id/2@parent_graphic_id")) >>>
<<< display "graphic/id/2/parent_graphic@name",(get_system_property("graphic/id/2/parent_graphic@name"))
>>>
<<< display "graphic/id/1@child_graphic_ids ",(get_system_property("graphic/id/1@child_graphic_ids")) >>>
parent->parent->name: <<< display
(get_system_property("graphic/id/2653275/parent_graphic/parent_graphic@name")) >>>
parent->parent->level: <<< display
(get_system_property("graphic/id/2653275/parent_graphic/parent_graphic@level")) >>>

References:
get_mp_nr_from_id
get_mp_text_data
SIAS commands – alphabetical list
54 SIAS Overview of Commands - WINMAG plus

gettime"text"
Interruption of the program flow and display of a time input dialogue

Required parameters:
"text" = text that appears in the dialogue
The time input fields are pre-allocated with the current time

The value for hour, minute and second are queried in separate input fields.
The transferred time is defined in the variable "RESPONSE" by the type “time” and can be checked there.

Examples:
<<< gettime " Operation ended at:>>>
displays the above dialogue on the screen
<<< display "Operation ended at ",response," >>>
shows the input time enclosed in a text

References:
reply"text"
report
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 55

hardcopy(No, Printer)
Print out on a "Graphic printer".

Up to 10 graphic printers can be defined at a WINMAG computer.

These printers print out graphics or texts one screen at a time. Only the information that appears in the program
window on the screen can be printed.

The command requires the window to be printed and the printer number as parameters
No from 0 - 3
0 = Text window
1 - 3 = contained graphic window clockwise
Instead of the numerical values, the terms "text","graphic_1", "graphic_2", "graphic3" can also be used
The printer is the number of the printer according to the printer configuration from 1 - 10
Instead of the numerical values, the terms graphicprinter_1, graphicprinter_2, graphicprinter_3, graphicprinter_4,
graphicprinter_5 can also be used.
The Graphic window is numbered according to the corresponding display in the messages window
0 = Text window left
1 = Graphic window top right
2 = Graphic window bottom right
3 = Graphic window bottom left
A graphic window is opened using the command "picture(No[,Name])".
If a print out is required without the displayed graphic, this can be executed using the command print_graphic.

Examples:
<<< hardcopy (text,graphicprinter_1) { druckt Text auf Grafikdrucker 1}>>>
<<< hardcopy (1,2) { druckt Grafik Nr. 1 auf Grafikdrucker 2} >>>

References:
Assistant
picture
print_graphic(Nr, Drucker)
screenshot
SIAS commands – alphabetical list
56 SIAS Overview of Commands - WINMAG plus

has_popup_alarm_parameter
Function for checking whether the actual alarm parameters from an alarm program exist.
The value is true if the popup program e.g. from a graphic, that was displayed from an alarm program, is started.

Required parameters None :

Return value: 0: No alarm parameters found

1: Alarm parameters exist

Examples:
<<< var integer ret >>>
...
<<< ret = has_popup_alarm_parameter >>>
<<< if has_popup_alarm_parameter then >>>
<<< display"Rückgabewert:", ret >>>
<<< use_popup_alarm_parameter >>>
<<< call (melderna) {Parameter vom Alarmprogramm}>>>
<<< endif >>>

<<< if has_popup_alarm_parameter then >>>

<<< use_popup_alarm_parameter >>>
<<< call (melderna) {Parameter vom Alarmprogramm}>>>
<<< endif >>>

References:
exec_popup_prog (programm)
use_popup_alarm_parameter
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 57

if (Bedingung) then ... [else ...] endif

Query and evaluation of conditions.

Required parameters:
Condition =
- Query a variable state
- Result of a user query (confirm, reply)
- Query an I/O point
- Query system parameters, e.g. time, safety,
The If command checks conditions that may be linked by logical operators. Depending on the result of the entire
print out, a jump can be made either to the command string introduced by "then" or to the optional command string
introduced by "else".

The if-command is always terminated with the key word "endif".

The key word "else" terminates the then-branch.
If-commands can be nested.
If-commands form the core of the executing conditions in "ausbed.eff".

Examples:
<<< if (alarm_reason_nr = 63) then
exec (Alarm,7000)
endif >>>
<<< if (confirm"Meldung rückstellen ?" then....>>>

References:
Auslösebedingung
Operators
SIAS commands – alphabetical list
58 SIAS Overview of Commands - WINMAG plus

inc variable [(Value)]

Increases the integer value "variable" by "value"

Required parameters
variable = Name of the variable defined in the program
Wert = numerical value [optional]
The function is only applicable to integer variables
If no "value" is stipulated, the command uses the value 1

Example:
<<< var integer counter >>>
counter has the value 0
<<< inc counter
increases the counter by 1, counter now has the value 1
<<< inc counter (5) >>>
increases the counter by 5, counter now has the value 6

References:
dec variable[(value)]
Variablen
var typ name[=value]
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 59

insert("string", "value", startindex)

Insertion of text characters in a text or text variable. A start position and number of digits that require examining
can be stipulated.
The command has the effect of a function that provides the result as an extended character chain.

Possible parameters that are separated by a comma.

string = Character chain or variable where an insertion is to be made
value = Character chain or variable that requires inserting
startindex = Start position, from where the insertion is to be made.
Value range is from position 0 = beginning of character chain.
If the value is higher than the string length, the insertion is at the end.

Examples:
<<< var string newstring >>>
<<< newstring = insert ("123456789","NEU",3)>>>
new string contains 123NEU456789, insertion was made after the 3rd digit
<<< newstring = insert ("123456789","NEU",0)>>>
new string contains NEU123456789, insertion was made after the 0 at the beginning of the string
<<< newstring = insert ("123456789","NEU",15)>>>
new string contains 123456789NEU, insertion was at the end of the string

References:
find
length
remove
replace
substring
Variablen
SIAS commands – alphabetical list
60 SIAS Overview of Commands - WINMAG plus

is_message_in_stack(net::object:mp.state=FW
The command checks, whether a message for the stipulated state/function value already exists in the stack.

Required parameters
net = Network name/number of message
object = Object name/number of message
mp = I/O point name/number
state = State of message
FW = Function value of message

Checking prevents programs from being started more than once.

The return value of the function is
1 for existing entry in stack
0 for all other cases

Examples:
<<< if is_message_in_stack("IGISLOOP 0 Knoten 68"::"EMZ 561-MB100.10":"PIR EG Wohnzimmer"."Alarm" =
"ein") then>>>
<<< display" Im Stapel">>>
<<< else >>>
<<< display" Nicht im Stapel">>>
<<< endif >>>

References:
is_message_removed
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 61

is_message_removed(net::object:mp.state=FW
The command checks whether a message for the stipulated state/function value was automatically removed from
the order stack (multiaccess behaviour / stack overflow,...).

Required parameters
net = Network name/number of message
object = Object name/number of message
mp = I/O point name/number
state = State of message
FW = Function value of message

Checking prevents programs from being started more than once.

The return value of the function is
1 for existing entry in stack
0 for all other cases

Examples:
<<< if is_message_removed("IGISLoop 0 Knoten 68"::"EMZ 561-MB100.10":"PIR EG Wohnzimmer"."Alarm" =
"ein") then>>>
<<< display" aus Stapel automatisch gelöscht">>>
<<< else >>>
<<< display" Nicht im Stapel oder gelöscht">>>
<<< endif >>>

References:
is_message_in_stack
SIAS commands – alphabetical list

is_mp_in_mandant
Checks whether a defined I/O point exists for a clientel.

Required parameters:
Network = Name of net
Object =- Object
I/O device = I/O point
clientel name = Name of the clientel

Example:
<<< is_mp_in_mandant("Network"::"Object":"I/O device", "clientel name") >>>

References:
SIAS commands – alphabetical list
62 SIAS Overview of Commands - WINMAG plus

left_substring(string,separator)
Search of substring to the left of the stipulated separator within a text variable.
The command returns a character chain to a variable/command.
If a substring is not found, the result is empty.

Possible parameters that are separated by a comma.

string = Character chain or variable that requires checking
separator = Separator, after its first occurrence, the left part of the character chain is returned.
Special characters:
CRLF = Carriage return + line feed

Examples:
Search fixed character chain, the result is 12
<<< result = left_substring("12.34", ".") >>>

View a seek result of all disarmed zones and put individual entries in the variable “test”
<<< seek_alarm_reason( 91 ) >>>
<<< result = (get_system_property("sias@seek_result")) >>>
<<< while (length(result) > 0) >>>
<<< test = left_substring(result, CRLF) >>>
<<< display Get_System_Property("mp/addr/"+test+"@name") >>>
<<< result = right_substring(result, CRLF) >>>
<<< endwhile >>>

References:
right_substring(string,seperator)
substring

length ("string")
Determines the length of a character chain or text variable.
Counting begins with 0 for an empty character chain and is returned as an integer value.

Possible parameters
string = Character chain or variable that requires testing

Examples:
<<< var integer laenge >>>
<<< laenge = length("12345")>>>
length contains the value 5
<<< laenge = length("")>>>
length contains the value 0 if the character chain is empty

References:
find
insert
remove
replace
substring
Variablen
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 63

lock_tile_off
Command to deactivate the locktile off between text and graphic windows.
The dividing line can be moved again (this is also the standard behaviour without using the command
lock_tile_on).
This command can be cancelled with lock_tile_on.

Required parameters None :

Examples:
<<< lock_tile_off >>>

References:
lock_tile_on
word_wrap_off
word_wrap_on
SIAS commands – alphabetical list

lock_tile_on
Command to activate locktile off between text and graphic windows.
The dividing line cannot be moved.
As a standard feature without this command, the dividing line can be moved
This command can be cancelled with lock_tile_off).

Required parameters None :

Examples:
<<< lock_tile_on >>>

References:
lock_tile_off
word_wrap_off
word_wrap_on
SIAS commands – alphabetical list
64 SIAS Overview of Commands - WINMAG plus

login ("user name" / variable)

Logs in the stipulated WINMAG user.

The user can be stipulated as a character chain in quotation marks.
If the stipulated name does not exist in the user list, there is no change.
If the name is not unambiguous in the user list, the first found entry is used
.

Examples:
<<< login ("Supervisor") >>>
logs in the user Supervisor

<<< login (username) >>>

logs in the user with the name defined in the variable username

References:
Logout
SIAS commands – alphabetical list

logout
logs out the logged in WINMAG user.
If a "Default-Login" is installed in WINMAG, it switches to the default user.

Example:
<<< logout >>>

References:
login
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 65

manual(Programm, Prio, Typ,”Text”[,”Meldung”])

Definition of an SIAS program that can be started manually

Required parameters:
Program = Name of an SIAS program without extension (e.g. bmc664stop)
Prio = Call priority with a numerical value between 1 and 30000. The user must have one start authorization
of at least equal value. Otherwise the entry in the list of the manual programs is not visible.
Type =) Stipulated alarm type category, in which the program is to be classified (e.g. 6 for manual).
"Text" = Character chain that names the call in the list of manual programs.
"Message" = optional stipulation of message parameters as
"Network name"::"Object name":"I/O point name"."State"="Function value"
These parameters are regarded as an assigned input message, e.g. a symbol can be assigned, the variables can
be used.
The list of manual programs can be called via
- the button "Manuelle Programme",
- input of the identically named entry in the menu "Fenster"
- or in the right mouse button menu of the stack

The inputs are arranged according to priority, however they can be arranged according to the table heading.
Tags are installed for contained alarm types.
The user only sees inputs for programs that he can start.

The definition of a manual program is dynamic and is possible in each program.

If the availability of an input is required at all times, the definition e.g. in the file "ausbed" must be entered before
the alarm loop.

A definition can be removed again by using the command "dismanual".

Examples:
<<< manual(bmc664stop,2000,1,"Brandmeldezentrale 664 stoppen","Lokale Igis Karte
1"::"Brandmeldercomputer BMC 664":"Bedienung Bmc 664"."Alarm" = "Alarm vorhanden") >>>

Defines the program bmc664stop with priority 2000 as a fire program with the entry "Brandmeldezentrale 664
stoppen". Required parameters are Network, Object, I/O point, State and Function Value (optional)

References:
call
dismanual
exec
run
SIAS commands – alphabetical list
66 SIAS Overview of Commands - WINMAG plus

maximize
Command for screen designing
The window opened in WINMAG is maximized, the entire WINMAG program window is filled by one image.

If several windows are active and the contents of the WINMAG screen require changing, this is possible via the
menu item ""Window" .

Required parameters: - None

Example:
<<< maximize >>>

References:
cascade
maximizeprog
maximizepicture(nr)
minimize
tile
tilepicture
SIAS commands – alphabetical list

maximizepicture (nr)
Command for screen designing
In the current message window, one of the assigned graphics is maximized.

A graphic window is assigned with previous "picture" commands.

The picture can be sequentially changed by using the button in the program control bar.

Required parameters:
no = Number of the picture window (1, 2 or 3)

Example:
<<< maximizepicture (1) >>>

References:
cascade
maximize
maximizeprog
minimize
picture(Nr[,Name/ID])
tile
tilepicture
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 67

maximizeprog
Command for screen designing
In the current message window, the text area is maximized. Graphics that may be open are blanked out.

If graphic windows were assigned with previous "picture" commands, the picture can be sequentially changed by
using the button in the program control bar.

Required parameters: - None

Example:
<<< maximizeprog >>>

References:
cascade
maximize
maximizepicture(nr)
minimize
tile
tilepicture
SIAS commands – alphabetical list
68 SIAS Overview of Commands - WINMAG plus

message ("text" / Variable[+"text"/Variable],Nr)

Input of "text" or variable in the protocol database in the message type "Nr"

text = Text, that is contained in the message

Variable = Contents of an SIAS variable or a self-defined string variable. In the event of numerical SIAS
variables, conversion is made to string format.
No = Number of message = type of message.
The message texts are predefined in the database and can be adapted there accordingly
Defined numbers are between 1 and 10

Texts and variables with the character '+' can be strung together.

Message texts in the database table "Protocol types":

500 User-defined message 1: %1!s!
501 User-defined message 2: %1!s!
...
509 User-defined message 10: %1!s!

For every message the output location can be defined for every message (every combination possible):

On the screen in the messages window with delay time

In the database
On the protocol printer (if defined and ready for use)

When outputting the system protocol, individual inputs can be selected according to type of message and
contained characters.

Examples:
<<< message ("This is a fire alarm",1) >>>
The messages text “This is a fire alarm" is filed as user-defined message 1.

<<< message ("This is a fire alarm of "+I/O_name,1) >>>

Message with mp_name = "fire detector GF"
The messages text " This is a fire alarm of fire detector GF" is filed as user-defined message 1.

<<< message (mp_name,1) >>>

The contents of SIAS variable "mp_name" (I/O_name) is filed as user-defined message 1, e.g. "Group 1".

<<< var string Ausgabe = "Test">>>

<<< message (Ausgabe,1) >>>
The contents of the SIAS variable "Ausgabe" is filed as user-defined message 1, in this case: "Test".

References:
var
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 69

minimize
Command for screen designing
The alarm window is minimized, a text field appears in the left bottom corner with the program name and window
control elements.
The window can be maximized, cascaded or closed via the window control elements.

Required parameters: - None

Example:
<<< minimize >>>

References:
cascade
maximize
maximizeprog
maximizepicture(nr)
tile
tilepicture
SIAS commands – alphabetical list
70 SIAS Overview of Commands - WINMAG plus

mp_exists ("net"::"obj_name":"mp_name")
The function "mp_exists" is used to check whether the stipulated I/O pointF1ProjectGlossary40 exists.
In the event of a fault, the return value is the numerical value 0, otherwise a value >0.

Parameters:
net = Network name
obj_name = ObjectF1ProjectGlossary43 name
mp_name = I/O pointF1ProjectGlossary40 name
The parameters can contain character chains, numerical values or variables.

For application when a customer can enter individual parameters to execute a control – the customer stipulates
e.g. a group number and the command checks whether an I/O point exists for the stipulated group
numberF1ProjectGlossary40.
Without checking, the SIASF1ProjectGlossary49 programF1ProjectGlossary45 would be closed by a syntax error.

Examples:
<<< var group>>>
...
<<< if mp_exists((("IGISLoop 0 Knoten 68")::0:gruppe)) then >>>
<<< put ("IGISLoop 0 Knoten 68"::(0):(gruppe).(0) = (1) >>>
<<< endif >>>

Checks whether an I/O point exists for the stipulated valueF1ProjectGlossary40, if this is the case (Return value
<>0), the control command is executed.

References:
get_mp_text_data
is_mp_in_mandant
SIAS commands – alphabetical list

newpage
Closes the program flow until the input key or the continue arrow is activated. After continuing to run, a new page
of the text window appears. Jump to the previous page by clicking the red "back"-arrows” in the program.

The command "newpage" is a combination of the commands "waitforkey" and "cls".

Required parameters: - None

Example:
<<< newpage >>>

References:
waitforkey
cls
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 71

on_close_exec_macro(macroname)
Executes a macro when the SIAS program is closed.
The macro is also started when the SIAS program is placed in the stack.
Recurring close settings can be created using the macro.
Commands should be placed at the beginning of the SIAS program.

Required parameters:
macroname = Macro to be executed when program is closed

Example:
<<< on_close_exec_macro (abschluss) >>>

Every time the program is closed, the macro "abschluss" is called.

Switches can be set, controls executed in this manner ...

References:
on_control_exec_macro(variable,macro)
on_open_exec_macro(macro)
SIAS commands – alphabetical list

on_control_exec_macro(variablenname,macroname)
Monitors the change of a variable and starts a macro when the change takes place.

Required parameters:
variable name = Variable that is monitored for change
macro name = Macro to be executed in the event of variable change

Example:
<<< var string stop >>>

{bml b_del.bmp}
<<<{Control moit Variable "stop" , no input required}>>>
<<< on_control_exec_macro (stop,cam_stop) >>>
<<< waitforkey >>>

By selecting the button, the related variable is changed (even if a value is not required). Thus the assigned macro
in the example cam_stop is started.

References:
on_close_exec_macro(macro)
on_open_exec_macro(macro)
SIAS commands – alphabetical list
72 SIAS Overview of Commands - WINMAG plus

on_open_exec_macro(macroname)
Executes a macro when an SIAS program is executed.
The macro is also started when the SIAS program is repeatedly removed from the stack to be executed.
Recurring standard settings can be created using the macro.
The command should be placed at the beginning of the SIAS program.

Required parameters:
macro name = Macro to be executed when the program starts

Example:
<<< on_open_exec_macro (a_graphic1) >>>

Contents of the macro: <<< picture(graphicwindow_1) >>>

When the program is called, the alarm picture is activated in a 2-screen constellation with the macro on the
graphic window.
Without this call, the alarm picture would be activated when the program is first called, if the program is placed in
the stack and removed again, there would be no switching.

References:
on_close_exec_macro(macro)
on_control_exec_macro(variable,macro)
SIAS commands – alphabetical list

pager_call (message,address,coding)
with "pager_call", messages can be transmitted to the Ackermann PSA module.

Parameters:
message = Message
address = a valid address in the PSA system
coding = Value from 1 - 10, that must be set at a value that is valid for the PSA type

References:
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 73

parent_var typ name [=wert]

Defines a variable "name" of the type "typ" , that was used in the calling program using the command "var" and
which is used by both the parent process and the current process.
The variable thus enables exchange of data between parts of a program.
The value remains the same during run time of WINMAG.

Required parameters:
typ = Type of the variable
name = Name of the variable
Init = Initialization value [optional]

Examples:
Calling program
<<< var integer counter >>>
...
<<< call (Modul1)>>>
...
<<< display counter>>>
...

Program Module1
<<< parent_var integer counter >>>
...
<<< inc counter >>>

Uses a variable counter in the program Module1, that was defined with "var" in the calling program where it can be
used.

References:
system_var typ name [=wert]
var typ name [=wert]
SIAS commands – alphabetical list
74 SIAS Overview of Commands - WINMAG plus

picture (Nummer [,ID / ”Name”])

Output of graphic on screen.
The command expects the parameters

Stipulated window number

1 = Graphic window top right
2 = Graphic window bottom right
3 = Graphic window bottom left

WINMAG operates with consecutive numbers. If e.g. number 2 was stipulated, without using the value 1, 2 is
automatically displayed as window 1.
Stipulated window of the standard view graphicwindow_1 .. 48
optional stipulation of picture via
- ID number in the database (this assignment is always unambiguous)
- File name with path as filed in the database (in the event of multiple use of pictures in the picture tree this must
not be unambiguous, the picture must exist in the database)
If a picture is not assigned, WINMAG automatically searches for pictures that contain a
symbol that matches the message.

If WINMAG does not find a matching picture, the first picture of the picture tree is displayed.

The database ID of picture inputs can be queried via the function picture_id.
e.g. picture_id = ID of the first database input
If an input is not found, the function returns the value -1.

If further SIAS commands are not stipulated, the messages window is subdivided as follows when graphic
windows are opened.
- Left always remains the section for texts
- A graphic is displayed in the right half of the window
- With 2 graphics, the first graphic is displayed at the top right, the second graphic at the bottom right
- With 3 graphics, the third graphic appears at the bottom left.

The representation of windows can be changed within the program by activating the button in the program control
bar.
Enables switching between text / full frame graphics / divided image.
SIAS commands
- maximizetext displays the full frame text section
- maximizepicture(No) displays the full frame picture(No)
- tilepicture shows the divided image
Examples:
<<<picture(1)>>>
automatically displays the picture with message in the first graphic window
<<<picture(2,1)>>>
shows the picture with ID 1 (= top picture) in the second graphic window
<<<picture(3,"c:\bilder\bild1.bmp")>>>
shows the picture with the name bild1.bmp in the third graphic window

References:
Alarmfenster
get_parent_picture_id
Assistant
hardcopy
picture_id
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 75

picture_id[(netz::objekt:mp,nr)]
Determination of the database ID of an assigned graphic.
The query returns the found ID or the value -1.

Required parameters: None or:

netz = Network name or number of the I/O point that requires a graphic input
objekt = Object name or number of the I/O point that requires a graphic input.
mp = I/O point number or name
nr = Input number
The graphic database ID is automatically created when a graphic is inserted in the picture tree as a random
number.
If the picture input was determined via an assigned symbol, the database IDs of the current picture can be queried
with the command picture_id and further pictures with the I/O point via pictures related to the pictures.
picture_id = ID of the first database input
picture_id(1) = ID of the second database input
picture_id(2) = ID of the third database input
picture_id(3) = ID of the fourth database input
If an input is not found, the function returns the value -1.

Furthermore, the graphic IDs assigned to general I/O point information can be found via picture_id.
picture_id((netz::objekt:meldepunkt), 1) determines the first database input
picture_id((netz::objekt:meldepunkt), 2) determines the second database input
... up to input 10

Examples:
<<< p_id = picture_id((netz::objpanel_nr:mp_nr), 1)>>>
<<< if p_id >=0 then >>>
<<< picture(1,p_id)>>>
<<< display "Grafik: ",picture_name1>>>
<<< endif >>>
checks whether a graphic database input exists for an I/O point and displays the picture.

<<< display picture_id>>>

displays the graphic database input found first for an I/O point.

References:
get_parent_picture_id
picture(Nr[,"Name"/ID])
SIAS commands – alphabetical list
76 SIAS Overview of Commands - WINMAG plus

popup_autoclose
Resets the visibility of a pinned popup window to autoclose (=default value).

Required parameters:
- None

Examples:
<<< popup_pin_parent {Popup window remains open until the parent or popup window is closed manually }>>>
...
<<< popup_autoclose {Standard,popup window closes even if another popup window is opened or you have
clicked next to the popup window }>>>
...
References:
exec_popup_prog
popup_pin
popup_pin_parent
SIAS commands – alphabetical list

popup_pin
Sets the visibility of the popup window at pin, until WINMAG is closed or the window is closed manually.
This enables several popup windows to be open simultaneously.

When the maximum number of open popup windows is simultaneously reached, the oldest window closes
automatically when a further popup window is opened.
With the WINMAG version V10, a maximum of 10 popup windows can be opened simultaneously.

Without this command, a popup window is closed immediately when a further popup window is opened or you
have “clicked” next to the popup window.

Required parameters:
- None

Examples:
<<< popup_pin>>>

References:
exec_popup_prog
popup_autoclose
popup_pin_parent
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 77

popup_pin_parent
Sets the visibility of the popup window at pinned until the relevant parent window is closed or the window is closed
manually. .
This enables several popup windows to be open simultaneously.

When the maximum number of popup windows is open simultaneously, the oldest window closes automatically
when a further popup window is opened.
With the WINMAG version V10, a maximum of 10 popup windows can be open simultaneously.

Without this command, a popup window is closed immediately when a further popup window is opened or you
have “clicked” next to the popup window

Required parameters:
- None

Examples:
<<< popup_pin_parent>>>

References:
exec_popup_prog
popup_autoclose
popup_pin
SIAS commands – alphabetical list

popup_pos (x, y)
Sets the X- and Y-coordinate of a popup-window

Required parameters:
x = number of pixel horizontally
y = number of pixel vertically

Example:
<<< popup_pos(200,100)>>>
Sets the popup window to the position of 200 pixel from the left and 100 pixel from the bottom.

References:
back_color(R,G,B)
exec_popup_prog (programm)
popup_size(xy)
SIAS commands – alphabetical list
78 SIAS Overview of Commands - WINMAG plus

popup_size (x, y)
Sets the popup program window at a specific size.
After calling, the popup window is quite small and not suitable for displaying texts.

Required parameters:
x number of pixel horizontally
y number of pixel vertically

Example:
<<< popup_size(200,100)>>>
Sets the popup window at a size of 200 pixel width and 100 pixel height.

References:
back_color(R,G,B)
exec_popup_prog (program)
SIAS commands – alphabetical list

print_graphic(No,Printer)
Print out of a graphic page on a "Graphic printer".

Up to 10 graphic printers can be defined at a WINMAG computer.

These printers print graphics one screen at a time.
The print_graphic command can print without displaying a graphic, e.g. only what appears in a program window
on the screen can be printed.
The command requires the ID(s) of the graphics being printed and the printer number as parameters

Nr = ID of the graphic that requires printing

The graphic ID can be determined e.g., via the system parameters using the command
Get_System_Property("message/mp@graphic_ids").
Printer is the number of the printer according to the printer configuration 1 - 10
Instead of the numerical values, the terms graphicprinter_1, graphicprinter_2, graphicprinter_3, ... can also be
used.

Examples:
Print graphic with ID 2 on printer 2
<<< print_graphic (2, 2) >>>

Print all graphics of the current I/O point.

The ID's of the graphics are determined via system properties.
<<< print_graphic (Get_System_Property("message/mp@graphic_ids"), graphicprinter_2) >>>

References:
hardcopy(Nr,Drucker)
screenshot
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 79

priority(value)
Changes the priority of a program during run time.

Required parameters:
Value = Numerical value of the new priority
The value can be increased or decreased.
The execution of the program in the stack is determined according to the priority .
Changing the priority means:
- Other programs with equal priority can be executed before completion of processing
- No other programs can interrupt the current program.

Highest settable priority is 32000. If a higher value is stipulated, priority is set at 32000.

Examples:
<<< priority (10000) >>>
sets the priority at 10000
<<< priority (priority-100)>>>
decreases the current priority by 100

References:
exec (program,prio[,typ])
SIAS commands – alphabetical list

prog_width (pixel)
Sets the width of the section of the window for texts at a specific size.
Without this information, the window is divided in the middle for graphics and texts.

Required parameters:
pixel Number of pixels horizontally

Example:
<<< prog_width (400)>>>
Sets the width of the text section at 400 pixel. The remaining section of the window is for graphics.

References:
maximizeprog
picture(Nr[,"Name"/ID])
popup_size (x,y)
tilepicture
SIAS commands – alphabetical list
80 SIAS Overview of Commands - WINMAG plus

prot_off
Deactivates the protocol of SIAS demands in the program protocol.
put-commands for example no longer appear on the screen and in the protocol.

Example:
<<< prot_off>>>

References:
prot_on
SIAS commands – alphabetical list

prot_on
Deactivates the protocol of SIAS commands in the program protocol.
Put-commands for example no longer appear on the screen and in the protocol.

Example:
<<< prot_on>>>

References:
prot_off
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 81

put_graphic_pos(net::object:mp,x,y)
sets the middle position of the stipulated x/y coordinate of a graphic.

Required parameters:
net = Network name/number of the I/O point
object = Object name/number of the I/O point
mp = I/O point name/number
x= x-value of the coordinate (horizontal)
y= y-value of the coordinate (vertical)
The coordinate system of a graphic is defined for every graphic separately by two opposing points of a rectangle.
These can be, e.g. GPS coordinates, so that a symbol can be moved on the picture background according to the
received GPS data.
X- and Y- value must be an integer value that may also be negative.
The symbol that requires moving must have the attribute “Bewegtes Symbol” defined in the symbol properties.
(Dialogue "Größe oder Symbol-Aktionen ändern" in edit drawing mode).

The X/Y value 0/0 sets the symbol at the allotted original coordinate when processing.

Examples:
<<< put_graphic_pos(((net)::(obj_nr):(mp_nr)),435010,275680) >>>
sets the current I/O point of editing at the coordinates x = 435010, y = 275680 (e.g.43,5010° East, 27,5680° North

<<< put_graphic_pos("System"::"Variablen":"Wagen 1",435010,275680) >>>

sets a specific I/O point – in this case the symbol for "Wagen 1" at the coordinates x = 435010, y = 275680 (e.g.
43,5010° East, 27,5680° North

References:
get_graphic xpos
get_graphic ypos
put_graphic_text
SIAS commands – alphabetical list
82 SIAS Overview of Commands - WINMAG plus

put_graphic_text(net::object:mp="text")
Assigns a text to an I/O point, that can be displayed by a text symbol.

Required parameters:
net = Network name/number of the I/O point
object = Object name/number of the I/O point
mp = I/O point name/number
text = Text as a character chain or variable

The graphic text is stored in the computer memory and must be refreshed after restarting the WINMAG program.
Displayed are text symbols, that can be specially configured in the font, color and transparency of the typeface
and the background.
If the text symbol is higher than it is wide, the text is turned 90°.

Examples:
<<< put_graphic_text (((netz)::(panel_nr):(meldepunkt)) = Gruppe+"/"+Nr) >>>
Enters the group number and detector ID separated by "/" (e.g. 12/4 for group = 12 and No = 4) in the graphic text

References:
put_graphic_pos
SIAS commands – alphabetical list

put parameter
With "put" controls can be executed at connected terminal devices and at the PC.

Parameters:
put "net"::"obj_name":"mp_name"."state_name" = "fkt_name"
put mp_name."state_name" = "fkt_name"
put (net::obj_nr:mp.(0)) = (1)
put variablenname = wert
net = Network name
obj_name = Object name
mp_name = I/O point name
state_name = State name
fkt_name = Function value name
variablenname = Name of a variable defined previously with the command "var"
For control, the destination must be stipulated either with network, object, I/O point , control state and control
function value or in the abbreviated form by stipulating the variable name "mp_name" with state and function value.
In the abbreviated form, the edited message must have the corresponding state and function values, otherwise
the control will not be executed.
.
Variables can be entered for every parameter that must be enclosed in brackets.

The parameters are separated by determined separators..

As also system information, calendar, variables are displayed in WINMAG , access is possible to edit with the
command "put".
SIAS Overview of Commands - WINMAG plus 83

Examples:
<<< put "Lokale Igis Karte 1"::"MB100":"Gruppe 10"."intern sperren" = "aus" >>>
<<< put "System"::"Variablen":"Variable 1"."Wert 1" = "1" >>>
Stipulated control function with all parameters

<<< put (net::obj_nr:mp.(0)) = (1) >>>

Use of variables/constants, activates in state 0 the function value 1.

<<< put mp_nr."löschen"="löschen" >>>

Abbreviated form with use of the variable I/O point for clearing an alarm in a group of an MB100 (corresponding
EPROM required).

<<< put (net_nr::obj_nr:(21700)."Alarm")="rückstellen >>>

Network and object set via message variable, I/O point via number, switching condition and function must be
stipulated as a character chain.

Control according to groups/detector ID:

<<< panel_nr = GET_OBJ_NR_FROM_ID (netz,i_Gruppe, i_nr) >>>
<<< if panel_nr > 0 then >>>
<<< meldepunkt = GET_MP_NR_FROM_ID (netz::panel_nr ,i_Gruppe, i_nr) >>>
<<< if meldepunkt > 0 then >>>
<<< put (netz::(panel_nr):(meldepunkt).(0))=(0)>>>
<<< else >>>
<<< display i_Gruppe,"/",i_nr," MP:",meldepunkt," kein Meldepunkt gefunden">>>
<<< endif>>>
<<< endif >>>

put line counter = 10

set a variable defined in the program
References:
get_mp_nr_from_id
get_obj_nr_from_id
Meldepunkt
simulate "net","obj_name","mp_name","state_name","fkt_name
Variablen
SIAS commands – alphabetical list

reload_database
Compels reloading of the WINMAG plus database

<<< reload_database >>>

References:
SIAS commands – alphabetical list
84 SIAS Overview of Commands - WINMAG plus

remove("string", startindex, count)

Removes text characters from a text or text variable. A start position and the number of digits that require
removing must be stipulated.
The command demands output of the reduced character chain.

Required parameters that are separated by a comma:

string = character chain or variable, on which the removal is based
startindex = Start position from where removal has to begin.
Value range is from position 0 = beginning of character chain.
If the value is higher than the string length, nothing is removed and the entire string returned.
count = number of characters that require removing.
Value range is 1 to string length -1.

Examples:
<<< var string newstring >>>
<<< newstring = remove ("123456789",3,3)>>>
newstring contains 123789, 3 characters are removed after the third digit
<<< newstring = remove ("123456789",8,3)>>>
newstring contains 12345678, characters were removed after the eighth digit up to the end of the string

References:
find
insert
length
replace
substring
Variablen
SIAS commands – alphabetical list

replace_in_page
Replaces a free variable parameter by user-defined default

Required parameters:
text to replace - (free variable parameter)
replace text -

Example:
<<< replace_in_page ("TextToReplace", "ReplaceText") >>>

References:
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 85

replace_in_page(TextToReplace, ReplaceText)
Replaces the „TextToReplace“ with „ReplaceText“ in the current page

Required parameters:
TextToReplace = text which shall be replaced
ReplaceText = text which is inserted

References:
SIAS commands – alphabetical list

replace("string", "oldValue", "newValue")

Replaces text characters in a text or text variable. All digits found are replaced.
The command has the function, of outputting the changed character chain.

Required parameters that are separated by a comma:

string = character chain or variable, that is the basis for replacement
oldValue = character chain or variable content that requires replacing
newValue = character chain or variable content that requires inserting as replacement

Examples:
<<< var string newstring >>>
<<< newstring = replace ("123456789","3","4")>>>
newstring contains "124456789", the character 3 was replaced by 4
<<< newstring = replace ("123456789","a","b")>>>
newstring contains "123456789", no replacement found, original string was displayed
<<< newstring = replace ("11111xx",1,2)>>>
newstring contains "22222xx", all 1s were replaced by 2

References:
find
insert
length
remove
substring
SIAS commands – alphabetical list
86 SIAS Overview of Commands - WINMAG plus

reply "text"
Interrupts the program flow and displays a single line input dialogue

Required parameters:
"text" = text shown in the dialogue
The entered characters are filed in the variable "ANSWER" type string where they can be checked.

Example:
<<< reply "Wie geht es Ihnen ? >>>
shows the above dialogue on the screen
<<< display "Die Antwort war ",answer >>>
reports the entered text

References:
gettime"text"
report
SIAS commands – alphabetical list

report
Interrupts the program flow and display of multi-line input dialogue.

Required parameters: - None -

More text can be included than the input window displays on the screen. The text extraction is then moved into the
window.
After clicking "OK", the input text is entered in the protocol.

Example:
<<< report >>>

References:
gettime"text"
reply"text"
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 87

restart_driver(net)
The command stops the driver assigned via the Net-ID and restarts it.

Parameter:
net = Network name or network ID

Examples:
<<< restart_driver(103515222) {Fusion}>>>

stops the driver for the network with the network ID 103515222 and restarts the driver.
<<< restart_driver("IGIS_Loop1")>>>

stops the driver for the network with the name "IGIS_Loop1" and restarts the driver.

References:
run("program","parameter")
SIAS commands – alphabetical list

right_substring(string,separator)
Searches a substring to the right of the shown separator within a text variable.
The command has the function that of returning a variable/command.
If a substring is not found, the result is empty.

Possible parameters that are separated by a comma.

string = character chain or variable that requires testing

separator = separator. After the first time if appears, the left part of the character chain is returned.
Special characters:
CRLF = Carriage return + line feed

Examples:
Searches a fixed character chain, the result is 34
<<< result = right_substring("12.34", ".") >>>

Viewing of a search result of all disarmed zones and transfer of individual inputs to the variable test
<<< seek_alarm_reason( 91 ) >>>
<<< result = (get_system_property("sias@seek_result")) >>>
<<< while (length(result) > 0) >>>
<<< test = left_substring(result, CRLF) >>>
<<< display Get_System_Property("mp/addr/"+test+"@name") >>>
<<< result = right_substring(result, CRLF) >>>
<<< endwhile >>>

References:
left_substring(string,seperator)
substring
88 SIAS Overview of Commands - WINMAG plus

run("Programmname"[,"Parameter"][,Variable])
Calls an external program

Required parameters:
Programmname = Name of an external program (e.g. wordpad.exe)
Parameter = Start parameter for a program, e.g. name of file that requires opening
Variable = SIAS variable or self-defined variable
Other programs can be started from WINMAG using the command "run".
Possible applications:
- Call pager service
- Video messaging with external program
- Table calculation for alarm recording
- ...
Windows programs and DOS programs can be started.
If the start behaviour of the called program can be influenced by external parameters, they can be stipulated as a
character chain or with variables.

Examples:
<<<run (“\windows\mplayer.exe”, “/play /close \winmag\avi\test.avi”)>>>
Immediately starts the Windows media player (/play) with the file test.avi and closes the application when the
playback has finished (/close).

<<<run ("notepad",mp_name,".abc")>>>
Immediately starts the editor notepad and attempts to open a file with the name of the current I/O point .abc.

References:
call
exec
run_no_window
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 89

run_no_window("Programmname"[,"Parameter"][,Variable])
Calls an external program without window, e.g.batch command line files, that would open an unnecessary
command window with run.

Required parameters:
Programmname = Name of an external background program (e.g..bat-Datei)
Parameter = Start parameter for a programF1ProjectGlossary45, e.g. name of the file that requires
opening
Variable = SIASF1ProjectGlossary49 variable oder self-defined variable
Other programs without a window can be opened from WINMAGplusF1ProjectGlossary57 with the command
"run_no_window".
Possible applications:
- Execution of batch files, e.g. copying files
- ...

If the start behaviour of the called program can be influenced by external parameters, these can be stipulated as a
character chain or with variables.

Examples:
<<<run_no_window("c:\winmagplus\test\test.bat")>>>

Immediately starts the batch command line file test.bat in the background, without opening a window.

References:
Calll
Exec
run("program","parameter")
SIAS commands – alphabetical list

screenshot
Printout of WINMAG program window on the "Hardcopy" graphic printer.

The printout contains all frames contained in the working window at the time of printing, e.g. texts and graphics on
a page.

The screenshot can be activated via the menu input "Datei/Hardcopy drucken" or the button "Screenshot.

The printer is configured in the system configuration / printer set up / hardcopy printer.

Please observe the difference between the hardcopy command, that prints the individual windows on separate
pages.

Examples:
<<< screenshot >>>

Prints the current contents of the alarm window

References:
hardcopy(No,Printer)
picture
SIAS commands – alphabetical list
90 SIAS Overview of Commands - WINMAG plus

search parameter[,parameter][and "state_name"="fkt_name"]

Searches for I/O points, that fulfill the stipulated conditions e.g.
search "net","obj_name","mp_type_name","state_name"="fkt_name"
and displays same in the form of a structured list on the screen.

Network / object / I/O point(s) e.g. are stipulated:

Required parameters:
All parameters can contain wildcards ' '. If wildcards are used, the corresponding parameter is not checked.
net = Network name
obj_name = Object name
mp_type_name = I/O point type name
state_name = State name
fkt_name = Function value name
In the search argument, the I/O point type must be stipulated. Only I/O pointsMeldepunkt are checked that have
the stipulated I/O point type!

If several criteria require checking, search can be used to

query a further argument in the I/O point type with "and". A further state and function name must be
stipulated.
and a further search condition added as "or" with ' , '

Examples:
Simple condition:
<<<search "Lokale Igis Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "in Ordnung">>>

Reference with and:

<<<search "Lokale Igis Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "ausgeloest" and
"Hauptbereich" = "HB 1">>>

Several arguments:
<<<search "Lokale Igis Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "ausgeloest","Lokale Igis
Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "nicht vorhanden">>>

Wildcards:
<<<search :: :"Gruppe Einbruch MB100/16/8"."Zustand" ="ausgeloest">>>

References:
seek "net","obj_name","mp_type_name","state_name"="fkt_name"
search_alarm_reason (no)
search_alarm_type (no)
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 91

search_alarm_reason(nr[,nr])
Searches for I/O points with the stipulated alarm reason counter.
The alarm reason counter is related to the function values.

Required parameters:
nr = Alarm reason counter as a constant or numerical variable

Examples:
<<< search_alarm_reason( 23 )>>>
Searches for detectors, that have the alarm reason 23 in a state (=triggered detector)

<<< search_alarm_reason( 100,102 )>>>

Searches for detectors, that have the alarm reason 100 or 102 in a state (=fire alarms)

<<< search_alarm_reason( alarm_reason_nr )>>>

Searches for detectors, that have the same alarm reason as the message being edited

References:
search "net","obj_name","mp_type_name","state_name"="fkt_name"
search_alarm_type (no)
SIAS commands – alphabetical list

search_alarm_type(nr[,nr])
Searches for I/O points with the stipulated alarm type number.
The alarm type number is related to the function values via the assigned alarm reason.

Required parameters:
no = Alarm type number as a constant or numerical variable

Examples:
<<< search_alarm_type( 1 )>>>
Searches for detectors, that contain the alarm type 1 = fire warnings

References:
search "net","obj_name","mp_type_name","state_name"="fkt_name"
search_alarm_reason (nr)
SIAS commands – alphabetical list
92 SIAS Overview of Commands - WINMAG plus

seek [,parameter][and "state_name"="fkt_name"]

Searches for I/O points that fulfill the stipulated condition in the form of
seek "net","obj_name","mp_type_name","state_name"="fkt_name"
and enters them as a list in the protocol and displays them on the screen.

Input in the protocol:

seek "Lokale Igis Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "in Ordnung"
Gefundene Melder :
Meldepunktname: PIR Büro 9 (Gruppe 1)
Meldepunktname: MK Büro 9 Tür (Gruppe 2)
Meldepunktname: MK Büro 9 Fenster (Gruppe 3)
Meldepunktname: RK Büro 9 (Gruppe 4)
Meldepunktname: PIR Treppe 1.OG (Gruppe 5)
Meldepunktname: MK Tür Sekretariat 1.OG (Gruppe 7)
Meldepunktname: Gruppe 9
Es wurden 7 Melder gefunden

Required parameters:
All parameters can contain the wildcard ' '. The corresponding parameter is not checked if wildcards are
used
net = Network name
obj_name = Object name
mp_type_name = I/O point type name
state_name = State name
fkt_name = Function value name
The I/O point type must be stipulated in the search argument. Only I/O pointsMeldepunkt are checked that have
the stipulated I/O point type!

If several criteria require checking, search can be used to

query a further argument in the I/O point type with "and" . A further state and function name must be
stipulated.
add a further search condition as "or" with ' , '

Examples:
<<<seek "Lokale Igis Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "in Ordnung">>>

Reference with and:

<<<seek "Lokale Igis Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "ausgeloest" and
"Hauptbereich" = "HB 1">>>

Several arguments:
<<<seek "Lokale Igis Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "ausgeloest","Lokale Igis
Karte 1"::"MB100":"Gruppe Einbruch MB100/16/8"."Zustand" = "nicht vorhanden">>>

Wildcards
<<<seek :: :"Gruppe Einbruch MB100/16/8"."Zustand" ="ausgeloest">>>

References:
search "net","obj_name","mp_type_name","state_name"="fkt_name"

SIAS commands – alphabetical list

SIAS Overview of Commands - WINMAG plus 93

seek_alarm_reason(nr)
Searches for I/O points with the stipulated alarm reason from one or more existing alarm reasons.

Required parameters:
alarm reason number = number of requested alarm reason.

References:
seek_alarm_type

SIAS commands – alphabetical list

seek_alarm_type
Searches for I/O points with the stipulated alarm type from one or more existing alarm types.

Required parameters:
Alarmtype = requested alarm type

References:
seek_alarm_reason

SIAS commands – alphabetical list

send_prog_to_group
Sends the current SIAS program to the stipulated user group
Required parameters:
groupname - Name of the user group

Example:
<<< send_prog_to_group ("Groupname") >>>

References:
Send_prog_to_station
Send_prog_to_user
SIAS commands – alphabetical list
94 SIAS Overview of Commands - WINMAG plus

send_prog_to_station
Sends the current SIAS program to the stipulated station
Required parameters:
Station name

Example:
<<< send_prog_to_station ("Stationname") >>>

References:
Send_prog_to_group
Send_prog_to_user
SIAS commands – alphabetical list

send_prog_to_user
Sends the current SIAS program to the stipulated user
Required parameters:
Username - Name of the user

Example:
<<< send_prog_to_user ("Username") >>>

References:
Send_prog_to_group
Send_prog_to_ station
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 95

set_control_text("name"/variable)
Sets the assigned text at the SIAS control defined last.

Required parameters:
name = Character chain in double quotation marks
variable = String variable with contents
With the set_control_text command, the pre-allocations of interactive SIAS controls can be changed during the
run time.
E.g. a button can contain various texts depending on the current conditions or an input field has the value entered
last.

Examples:
{bml siased~1.bmp}
<<<set_control_text(user)>>>
sets the current user name in the editing field

References:
Controls
SIAS commands – alphabetical list

set_title_popup("title_string"/variable)
Sets the window title of a popup program.

Required parameters:
title_string = title name
variable = String-variable with content

Example:
<<<set_title_popup(obj-name+“ „mp-name)>>>

sets the current pop-up window title

References:
SIAS commands – alphabetical list
96 SIAS Overview of Commands - WINMAG plus

simulate
netz::objekt:meldepunkt.Eingangszustand=Funktionswert
A control can be simulated using "simulate" at connected terminal devices and at the PC.

The syntax corresponds with the put-command, the difference being that
with states, the input states
with the function values, the values of the input states
must be stipulated.
If the possible text parameters require simulating, the command „simulate_text“ must be used.

Example:
<<< simulate "Igis 1"::"MB100":"Hauptbereich 1"."Schärfungszustand" = "extern scharf" >>>

<<< simulate mp_nr.(0) = (1) >>>

sets the state 0 in the current I/O point at the function value 1

<<< simulate (net::obj_nr:(1101).(1)) = 1>>>

sets the I/O point 1101 in state 1 in the current network and object at the function value 1 (e.g. with a control panel
MB100.10 group 1, the state alarm at function value 1)

References :
Meldepunkt
put "net"::"obj_name":"mp_name"."state_name"="fkt_name
simulate_text ("net"::"obj_name":"mp_name"."state_name"="fkt_name,”text1”,”text2”,”text3”,”text4”,”text5”
SIAS_put)
SIAS commands – alphabetical list

simulate_text
(netz::objekt:meldepunkt.Eingangszustand=Funktionswert,text1,text2,text3,text4)
With "simulate_text", a control can be simulated at connected terminal devices and at the PC with the possible text
parameters.
Text parameters can have a maximum of 200 characters and be subdivided into 5 units.

The Syntax corresponds with the put command, the difference being that
the added text parameters are separated by a comma (1-5)
the printout must be enclosed in brackets
Example:
<<< simulate_text ("IGISLoop Knoten 1/3"::"EMZ 561-MB256":"Schlüssel an Schalteinrichtung 1"."letzte Aktion" =
"scharf","Max Mustermann","12345678") >>>

2 texts are transmitted that can be evaluated in the SIAS program via the parameter mp_text1, mp_text2

References :
Meldepunkt
put "net"::"obj_name":"mp_name"."state_name"="fkt_name t
simulate "net"::"obj_name":"mp_name"."state_name"="fkt_name
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 97

simulate_value (Netz::Objekt:MP.zustand,Wert)
With "simulate_value" a value can be assigned to an I/O pointF1ProjectGlossary40.
With multiaccess systems this value can also exchanged between the stations.

The I/O pointF1ProjectGlossary40 is determined by the stipulated network, objectF1ProjectGlossary43, I/O

pointF1ProjectGlossary40.

The value is queried via system properties.

A change of the value, triggers the alarm reason 700, so that changes can be reacted to with a
SIASF1ProjectGlossary49 programF1ProjectGlossary

Examples:
<<< simulate_value(((0)::(3):(1)), "Beispiel-Text 1") >>>
<<< delay(5) >>>
<<< display "value1:", get_system_property ("mp/addr/0::3:1@value") >>>

Sets the textF1ProjectGlossary40 "Beispiel Text1" for the I/O point of the object variable in the system network
The text is queried with get_system_property

References :
simulate "net"::"obj_name":"mp_name"."state_name"="fkt_name
put_graphic_text
SIAS commands – alphabetical list

single_symbol_off / single_symbol_on
Switches the graphic display in the alarm program

single_symbol_on only shows objects related to the message (symbols and image links)
single_symbol_off shows all objects (symbols and image links).
This is the standard value when a graphic is opened.

The symbol display can also be activated via the SIAS program control bar.

References :
SIAS commands – alphabetical list
98 SIAS Overview of Commands - WINMAG plus

sms_notification(telephone,"text"/variable[+"text"/variable][,web])
Transmits an SMS message via the WINMAG component "Notification" to a stipulated telephone number.
The notification can contain variables and constants.

Required parameters:
telephone = Destination telephone number as text or variable
text = Constant text enclosed in double quotation marks
or
variable = Variable with character chain or numerical value
+ connection of constant text enclosed in double quotation marks
or
variable = Variable with character chain or numerical values and variables
web = optional to enable the transmission of the notification via the esafetynet portal
The notification is executed as a function so that dispatch of the message and its acknowledgement can be
checked.
An SMS notification can have a maximum of 160 characters.

Examples:
<<< var integer notification_id >>>
<<< system_var string Ziel >>>
<<< notification_id = sms_notification (Ziel,alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>>
<<< delay(5)>>>
<<< if check_notification_sent (notification_id) then >>>
...
<<< endif >>>

Transmits a message comprising an event-related variable to a global telephone number defined elsewhere. After
5 seconds, transmission is checked.

References:
check_notification_ack(id)
check_notification_sent(id)
email_notification(to,supject,message)
fax_notification(telephone,message)
voice_channel(name,menu)
voice_notification(telephone,message)
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 99

sound(filename.wav[,loop,norestart])
Output of a sound file via soundcard.

The command expects the parameters

filename.wav
File name of the .wav-file to be played back with relative or absolute path
The relative path refers to a file in the WINMAG sub-directory "sounds"
loop
Repeat command until stopped

norestart
After continuing a stopped alarm program, the sound file cannot be restarted.
This parameter must be always be defined as the last parameter!

With the command "sound", a sound file can be output via a soundcard. The sound file is played back once without
stipulated parameters.
With the optional parameter "loop", the wav-file is played back until
- the "Sound off" switch is activated
- the alarm program is exited
If the sound file was started with the parameter loop and the alarm program placed in the stack and removed again,
the sound output is continued.
This can be cancelled with the parameter "norestart".

Examples:
<<< sound ("sounds\siren.wav")>>>
= one-time play back of sound file siren.wav

<<< sound ("sounds\siren.wav",loop)>>>

= repeated play back of the sound file siren.wav until stopped.

<<< sound ("sounds\siren.wav",loop,norestart)>>>

= after removing from the stack, the sound file is no longer played back.

INCORRECT: <<< sound ("sounds\siren.wav",norestart, loop)>>>

References:
beep
bell
generate_wav_file
speak (message)
SIAS commands – alphabetical list
100 SIAS Overview of Commands - WINMAG plus

speak ("message")
“Speak” speaks the stipulated text at the PC.
Conditions:
- The option notification must be included in the license
- The PC must be multimedia-capable in order to speak a text
- The spoken text depends on the installed and configured synthetic voice

Required parameters:
message = Parameter, that requires speaking
notification option must be set and configured.

Examples:
<<< speak ("Achtung, rufen Sie den Notdienst über Telefonnummer 123 an!")>>>
<<< speak (alarm_reason_name+" "+mp_name+" "+state_name+" "+fkt_name) >>>
speaks text according to notification e.g..
"Brandalarm Einzelmelder Rauchmelder 41/1 Verwaltung EG Raum 107 Alarm automatisch"

References:
generate_wav_file
sound"Name"[,loop]
SIAS commands – alphabetical list

stack_color(R,G,B)
Sets the stack input color at a specific color value

Required parameters:
R (red value) in the range from 0 - 255
G (green value) in the range from 0 - 255
B (blue value) in the range from 0 - 255
Examples:
<<< stack_color(0,0,255) >>>
sets the stack input at blue

References:
back_color(R,G,B)
exec (program,prio[,typ])
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 101

substring("string", startindex, length)

Creates a new character chain from a text or text variable. A start position and the number of digits to be used
must be stipulated.
The command has the function of outputting the abstracted character chain.

Required parameters that are separated by a comma:

string = Character chain or variable that are required as a basis of the string
startindex = Start position, from where the characters are to be used.
Value range is from position 0 = beginning of character chain.
If the value is higher than the string length, an empty string is returned.
length = Number of characters that are required.
Value range is 1 up to string length-1.

Examples:
<<< var string newstring >>>
<<< newstring = substring ("123456789",3,3)>>>
newstring contains "456", 3 characters are used after the third character
<<< newstring = substring ("123456789",10,3)>>>
newstring contains "", as nothing was found after the tenth character
<<< newstring = substring ("123456789",8,3)>>>
newstring contains "9", as only 1 character was found after the eighth character

References:
find
insert
length
remove
replace
Variablen
SIAS commands – alphabetical list
102 SIAS Overview of Commands - WINMAG plus

system_var typ name [=value]

Defines a variable "name" of type "typ" , that is filed in the system and is used jointly by all programs with the
definition "system_var".
The variable is thus global.
The value remains the same during the run time of WINMAG.

Required parameters
typ = Type of variable
name = Name of variable
Init = Initialization value [optional]

Examples:
<<< system_var integer counter >>>
Uses a variable counter in the program, that can be used by several programs, that all contain the above
mentioned definition

References:
parent_var typ name [=value]
var typ name [=value]
SIAS commands – alphabetical list

tile
Command for screen designing
All opened windows are arranged next to one another.
The size of the window depends on the number of windows and the size of the WINMAG main window.

Required parameters: - None -

Example:
<<< tile >>>

References:
cascade

maximize

maximizeprog

maximizepicture(nr)

minimize

tilepicture

SIAS commands – alphabetical list

SIAS Overview of Commands - WINMAG plus 103

tilepicture
Command for screen designing
In the alarm window, texts and graphics are arranged next to one another.

Required parameters: - None -

Example:
<<< tilepicture >>>

References:
cascade
maximize
maximizeprog
maximizepicture(no)
picture(No[,Name/ID])
tile
SIAS commands – alphabetical list

top
Sets the program window at the initial line.
If the window contains more lines than are displayed, the window scrolls through the contents and the bottom
section fills the window.
If the top section of the window requires showing, use the command <<<top>>> to move to this position.

Required parameters: None

References:
SIAS commands – alphabetical list
104 SIAS Overview of Commands - WINMAG plus

url(Address)
Calls the Internet explorer and displays the page with the title "Adresse".

Required parameters:
Address = URL
Internet explorer from Version 4.01 must be installed
URL shows the called page in the program window.
The contents of pages already displayed by the SIAS program are blanked out and in again when the URL_page
has been exited.

The address of the called page is filed in the protocol and not its contents.

Examples:
<<<url ("http://www.esser-security.com")>>>
Calls the esser homepage
<<<{Videobild des Videoservers anzeigen. Die Videoserver-Adresse ist im url-Befehl angegeben}>>>
<<< popup_size (492, 412) >>>
<<< set_title_popup("Videoserver / WebCam")>>>
<<< url ("http://10.10.1.3") >>>
<<< waitforkey >>>

References:
url_secure
get_playbacktime
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 105

url_secure [(Meldepunktnummer/ID)][+"&TYPE=1"]
Calls the Internet explorer and displays pages, that are provided by MultiAccess for Windows.

Required parameters:
I/O point number: optional transfer of an explicitly stipulated I/O point number.
Internet explorer from Version 4.01 must be installed
Passwords and addresses must be defined in WINMAG and MAfW

The target address and the required passwords must be defined in the
WINMAG network configuration, for the AC network in
in MultiAccess

If URL_secure is called without parameters, the current I/O point number (from the called program or by symbol
linking) is transferred to MultiAccess and information relating to the I/O point displayed.
For the I/O point numbers from 1 - 1000:
the last actions assigned to the I/O point

For I/O point numbers from 3001 - 3256:

the persons in the assigned range

The address of the called page is filed in the protocol and not its contents.

With the extension +"&TYPE=1", picture information is requested in Multiwin (Condition: Multiwin Version 6 and
assigned picture file, the ID must include the ID number).

Examples:
<<<url_secure>>>
Calls information relating to the current I/O point

<<< url_secure (1) >>>

Calls information relating to Door 1

<<< url_secure(ausweisnr+"&TYPE=1"){ mit Bild von Ausweisnummer = mp_text3}>>>

Calls picture information relating to the stipulated ID number. If a picture is assigned in Multitime from
Version 6, the picture information is transmitted to WINMAG and can be displayed

References:
url
SIAS commands – alphabetical list
106 SIAS Overview of Commands - WINMAG plus

use_popup_alarm_parameter
Commands, for using existing alarm parameters instead of parameters used in the direct context.

Required parameters None :

Examples:
<<< var integer ret >>>
...
<<< ret = has_popup_alarm_parameter >>>
<<< if has_popup_alarm_parameter then >>>
<<< display"Rückgabewert:", ret >>>
<<< use_popup_alarm_parameter >>>
<<< call (melderna) {Parameter vom Alarmprogramm}>>>
<<< endif >>>

<<< if has_popup_alarm_parameter then >>>

<<< use_popup_alarm_parameter >>>
<<< call (melderna) {Parameter vom Alarmprogramm}>>>
<<< endif >>>

References:
exec_popup_prog (programm)
has_popup_alarm_parameter
SIAS commands – alphabetical list

var typ name [=Init]

Defines a variable "name" of type "typ"

Required parameters
typ = Type of variable Assistent_Variablentyp
name = Name of variable
Init = Initialization value [optional]
Assistent_Init_Time

Examples:
<<< var integer counter >>>
Defines the variable counter and initializes it with 0
<<< var integer counter = 10 >>>
Defines the variable counter and initializes it with 10

References:
parent_var typ name [=value]
system_var typ name [=value]
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 107

voice_channel("text"/variable[+"text"/variable])
Creates a voice output via an existing telephone connection.
The text can be composed of both constants and variables.

Required parameters:
text = Constant text enclosed in double quotation marks
or
variable = Variable with character chain or numerical value
+ Connection of constants and variables

Examples:
<<< voice_channel (" Einbruchalarme :"+EMA_alarm) >>>
<<< voice_channel (" Kein Einbruchalarm anstehend.") >>>

References:
dtmf_menu(name, on_key_1()"text")
sms_notification(telephone,message)
SIAS commands – alphabetical list

voice_notification(telephone,"text"/variable[+"text"/variable][,web]
Transmits a voice message via WINMAG component "Notification" to a defined telephone number.
The message can contain both variables and constants.

Required parameters:
telephone = Destination telephone number as text or variable
text = Constant text enclosed in double quotation marks
or
variable = Variable with character chain or numerical value
+ Connection of constants and variables
web = Optional information to enable transmission of the message via the esafetynet portal
The message is executed as a function so that the actual dispatch of the message and its acknowledgement can
be checked.

Examples:
<<< var integer quittierung >>>
<<< system_var string Ziel >>>
<<< quittierung = voice_notification (Ziel,alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>>

Transmits a message comprising event-related variables to a global telephone number defined elsewhere.

References:
check_notification_ack(id)
check_notification_sent(id)
email_notification(to,supject,message)
fax_notification(telephone,message)
sms_notification(telephone,message)
voice_channel(name,menu)
SIAS commands – alphabetical list
108 SIAS Overview of Commands - WINMAG plus

wait(min)
Replaces a program sequence in the stack for "min" minutes

Required parameters:
min = Stipulated waiting in minutes
Value range 1-1000 minutes
The wait command interrupts the execution of the program for the stipulated number of minutes.
During the waiting time, the program is replaced in the stack and the program is no longer visible on the screen.
The number of minutes that the input remains in the stack, is displayed in the status column.
The program is restarted on expiry of the waiting time, if this is allowed by the priority control.
With the corresponding authorization for stack management, the program can be removed from the stack and
displayed on the screen again at all times.

Example:
<<<delay(10)>>>
Waits 10 seconds for the program to continue

References:
delay(sec)
waitforkey
SIAS commands – alphabetical list

waitforkey
Interrupts the program flow until the enter key or the continue arrow is activated.

Required parameters: - None

The wait commands enable the user to observe what is written on the screen.
After the waitforkey command, the green "Weiter" arrow is activated and the program continued with the enter key.

If controls are contained in the program flow, at least a wait command must follow the last control so that it can be
processed.

Alternative wait commands are:

confirm"text"
delay(sec)
gettime"text"
newpage
report
reply"text"
wait(min)

Example:
<<< waitforkey >>>
References:
Controls
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 109

winmag_exit
exits WINMAG and pays attention to user credentials.

Reference:
SIAS commands – alphabetical list

while (Bedingung) ... endwhile

A loop that is executed until the "Condition" is no longer fulfilled.

Required parameters:
Condition = logical condition, that can also contain several queries linked by operators (see if command)
The while- loop can be used depending on the condition as
- Counting loop
- Condition test
- Infinite loop

An important application of the while command is the triggering loop in the program "ausbed", in which incoming
messages are checked.
CAUTION! Assess your condition exactly and if necessary, allow for a escape hatch!

Examples:
Infinite loop in ausbed.wxe:
<<< while (1)
repeatproc
if... then... endif
...
endwhile >>>
Counter loop
<<< var integer counter >>>
<<< while (counter < 10)
inc counter
...
endwhile >>>
Control panel condition test
<<< while ("IGIS1"::"MB100":"Hauptbereich 1"."Schärfungszustand" = "unscharf")
put "IGIS1"::"MB100":"Hauptbereich 1"."schalten" = "unverz_intern_scharf" >>>
endwhile >>>

References:
if then endif
Auslösebedingungen
SIAS commands – alphabetical list
110 SIAS Overview of Commands - WINMAG plus

word_wrap_off
Command to deactivate word wrap in the text window.
The text can then also be scrolled horizontally in the window.
The standard state of the word wrap function in the text window is activated.
This command can be reactivated with word_wrap_on.

Required parameters None :

Examples:
<<< word_wrap_off >>>

References:
lock_tile_off
lock_tile_on
word_wrap_on
SIAS commands – alphabetical list

word_wrap_on
Command to activate word wrap in the text window.
The standard state of the word wrap function in the text window is activated.
This command should be used to reactivate a command previously deactivated using word_wrap_off.

Required parameters None :

Example:
<<< word_wrap_on >>>

References:
lock_tile_off
lock_tile_on
word_wrap_off
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 111

Alarm types
The system can differentiate between various alarm types.

A distinction is made between alarm reason and alarm type.

The alarm reason is automatically assigned to every message (in the I/O point type).
Every alarm reason however, is assigned to an alarm type.
In the alarm program, the alarm type is represented by a flashing icon in the top left corner of the window. Alarm
type and alarm reason can be queried in the program.

The alarm type is defined in the execution condition or via the alarm reason in the I/O point type description. The
assigned text and the icon can be defined separately in the database.

Tables such as the stack list, manual programs, program starts, can be displayed according to alarm type. For this
purpose, the tag with the corresponding alarm type must be selected. Inputs with the selected alarm type or all
messages are displayed.

User-defined names can be assigned to the defined alarm reason and alarm type names. If these exist, they will
be used.

Table of alarm types and alarm reasons (see also Programming Manual P03126-05)

Alarm type Id Name Alarm reason Id Alarm reason name

0 overview 0 -
0 overview 127 alarm finished
0 overview 128 malfunction finished
0 overview 129 activation finished
1 fire 1 fire alarm
1 fire 10 fire alarm single detection
1 fire 11 fire alarm detector group
1 fire 12 prealarm fire single detection
1 fire 13 prealarm fire detector group
1 fire 14 fault indication
1 fire 15 transmission
1 fire 16 fire key safe
1 fire 17 time is running
1 fire 18 smoke
1 fire 19 fire linear detector
1 fire 27 fire alarm
1 fire 100 Alarm automatic detector
1 fire 101 Alarm automatic group
1 fire 102 Alarm manual detector
1 fire 103 Alarm manual group
1 fire 104 not existing
1 fire 105 off
1 fire 107 switch on
1 fire 108 change detector
2 intruder 2 intruder alarm
2 intruder 3 attack alarm
2 intruder 20 intruder alarm single detector
112 SIAS Overview of Commands - WINMAG plus

Alarm type Id Name Alarm reason Id Alarm reason name

2 intruder 21 intruder alarm detector group
2 intruder 23 released
2 intruder 24 technical alarm
2 intruder 25 opening contact alarm
2 intruder 26 opening contact
2 intruder 28 bolt switching contact
2 intruder 29 pre alarm
3 fault 5 technical indication
3 fault 6 fault indication
3 fault 9 network error
3 fault 14 fault indication
3 fault 68 wireless malfunction
3 fault 190 LAN Loop net message
3 fault 191 LAN Loop rupture
3 fault 192 LAN Loop message
3 fault 450 paper out
3 fault 451 contamination
3 fault 452 ground fault
3 fault 453 low level fault
3 fault 454 fault
4 access control 4 indication by access control
4 access control 37 locked card
4 access control 38 number of paper changed
4 access control 39 special code
4 access control 40 message
4 access control 41 door open
4 access control 42 malfunction
4 access control 43 alarm
4 access control 44 area empty
4 access control 45 attendance
4 access control 46 released
4 access control 47 blocking
4 access control 48 permamently open
4 access control 49 key missing
5 system 7 system indication
5 system 8 program indication
5 system 180 initialized
5 system 181 initialization unsuccessful
5 system 195 user change
6 manual 99 manually released
7 tamper 22 tamper
7 tamper 62 tamper indication
8 attack 60 attack and danger
8 attack 61 hostage-taking
SIAS Overview of Commands - WINMAG plus 113

Alarm type Id Name Alarm reason Id Alarm reason name

8 attack 63 attack indication
9 switching 64 time interval alarm
9 switching 66 technical station
9 switching 90 ident key
9 switching 91 disarmed
9 switching 92 armed
9 switching 93 external armed
9 switching 94 changed
9 switching 95 blocking
9 switching 96 off
9 switching 97 day operation
10 WM 65 Wachtel-indication
10 WM 67 Wachtel-malfunction
11 time process 50 time
11 time process 51 time area A
11 time process 52 time area B
12 key safe 70 key management
12 key safe 71 Alarm
12 key safe 72 key missing
13 video 130 Video malfunction
13 video 131 Video alarm
13 video 132 off
13 video 133 on
13 video 134 event
13 video 135 tamper
14 escape door 140 emergency exit malfunction
14 escape door 141 emergency exit alarm
14 escape door 142 emergency exit offline
14 escape door 143 sabotage
14 escape door 144 emergency call
14 escape door 145 door released
15 BMS 150 BSMS malfunction
15 BMS 151 alarm
15 BMS 152 pre-alarm
15 BMS 153 signalling
15 BMS 154 warning
15 BMS 155 disconnection
15 BMS 156 revision
16 technical 159 inhouse emergency call
16 technical 160 technical alarm
16 technical 161 technical malfunction
16 technical 162 technical message
16 technical 163 water detector malfunction
16 technical 164 malfunction alarm
114 SIAS Overview of Commands - WINMAG plus

Alarm type Id Name Alarm reason Id Alarm reason name

16 technical 165 heat detector
16 technical 166 heat detector alarm
16 technical 167 gas detector
16 technical 168 gas detector alarm
16 technical 169 system malfunction
16 technical 170 malfunction
17 test/revision 30 Error message
17 test/revision 31 Input from fire alarm system
17 test/revision 32 Input from fire control system
17 test/revision 33 Input from PC switch control
17 test/revision 34 Output of fire control system
17 test/revision 110 Revision running
17 test/revision 111 Revision group running
17 test/revision 112 Revision group off
17 test/revision 113 Revision user
17 test/revision 114 inspection alarm
17 test/revision 115 diagnosis
17 test/revision 116 remote maintenance
17 test/revision 117 test
17 test/revision 118 test function
17 test/revision 119 test alarm
18 switch off 106 switch off
18 switch off 1060 detector in group
18 switch off 1061 group
18 switch off 126 terminated
19 control 109 triggering
20 user defined 20 200 user defined 200
20 user defined 20 201 user defined 201
20 user defined 20 202 user defined 202
20 user defined 20 203 user defined 203
… …. …. ….
29 user defined 29 296 user defined 296
29 user defined 29 297 user defined 297
29 user defined 29 298 user defined 298
29 user defined 29 299 user defined 299
30 warning 120 warning active
31 switch off general 121 switch off
32 sub malfunction 122 malfunction condition
33 output 123 output activated
34 information 124 information
34 information 125 important information
34 information 400 GPS-message
34 information 410 switching
34 information 411 call fire brigades
SIAS Overview of Commands - WINMAG plus 115

Alarm type Id Name Alarm reason Id Alarm reason name

35 guard supervising function 171 alarm
35 guard supervising function 172 malfunction
35 guard supervising function 173 incoming call
35 guard supervising function 174 logout PNG
35 guard supervising function 175 zone alarm
35 guard supervising function 176 test
35 guard supervising function 177 muting circuit
36 OPC 350 message
36 OPC 351 alarm
37 DEZ 370 message
37 DEZ 371 trouble
37 DEZ 372 line error
37 DEZ 373 alarm
37 DEZ 375 request
38 Clino 380 presence
38 Clino 381 call
38 Clino 382 priority call
38 Clino 383 emergency call
38 Clino 384 trouble
39 alarm 600 pre alarm
39 alarm 601 internal alarm
39 alarm 602 external alarm
39 alarm 603 alarm
40 message 500 normal
40 message 501 feed back
40 message 502 triggered
40 message 503 criterion
1000 not fixed 1000 not fixed
116 SIAS Overview of Commands - WINMAG plus

Defined alarm types :

(see also Programming Manual P03126-05)

Id Name Icon_id
0 Overview 233
1 Fire 159
2 Intruder 160
3 Fault alarm 169
4 Access control 218
5 System 166
6 Manual 251
7 Tamper 249
8 Attack 250
9 Switching 229
10 WM 229
11 Time process 220
12 Key safe 218
13 Video 163
14 Escape door 336
15 BMS 228
16 Technical 228
17 Test/Revision 166
18 Switch-off 233
19 Control 233
20 User-defined 20 169
21 User-defined 21 169
22 User-defined 22 169
23 User-defined 23 169
24 User-defined 24 169
25 User-defined 25 169
26 User-defined 26 169
27 User-defined 27 169
28 User-defined 28 169
29 User-defined 29 169
30 Warning 169
31 Switch-off general 169
32 Sub-malfunction 169
33 Output 169
34 Information 169
35 Guard supervising function 250
36 OPC 228
37 DEZ 228
38 Clino 228
39 Alarm 169
40 Message 169
10000 Not assigned 0
SIAS Overview of Commands - WINMAG plus 117

Alarm program
Alarm programs are executed in separate windows.
The structure of the program window can be defined in the program.
Not only graphics and texts but also a combination of graphics and text can be displayed.

Alarm window
{bml alarm.bmp}
The alarm program sequence depends on the program description (SIAS) and can be controlled by its own tool
bar.

Alarm window structure:

Heading with definition of the process
Alarmart ICON indicates the type of alarm by a flashing icon

Alarmarten Alarmarten
tool bar of the alarm window with possibility for
- go back
- go forward
- put the programm in the stack
- delete the program
- change the display mode between full sceen drawing or mixed text/drawing display

Message text with object name and I/O point name (flashes)

Optional text/graphic window

A maximum of 1 text and 3 graphics can be displayed simultaneously.

Stack display with status of inputs, in order of priority
118 SIAS Overview of Commands - WINMAG plus

Auslösebedingung (Executing/triggering condition)

Executing condition determines when a program has to be started.

In Winmag / WINMAG plus the Auslösebedingungen (Executing conditions) are edited in the file
"winmagex\ausbed.eff".
In WINMAGplus actions can be directly assigned to individual alarm types in the system configuration so that the
extent of the file Ausbed in WINMAGplus has been considerably reduced.

<<<while (1)
getParameter
{ Einbruch-Alarm}
if {(alarm_reason_nr = 2) or }(alarm_reason_nr = 20) or (alarm_reason_nr = 21) then
exec (Alarm,5000)
endif
{ Sabotage-Alarm}
if (alarm_reason_nr = 62) or (alarm_reason_nr = 22) then
exec (Alarm,7000)
endif
{ Überfall-Alarm}
if (alarm_reason_nr = 63) then
exec (Alarm,8000)
endif
{ Störmeldungen}
if (alarm_reason_nr = 5) or (alarm_reason_nr = 6) then
exec (Stoerung,2000)
endif
{ Brand-Alarm}
if {(alarm_reason_nr = 1) or }(alarm_reason_nr = 10) or (alarm_reason_nr = 11) then
exec (Alarm,10000)
endif
{ Zeitprogramm Pause -----------------------------------------}
if ((mp_name = "09:00")or (mp_name = "12:00")) and (state_nr = 0) and (fkt_nr = 1) then
exec (pause,20000)
endif
{ Totmannschaltung -------------------------------------------}
if (mp_name = "Totmann") and (fkt_name = "Alarm") then
exec (totmann,31000,5)
endif
{ Initialisierungen -----------------------------------------}
{ Netz-Meldung }
if (alarm_reason_nr = 9) then
exec (fail,30000,5)
endif
endwhile >>>

The executing/triggering conditions are contained in a while loop, that is always fulfilled.
This means that the program always runs as long as a jump is not made to the internal WINMAG edit functions.

- Messages are read in from the networks with the SIAS command "repeatproc"
- All contained conditions are tested in the program loop with the input message.
- If a condition is fulfilled, a program can e.g. be started with the command "exec".

The program ausbed.wxe always runs, even if another program is also running at the same time (e.g. alarm
program).
SIAS Overview of Commands - WINMAG plus 119

Comments <<<{ ... }>>>

Comments are part of the SIAS source files (.eff), that are not used as a command or display text.

Comments are enclosed in curly brackets <<<{ Comment }>>>

Comments can comprise several lines.
Comments cannot be nested (comment in comment).

Comments can only be written within SIAS blocks ( <<< to >>> ).

Examples:
<<< if alarm_type_nr = 2 then {2 = Alarmtyp Einbruch} >>>
<<<{Program type: Popup
Purpose: This program serves to control an intrusion detector zone taking into consideration the current
state and user rights
Parameters: Network and object are assigned by the related symbol
Issued: 12.07.2007
Author: Max Mustermann}>>>
120 SIAS Overview of Commands - WINMAG plus

Operators
The following operators are possible in conditions and comparisons:

and Logical AND

or Logical OR
from...to Between query
() Brackets
< Less than
> Greater than
= Equal
<= Less or equal
>= Greater or equal
<> Unequal

and / or
"and" and "or" are logical references, that can be used in

Trigger conditions
Program code

Various conditions can thus be linked together.

Recommendation:
- Write understandable links
- Set more brackets than are necessary (as considered necessary)
- Comment your condition

Examples:
Triggering condition:
<<< { request "triggered" and "not present" at group1 (mp_nr = 101) and
(state_nr = 0) and
((fkt_nr = 1) or (fkt_nr = 2))) then....>>>

Program code:
<<< if time > 12:00 and time < 13:00 then....>>>
SIAS Overview of Commands - WINMAG plus 121

Controls
In addition to texts and SIAS commands, a SIAS file can also contain "Components". These are embedded,
independent programs that have their own functionality and communicate with the SIAS application.

The controls can be positioned as text characters in a text and are integrated in the program flow optically
(contrary to dialogues, such as confirm, that are positioned on top of the respective application window).
This enables the designing of more visually sophisticated programs.

The "controls" can be configured via their properties.

The following can be set in the control:
- Color
- Size
- Typeface
- Text content
- Corresponding variable
- Editing behaviour (single or multiple choice)
- Input required
- Automatic continuation after activating button

The program run is controlled by SIAS commands. An SIAS wait command such as <<<waitforkey>>> must
always follow one or several control commands so that the user can edit the controls.

{bml C_Button.BMP}SIASButtonCONTROL
The button can be activated and can transmit the button legend to a variable.
The button can have a bitmap.
{bml C_CHECK.BMP}SIASCHECKBOXCONTROL
The checkbox shows a tick after selecting and can also display the date and time of activation at the right or left of
the button. The setting of the acknowledgement tick can be assigned to a numerical variable.
{bml C_COMBO.BMP}SIASCOMBOBOXCONTROL
The combobox enables the selection of an input from a list of possibilities. The selected input can be assigned to
a string variable.
{bml C_EDIT.BMP}SIASEDITCONTROL
The edit control enables the input of a character chain in the size of the box. A maximum of 255 characters can be
assigned to a string variable.
{bml C_listb.BMP}SIASLISTBOXCONTROL
The list box enables the selection of an input from a list of possibilities. The selected input can be assigned to a
string variable.
{bml C_yesno.BMP}SIASYESNOCONTROL
The control enables a Yes-No selection. If one of the individually writable buttons is activated, the button text can
be assigned to a string variable.
With the SIAS command freeze_controls, the multiple activation of the controls can be frozen – all controls before
the command cannot be changed.

With the SIAS command set_control_text. the text contained in the control can be changed during run time.
Several text lines can be assigned.
122 SIAS Overview of Commands - WINMAG plus

Example:
<<< var string Polizei>>>

Call the police ?

<<< waitforkey >>>
<<< freeze_controls>>>
<<< if (Police = "Yes") then .... endif>>>

The string variable "Police" is defined first. This is assigned to the SIASYESNOCONTROL in the properties as a
variable.
The control is part of a text block (not a SIAS block) and can be enclosed in a text.
With the "Waitforkey" command, the program flow waits after the control. Depending on the properties, the
program is immediately continued by activating the control or a continue button must be activated (simulate next
page). If the user requires multiple selection, automatic continuation should not be defined ( no single action ).
With the command "freeze_controls, the further selection possibility for the control is deactivated.
The text of the selected button is assigned to the variable "Police" and can then be queried.
.

<<<set_control_text(user)>>>
sets the current user name in the editing field

References:
freeze_controls
set_control_text
waitforkey
SIAS commands – alphabetical list
SIAS Overview of Commands - WINMAG plus 123

Variables / Variable types

List of defined variables (see also Programming Manual P03126-05)
alarm_reason_name alarm reason name
alarm_reason_nr alarm reason number
alarm_type_name alarm type name
alarm_type_nr alarm type number
answer answer string from reply/query
arrival received date + time of message
day current day in form dd.mm.yyyy
fkt_name function value/name of the message
fkt_nr function value/number of the message
found number of found items in search/seek
hour current hour
in_mandant message belongs to logged-in mandantory
lite identification code for operation mode lite
minute current minute
mp_family_type_name i/o device family type name of the message
mp_family_type_nr i/o device family type number of the message
mp_id1 first identification number of the I/O device
mp_id2 second identification number of the I/O device
mp_name i/o device - name of the message
mp_nr i/o device number of the message
mp_text i/o device additional text
mp_text1-5 i/o device specific text (1-5) are set from drivers
mp_type_name i/o device type - name of the message
mp_type_nr i/o device type - number of the message
net network name of the message
net_nr database ID of the network
obj_name object name of the message
obj_nr database ID of the object
obj_text object text from object system configuration
obj_id_text object-ID-text from object system configuration
obj_type_name end device type name of the object
obj_type_nr end device type number of the object
offline identification for program state online/offline
picture_id Picture ID
picture_name1-3 name of picture displayed via “picture”
priority priority of the program
response response to “gettime” in format date
second current second
severity severity from alarm reason definition
simulated identification for programs with simulated start
state_name state name of the message
state_nr state number of the message
station_nr station number - virtual address of the station (multi-station)
time current time in format hh.mm.ss
user user name logged-in
user_group(1..32) user group allocation, 1 = member of the group
user_priority control priority of the user logged-one
weekday weekday in system format (Mon, Tue, Wed,...Sun)
124 SIAS Overview of Commands - WINMAG plus

Assistants
Assistants support the creation of commands with parameters.

A command assistant therefore, is only available for more complex commands. The structure of the assistant
varies according to the structure of the command.

The assistant queries the required parameters, assists in making a decision by selection lists and inserts the
command at the current cursor position.

Call an assistant
{bml AS_assi.BMP}When selecting a SIAS command in the command insert dialogue with assistant, a button
appears for calling the corresponding assistant.

Sequence control in the assistant

The work sequence in the assistant is controlled by buttons.

back go back to previous sequence

forward go forward to next sequence
cancel close the assistant
help call for help
finish insert the command

{bml as_butt.bmp}
After inserting all required parameters, the completed command is displayed in an edit window and can be
changed manually before inserting.

By selecting the button "Übernehmen" , the command inserted in the file at the current cursor position.

Available assistants
Assistants exist for the following SIAS commands:

call manual
confirm maximizepicture
comment message
confirm picture
dec priority
delay put
disable reply
dismanual run
display search
enable seek
exec simulate
gettime sound
hardcopy var
if wait
inc while
SIAS Overview of Commands - WINMAG plus 125

Assistant picture tree number

The position of pictures is defined in WINMAG as follows:

1. For one picture the right half of the alarm window

for more than one picture the top half of the alarm window
2. Right bottom half of the alarm window
3. Left bottom half of the alarm window
Text is the left alarm window, with a third picture the top left corner

Note:
Areas for pictures are filled in the above mentioned sequence
If an input for the 2nd picture is executed, the input is positioned on the first picture area !
Pictures are always displayed in full frame.
When displaying only one picture, the right half of the alarm window is used for the picture
For printing texts on a graphic printer, the program button must be selected !

Select assistant printer

The printer selection dialog supports the assignment of the printer in the hardcopy command.

WINMAG supports up to 5 connected graphic printers and a protocol printer at one computer.
The graphic printer used for the output must be defined for every print order. If the same output is required on 2
printers, 2 print requirements must be made.

The assistant is used to select whether the output is to take place at printer 1.,2.,3.,4. or 5. For this purpose, the 1st
graphic printer is assigned to the term graphicprinter_1 etc.
Which printer is physically connected to printer 1, must be defined in the WINMAG system parameters in the
printer menu.

Only printers can be assigned that were installed in Windows.

126 SIAS Overview of Commands - WINMAG plus

Assistant Variable type

For defining a variable, the variable type must always be stipulated.

Please select one of the possible data types:

Integer
Numerical variable for counters. Calculations can also be made with these variables.
Examples:
<<< var integer Wiederholungen = 5 >>>
<<< var integer Zaehler >>> (initialized with 0)

String
Character chains - Variable to hold texts e.g. from variables such as detector names, answer,
Examples:
<<< var string Passwort = "Hallo" >>>
<<< var string Zeichenkette >>> (is initialized with empty string "" )

Date
Date variable to hold a defined date, e.g. from the variable day
The format of the variable is: dd.mm.yyyy
Example:
<<< var date Weihnachten = 24.12.1997 >>>

Time
Time variable to hold a defined time, e.g. from the variable time, response
The format of the variable is: Hours:Minutes:Seconds
Example:
<<< var time Pause = 09:00:00 >>>
<<< var time Mittag = 12:00 >>>
<<< var time NullUhr >>> (Zero hour is set at 00:00:00)

A variable is defined by
- Stating the key word var
- Stating the variable type
- Stating the variable name
- Optional stating of initialization value according to the variable type = ...
SIAS Overview of Commands - WINMAG plus 127

Assistant variable name

When defining a variable, the variable name must also be stipulated.

Note:
The variable is only valid in the SIAS program, in which it was defined.
The variable name must be unambiguous in the SIAS program
The variable name should be descriptive so that the intended purpose is already obvious from the name
The variable name should not contain any mutations (ä,ü,ö)
The variable name must be composed of a continuous character chain
The length of the variable name is limited to 20 characters
A distinction is made between capital and small letters
Global variables that are valid beyond the limits of an SIAS program, can be defined as system I/O
pointsMeldepunkt.
Network:System
Object: Variables
The following global variables are defined at the time of delivery:
Variable 1, Variable 2, Variable 3, Initialization, Alarms

Examples:
var integer Alarmzaehler
var integer Wiederholungen = 5

Assistant Init Integer

Please enter the numerical value that is required for initializing the integer variable.

Without initialization, the standard value is set at 0 .

Both positive and negative values can be used.

Examples:
<<< var integer Wiederholungen = 5 >>>
<<< var integer Zaehler >>> (is initialized with 0)

Assistant Init String

Please enter the character chain that is required for initializing the string variable. The character chain can be of
any length (max. approx. 2 billion characters)

Without initialization an empty string "" is entered.

Any characters can be used.

Examples:
<<< var string Passwort = "Hallo" >>>
<<< var string Zeichenkette >>> (is initialized with "" )
128 SIAS Overview of Commands - WINMAG plus

Assistant Init Time

Please enter the time required for initializing the time variable.

The format of the variables is: Hours:Minutes:Seconds

Examples:
<<< var time Pause = 09:00:00 >>>
<<< var time Mittag = 12:00 >>>
<<< var time NullUhr >>> (Zero hour is set at 00:00:00)

Assistant Display
The display command enables the output of variables and texts in an SIAS program.
A number of parameters can be output in a command.
The individual inputs must be separated by a comma.

Example:
display "The detector ", mp_name," has the value ", state_name

Cyclical components can be strung together in the assistant, until the radio button "Eingabe beenden" was
activated.

The following can be combined

Constant texts (character chains)
Self-defined variables and internal variables
I/O point states

A set radio button can be reset via the respective button.

Assistant alarm type

The alarm type is the category in which the event is classified.
Each category is identifiable in the stack general view or in the program lists as a tab.

WINMAG already contains over 10 alarm types. The list of types can be extended accordingly.

Example for alarm types:

Fire
Intrusion
Fault
SIAS Overview of Commands - WINMAG plus 129

Assistant picture tree

Pictures in WINMAG are arranged in a hierarchical structure. Starting from a "Root picture" the next level is
reached via "Picture References". The depth of this father/son structure is virtually unlimited.
A picture can appear more than once in this structure – together with other assigned symbols (e.g. the same
picture for fire and intrusion).
Therefore, it is important to define precisely the correct picture position if a specific picture output is required in an
alarm program.

The assistant shows the picture structure starting from the "Root picture".
- The levels are shown by indenting.
- The next level is reached by a double click on a file name or by clicking the preceding +- character, that indicates
a further level.

If possible, a preview of the picture can be displayed in the preview window.

Assistant function value

Dialogue for selecting the function value that requires editing.

The possible values must be selected from a list in alphabetical order. The checkbox contains the first value of the
list in alphabetical order.

By entering a letter, a jump can be made to values beginning with this letter.

Assistant If While
The If query is one of the most vital elements of the SIAS syntax.
The contained conditions can include various parameters, e.g.
- Comparisons
- logical And-References
- logical Or-References

Assistant Init Date

Please enter the date, that is required for initializing the date variable.

Without initialization, the standard value is set at 01.01.1995.

Examples:
<<< var date Weihnachten = 24.12.1997 >>>
<<< var date noinit >>> (is initialized with 01.01.1995)
130 SIAS Overview of Commands - WINMAG plus

Assistant I/O point

Dialogue for selecting an I/O point
The dialogue appears, e.g. in the assistant for the commands put, simulate, enable

Condition:
The I/O point must exist in the WINMAG database
The I/O point must be activated

Procedure
1 Select the network in the table view, that contains the I/O point (in the example "Local IGIS card 1")
2 Select the Object in the table view, that contains the I/O point (in the example "MB100")
3 Select the I/O point in the table view (e.g. "Group 14")
4 Press the " Next >" button
{bml AS_mp.BMP}

Assistant I/O point type name

The I/O point type dialogue supports the selection of an I/O point type as required in the search- and seek program.

All possible types, e.g. types defined in the database are offered in the list.

Note:
As all I/O point types are offered (as the type is not limited to an Object), the I/O point type must be selected
with caution !
Linked commands, e.g. in GEMAG are currently not possible

Assistant preview
After entering all required parameters, the completed command is displayed in an editing window and can be
changed before assigning.

After selecting the button " Next > " no further entries are possible and the command can be inserted

By selecting the button "Übernehmen" at the current cursor position in the file
and not inserted
By selecting the button "Abbrechen".
SIAS Overview of Commands - WINMAG plus 131

Assistant Program name

The program name must always be stipulated when defining or calling a program.

Note:
The program name should be descriptive so that the intended purpose is already obvious from the name
A distinction is made between capital and small letters
Program names are globally valid in WINMAG!
> Names must be unambiguous
> Every program is saved in a separate file

Examples:
call (program name)
exec (Program name, priority[,Type])
manual (Program name,priority,Type,"Text"[message])

Select assistant sound

Dialogue for selecting a sound file that can be played back using the "sound" command

Conditions:
Files in .wav format can be used as sound files.
A sound card and loudspeaker are required for sound output
Procedure:
1 Enter sound file name in input field or select button "Sound-Datei suchen"
2 Select sound file with extension .wav in the file dialogue
3 If necessary, activate the parameter "Sound endlos abspielen"
4 Select "Weiter >" button
132 SIAS Overview of Commands - WINMAG plus

Assistant system variable

The assistant enables a system variable to be selected from a list.

Examples:
alarm_reason_name Alarm reason name
alarm_reason_nr Alarm reason number
alarm_type_name Alarm type name
alarm_type_nr Alarmtype number
answer Answer string from reply/query
arrival received date + time of message
day Current day in format dd.mm.yyyy
fkt_name Function value name of message
fkt_nr Function value number of message
found Number of found items in search/seek
mp_name I/O point name of message
mp_nr I/O point number of message
mp_type_name I/O point name of message
mp_type_nr I/O point number of message
net Network name of message
obj_name Object name of message
priority Priority of program
response Response to "gettime" in format date
state_name State name of message
state_nr State number of message
time Current time in format hh.mm.ss
user User name
weekday Weekday in system format (Mon, Tue, Wed,...Sun)

To output self-defined variables, the variable name must be defined manually.

Assistant text
Input of a text.

The text is output according to the previous text formatting.

Assistant comparison
The comparison dialogue enables the choice between the following
Whether the current state of an I/O point matches a predefined value
Whether a system variable/ individual variable contains a specific value
Various subsequent dialogues appear according to the selection made via the "Radio Button".
SIAS Overview of Commands - WINMAG plus 133

Assistant comparison variable

The dialogue supports the comparison of system variables / individual variables and variables or texts with a
selectable operator.

Example:
if (answer = "123") then ....

Possible operators:
= Equal
<> Unequal
< Less
> Greater
>= Greater than
<= Less than

Assistant comparison operators

The comparison operator dialogue presents a list of the possible operators.
The following operators are possible depending on the operands:

= Equal
<> Unequal

Assistant value
Please enter the value at which the desired printout requires setting.

Examples
- Stipulated priority in program calls
- Increment in INC command = Value by which the variable requires increasing
- Decrement in DEC command = Value by which the variable requires decreasing

Assistant state name

Dialogue for selecting the state that requires processing.

The possible values shall be selected from a list in alphabetical order. The pull-down menu is preoccupied with the
first value of the list in alphabetical order.

By entering a letter, a jump can be made to values beginning with this letter. .

Depending on the command type, input or output states are displayed in the list.
- Input: With command put, enable, disable
- Output: With command simulate
134 SIAS Overview of Commands - WINMAG plus

Terms
Alarm sequence
An alarm sequence is a sequence of commands that are executed by the system when a trigger condition is
fulfilled.
All alarm sequences have a priority.
They can contain control commands, texts, graphics, multimedia elements, selections.

Alarm reason
Automatically assigned alarm specification, e.g. fire alarm single detector, fire alarm group. Several alarm reasons
are assigned to an alarm type, e.g. fire

Alarm type
= Alarm type into which the alarm lists and programs can be divided, e.g. fire, intrusion, system

Trigger condition
The trigger condition determines under which circumstances special actions require executing in the system, e.g.
start an alarm sequence.

Tree diagram
Hierarchical display with pull-down menus
+ = Further sub-levels exist
- = Lowest level reached

DAO
Data Access Objects = Library. Contains the JET engine = "Database engine"

Database
Collective term for "Database" and "Database system". "Database" = one or more files containing all data.
"Database system" = management system for the files in the database

DEZ9000
Digital receiving terminal station for processing remote control information via different transmission media. The
incoming messages can be transmitted to WINMAG.

Dump
Table of incoming messages

Terminal device
A user at the IGIS network is described as a terminal device.

Next image
Next image is a graphic that was reached via a next image link from a superior graphic

Next image link

Next image link is formed by a rectangular frame of any size. By clicking this area with the left mouse button, a
jump is made to the next image.
SIAS Overview of Commands - WINMAG plus 135

Function value
Function values are values that a state can adopt.
A maximum of 16 different function values can be assigned to a state.

Graphic
A graphic is the graphical representation of a monitored zone. The graphic can have dynamic symbols for
displaying detectors.

Main address
Address in the IGIS network that can adopt the master function.
A main address is every address that can be divided by 8 and the address 0.

IGIS
Integrated hazard information system = effeff network

JET engine
= "Database engine". Is responsible for the actual database management.

Calendar
Determination of specific days. A calendar extends over 4 years. Calendars can be queried in trigger conditions
and programs.

Convert
Programs to convert existing GEMAG data into WINMAG data. Drawings, symbols, object data with I/O points and
programs can be converted.

Headshot
The top image in the image tree structure

Master
User at the network that currently occupies the network control. The master must be set at a main address.

Master change
Automatic change of master network control when current master is deactivated.
The next higher main address takes over the master function.

I/O point
An I/O point is an address, under which information can be obtained from connected devices. I/O points can
contain up to 8 x information states.

Object
An object is a component connected to the management system, e.g. intruder alarm control panel.

ODBC
= Open DataBase Connectivity, is a standard introduced by Microsoft for access to databases. A specific “ODBC
driver” is required for the respective database.
136 SIAS Overview of Commands - WINMAG plus

Program
A program is sequence of commands that can be executed
The program contains commands for alarm processing, control commands, graphic displays, multimedia
elements,...

Procedures
Procedures are a logical sequence of commands.
They serve as modules for programs.

Frame bus
Honeywell bus that can be connected to IGIS via an IGIS-LAN frame interface. Up to 7 users in the close vicinity
can be connected to a frame bus.
The frame addresses are the IGIS addresses between the main addresses (all addresses that cannot be divided
by 8).

SIAS
SI cherheits - A nwendungs- S prache - Security application language
Alarm programs and triggers are formulated in this syntax
e.g. confirm for a YES/NO query

SIASEdit
Editor and translator for user-specific WINMAG programs.

SQL
= "Structured Query Language", a standardized database query language

Symbol
A symbol is the graphical representation of an I/O point.
Its form of representation depends on the current states and function values of the I/O point.

Thread
Part of a program that can be processed simultaneously to other parts. Every alarm program runs in its own
thread.

Ur master
Ur master is the user with the address 0, that starts the network operation. Only users that are known to the
Urmaster when the network is started, can participate in the network operation.
Every main address can take over the master function from the Ur master.

IQ MultiAccess
Novar access control system with direct coupling to WINMAG.

WINMAG plus
WINMAG plus is the hazard management system with visualization and individual alarm processing by Novar.

State
The state is one of a maximum of 8 x information states of an I/O point.
A distinction is made between input and output states.
Input = from terminal device to the management system
Output = from the management system to the terminal device
SIAS Overview of Commands - WINMAG plus 137
Honeywell Security Group
Novar GmbH
Johannes-Mauthe-Straße 14
P03126-15-0G0-02
D-72458 Albstadt 2011-02-16
www.honeywell.com/security/de © 2011 Novar GmbH