Administrator Command
Reference Manual
Transaction Database
: TROUCO Element (Output Command)
TROUCO Element (Output Command)
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.
TRCNUM
int
Command number of command being sent.
OUTSTA
int
State of processing of the TROUCO.
COMREF
ref
Ref of the TRINCO of this command stored in the receiving location transaction database. 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 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
Filetype of DB element.
TRDBNO
int
Dbnumber 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
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.
1974 to current year.
AVEVA Solutions Limited and its subsidiaries. All rights reserved.