TROUCO Element (Output Command)
- Last UpdatedFeb 15, 2023
- 4 minute read
The TROUCO element contains information about an output command to be issued by the daemon to itself, or to the daemon at another Location. The information includes the state of processing of the command and is sufficient for the command to be resent when a daemon is restarted.
Output commands are generated by an input command when operations are created. They may be destined to be executed at this, or another site.
Attributes:
|
NAME |
text |
Not automatically generated. |
|
COMMTYpe |
text |
Command type. |
|
OUTSTA |
int |
State of processing of the TROUCO. |
|
COMREF |
ref |
Ref of the TRINCO of this command stored in the receiving Location transaction Database (DB). This is null until an acknowledgement is received. |
|
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. |
|
NXTARL[3]- |
text |
Next target Location ‑ this is needed to determine which port to assign the output command to, and which Location to send the command. |
|
DEPCOU |
int |
Number of other TROPERs and TROUCOs on which this is dependent. |
|
DEPEND[*] |
ref |
References of TROPERs and TROUCOs on which it is dependent. |
|
DEPTYP[*] |
log |
Type of dependencies - on success or failure. |
|
PREOP |
ref |
Reference of previous operation which generated this output command as one of its post operations. If no previous operation this is null. |
|
DATECR |
date |
Date command created by owning input command. |
|
DATERD |
date |
Date command is ready to send after dependencies satisfied. |
|
DATESN |
date |
Date command sent to destination Location. |
|
NRETRY |
int |
Number of attempts when command was sent. |
|
MAXTRY |
int |
Number of attempts sending command before command fails. |
|
WAITIM |
int |
Number of seconds delay between attempts at sending. |
|
ENDTIM |
date |
Date when command will fail if sending remains stalled. |
|
DATEAK |
date |
Date acknowledgement received from destination Location. |
|
NACKN |
int |
Number of times acknowledgement received. |
|
DATERP |
date |
Date reply with results received from destination Location. |
|
DATERK |
date |
Date reply acknowledgement sent to destination Location. |
|
NREPLY |
int |
Number of times reply received. |
|
MSTEXT |
text |
Text info set on completion (normally only if failed to generate operations). |
|
TRPASS |
log |
true if command succeeded, false if failed. This is determined from the result received. |
|
POPCOD |
int |
Code for post operation creation function to be run. If none then zero. |
|
DATEND |
date |
Date all processing of command finished all post operations generated, or command cancelled, or command timed out. |
|
NREPAK |
int |
Number of times reply acknowledgement received. |
|
USERST |
text |
User cancelling the command. |
|
TRDBRF |
ref |
Reference for 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 OUTSTA State Attribute and Order of Change:
|
WAIT |
The command is waiting until it is independent of any other operation/command. DATECR is set. |
|
READY |
The command is independent and ready to be sent. DATERD is set. |
|
STALLED |
The command could not be sent. State will later return to ACKNOWLEDGED ready for retry, or to TIMEDOUT. |
|
SENT |
The command has been sent and waits for an acknowledgement. DATESN is set, NRETRY is incremented. |
|
ACKNOWLEDGED |
An acknowledgement has been received from the destination Location. DATEAK is set, NACKN is incremented, CMREF is set. |
|
REPLIED |
A reply with results has been received from the destination Location. DATERP is set, NREPLY is incremented. |
|
COMPLETE |
A reply acknowledgement has been returned to the executing Location. DATERK, TRPASS, MSTEXT are set. NREPAK is incremented. |
|
STALLED_POSTOP |
Post operations could not be created. State will later return to COMPLETE ready for retry, or to TIMEDOUT. |
|
PROCESSED |
Any required post operations have been generated using the result of this command. DATEND is set. |
|
REDUNDANT |
The command will not be executed now due to dependency rules. DATEND is set. |
|
CANCELLED |
The command has been cancelled by owning TRINCO by a User. DATEND is set. |
|
TIMEDOUT |
The command has had the number of sends exhausted, or maximum time exceeded. DATEND is set. |