Porovnávané verzie

Stará verzia 14

changes.mady.by.user D2000 Dev Team

Uložené

porovnané s

Nová verzia Aktuálny

changes.mady.by.user D2000 Doc Team

Uložené

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

...

Kotva
audit_info
audit_info
AUDIT_INFO [REINIT [USER|RESGROUP]]
The process without parameters writes out the status of monitoring, or storing of auditing information (see also Object Group - monitoring changes in configuration).
Parameter REINIT USERS causes the writing the current configuration of all objects of *User* type into the monitoring database.
Parameter REINIT RES_GROUP causes the writing the current configuration of necessary objects of *Object group* type into the monitoring database.
In any object type is not stated in the command, both type of objects will be written into the monitoring database.
BACKUP SYSCFG pathCreates a configuration database backup in a directory specified by the parameter path.

Note 1: The backup can be influenced by the setting of parameter ConfigBackUpTimeout.
Note 2: This functionality can not be used for databases built on PostgreSQL. Such databases can be backed up according to this instruction.
BACKUP LOGFILE pathCreates a log database backup in the directory specified by the parameter path.

Note 1: This functionality can not be used for databases built on PostgreSQL. Such databases can be backed up according to this instruction.
BACKUP VALUES pathCreates the backup of the database VALUES. DB in the directory specified by the parameter path.
CFGSYNCHROAUTO ON/OFFEnables / disables the automatic synchronisation of configuration databases after a new SBS (stand-by server) is connected.

Note 1: The command can be applied to HOT server only.
Note 2: The synchronization can be influenced by the setting of parameter ConfigSynchroTimeout.
CHECK_ARCHIVEChecks a value type consistency between primary archive object and the archival one and shows the errors (writes it into log). The error is, if the value type of the primary archive object is different than value type of the archival object.
Kotva
deploy_java_shared
deploy_java_shared
DEPLOY_JAVA_SHARED

If some files - the external and user libraries for Java, placed in directory %lt;appldirgt;/java/shared are changed, D2000 Server will send these files to all running clients.

DI ON/OFFDebug Info - shows / hides internal debug information of D2000 Server (in the process window and in the process D2000 Sysconsole).
DP ON/OFFDebug Pipe - enables / disables the displaying of the communication of D2000 Server with client processes (only if the D2000 Server's window is displayed on the desktop).
INSTANCE SET|GET ACTIVE|PREFERRED|USABLE ...

It is used to determine and set the active instance, preferred instance and instance mode in a load-balancing mode.

INSTANCE GET PREFERRED process_nameShows the number of the preferred process instance.
Kotva
set_pref_inst
set_pref_inst
INSTANCE SET PREFERRED process_name instance_number

Sets a preferred process instance.
It is used to set the preferred archive if the archives run as instance (for more information see the chapter Redundant archiving). By default, the instance with minimal number is active.
This parameter can be used also for setting up the D2000 KOM process (for more information see the chapter Redundancy of communication process KOM).

The command writes the number of the preferred instance into the system registers:

HKEY_LOCAL_MACHINE\Software\Ipesoft\D2000V70\cfg_Meno_Aplikacie\Kernel\SELF.ARC_PreferredActiveInstance

Warning: If the preferred value is 0, the process instances are not switched actively while the terminated active instance is started. I.e. when some active instance is finished, other existing instance will be a new active instance. If there are more process instances, the active one will be that with the minimum number. This process instance remains active even if other one is started (it had to be active before termination).

Incorrect termination of the active and preferred instances may change the preferred process instance. If the active instance crashes while other instance is operating, it becomes a new preferred active instance (with the minimum number).

INSTANCE GET ACTIVE process_nameEnables to display the number of active process instance.
Kotva
set_act_inst
set_act_inst
INSTANCE SET ACTIVE process_name instance_number

Sets the active instance of given process.
The parameter is used for setting up the active instance of archive process, if all the instances are running as instances (for more information see the chapter Redundant archiving). By default, the instance with minimal number is active.
This parameter can be used also for setting up the D2000 KOM process (for more information see the chapter Redundancy of communication process KOM).

The command switches the active instance of the process.

INSTANCE GET USABLE process_name instance_numberEnables to display '1' if a process of given instance is active in load-balancing mode. If not, then '0'.
Kotva
set_inst_usable
set_inst_usable
INSTANCE SET USABLE process_name instance_number 1|0
Sets the instance of process as active or passive in Load balancing mode (see the chapter Redundant archiving - Load balancing).

 

MESSAGE Message_Text process_nameBroadcasts (sends) a text message to client processes. The process name can be entered as a mask (e.g. *.HIP - for all processes D2000 HI). If the return code is Success, it contains the number of clients, the message from D2000 Server was sent to.
LIC_PostponeLicWrnToUsers
0 až 240 [hod], default 24		Delay of license warnings for common users. The administrators of D2000 will get the license warning always and immediately.
LIC_DoNotAllowConsoleOverLimit
0|1, default 0		When setting 1, the system will not allow to connect consoles (HI) over the scope of license.
LIC_DoNotAllowSysProcOverLimit
0|1, default 0		When setting 1, the system will not allow the system processes (CALC, EVENT, KOM,...) over the scope of license.
RD_SET_HOT serverNameSets the hot server in the redundant system. The parameter serverName is the name of server within the frame of the redundant group.
Kotva
refresh_licence
refresh_licence
REFRESH_LICENCE
On-line refresh of the information about the licence range (from file LicenceRun.code or LicenceDev.code) and information about the network clients (from file ConsolesInfo.txt). It enables to change the licence range without any need to stop the system - as well as re-reading the list of network clients after it has been manually edited.

Note 1: In redundant systems it is necessary to replace the files LicenceRun.code or LicenceDev.code on all redundant servers.
Note 2: In redundant systems it is necessary to modify the file ConsolesInfo.txt only on the active (HOT) server. The changes will be transferred to all SBS servers.
Note 3: The information about the licence is sent to the client processes when connecting to D2000 Server. For that reason, if the change of licence affects even other processes than D2000 Server, they must be restarted. For example, when a user add a new communication protocol, it influences D2000 CNF process. To enable this protocol in D2000 CNF, it must be restarted. Also, when adding a new communication station and I/O tags with the given protocol to D2000 KOM process, it must be restarted.
RELOAD_PARAMSLoads all parameters for kernel (except the parameters for saving the monitoring database to the depository). The D2000 System may not be restarted.
RELOAD_SECURITYSets the new configuration of Security Policy with no need to restart D2000 System.
REPAIR_ARCHIVEChecks a value type consistency between primary archive object and archival one. If some error occurs, it will repair it immediately and write information into log. The error is if the value type of the primary archive object is different than value type of the archival object.
RESTART process_nameStops the given process and then starts it correctly.

Note: If the process is stopped (Stop or Crash status), the command just starts it.

Kotva
set_load_bal_mode
set_load_bal_mode
SET_LOAD_BAL_MODE
process_name mode
Activates/deactivates Load balancing mode (see the chapter Redundant archiving - Load balancing).

Example:
SET_LOAD_BAL_MODE SELF.ARC 1 - activates Load balancing mode for SELF.ARC process.
Kotva
show_access_list
show_access_list
SHOW_ACCESS_LIST

The command writes the list of the names registered by the action GETACCESS within the application (with the keyword PUBLIC) into the text console and to the log file (kernel.log) of the process D2000 Server.
The list contains the owner of register name as follows:
computer_name;process_name;event_name/activepicture_name

Example:
ACCESS LIST BEGIN
GETACCESS : "RegisteredName" is locked by : ComputerName;SELF.EVH;E.EventName
GETACCESS : "RegisteredName2" is locked by : ComputerName;ComputerName.HIP;S.PictureName
ACCESS LIST END

SHOW_ARC_STAT
process_name		Shows the statistical information about the running instances of archive - the maximum number and sum of the read requests that are being processed.
Kotva
show_config
show_config
SHOW_CONFIG
Shows configuration information of the process D2000 Server.
This information covers:
  • start parameters of process D2000 Server,
  • configuration parameters of D2000 system installation common for all applications,
  • parameters of process D2000 Server specified in Windows registry (specific for running application),
  • in redundant systems parameters of redundancy specified in Windows registry (specific for running application),
  • parameters specific for ODBC and OCI versions of process D2000 Server.
  • detailed information on the number and structure of the tags
    For Structured Variables: Object Name; number of tags; the number of tags according to the methodology into the version D2000 V11
    ;D2RECORD;SV.DaE_Export_Head; 0; 11
    For Structured Eval Tags: Object Name; number of tags;
    ;CLC_VAL Struct;P.TASK_SUM_Pending; 13

    Summary information on the contribution to the total number of tags for each object types:
    Number of tags for structured variables from V11 and to V11
    ;D2RECORD;Summary V11+; 9126
    ;D2RECORD;Summary OLD; 49044

    Number of tags for structured eval tags
    ;CLC_VAL Struct;Summary; 314

    Number of tags for eval variables
    ;CLC_VAL;; 98
    Number of tags for I/O tags
    ;POINT;; 25
    Number of tags for user variables
    ;USER_VAR;; 2095
    Number of tags for remote objects
    ;REM_OBJ;; 2
    The total number of application tags
    ;TOTAL TAGS;; 11510

Note: By comparing the information, obtained by this tell command, it is possible to find out whether D2000 Server processes in redundant group are configured identically, resp. if any parameter was omitted during migration of application server.
Kotva
show_dyn_info
show_dyn_info
SHOW_DYN_INFO object_name or HOBJ

Shows dynamic information on the specified object (list of objects that dynamically or statically use the object) on the text console of the process D2000 Server.

Note: The command is intended to be used mainly for D2000 System diagnostic purposes.

SHOW_DYNO_LIST idFirst idLastThe command dumps the list of current dynamic objects (ID and object name) to the text console of process based on the defined interval.

Note: The command is mainly intended for diagnostic purposes.
SHOW_TRANS_LISTLists internal transactions of the D2000 system.

Note: The command is intended to be used mainly for D2000 System diagnostic purposes.

SHUTDOWN D2000Stops D2000 System.
SHUTDOWN RESTARTStops D2000 System and restarts the operating system.
SHUTDOWN SHUTDOWNStop D2000 system and shutdown operating system.
SHUTDOWN WINNTStops D2000 System and restarts the operating system.
START process_nameStarts specified process.
STDOUT outputThe command redirects the standard output to new output specified by output.

Example:
D2000 on OpenVMS platform: STDOUT "_TNA2:" (output is redirected to the terminal _TNA2:)
D2000 on Windows platform: STDOUT C:\output.txt (output is redirected to the file output.txt)

Note: If a D2000 process is run on Windows platform as a service, console output is disabled.

STOP process_name [FORCE]It stops a process. When using the optional parameter FORCE, the termination of process will be forced.
*SUSPEND* SLEEP [WAKEUP yyyy-mm-ddThh:mi:ssZ]|HIBERNATEIt causes, that operating system switches into sleep mode (SLEEP) or hibernation (HIBERNATE). If OS switches into sleep mode, user may define a time of its automatic awakening by the parameter WAKEUP yyyy-mm-ddThh:mi:ssZ, where yyyy-mm-ddThh:mi:ssZ defines UTC time of awakening. The string must be in ISO 8601 format (http://sk.wikipedia.org/wiki/ISO_8601).

Example: *SUSPEND SLEEP WAKEUP 2015-02-11T12:00Z* - causes putting the computer to sleep and automatic awakening at noon, February 11th, 2015 (UTC).
Kotva
tcp_no_delay
tcp_no_delay
TCP_NO_DELAY process_name|process_mask [FALSE|TRUE|QUERY]
Enables, disables or queries the delay of data transfer between the process D2000 Server and the client connected via TCP/IP protocol. Setting the parameter TCP_NO_DELAY to TRUE disables TCP delay before sending TCP packets (function setsockopt with parameter TCP_NODELAY - see Nagle's algorithm). The delay improves efficiency of TCP/IP networks by reducing the number of packets that need to be sent over the network. On the other hand if the communicating partners wait for each other's response (e.g. remote procedure calls between two EVENT processes or between HI and EVENT), this delay can significantly slow down execution of scripts and other interactions.
By default TCP delay is on (TCP_NO_DELAY = FALSE).
This tell command is intended only for tuning and debugging purposes.

Note 1: When registering a TCP/IP client, the process D2000 Server queries the value of parameter TCP_NO_DELAY and, depending on this value, it does or does not change the parameter TCP_NO_DELAY for client connection. This value is then sent to client, which also changes TCP_NODELAY parameter of its TCP connection to server.
Warning: In current implementation the tell command TCP_NO_DELAY does not cause any change in the setting on client's side!
Note 2: Besides the parameter TCP_NO_DELAY, there is also another parameter which influences sending TCP delayed acknowledgments (it can be set on OpenVMS and *nix system by calling sysconfig -r inet tcpnodelack). This parameter induces a 200 ms delay before sending TCP acknowledgments and it can interact with TCP_NODELAY parameter.
Kotva
xml_export0
xml_export0
XML_EXPORT
Warning: Since the version V8.00.001, the command is not supported.

XML file(s) export from the directory, which is defined by the parameter path, together with the following parameters:

  • Path –  defines the directory where the objects will be exported; required parameter.
    It must contain the complete path, e.g. c:\XML. The path must exist. If it does not exist, the export is not allowed.
    Instead of fixed path, the user can select the default directory - by entering the value "*" into parameter.
    The default directory is placed in "[APP_DIR]\XML_EXPORT", where APP_DIR defines the application directory, e.g. c:\D2000\D2000.APP\application_name\XML_EXPORT" ".
  • Mask – defines the mask, which correspond to the list of objects that are to be exported; required parameter.
  • optional settings of XML_SETTINGS

The path for the file export on VMS must be written in Unix format.

Correct syntax: /DKB0/d2000/d2000-app/RIS_ROVE/XML/ mask
Incorrect syntax: DKB0:[d2000.d2000-app.RIS_ROVE.XML] mask - this syntax is not supported, export ends with error.

Kotva
xml_export_table
xml_export_table
XML_EXPORT_TABLE 
The configuration parts export to the XML files, which is not the part of the object configuration.
The parameters: [Path, FileName, TableName].
  • Path - defines the path for saving the configuration.
  • FileName - defines the name of output file. E.g. for the file "systemtxt", there is created the file with the name "systemtxt.xml".
  • TableName - defines the table of database, which the configuration is to be exported from.
    TableName can acquire following values: SYS_COLORS, SYSTEM_TEXT, TRANS_MASKA, DICTIONARY, LANGUAGES, LOGDEF, NAME_RULES.

Warning: Extension ".xml" is added automatically, do not write it.

Kotva
xml_import0
xml_import0
XML_IMPORT
Warning: This command is not supported for OpenVMS.

XML file(s) import from the directory, which is defined by the parameter Path.
The parameter:[path_to_dir / path_to_file]

The initialization of tell command is conditioned by using a configuration key.

The path for the file import on VMS should be entered in Unix format.
Correct syntax: /DKB0/d2000/d2000-app/RIS_ROVE/XML/
Incorrect syntax: DKB0:[d2000.d2000-app.RIS_ROVE.XML] - this syntax is not supported, import of directory containing XML files ends with error

The import of one file supports the both records:
Correct syntax: /DKB0/d2000/d2000-app/RIS_ROVE/XML/file.xml
Correct syntax: DKB0:[d2000.d2000-app.RIS_ROVE.XML]file.xml

Note: The command belongs to the "security" TELL commands. I.e., it can be activated only from interactive processes with configuration key or from process D2000 Event Handler.

Kotva
xml_import_table
xml_import_table
XML_IMPORT_TABLE
Import of the configuration parts that is not the part of the object configuration from XML files.
The parameter [Path, FileName, TableName[, CleanTable]]
  • Path - defines the path from which the configuration will be read.
  • FileName - defines the name of input file without xml extension. For example, "systemtxt" for the file with the name "systemtxt.xml".
  • TableName - defines the table of database to which the configuration is to be imported.
    TableName can acquire following values: SYS_COLORS, SYSTEM_TEXT, TRANS_MASKA, DICTIONARY, LANGUAGES, LOGDEF, NAME_RULES.
  • CleanTable - defines whether the table in database will be cleaned before import.
    This parameter is optional, default value is FALSE.
    Parameter can acquire two values: TRUE - clean table, FALSE - table is updated.

The initialization of tell command is conditioned by using the configuration key.

Note: The command belongs to the "security" TELL commands. I.e., it can be activated only from interactive processes with configuration key or from process D2000 Event Handler.

Kotva
xml_settings
xml_settings
XML_SETTINGS
Warning: Since the version V8.00.001, the command is not supported.

Sets the parameters for TELL commands XML_IMPORT a XML_EXPORT.

The command without parameter displays the default parameters of D2000 Server.

Kotva
xml_update
xml_update
XML_Update
Partial update of the objects by XML from the directory, which is defined by parameter Path.
The parameter:
[path_to_dir / path_to_file]

Note: The command belongs to the "security" TELL commands. I.e., it can be activated only from interactive processes with configuration key or from process D2000 Event Handler.

...