Dynamark Logging Protocol User Guide r01
Dynamark Logging Protocol User Guide r01
User Guide
Supported technologies
D-/F-Series
D310/D310e
G-/Gx-Series
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 1 of 27
Dynamark Logging Protocol
Contents
General ............................................................................................................................................................................ 4
Command Syntax ............................................................................................................................................................. 6
Answer Syntax ................................................................................................................................................................. 6
Parameter Syntax ............................................................................................................................................................ 6
Action IDs......................................................................................................................................................................... 7
Error Numbers ................................................................................................................................................................. 9
Command Reference ..................................................................................................................................................... 10
ACTION ................................................................................................................................................................................................................. 10
GETCOUNTACTION................................................................................................................................................................................................ 12
GETCOUNTSTATUS ................................................................................................................................................................................................ 13
GETACTIONKEYS ................................................................................................................................................................................................... 14
CMD_GET_ACTIONLOGSUBS ................................................................................................................................................................................ 15
GETOLDLOGWARNINGLEVEL ................................................................................................................................................................................ 16
GETSTATUS ........................................................................................................................................................................................................... 17
QUIT ...................................................................................................................................................................................................................... 19
REGISTER............................................................................................................................................................................................................... 20
RMOLDACTION ..................................................................................................................................................................................................... 21
RMOLDSTATUS ..................................................................................................................................................................................................... 22
STATUSACK ........................................................................................................................................................................................................... 23
STATUS_ACK_BY_FILTER ....................................................................................................................................................................................... 24
STATUSBEGIN........................................................................................................................................................................................................ 25
STATUSEND ........................................................................................................................................................................................................... 26
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 2 of 27
Dynamark Logging Protocol
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 3 of 27
Dynamark Logging Protocol
General
To authenticate from a remote server to the controller, printer or laser coder, an implemented TCP/IP server is
needed on the remote peer.
The following illustrations show the layout of the data and the relation between a top-level entry and sub-entries of a
user action:
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 4 of 27
Dynamark Logging Protocol
Parameter Parameter
OldValue OldValue
NewValue NewValue
Sub
LogID=n
LogLevel=1
LogLink=0
BackLink=0
Parameter
OldValue
NewValue
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 5 of 27
Dynamark Logging Protocol
Command Syntax
The client connection to an authentication is based on TCP/IP via Ethernet.
The protocol is UTF-8-based. Every command starts with its token which can be of different length, followed by
additional parameters which are comma separated (see 0) and terminated by a carriage-return and a linefeed character
(0x0d, 0x0a).
Answer Syntax
The returned answer is one of:
• OK
• RESULT <COMMAND> [parameters...]
where <COMMAND> is the same token as the sent command
• ERROR <number>
(see 0)
Parameter Syntax
The parameters are comma separated as follows:
• No additional blanks other than those belonging to the parameter before/after the comma must be inserted
• A comma as a character of the parameter is enclosed in double quotes (, becomes ",")
• A double quote is escaped by a backslash (" becomes \")
• a backslash is escaped by another backslash (\ becomes \\)
Examples:
Parameter 1 Parameter 2 Result
Hello World Hello,World
Well, what's up? Well"," what's up?
Well, what's up dude? Well"," what's up,dude?
Here comes a backslash\ Here comes,a backslash\\
"Quoted" \"Quoted\"
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 6 of 27
Dynamark Logging Protocol
Action IDs
The actions that are logged are enumerated as follows. The descriptive text is an excerpt from the English translation
used to generate the parameter of a subentry.
ID Description
0 Logged in
1 Logged out
2 Marking started
3 Marking stopped
4 System Settings modified
5 Application started
6 Application terminated
7 Connected to interface
8 Disconnected from interface
9 Electronic Signature %1%
10 Message changed
11 Created user %1%
12 Deleted user %1%
13 Changed user data %1%
14 System Settings restored
15 Backup system data
16 Changed password %1%
17 Login failed
18 Object %1% changed
19 Object %1% added
20 Object %1% deleted
21 Object %1% moved
22 Override %1% changed
23 Override %1% added
24 Override %1% removed
25 Coding changed
26 Coding activated
27 Coding deactivated
28 Counter %1% changed
29 Counter %1% added
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 7 of 27
Dynamark Logging Protocol
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 8 of 27
Dynamark Logging Protocol
Error Numbers
The following enumeration is used to send an ERROR as answer:
1. Unknown error
2. Unknown command
3. Wrong number of parameters
4. Client has already registered (see REGISTER)
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 9 of 27
Dynamark Logging Protocol
Command Reference
Mandatory parameters are enclosed in angular bracket< >.
Optional parameters are enclosed in square brackets [ ].
The parameter names are prefixed to reflect their data type:
n: Number
str: String
b: Boolean as 0=false, 1=true
ACTION
Command
ACTION <nTypeID>, <nActionID>, <strUserID>, <strTime>, [
[<nLogLevel_0=1>,<nActionId_0>,<strParam_0>,<strOldVal_0>,<strNewVal_0>],
[...],[<nLogLevel_n>,<nActionId2_n>,<strParam2_n>,<strOldVal2_n>,<strNewVal2_n>]]
Description
Sends an audit trail entry for the device with the specified nTypeID.
Parameter Description
Top-level entry: These four mandatory parameters define a simple action and are
sufficient for actions that do not need additional information like old/new
value
nTypeID ID of the type of device (in case another device type is embedded into the client)
nActionID see 0
strUserID ID (i.e. login name) of the user who is logged in and performs this action
strTime This parameter is empty or should be discarded if not: Clients that directly use a
local database send the timestamp, but a server process should use the server-time
Sub-entries: In case the top-level entry needs additional information in order to be
complete, optional sub-entries can be stated here.
nLogLevel Parent-level to which this log entry belongs or parent-level + 1 in case a sub-entry
descends again into sub-entries. Hence the first log level is 1, as it belongs to the
top-level entry. Sub-entries may have the same log-level, if a parent entry needs
more than just one further sub-entry
nActionID see 0
strParam Descriptive text, see 0
strOldVal Old value of a change that has been performed due to the action. Mandatory, but
may be empt
strNewVal New value of a change that has been performed due to the action. Mandatory, but
may be empty
Result Description
Success OK
Fault ERROR <no>
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 10 of 27
Dynamark Logging Protocol
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
Examples
ACTION 1,4,Administrator,,1,4,DSP,,,2,4,strMADFile,Matrix-Adaption/07-
200.mad,Matrix-Adaption/10-075.mad
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 11 of 27
Dynamark Logging Protocol
GETCOUNTACTION
Command
GETCOUNTACTION <nTypeID>, <strIdentifier>, <strIPAddress>, <strTimeFrom>, <strTimeTo>, <nActionID>,
<strUserID>, <strParam>, <strOldVal>, <strNewVal>
Description
Returns the number of log entries that match the given parameters.
Empty parameters are not compared to match the query.
Parameter Description
nTypeID ID of the type of device
strIdentifier Identifier string of the device
strIPAddress IP address of the device as nnn.nnn.nnn.nnn
strTimeFrom Time range of the entries in yyyy-mm-dd
HH:MM:SS notation
strTimeTo
nActionID see 0
strUserID ID (i.e. login name) of the user who performed this action
strParam Descriptive text, see 0
strOldVal Old value of a change
strNewVal New value of a change
nTypeID ID of the type of device
Result Description
Success RESULT GETCOUNTACTION
Fault: ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
See also
GETCOUNTSTATUS
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 12 of 27
Dynamark Logging Protocol
GETCOUNTSTATUS
Command
GETCOUNTSTATUS <nTypeID>, <strIdentifier>, <strIPAddress>, <strTimeFrom>, <strTimeTo>, <nActionID>,
<strUserID>, <strParam>, <strOldVal>, <strNewVal>
Description
Returns the number of log entries that match the given parameters.
Empty parameters are not compared to match the query.
Parameter Description
nTypeID ID of the type of device
strIdentifier Identifier string of the device
strIPAddress IP address of the device as nnn.nnn.nnn.nnn
strTimeFrom Time range of the entries in yyyy-mm-dd
HH:MM:SS notation
strTimeTo
nStatusID Unique ID of this status
bActive (0/1) Status not marked as reset, i.e. still active
bAcknowledged (0/1) Marked as acknowledged
Result Description:
Success: RESULT GETCOUNTSTATUS <nNumber>
Fault: ERROR <NO>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
See also
GETCOUNTACTION
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 13 of 27
Dynamark Logging Protocol
GETACTIONKEYS
Command
GETACTIONKEYS <nTypeID>, <strIdentifier>, <strIPAddress>, <strTimeFrom>, <strTimeTo>, <nActionID>, <strUserID>,
<strParam>, <strOldVal>, <strNewVal>, <nBlock>
Description
Returns the top-level log entries that match the given parameters.
Empty parameters are not compared to match the query.
Parameter Description:
nTypeID ID of the type of device
strIdentifier Identifier string of the device
strIPAddress IP address of the device as nnn.nnn.nnn.nnn
strTimeFrom Time range of the entries in yyyy-mm-dd
HH:MM:SS notation
strTimeTo
nActionID see 0
strUserID ID (i.e. login name) of the user who performed this action
strParam Descriptive text, see 0
strOldVal Old value of a change
strNewVal New value of a change
nBlock Instead of sending all entries, the server should send only a block of nBlockSize
entries (amount is to be defined in the server), beginning at nBlock*nBlockSize.
Result Description:
Success: RESULT GETACTIONKEYS [<nLogID0>, <nTypeID0>, <strIdentifier0>, <strIPAddress0>,
<strTime0>, <nActionID0>, <strUserID0>], [<nLogID1>, <nTypeID1>, <strIdentifier1>,
<strIPAddress1>, <strTime1>, <nActionID1>, <strUserID1>]
nLogID: Unique numerical identifier of this entry.
All other parameter descriptions match those of the input parameters.
Fault: ERROR <NO>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 14 of 27
Dynamark Logging Protocol
CMD_GET_ACTIONLOGSUBS
Command
CMD_GET_ACTIONLOGSUBS <nLogID>,<nLogLevel>,<nLogLink>
Description
Returns sub-entries that belong to a top-level.
Parameter Description
nLogID Log ID as acquired before with GETACTIONKEYS.
nLogLevel Level, i.e. depth of subentries.
nLogLink ID that links to this entry. 0 if coming from a top-level entry, otherwise the return
parameter nLogLink of this command that was sent before.
Result Description
Success: RESULT GETACTION [<nLogId0>, <nLogLevel0>, <nLogLink0>, <nLogBackLink0>,
<nActionID0>, <strParam0>, <strOldVal0>, <strNewVal0>], [<nLogId1>,
<nLogLevel1>, <nLogLink1>, <nLogBackLink1>, <nActionID1>, <strParam1>,
<strOldVal1>]
• nLogId
Same as input parameter
• nLogLevel
Same as input parameter
• nLogLink
0: Indicates that no sub-entries to this entry follow
>0: ID that links to the sub-entries of this entry with a subsequent command
• nLogBackLink
ID that links to the preceding element. If 0, this will be the top-level entry
acquired by GETACTION
• nActionID
see 0
• strParam
Descriptive text, see 0
• strOldVal
Old value of a change
• strNewVal
New value of a change
Fault: ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
See also
GETACTIONKEYS
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 15 of 27
Dynamark Logging Protocol
GETOLDLOGWARNINGLEVEL
Command
GETOLDLOGWARNINGLEVEL
Description
In case the server database capacity is limited, the user should be informed that the data must be stored, rather than
deleting old entries. A warning just informs the user, an error will disable the client until the server data has been stored.
Parameter Description
- -
Result Description:
Success RESULT GETOLDLOGWARNINGLEVEL<nLevel>
nLevel:
• 0: None
• 1: Warning
• 2: Error
Fault ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
Examples
GETOLDLOGWARNINGLEVEL
RESULT 0
In the example above, the warning level is none.
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 16 of 27
Dynamark Logging Protocol
GETSTATUS
Command
GETSTATUS <nTypeID>, <strIdentifier>, <strIPAddress>, <strTimeFrom>, <strTimeTo>, <nStatusID>,<bActive>,
<bAcknowledged>, <nBlock>
Description
Returns the number of log entries that match the given parameters.
Empty parameters are not compared to match the query.
Parameter Description
nTypeID ID of the type of device
strIdentifier Identifier string of the device
strIPAddress IP address of the device as nnn.nnn.nnn.nnn
strTimeFrom Time range of the entries in yyyy-mm-dd
HH:MM:SS notation
strTimeTo
nStatusID Unique ID of this status
bActive (0/1) Status not marked as reset, i.e. still active
bAcknowledged (0/1) Marked as acknowledged
nBlock Instead of sending all entries, the server should send only a block of nBlockSize
entries (amount is to be defined in the server), beginning at nBlock*nBlockSize.
Result Description
Success RESULT GETSTATUS [<nLogID0>, <nTypeID0>, <strIdentifier0>, <strIPAddress0>,
<nStatusID0>, <nMessageID0>, <nSeverity0>, <strTimeBegin0>, <strTimeEnd0>,
<strTimeAcknowledge0>],[<nLogID1>, <nTypeID1>, <strIdentifier1>,
<strIPAddress1>, <nStatusID1>, <nMessageID1>, <nSeverity1>, <strTimeBegin1>,
<strTimeEnd1>, <strTimeAcknowledge1>]
• nLogID:
Unique numerical identifier of this entry
• nSeverity:
See STATUSBEGIN
• nMessageID
See STATUSBEGIN
• strTimeBegin:
Time in yyyy-mm-dd HH:MM:SS notation when this status began.
• strTimeEnd:
Time in yyyy-mm-dd HH:MM:SS notation when this status ended (empty if still
active)
• strTimeAcknowledged:
Time in yyyy-mm-dd HH:MM:SS notation when this status has been
acknowledged.
All other parameter descriptions match those of the input parameters
Fault ERROR <no>
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 17 of 27
Dynamark Logging Protocol
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
See also
STATUSACK, STATUS_ACK_BY_FILTER, STATUSBEGIN, STATUSEND
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 18 of 27
Dynamark Logging Protocol
QUIT
Command
QUIT
Description
Asks the server process to terminate gracefully.
Parameter Description
- -
Result Description
Success OK
Fault ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
Examples
QUIT
OK
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 19 of 27
Dynamark Logging Protocol
REGISTER
Command
REGISTER <nTypeID>. <strIdentifier>
Description
Registers a client. The nTypeID and strIdentifier should be used to generate client-specific audit-trail entries, where a
coherent set of devices has the same nTypeID, and the strIdentifier is unique for each device of this type.
Parameter Description
nTypeID Numerical identifier for a coherent group of devices (i.e. D-Series Laser)
strIdentifier Unique identifier for this client
Result Description
Success OK
Fault ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
Examples
REGISTER 0,Mars
OK
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 20 of 27
Dynamark Logging Protocol
RMOLDACTION
Command
RMOLDACTION <nDays>, <nTypeID>, <strIdentifier>, <strIPAddress>, <strTimeFrom>, <strTimeTo>, <nActionID>,
<strUserID>, <strParam>, <strOldVal>, <strNewVal>, <nBlock>
Description
Remove the entries that are older than nDays and match the given parameters.
Empty parameters are not compared to match the query.
Parameter Description
nDays Number of days before the current date upon entries should be deleted.
nTypeID ID of the type of device.
strIdentifier Identifier string of the device.
strIPAddress IP address of the device as nnn.nnn.nnn.nnn
strTimeFrom Time range of the entries in yyyy-mm-dd
HH:MM:SS notation
strTimeTo
nActionID see 0.
strUserID ID (i.e. login name) of the user who performed this action.
strParam Descriptive text, see 0.
strOldVal Old value of a change.
strNewVal New value of a change.
nBlock Instead of sending all entries, the server should send only a block of nBlockSize
entries (amount is to be defined in the server), beginning at nBlock*nBlockSize.
Result Description
Success OK
Fault ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 21 of 27
Dynamark Logging Protocol
RMOLDSTATUS
Command
RMOLDSTATUS <nDays>, <nTypeID>, <strIdentifier>, <strIPAddress>, <strTimeFrom>, <strTimeTo>,
<nStatusID>,<bActive>, <bAcknowledged>, <nBlock>
Description
Remove the entries that are older than nDays and match the given parameters.
Empty parameters are not compared to match the query.
Parameter Description
nDays Number of days before the current date upon entries should be deleted.
nTypeID ID of the type of device.
strIdentifier Identifier string of the device.
strIPAddress IP address of the device as nnn.nnn.nnn.nnn.
strTimeFrom Time range of the entries in yyyy-mm-dd
HH:MM:SS notation
strTimeTo
nStatusID Unique ID of this status.
bActive (0/1) Status not marked as reset, i.e. still active.
bAcknowledged (0/1) Marked as acknowledged.
nBlock Instead of sending all entries, the server should send only a block of nBlockSize
entries (amount is to be defined in the server), beginning at nBlock*nBlockSize.
Result Description
Success OK
Fault ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 22 of 27
Dynamark Logging Protocol
STATUSACK
Command
STATUSACK <nStatusID>, <nLogID>
Description
Marks the status as acknowledged.
Parameter Description
nStatusID Status ID
nlogID ID previously acquired with GETSTATUS
Result Description
Success OK
Fault ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
See also
GETSTATUS
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 23 of 27
Dynamark Logging Protocol
STATUS_ACK_BY_FILTER
Command
STATUS_ACK_BY_FILTER <nTypeID>, <strIdentifier>, <strIPAddress>, <strTimeFrom>, <strTimeTo>,
<nStatusID>,<bActive>, <bAcknowledged>, <nBlock>
Description
Marks the status as acknowledged that matches the given parameters.
Empty parameters are not compared to match the query.
Parameter Description
nTypeID ID of the type of device.
strIdentifier Identifier string of the device.
strIPAddress IP address of the device as nnn.nnn.nnn.nnn.
strTimeFrom Time range of the entries in yyyy-mm-dd HH:MM:SS notation.
strTimeTo
nStatusID Unique ID of this status.
bActive (0/1) Status not marked as reset, i.e. still active.
bAcknowledged (0/1) Marked as acknowledged.
Result Description
Success OK
Fault: ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
See also
GETSTATUS
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 24 of 27
Dynamark Logging Protocol
STATUSBEGIN
Command
STATUSBEGIN <nStatusID>, <nMessageID>, <nSeverity>
Description
States the beginning of an occurrence of a status.
Parameter Description
nStatusID Status ID
nMessageID Message ID
nSeverity Severity
Result Description
Success OK
Fault ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
G-Series Not supported
Gx-Series Not supported
See also
GETSTATUS
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 25 of 27
Dynamark Logging Protocol
STATUSEND
Command
STATUSEND<nStatusID>
Description
Marks the most recent status entry having this status as ended.
Parameter Description
nStatusID Status ID
Result Description
Success OK
Fault ERROR <no>
Supported technology
D-/F-Series Supported since Dynamark 3 Logging Client 1.2
D310/D310e Not supported
Gx-Series Not supported
G-Series Not supported
See also
GETSTATUS
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 26 of 27
Dynamark Logging Protocol
Document Reference
Doc-0018559 User Guide: Dynamark Interface Communication Protocol
Doc-0018740 User Guide: Dynamark Interface Authentication Protocol
No part of this publication may be reproduced, stored on a retrieval system, or transmitted in any form, or by any means, electronic, mechanical,
photocopying, recording or otherwise, without the prior permission of Domino Printing Sciences plc.
Doc-0018741_Dynamark-Logging-Protocol_User-Guide_R01.docx Page 27 of 27