Porovnávané verzie

Stará verzia 11

changes.mady.by.user D2000 Dev Team

Uložené

porovnané s

Nová verzia 12

changes.mady.by.user D2000 Dev Team

Uložené

Kľúč

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

...

BACKUP [path]Creates an archive database backup. If the parameter path is not specified, the backup will be performed into the directory, which is set in the archive configuration.
Kotva
calc_old_requests
calc_old_requests
CALC_OLD_REQUESTS [path+filename]
Executes recalcs of old values, which were redirected to the auxiliary calc task (see the archive parameter RecalcImmediateDepth) and then instead of being performed were stored to the file (see the archive parameter DropOldRequests). If path+filename is not specified, the file name_ARCHIV_DROPPED_CALCS.DAT will be processed by name.ARC and then renamed to name_ARCHIV_DROPPED_CALCS.DONE (if such a file exists, it will be deleted).

Note: This command fails if the archive parameter DropOldRequests has value 1, because in this case the recalcs would be again stored to the file after being read.

Kotva
cleanup_slices
cleanup_slices
CLEANUP_SLICES
A command that must be run after the change of parameter DataTableSlices from value 1 to value 2 (i.e. after changing the time slices mode to time slices for structured archives only).
Archive will transfer the archived values from time slices of simple archives to the original data tables and these time slices will be deleted.
Note: for simple archives, from start of the the archiv till the transfer of archived values to the original data tables, the archiv will provide only data which are located in original data tables. Therefore this conversion is recommended only for systems with redundant archives and the archive performing conversion should be set as passive instance.
CRC path\filename mask from to [step] [PO]
Parameter checks the data identity in instance archives. Creating the file with CRC (checking sum) for archive objects that correspond to mask for entered time period.
Optional parameter step (in hours) allows to divide the calculation for time period into intervals.
The parameter PO ensures the calculation will be executed only for primary archive data.

Kotva
crc_poznamka
crc_poznamka
Note: Values entering the CRC calculation can be "truncated" - in a 64-bit floating point value complying with the IEEE 754 standard, the two lowest bytes will be zeroed, if a debug category DBG.ARCHIV.CRC.Z2LB is enabled. The truncation can be used to ignore minor differences (16. and higher decimal point), which can occur in floating point calculations in archives running on different processors.
CRC_TREE path\filename name row col from to [step]Parameter checks the data identity in instance archives. Creating the file with CRC (checking sum) for archive objects that correspond to mask for entered time period.
The calculation will be realized for object that has been defined by parameter "name row col" and for all objects that influence its value.
Optional parameter step (in hours) allows to divide the calculation for time period into intervals.
See the note to CRC command.
DEL mask [before]Deletes data from the archive database as follows:
  • the parameter before is not defined - for individual archive objects, there will be deleted all data that are older than the history depth (the parameter History depth) defined in the configuration of the objects,
  • the parameter before is defined - there will be deleted all data with the timestamps older than defined by the parameter before.
Kotva
delete_data
delete_data
DELETE_DATA mask from [to]
Deletes data from the archive database without activation of dependent statistics evaluation (similar to the action DELETEARCHDATA).
Time format is dd-mm-rrrr hh:mi:ss.mss.
DI ON/OFFDebug Info - shows / hides internal debug information of the process D2000 Archiv (in the process window and in the process D2000 Sysconsole).
DI ON/OFF [HOBJ/mask [ROW [COL]]]Debug Info for values - enables / disables displaying information about the evaluation of historical values with specified HOBJ or with the name matching given mask. For structured historical values, you can specify required structure item - column (if ROW=0) or row (if COL=0).

Example:
DP ON H.Test1 3 4 - enables debug information for the item of structured historical value H.Test1 on row 3 and column 4
DP ON H.Test2 - enables debug information for historical value H.Test2 (for all items if the object is a structure)
DP OFF 1234 0 4 - disables debug information for the whole column 4 in the structured historical value with HOBJ=1234

By default, debug information shows just the time and the value of historical value. Enabling the debug category DBG.ARCHIV.DATA (in the process D2000 System Console or using the start parameter /E+DBG.ARCHIV.DATA when starting the process D2000 Archiv), allows to show the complete stored data designed for the D2000 System developers:
Time (archive value time)
Value (value)
Status (a True/False array containing Valid, ProcAlarm, NoAckPAlarm, PrAlSilent, Weak, NoAckValue, Transient, Default, Manual, AlCrit, Unknown values)
Limits (one of the value of InLimit, VL_Limit, L_Limit, H_Limit, VH_Limit, LimitsProblem)
ArchFlags (a True/False array containing Start, Stop, Block, UnBlock, Deleted, UserModify, OldVal, ProcesModify, LoadData, MONO_TIME, K, L, M, N, O, Ver1 values)

DI ONREC/OFFREC HOBJ/mask [ROW [COL]]Debug Info for values - recursive. The command extends the functionality of the previous commands with the possibility of showing / hiding the debug information for historical values that depend on specified historical values (e.g. minute averages).
Kotva
dismount_trezor0
dismount_trezor0
DISMOUNT_TREZOR path+trezor_name
Sybase platform: The parameter path+trezor_name specifies the path and the name of the depository database to dismount. The * and ? characters for mask definition can be used in the depository database name. If more files match to entered mask, all these ones will be dismounted.

For more information see the topic On-line access to data from depository databases.
Kotva
dismount_trezor_ora0
dismount_trezor_ora0
DISMOUNT_TREZOR Id [SEGMENT seg]
DISMOUNT_TREZOR trezor_name [SEGMENT seg]
DISMOUNT_TREZOR IdFrom IdTo [SEGMENT seg]
Oracle platform: The parameter Id or trezor_name defines the number (name) of depository database to dismount.
Name of depository database is the name of depository tablespace (e.g. MYAPP_TS_TREZOR15 or MYAPP_TS_TREZOR15_02) or name of tablespace's datafile (e.g. MYAPP_TS_TREZOR0015_S02_20040801.ORA).
You can also dismount all depository databases (except the ones that are currently being filled) by using the parameter all. The parameters IdFrom and IdTo allow to dismount a sequence of depository databases.
The parameter SEGMENT seg (where seg is the number of depository database segment) allows to dismount just the segment. Seg is the number between 0 and TrezorCountSegments. If the command DISMOUNT is used without the parameter SEGMENT Seg for depository database segments enabled, the process D2000 Archiv attempts to dismount all segments of specified depository database/s.

For more information see the topic On-line access to data from depository databases.
Kotva
dismount_trezor_pg
dismount_trezor_pg
DISMOUNT_TREZOR Id [SEGMENT seg]
DISMOUNT_TREZOR IdFrom IdTo [SEGMENT seg]
PostgreSQL platform: The parameter Id defines the number of depository database to dismount.
You can also dismount all depository databases (except the ones that are currently being filled) by using the parameter all. The parameters IdFrom and IdTo allow to dismount a sequence of depository databases.
The parameter SEGMENT seg (where seg is the number of depository database segment) allows to dismount just the segment. Seg is the number between 0 and TrezorCountSegments. If the command DISMOUNT is used without the parameter SEGMENT Seg for depository database segments enabled, the process D2000 Archiv attempts to dismount all segments of specified depository database/s.

For more information see the topic On-line access to data from depository databases.
DP ON/OFFDebug Pipe - shows / hides the course of communication with D2000 Server (only if the process window is displayed on the desktop).
DROP_LIST path+filenameCreates the file (defined by the parameter path+filename) containing SQL commands to delete tables, which are not used by the archive configuration. If the time slices are enabled, the file will contain also the commands to delete respective rows of the table ARC_SLICE, which contain information about the time slices corresponding to tables that are to be deleted.
Kotva
fill_cache
fill_cache
FILL_CACHE
Manual loading of archive cache (only available for isochronous cache mode) by reading values from archive database.
Archive cache loading can be also automatic after startup - for more information see description of parameter IsoCacheAutoFill.
Kotva
force_clear
force_clear
FORCE_CLEAR HOBJ/mask
For selected object(s), their ClearTime is set to a value of several hours in the past, which means that a periodic delete of object's data should occur shortly - within a minute (unless it is disabled for some reason, e.g. if the time slices are enabled, it can depend on parameters DeleteInSlice0 and DeleteInSlices).
Kotva
freeze
freeze
FREEZE freeze_seconds [report_seconds]

UNFREEZE
FREEZE command causes the writing and calculating tasks of archive stop processing the requests for a period freeze_seconds. Within this time, the next task (deleting) will list the number of requests (primary and calculated) in the queues. After elapsing the time freeze_seconds, the processing of values will be restored. If the parameter report_seconds is entered, the deleting task continues to list the number of request in the queues for this period.
FREEZE command is primarily used for performance tests (testing the maximum speed for processing the requests under load). Before its using, you should realize that it does not influence reading from archive, but during its execution, the writing to the archive (so the newest values are not available when reading) and the calculations are not executed for the period freeze_seconds. In the redundant systems with 2 and more archives, we recommend to execute FREEZE command on a passive instance, so that the functionality of subsystem will not be affected.
UNFREEZE command (without parameters) is used for aborting an inactivity that was caused by FREEZE command.
Kotva
import_data
import_data
IMPORT_DATA
Activates the process D2000 Archiv to import external data, e.g. Importing archive databases from D2000 V3.65 (OS/2).
Kotva
list_trezor
list_trezor
LIST_TREZOR [all]
LIST_TREZOR id
The parameter allows to shows the list of depository databases used by the process D2000 Archiv. The contents of the list depends on the used platform - Sybase, PostgreSQL or Oracle.
Parameter id:
LOAD_TREZOR path+filename [mask] [from] [to]On-line depository database import.
Kotva
mount_trezor0
mount_trezor0
MOUNT_TREZOR path+trezor_name
Sybase platform: The parameter path+depository_name defines the path and name of the depository database to be mounted. The name may contain * and ? characters to define a mask. If more files match specified mask, all these will be mounted.

For more information see the topic On-line access to data from depository databases.
Kotva
mount_trezor_ora
mount_trezor_ora
MOUNT_TREZOR Id [SEGMENT seg] [WRITE]
 MOUNT_TREZOR trezor_name [SEGMENT seg] [WRITE]
MOUNT_TREZOR IdFrom IdTo [SEGMENT seg] [WRITE]
Oracle platform: The parameter Id (trezor_name) defines the number (name) of a depository database to be mounted.
Name of depository database is the name of depository tablespace (e.g. MYAPP_TS_TREZOR15 or MYAPP_TS_TREZOR15_02) or name of tablespace's datafile (e.g. MYAPP_TS_TREZOR0015_S02_20040801.ORA).
The parameters IdFrom and IdTo allow to mount the sequence of depository databases.
The parameter SEGMENT Seg (where Seg is the number of the depository database segment) allows to mount on just one depository database segment. If the command MOUNT is used without the parameter SEGMENT Seg for depository database with segments enabled, the process D2000 Archiv attempts to mount on all segments of specified depository database/s.
The parameter Write can be used to mount depository database (s) for writing (for depository databases synchronization through the Arcsynchro tool).

For more information see the topic On-line access to data from depository databases.
Kotva
mount_trezor_pg
mount_trezor_pg
MOUNT_TREZOR Id [SEGMENT seg] [WRITE]
 MOUNT_TREZOR IdFrom IdTo [SEGMENT seg] [WRITE]
PostgreSQL platform: The parameter Id specifies the number of a depository database to be mounted. The parameter SEGMENT Seg (where Seg is the number of the depository database segment) allows to mount on just one depository database segment. If the command MOUNT is used without the parameter SEGMENT Seg for depository database with segments enabled, the process D2000 Archiv attempts to mount on all segments of specified depository database/s.
The parameter Write can be used to mount depository database (s) for writing (for depository databases synchronization through the Arcsynchro tool).

For more information see the topic On-line access to data from depository databases.
OPTIMIZE_QUEUEReduction of number of calc requests in the archive queue. If, for some reason, the number of requests in the archive queue has increased (for example, due to the arrival of old values from the communication), this tell command can reduce duplicate requests.
PENDING_REQUESTS path+filenameCreates a file containing the descriptions of pending requests.
Kotva
recalc
recalc
RECALC Mask [Row [Col]] From [To] [BACKGROUND]
Recalculates the values in the statistical archive.
Mask - defines the list of objects, which are to be recalculated. If the specific row and/or column of the structured archive is  recalculated, it is possible to specify parameters Row and Col (if unspecified, their default value is 0, meaning "whole row/column").
The parameters <From, To> define a time interval to be recalculated. If end time is not entered, current time will be used. Time format is dd-mm-yyyy [hh[:mi[:ss[.mss]]]].
Optional parameter BACKGROUND (implemented in version 7.02.006) puts the recalculation to the auxiliary calc task (see the archive parameter RecalcImmediateDepth). The parameter is recommended for long-lasting recalculation of historical values which are supposed to be performed on the background while archive still continues archiving real-time data.

Note: If the parameter RecalcTimeIntervalLimit has non-zero value and the time interval <From, To> is longer than RecalcTimeIntervalLimit hours, the parameter BACKGROUND is mandatory, to ensure that the recalculation will be performed by auxiliary calc. This behaviour is stated as a protection against overloading the main task by recalculations.
Kotva
release_trezor
release_trezor
RELEASE_TREZOR
Early disconnection of current depository database.
Kotva
rem_empty_slices
rem_empty_slices
REM_EMPTY_SLICES HOBJ|mask
If the time slices are activated, the command causes that archive will review all time slices of simple archive objects according to the defined HOBJ or mask and deletes the time slices without data.
The command is used to purify the archive database from empty time slices that were created due to error of archive. This error was repaired in the supported versions in June 8, 2015.
Kotva
reorganize
reorganize
REORGANIZE
On-line reorganization of archive database. The command compacts all archive tables (same as the Oracle command ALTER TABLE MOVE or the Sybase command REORGANIZE TABLE INDEX).

Note: For Oracle, PostgreSQL and Sybase 8.0 platforms or later only.

Kotva
reorganize_slice
reorganize_slice
REORGANIZE HOBJ|mask [SLICE slice] [tablespace]

On-line reorganization of archive table of object with specified HOBJ or with name matching specified mask. If the parameter tablespace is also defined, given archive table will be moved to specified tablespace. If time slices are on, all slices of one archive object will be reorganized/moved unless a slice number slice is specified.

Note 1: The parameter tablespace can be used on Oracle platform Oracle and PostgreSQL platforms only.
Note 2: The slice number, except for ordinary values, supports special values:

  • value -1 means "all slices"
  • value -2 means "slice for current time"
  • value -3 means "previous time slice"
  • value -4 means "all slices older than current time slice"


REORGANIZE ONEnables the reorganization of archive database (same as running the process D2000 Archiv with the /DBCY parameter).
REORGANIZE OFFEnables the reorganization of archive database (same as running the process D2000 Archiv without the /DBCY parameter).
REORGANIZE ACTIVEEnables the reorganization of archive database in the active mode only (same as running the process D2000 Archiv with the /DBCA parameter).
REORGANIZE PASSIVEEnables the reorganization of archive database in the passive mode only (same as running the process D2000 Archiv with the /DBCP parameter).
REORGANIZE SHRINKEnables the alternate mode of reorganization of archive database - only for Oracle 10g and above (dame as running the process D2000 Archiv with the /DBCS parameter).
Note: To enable the original mode, use tell command REORGANIZE MOVE.
REORGANIZE TableRowLimit rowLimitOn-line change of the parameter ReorganizeTableRowLimit used for the automatic reorganization of archive database.
REORGANIZE TableTimeLimit timeLimitOn-line change of the parameter ReorganizeTableTimeLimit used for the automatic reorganization of archive database.
Kotva
set_cache
set_cache
SET_CACHE size [MB]
The command allows the user to change the dynamic cache size to speed-up the calculation of statistical historical values while the process D2000 Archiv is still running.

Note 1: The initial cache size can be specified by the parameter MaxCacheSize in the process D2000 Application Manager.
Note 2: The command SET_CACHE also changes value of the parameter MaxCacheSize in registry.
Kotva
set_option
set_option
SET_OPTION
name_parameter
value_parameter
Tell command SET_OPTION controls the following configuration and start-up parameters of the process D2000 Archiv:


name_parametervalue_parameterdescription

AlmostZero
ALMOST_ZERO

positive real number (e.g. 1e-10)

See description of the parameter AlmostZero.
CommitCountActive
COMMIT_COUNT_ACTIVE		positive numberSee description of the parameter CommitCountActive.
CommitCountPassive
COMMIT_COUNT_PASSIVE		positive numberSee description of the parameter CommitCountPassive.
CommitTimeActive
COMMIT_TIME_ACTIVE		positive numberSee description of the parameter CommitTimeActive.
CommitTimePassive
COMMIT_TIME_PASSIVE		positive numberSee description of the parameter CommitTimePassive.
DBPOON/OFFOnly primary data processing.
RXON/OFFNo delete.
ROON/OFFRead only.
RSON/OFF>Backup by copying.
DBRTON/OFFCalculation of the computed historical values in real time.
Kotva
read_archive_depth
read_archive_depth
READ_ARCHIVE_DEPTH
"dd-mm-yyyy hh-mi-ss"

OFF		Limitation of the reading depth from the archive.

If the saving to the depository is ON the older data than the specified date will be read from the depository databases. This parameter can be used for checking if the depositories truly contain all data (e.g. after the patching by arcsynchro).
The value OFF deactivates the limitation.
When the limitation is active, every reading from the archive (in which the limitation is applied) produces the following note in the archive log file:
Start time for reading values from archive is before READ_ARCHIVE_DEPTH, limiting

DiskUsageWarning
DISK_USAGE_WARNING		ON/OFFSee description of the parameter DiskUsageWarning.
DropOldRequests
DROP_OLD_REQUESTS		ON/OFFSee description of the parameter DropOldRequests.
IsochronousCache
ISOCHRONOUS_CACHE		ON/OFFSee description of the parameter IsochronousCache.
IsoCacheFullDepth
ISOCACHE_FULL_DEPTH		ON/OFFSee description of the parameter IsoCacheFullDepth.

IsoCacheDepth
ISOCACHE_DEPTH

positive number (seconds)

See description of the parameter IsoCacheDepth.
OldValIgnoreAgepositive number (hours)See description of the parameter OldValIgnoreAge.
OldValOnAuxTask
OLD_VAL_ON_AUX_TASK		ON/OFFSee description of the parameter OldValOnAuxTask.
OneThreadForGraph
ONE_THREAD_FOR_GRAPH		ON/OFFSee description of the parameter OneThreadForGraph.
PG_ReorganizeSlice
PG_REORGANIZE_SLICE		0-2See description of the parameter PG_ReorganizeSlice.
PG_ReorgSliceTime
PG_REORGSLICE_TIME		secondsSee description of the parameter PG_ReorgSliceTime.
PG_TrezorFileMulti
 PG_TREZORFILEMULTI		numberSee description of the parameter PG_TrezorFileMulti.
RecalcImmediateDepth
RECALC_IMMEDIATE_DEPTH		seconds/OFFSee description of the parameter RecalcImmediateDepth.
RecalcParallelInterval
RECALC_PARALLEL_INTERVAL		seconds/OFFSee description of the parameter RecalcParallelInterval.
RecalcTimeIntervalLimit
RECALC_TIME_INTERVAL_LIMIT		hours/OFFSee description of the parameter RecalcTimeIntervalLimit.
RecalcUseTrezor
RECALC_USE_TREZOR		ON/OFFSee description of the parameter RecalcUseTrezor.
ReadTimeBeforeStart
READ_TIME_BEFORE_START		seconds/OFFSee description of the parameter ReadTimeBeforeStart.
ReorganizeOffset
REORGANIZE_OFFSET		hh:miSee description of the parameter ReorganizeOffset.
ReorganizePeriode
REORGANIZE_PERIODE		hoursSee description of the parameter ReorganizePeriode.
ReorganizeTableRowLimit
REORGANIZE_TABLE_ROW_LIMIT		rowsSee description of the parameter ReorganizeTableRowLimit.
ReorganizeTableTimeLimit
REORGANIZE_TABLE_TIME_LIMIT		hoursSee description of the parameter ReorganizeTableTimeLimit.
Tablespace_Name
TABLESPACE_NAME		name_of_tablespaceSee description of the parameter Tablespace_Name (only on Oracle platform).

TrezorReadSegment0
TREZOR_READ_SEGMENT0

ON/OFF

See description of the parameter TrezorReadSegment0.

WorkingHoursStart
WORKING_HOURS_START

non-negative integer number

See description of the parameter WorkingHoursStart.

WorkingHoursEnd
WORKING_HOURS_END

non-negative integer number

See description of the parameter WorkingHoursEnd.


Note: For parameters which are stored in the Registry database the tell command SET_OPTION will change the value of configuration parameters not only in archive but also in the Registry database.

Kotva
show_dyn_info_archiv
show_dyn_info_archiv
SHOW_DYN_INFO HOBJ/name [ROW [COL]]
Shows dynamic information on the specified object (current value, last sent value, time of next calculation for periodic archived objects, time of periodic deleting, parameters and content of cache) on the text console of the process D2000 Archiv.

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

Kotva
show_cache
show_cache
SHOW_CACHE count
If archive cache is enabled, the result is a list of top count historical values having the most values in archive cache.
For every value the following properties are displayed: HOBJ, name, number of items and time interval of values in archive cache.

Kotva
show_config_arc
show_config_arc
SHOW_CONFIG

Shows configuration information of the process D2000 Archiv and archive database.
This information covers:
  • start parameters of process specified in the configuration of archive process (if the archive process is run by process D2000 Server ), or archive service (if the archive process is run by its own watchdog), or command-line parameters (if the archive process is run manually),
  • parameters for archive specified in Windows registry,
  • parameters stored directly in archive database in LOG_DATA table (see the parameter /CLD of arcsynchro utility),
  • specific parameters of database (currently only for Oracle platform).
Note: By comparing information, obtained by this tell command, there is possible to find out whether the redundant archives are configured identically or if any parameter was omitted during migration of archive, database etc.
Kotva
show_info
show_info
SHOW_INFO
Shows various information about the process D2000 Archiv and the archive database.
STATISTICS path+filename hoursCreates the file path+filename with statistical information, i.e. number of values for individual historical values from the last n-hours.
Kotva
arc_stdout
arc_stdout
STDOUT output
The command redirects the standard output to a new 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 runing on Windows platform as a service, console output is disabled. Therefore if this functionality is required, it is necessary for a D2000 process to be started by D2000 Server without /X parameter.

Kotva
stop_import_data
stop_import_data
STOP_IMPORT_DATA
Deactivates a feature of the process D2000 - import of external data.
STOP [NOQUEUE]Stops the process D2000 Archiv. All unsaved values from the request queue are to be automatically stored on the disk and during the next starting the process, the values will be read from the disk. The current values of historical values are to be stored in the table SAVED_LAST_ROWS to quicken the next start of the process.
If the parameter NOQUEUE is used, the unsaved values from the request queue will not be stored in the file (it quickens stopping the process with a large amount of unprocessed values).
TIMESTAT START
TIMESTAT RESTART
TIMESTAT SHOW
TIMESTAT SHOWLONG
TIMESTAT SHOWSTART
TIMESTAT STOP		Starts (START), stops (STOP), restarts (RESTART), shows (SHOW), shows and restarts (SHOWSTART) or shows the time statistics of reading task(s) in long time format, including the days (SHOWLONG). After starting the statistics, the database reading task(s) will start the measuring time, spent in various parts of reading procedure. These values can be used for tuning by system specialists. Time statistics are displayed per reading task and if ReadThreadsCount > 1, also totals for all tasks are shown.
Note: When time statistics are on, reading from archive may be several percent slower due to time measuring.

...