TRINCO Element (Input Command)
- Last UpdatedFeb 15, 2023
- 3 minute read
The TRINCO element stores the information about an input command issued to the daemon from a User, or another Location’s daemon. The information includes the state of processing of the command and is sufficient for the command to be restarted when a daemon is restarted, and is sufficient to generate the operations and output commands necessary to execute the command.
Note:
Local commands added from the AVEVA base product, that is those with TRLOCL true, do not contain successes, failures or messages.
Attributes:
|
NAME |
text |
Not automatically generated. |
|
COMMTYpe |
text |
Command type. |
|
INCSTA |
int |
The state of processing of the TRINCO. |
|
COMUID |
ref |
This is the reference of the command that sent this command to the daemon. For commands sent by this or other daemons it is the ref of the TROUCO element at the relevant Location. For commands originating from the AVEVA base product it will be set to null. |
|
TRMODU |
int |
Module number through which the User has issued this command, or GLOBALDAEMON module. |
|
TRLOCL |
log |
true if command stored directly by the AVEVA base product is independent of the daemon. |
|
COMSTR |
text |
Command string the User entered that generate this command, else null. |
|
ORILOC[3] |
text |
Original Location where User issued the command. |
|
DESLOC3] |
text |
Ultimate target ‑ destination Location where command will be executed. For some commands this is the destination of subsidiary commands to be sent, not this command itself. |
|
PRVLOC[3] |
text |
Previous Location which passed the command on to this Location (normally the same as the TRLOC element). |
|
AUXLOC[3] |
text |
Auxiliary Location. Often used as a Location to send auxiliary commands. |
|
SYSLOC[3] |
text |
Location of administrator when being remotely administered, else null. |
|
DEPCOU |
int |
Number of other TRINCOs on which this is dependent (always zero). |
|
DEPEND[*] |
ref |
References of TRINCOs on which it is dependent, (always none). |
|
DEPTYP[*] |
log |
Type of dependencies - on success or failure. |
|
DATECR |
date |
Date command received and recreated. |
|
DATEAK |
date |
Date sent acknowledgement for command. |
|
NACKN |
int |
Number of times acknowledgement sent. |
|
EXTIME[4] |
text |
Time to execute command (hence allows a delay) ‑. |
|
DATERD |
date |
Date command made ready (after EXTIME has been reached). |
|
DATECM |
date |
Date command completed. |
|
DATERP |
date |
Date reply sent with results of command. |
|
NREPLY |
int |
Number of times reply sent. |
|
MSTEXT |
text |
Text info set on completion (normally only if failed to generate operations). |
|
TRPASS |
log |
true if command succeeded, false if failed. The command fails if any of its operations fail, or if it fails to generate operations. |
|
DATEND |
date |
Date all processing of command finished ‑ acknowledgement of command received, or command cancelled. |
|
NREPAK |
int |
Number of times reply acknowledgement received. |
|
USERST |
text |
User cancelling the command. |
|
TRDBRF |
ref |
Of Database (DB) element. |
|
TRFINO |
int |
File number of DB element. |
|
TREXTN |
int |
Extract number of DB element. |
|
TRAREA |
int |
Area number of DB element. |
|
TRSTYP |
int |
File type of DB element. |
|
TRDBNO |
int |
DB number of DB element. |
|
TRDACC |
int |
Access type of DB element. |
|
INARCO |
int |
Argument count for intargs (args of the command) (defaulted to zero). |
|
INTARG[*] |
int |
Command arguments (passed around as a Conformant array). |
|
TRCARG[*] |
text |
Command argument qualifiers space separated. e.g. ‘NAME=X/Y’. |
|
TRVISI |
log |
Visible or not. |
|
DESC[256] |
text |
User description. |
|
TSTATE |
text |
Pseudo-attribute, a simplified view of the INCSTAtus attribute or a synonym for COMMType or OPTYPE attributes. Note: |
|
TRTYPE |
Returns COMMType attribute if set, otherwise OPTYPE attribute is returned. |
Values of INCSTA State Attribute and Order of Change:
|
RECEIVED |
The command has been received ready for processing. DATECR is set. |
|
ACKNOWLEDGED |
An acknowledgement has been sent off by this daemon. DATEAK is set and NACKN incremented. |
|
STALLED |
The command has failed to create its operations and state will later return to ACKNOWLEDGED ready for retry, or to TIMEDOUT. |
|
READY |
The command has reached its execute time and is independent. DATERD is set. |
|
COMPLETE |
The command has been processed, and results obtained. DATECM is set. |
|
REPLIED |
The daemon has sent the results back to the originating Location. DATERP is set and NREPLY incremented. |
|
PROCESSED |
An acknowledgement for the result received from originating Location. DATEND is set and NREPAK incremented. |
|
REDUNDANT |
The command will not be executed now due to dependency rules. DATEND is set. |
|
CANCELLED |
The command has been cancelled and finished with TRPASS false. DATEND is set. |
|
TIMEDOUT |
The command has timed out before creating its operations and finished with TRPASS false. DATEND is set. |