[go: up one dir, main page]

0% found this document useful (0 votes)
411 views27 pages

Dynamark Logging Protocol User Guide r01

The document describes a logging protocol for communicating user actions and device statuses from controllers, printers, and coders to a remote logging server. It details command syntax, parameters, action IDs, and error numbers, and provides references for each command.

Uploaded by

guisouza170895
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
411 views27 pages

Dynamark Logging Protocol User Guide r01

The document describes a logging protocol for communicating user actions and device statuses from controllers, printers, and coders to a remote logging server. It details command syntax, parameters, action IDs, and error numbers, and provides references for each command.

Uploaded by

guisouza170895
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 27

Dynamark Logging Protocol

Document number Doc-0018741 Document revision R01

User Guide

Dynamark Logging Protocol

Supported technologies
D-/F-Series
D310/D310e
G-/Gx-Series

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Document Reference ..................................................................................................................................................... 27

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

THIS PAGE INTENTIONALLY LEFT BLANK

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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.

Contact Domino to receive details about configuring the remote access.

Two types of messages are sent to the logging server:


• User actions, i.e. actions that can be assigned to a logged in user.
These actions have an numerical ID (see 0), and if need is further descriptions about the action that was
performed. Each time such an action is performed, the client sends the ACTION command (see 0).
• Status, i.e. conditions of the device (i.e. power supply error).
If such a condition occurs, it is sent to the server with the command STATUSBEGIN (see 0) that marks this
condition as "active". As long as this contition is not marked as either ended (command STATUSEND, see 0)
or acknowledged (command STATUSACK, see 0), subsequent commands STATUSBEGIN on this status are
ignored by the server (i.e. do not cause another entry).

The following illustrations show the layout of the data and the relation between a top-level entry and sub-entries of a
user action:

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

Key Sub Sub


Log-ID=n LogID=n LogID=n
LogLevel=1 LogLevel=2
LogLink=1 LogLink=0
BackLink=0 BackLink=1

Parameter Parameter
OldValue OldValue
NewValue NewValue

Sub
LogID=n
LogLevel=1
LogLink=0
BackLink=0

Parameter
OldValue
NewValue

Top Sub Sub Sub


Log-ID=n+1 LogID=n+1 LogID=n+1 LogID=n+1
LogLevel=1 LogLevel=2 LogLevel=3
LogLink=1 LogLink=2 LogLink=0
BackLink=0 BackLink=1 BackLink=2

Parameter Parameter Parameter


OldValue OldValue OldValue
NewValue NewValue NewValue

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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\"

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

30 Counter %1% removed


31 Text insert %1% changed
32 Text insert %1% added
33 Text insert %1% removed
34 Clock setting %1% changed
35 Clock setting %1% added
36 Clock setting %1% removed
37 Text variable %1% changed
38 Text variable %1% added
39 Text variable %1% removed
40 Parameter %1% changed
41 Parameter %1% added
42 Parameter %1% removed
43 Shift setting modified
44 Clockcontrols modified
45 Dynamic text changed
46 Dynamic text added
47 Dynamic text removed
48 Message %2% in store %1% saved
49 Message %2% in store %1% created
50 Added user group %1%
51 Deleted user group %1%
52 Changed user group %1%
53 Changed password policy
54 Auto Login %1%
55 Auto Logout %1%
56 Set Date/Time
57 Nonvolatile storage formatted (Type=%1%)
58 Restore, %1%
59 Update, %1%
60 Removed Action Log entries that are older than %1% days
61 Font %1% added
61 Font %1% removed
63 Setup print field offset

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

64 Message %2% in store %1% removed


65 Store %1% removed
66 Store %1% created
67 Renamed store %1% to %2%
68 Renamed message %2% to %3% in store %1%
69 Copied message %2% into store %1%
70 Graphic file %1% uploaded
71 Coding file %1% uploaded
72 Coding file %1% removed

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)

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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>

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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.

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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>

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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

Document number Doc-0018741 Document revision R01

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

Copyright © 2021, Domino Printing Sciences plc

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 number Doc-0018741 Document revision R01

Document Reference
Doc-0018559 User Guide: Dynamark Interface Communication Protocol
Doc-0018740 User Guide: Dynamark Interface Authentication Protocol

Copyright © 2021, Domino Printing Sciences plc

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

You might also like