Logbook events are fired by the machine for the documentation of relevant changes in the machine configuration/status. The LogbookEventType is formally defined in Table 12.

Table 12 – LogbookEventType Definiton

Attribute

Value

BrowseName

LogbookEventType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of 0:BaseEventType defined in OPC UA Part 5

0:HasComponent

Object

User

UserType

M

0:HasProperty

Variable

EventOriginator

EventOriginatorEnumeration

0:PropertyType

M

0:HasProperty

Variable

JobCycleCounter

0:UInt64

0:PropertyType

O

0:HasSubtype

ObjectType

ParameterChangeLogType

Defined in 9.5

0:HasSubtype

ObjectType

UserLogType

Defined in 9.6

0:HasSubtype

ObjectType

RemoteAccessLogType

Defined in 9.7

0:HasSubtype

ObjectType

SequenceChangeLogType

Defined in 9.8

0:HasSubtype

ObjectType

MachineModeChangeLogType

Defined in 9.9

0:HasSubtype

ObjectType

ProductionStatusChangeLogType

Defined in 9.10

0:HasSubtype

ObjectType

ProductionDatasetChangeLogType

Defined in 9.11

0:HasSubtype

ObjectType

ProductionDatasetFrozenLogType

Defined in 9.12

0:HasSubtype

ObjectType

StandstillReasonLogType

Defined in 9.13

0:HasSubtype

ObjectType

MessageLogType

Defined in 9.14

0:HasSubtype

ObjectType

UserFeedbackLogType

Defined in 9.15

The LogbookEventType is abstract. There will be no instances of a LogbookEventType itself, but there will be instances of its subtypes which provide detailed information.

The EventSource is the root node of the interface (e.g. instance of IMM_MES_InterfaceType for OPC 40077).

NOTE: The EventSource, Time and a Message are already included in the BaseEventType of OPC UA.

There shall be a buffer to be accessible via the OPC UA service history read (even when the machine has been switched off in the meantime). The minimum size is 100 LogbookEvents to be stored in a (persistent) ring buffer containing the recent 100 events (over all LogbookEvents).

This Object indicates the user who is responsible for the change that leads to the event. The fields of UserType (see 13.2) shall be null or emtpy if no user is directly responsible (e.g. for messages coming from the machine control system).

This Property represents the originator of a logbook event. The EventOriginatorEnumeration is defined in Table 13.

Table 13 – EventOriginatorEnumeration Items

Name

Value

Description

OTHER

0

Undefined

MACHINE

1

The machine causes the event (e.g. an alarm)

OPERATOR

2

The operator of the machine causes the event (e.g. a parameter change)

MES

3

The MES causes the event (e.g. a MESMessage)

PERIPHERAL_DEVICE

4

A peripheral device causes the event (e.g. an alarm)

This Property represents the current value of JobCycleCounter in the ActiveJobValues Object when the event is fired (see 18.4.7.1). Only to be used for cyclic production (e.g. injection moulding).

The ParameterChangeLogType is used for the logging of relevant changes in production parameters.

The decision which parameter is relevant for the production is done by the machine.

Table 14 – ParameterChangeLogType Definition

Attribute

Value

BrowseName

ParameterChangeLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

ParameterId

0:String

0:PropertyType

M

0:HasProperty

Variable

OldValue

0:BaseDataType

0:PropertyType

M

0:HasProperty

Variable

OldValueUnit

0:EUInformation

0:PropertyType

O

0:HasProperty

Variable

NewValue

0:BaseDataType

0:PropertyType

M

0:HasProperty

Variable

NewValueUnit

0:EUInformation

0:PropertyType

O

The ParameterId Property represents the Id of the changed parameter.

The OldValue Property represents the old value of the changed parameter.

The NewValue Property represents the new value of the changed parameter.

Depending on the changed parameter, the Datatype of OldValue and NewValue are subtypes of 0:BaseDataType (0:String, Number, …). Where the unit is important (e.g. temperatures, lengths…), also OldValueUnit and NewValueUnit shall be used (see OPC UA Part 5 for the definition of EUInformation).

The UserLogType is used for logging which users are logged in to the machine.

Table 15 – UserLogType Definition

Attribute

Value

BrowseName

UserLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

UserChange

UserChangeEnumeration

0:PropertyType

M

The UserChangeEnumeration is defined in Table 16.

Table 16 – UserChangeEnumeration Definition

Name

Value

Description

LOG_ON

0

The User has logged on the machine.

LOG_OFF

1

The User has logged off the machine.

The RemoteAccessLogType is used for logging access from outside to the machine (e.g. remote service).

Table 17 – RemoteAccessLogType Definition

Attribute

Value

BrowseName

RemoteAccessLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

RemoteUserName

0:String

0:PropertyType

M

0:HasProperty

Variable

UserChange

UserChangeEnumeration

0:PropertyType

M

0:HasProperty

Variable

Origin

0:String

0:PropertyType

O

RemoteUserName: Name of the remote user (e.g. name of the service employee doing remote service)

UserChange: The UserChangeEnumeration is the same used in UserLogType and is defined in Table 16.

Origin: Information about the origin of the remote access (e.g. "Headquarters").

The SequenceChangeLogType is used for the logging changes in the production sequence.

Table 18 – SequenceChangeLogType Definition

Attribute

Value

BrowseName

SequenceChangeLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

SequenceChange

SequenceChangeEnumeration

0:PropertyType

M

The SequenceChange Property allows classifying the changes. (A description of the changes is included in the Message Property of the LogBookEventType)

Table 19 – SequenceChangeEnumeration Definition

Name

Value

Description

UPDATE

0

The sequence has been updated (e.g. when a new production dataset has been activated)

ADD

1

An element has been added to the sequence

MODIFY

2

An element of the sequence has been modified.

MOVE

3

An element of the sequence has been moved.

DELETE

4

An element of the sequence has been deleted.

The MachineModeChangeLogType is used for logging changes of the machine mode.

Table 20 – MachineModeChangeLogType Definition

Attribute

Value

BrowseName

MachineModeChangeLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

OldMachineMode

MachineModeEnumeration

0:PropertyType

M

0:HasProperty

Variable

NewMachineMode

MachineModeEnumeration

0:PropertyType

M

The MachineModeEnumeration is defined in 12.4.

The ProductionStatusChangeLogType is used for logging changes of the production status.

Table 21 – ProductionStatusChangeLogType Definition

Attribute

Value

BrowseName

ProductionStatusChangeLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

OldProductionStatus

ProductionStatusEnumeration

0:PropertyType

M

0:HasProperty

Variable

NewProductionStatus

ProductionStatusEnumeration

0:PropertyType

M

The ProductionStatusEnumeration is defined in 14.7.1.

The ProductionDatasetChangeLogType is used when a new production dataset is loaded and activated in the control system of the machine.

Table 22 – ProductionDatasetChangeLogType Definition

Attribute

Value

BrowseName

ProductionDatasetChangeLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

OldProductionDatasetName

0:String

0:PropertyType

M

0:HasProperty

Variable

NewProductionDatasetName

0:String

0:PropertyType

M

The ProductionDatasetFrozenLogType is used when a production dataset is locked or unlocked (see 20.3.4).

Table 23 – ProductionDatasetFrozenLogType Definition

Attribute

Value

BrowseName

ProductionDatasetFrozenLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

OldValue

0:Boolean

0:PropertyType

M

0:HasProperty

Variable

NewValue

0:Boolean

0:PropertyType

M

The StandstillReasonLogType is used for logging StandstillReasons.

Table 24 – StandstillReasonLogType Definition

Attribute

Value

BrowseName

StandstillReasonLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

StandstillReasonId

0:String

0:PropertyType

M

The MessageLogType is used for logging MessageConditions (see 14.8).

Table 25 – MessageLogType Definition

Attribute

Value

BrowseName

MessageLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

Id

0:String

0:PropertyType

M

0:HasProperty

Variable

IsStandstillMessage

0:Boolean

0:PropertyType

M

0:HasProperty

Variable

Classification

0:Enumeration

0:PropertyType

M

Classification: Classification of the message. The valid values of the Enumeration are specified in the specific Companion Specification (e.g. IMMMessageClassificationEnumeration in OPC 40077).

The UserFeedbackLogType is used for logging text messages entered by the user into the machine control system.

Table 26 – UserFeedbackLogType Definition

Attribute

Value

BrowseName

UserFeedbackLogType

IsAbstract

True

References

Node Class

BrowseName

DataType

TypeDefinition

Other

Subtype of LogbookEventType

0:HasProperty

Variable

Classification

0:Enumeration

0:PropertyType

M

Classification: Classification of the message. The valid values of the Enumeration are specified in the specific Companion Specification (e.g. IMMMessageClassificationEnumeration in OPC 40077).

NOTE: The Message itself is included in the BaseEventType