From 9ab37e983685b34ddaad19bc029855480d835b0f Mon Sep 17 00:00:00 2001
From: Michael Zillgith <michael.zillgith@mz-automation.de>
Date: Mon, 24 Aug 2020 19:20:26 +0200
Subject: [PATCH] - IED Server/GOOSE: Don't send GOOSE message with new event
 while data model is locked

---
 .../server_example_goose.c                    |  17 +++
 .../simpleIO_direct_control_goose.cid         |  13 ++-
 examples/server_example_goose/static_model.c  | 100 +++++++++++++++-
 src/iec61850/inc_private/mms_goose.h          |   8 +-
 src/iec61850/server/impl/ied_server.c         |   6 +
 src/iec61850/server/mms_mapping/mms_goose.c   |  81 +++++++++----
 src/iec61850/server/mms_mapping/mms_mapping.c |   8 +-
 tools/model_generator/genmodel.jar            | Bin 94594 -> 94643 bytes
 .../tools/StaticModelGenerator.java           | 110 +++++++++---------
 9 files changed, 264 insertions(+), 79 deletions(-)

diff --git a/examples/server_example_goose/server_example_goose.c b/examples/server_example_goose/server_example_goose.c
index 2fe77f47..d6548c35 100644
--- a/examples/server_example_goose/server_example_goose.c
+++ b/examples/server_example_goose/server_example_goose.c
@@ -104,6 +104,8 @@ int main(int argc, char** argv) {
 
 	float anIn1 = 0.f;
 
+	int eventCount = 10;
+
 	while (running) {
 
 	    IedServer_lockDataModel(iedServer);
@@ -111,6 +113,21 @@ int main(int argc, char** argv) {
         IedServer_updateUTCTimeAttributeValue(iedServer, IEDMODEL_GenericIO_GGIO1_AnIn1_t, Hal_getTimeInMs());
 	    IedServer_updateFloatAttributeValue(iedServer, IEDMODEL_GenericIO_GGIO1_AnIn1_mag_f, anIn1);
 
+	    if (eventCount) {
+	        IedServer_updateUTCTimeAttributeValue(iedServer, IEDMODEL_GenericIO_GGIO1_SPCSO4_t, Hal_getTimeInMs());
+
+	        if (eventCount % 2) {
+	            IedServer_updateQuality(iedServer, IEDMODEL_GenericIO_GGIO1_SPCSO4_q, QUALITY_VALIDITY_GOOD);
+	            IedServer_updateBooleanAttributeValue(iedServer, IEDMODEL_GenericIO_GGIO1_SPCSO4_stVal, true);
+	        }
+	        else {
+                IedServer_updateQuality(iedServer, IEDMODEL_GenericIO_GGIO1_SPCSO4_q, QUALITY_VALIDITY_INVALID);
+                IedServer_updateBooleanAttributeValue(iedServer, IEDMODEL_GenericIO_GGIO1_SPCSO4_stVal, false);
+	        }
+
+	        eventCount--;
+	    }
+
 	    IedServer_unlockDataModel(iedServer);
 
 	    anIn1 += 0.1;
diff --git a/examples/server_example_goose/simpleIO_direct_control_goose.cid b/examples/server_example_goose/simpleIO_direct_control_goose.cid
index 8f443989..1701b9fe 100644
--- a/examples/server_example_goose/simpleIO_direct_control_goose.cid
+++ b/examples/server_example_goose/simpleIO_direct_control_goose.cid
@@ -68,6 +68,17 @@
               <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO3" />
               <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO4" />
             </DataSet>
+            
+            <DataSet name="Events3" desc="Events3">
+              <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO1" daName="stVal" />
+              <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO1" daName="q" />
+              <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO2" daName="stVal" />
+              <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO2" daName="q" />
+              <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO3" daName="stVal" />
+              <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO3" daName="q" />
+              <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO4" daName="stVal" />
+              <FCDA ldInst="GenericIO" lnClass="GGIO" fc="ST" lnInst="1" doName="SPCSO4" daName="q" />
+            </DataSet>
 
             <DataSet name="AnalogValues" desc="analog values">
               <FCDA ldInst="GenericIO" lnClass="GGIO" fc="MX" lnInst="1" doName="AnIn1" />
@@ -88,7 +99,7 @@
               <RptEnabled max="1" />
             </ReportControl>
 
-            <GSEControl appID="events" name="gcbEvents" type="GOOSE" datSet="Events" confRev="2" />
+            <GSEControl appID="events" name="gcbEvents" type="GOOSE" datSet="Events3" confRev="2" />
             <GSEControl appID="analog" name="gcbAnalogValues" type="GOOSE" datSet="AnalogValues" confRev="2"/>
 
             <DOI name="Mod">
diff --git a/examples/server_example_goose/static_model.c b/examples/server_example_goose/static_model.c
index e57b0596..245575f0 100644
--- a/examples/server_example_goose/static_model.c
+++ b/examples/server_example_goose/static_model.c
@@ -9,6 +9,7 @@ static void initializeValues();
 
 extern DataSet iedModelds_GenericIO_LLN0_Events;
 extern DataSet iedModelds_GenericIO_LLN0_Events2;
+extern DataSet iedModelds_GenericIO_LLN0_Events3;
 extern DataSet iedModelds_GenericIO_LLN0_AnalogValues;
 
 
@@ -115,6 +116,103 @@ DataSet iedModelds_GenericIO_LLN0_Events2 = {
   "LLN0$Events2",
   4,
   &iedModelds_GenericIO_LLN0_Events2_fcda0,
+  &iedModelds_GenericIO_LLN0_Events3
+};
+
+extern DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda0;
+extern DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda1;
+extern DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda2;
+extern DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda3;
+extern DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda4;
+extern DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda5;
+extern DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda6;
+extern DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda7;
+
+DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda0 = {
+  "GenericIO",
+  false,
+  "GGIO1$ST$SPCSO1$stVal",
+  -1,
+  NULL,
+  NULL,
+  &iedModelds_GenericIO_LLN0_Events3_fcda1
+};
+
+DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda1 = {
+  "GenericIO",
+  false,
+  "GGIO1$ST$SPCSO1$q",
+  -1,
+  NULL,
+  NULL,
+  &iedModelds_GenericIO_LLN0_Events3_fcda2
+};
+
+DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda2 = {
+  "GenericIO",
+  false,
+  "GGIO1$ST$SPCSO2$stVal",
+  -1,
+  NULL,
+  NULL,
+  &iedModelds_GenericIO_LLN0_Events3_fcda3
+};
+
+DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda3 = {
+  "GenericIO",
+  false,
+  "GGIO1$ST$SPCSO2$q",
+  -1,
+  NULL,
+  NULL,
+  &iedModelds_GenericIO_LLN0_Events3_fcda4
+};
+
+DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda4 = {
+  "GenericIO",
+  false,
+  "GGIO1$ST$SPCSO3$stVal",
+  -1,
+  NULL,
+  NULL,
+  &iedModelds_GenericIO_LLN0_Events3_fcda5
+};
+
+DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda5 = {
+  "GenericIO",
+  false,
+  "GGIO1$ST$SPCSO3$q",
+  -1,
+  NULL,
+  NULL,
+  &iedModelds_GenericIO_LLN0_Events3_fcda6
+};
+
+DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda6 = {
+  "GenericIO",
+  false,
+  "GGIO1$ST$SPCSO4$stVal",
+  -1,
+  NULL,
+  NULL,
+  &iedModelds_GenericIO_LLN0_Events3_fcda7
+};
+
+DataSetEntry iedModelds_GenericIO_LLN0_Events3_fcda7 = {
+  "GenericIO",
+  false,
+  "GGIO1$ST$SPCSO4$q",
+  -1,
+  NULL,
+  NULL,
+  NULL
+};
+
+DataSet iedModelds_GenericIO_LLN0_Events3 = {
+  "GenericIO",
+  "LLN0$Events3",
+  8,
+  &iedModelds_GenericIO_LLN0_Events3_fcda0,
   &iedModelds_GenericIO_LLN0_AnalogValues
 };
 
@@ -1896,7 +1994,7 @@ static PhyComAddress iedModel_GenericIO_LLN0_gse0_address = {
   {0x1, 0xc, 0xcd, 0x1, 0x0, 0x1}
 };
 
-GSEControlBlock iedModel_GenericIO_LLN0_gse0 = {&iedModel_GenericIO_LLN0, "gcbEvents", "events", "Events", 2, false, &iedModel_GenericIO_LLN0_gse0_address, 1000, 3000, &iedModel_GenericIO_LLN0_gse1};
+GSEControlBlock iedModel_GenericIO_LLN0_gse0 = {&iedModel_GenericIO_LLN0, "gcbEvents", "events", "Events3", 2, false, &iedModel_GenericIO_LLN0_gse0_address, 1000, 3000, &iedModel_GenericIO_LLN0_gse1};
 
 static PhyComAddress iedModel_GenericIO_LLN0_gse1_address = {
   4,
diff --git a/src/iec61850/inc_private/mms_goose.h b/src/iec61850/inc_private/mms_goose.h
index 0b1a22d5..326e35dc 100644
--- a/src/iec61850/inc_private/mms_goose.h
+++ b/src/iec61850/inc_private/mms_goose.h
@@ -69,7 +69,10 @@ LIB61850_INTERNAL void
 MmsGooseControlBlock_checkAndPublish(MmsGooseControlBlock self, uint64_t currentTime);
 
 LIB61850_INTERNAL void
-MmsGooseControlBlock_observedObjectChanged(MmsGooseControlBlock self);
+MmsGooseControlBlock_setStateChangePending(MmsGooseControlBlock self);
+
+LIB61850_INTERNAL void
+MmsGooseControlBlock_publishNewState(MmsGooseControlBlock self);
 
 LIB61850_INTERNAL void
 MmsGooseControlBlock_enable(MmsGooseControlBlock self);
@@ -77,6 +80,9 @@ MmsGooseControlBlock_enable(MmsGooseControlBlock self);
 LIB61850_INTERNAL void
 MmsGooseControlBlock_disable(MmsGooseControlBlock self);
 
+LIB61850_INTERNAL void
+GOOSE_sendPendingEvents(MmsMapping* self);
+
 LIB61850_INTERNAL MmsVariableSpecification*
 GOOSE_createGOOSEControlBlocks(MmsMapping* self, MmsDomain* domain,
         LogicalNode* logicalNode, int gseCount);
diff --git a/src/iec61850/server/impl/ied_server.c b/src/iec61850/server/impl/ied_server.c
index 086011be..1422f79a 100644
--- a/src/iec61850/server/impl/ied_server.c
+++ b/src/iec61850/server/impl/ied_server.c
@@ -34,6 +34,7 @@
 
 #include "libiec61850_platform_includes.h"
 #include "mms_sv.h"
+#include "mms_goose.h"
 
 #ifndef DEBUG_IED_SERVER
 #define DEBUG_IED_SERVER 0
@@ -728,6 +729,11 @@ IedServer_lockDataModel(IedServer self)
 void
 IedServer_unlockDataModel(IedServer self)
 {
+#if (CONFIG_INCLUDE_GOOSE_SUPPORT == 1)
+    /* check if GOOSE messages have to be sent */
+    GOOSE_sendPendingEvents(self->mmsMapping);
+#endif /* (CONFIG_INCLUDE_GOOSE_SUPPORT == 1) */
+
     /* check if reports have to be sent! */
     Reporting_processReportEventsAfterUnlock(self->mmsMapping);
 
diff --git a/src/iec61850/server/mms_mapping/mms_goose.c b/src/iec61850/server/mms_mapping/mms_goose.c
index 09184a62..b109dafd 100644
--- a/src/iec61850/server/mms_mapping/mms_goose.c
+++ b/src/iec61850/server/mms_mapping/mms_goose.c
@@ -72,6 +72,8 @@ struct sMmsGooseControlBlock {
     char* dataSetRef;
 
     char* gooseInterfaceId;
+
+    bool stateChangePending;
 };
 
 #if (CONFIG_IEC61850_SERVICE_TRACKING == 1)
@@ -357,43 +359,50 @@ MmsGooseControlBlock_enable(MmsGooseControlBlock self)
             else
                 self->publisher = GoosePublisher_createEx(&commParameters, self->mmsMapping->gooseInterfaceId, self->useVlanTag);
 
-            self->minTime = MmsValue_toUint32(MmsValue_getElement(self->mmsValue, 6));
-            self->maxTime = MmsValue_toUint32(MmsValue_getElement(self->mmsValue, 7));
+            if (self->publisher) {
+                self->minTime = MmsValue_toUint32(MmsValue_getElement(self->mmsValue, 6));
+                self->maxTime = MmsValue_toUint32(MmsValue_getElement(self->mmsValue, 7));
 
-            GoosePublisher_setTimeAllowedToLive(self->publisher, self->maxTime * 3);
+                GoosePublisher_setTimeAllowedToLive(self->publisher, self->maxTime * 3);
 
-            GoosePublisher_setDataSetRef(self->publisher, self->dataSetRef);
+                GoosePublisher_setDataSetRef(self->publisher, self->dataSetRef);
 
-            GoosePublisher_setGoCbRef(self->publisher, self->goCBRef);
+                GoosePublisher_setGoCbRef(self->publisher, self->goCBRef);
 
-            uint32_t confRev = MmsValue_toUint32(MmsValue_getElement(self->mmsValue, 3));
+                uint32_t confRev = MmsValue_toUint32(MmsValue_getElement(self->mmsValue, 3));
 
-            GoosePublisher_setConfRev(self->publisher, confRev);
+                GoosePublisher_setConfRev(self->publisher, confRev);
 
-            bool needsCom = MmsValue_getBoolean(MmsValue_getElement(self->mmsValue, 4));
+                bool needsCom = MmsValue_getBoolean(MmsValue_getElement(self->mmsValue, 4));
 
-            GoosePublisher_setNeedsCommission(self->publisher, needsCom);
+                GoosePublisher_setNeedsCommission(self->publisher, needsCom);
 
-            if (self->goId != NULL)
-                GoosePublisher_setGoID(self->publisher, self->goId);
+                if (self->goId != NULL)
+                    GoosePublisher_setGoID(self->publisher, self->goId);
 
-            /* prepare data set values */
-            self->dataSetValues = LinkedList_create();
+                /* prepare data set values */
+                self->dataSetValues = LinkedList_create();
 
-            DataSetEntry* dataSetEntry = self->dataSet->fcdas;
+                DataSetEntry* dataSetEntry = self->dataSet->fcdas;
 
-            while (dataSetEntry != NULL) {
-                LinkedList_add(self->dataSetValues, dataSetEntry->value);
-                dataSetEntry = dataSetEntry->sibling;
-            }
+                while (dataSetEntry != NULL) {
+                    LinkedList_add(self->dataSetValues, dataSetEntry->value);
+                    dataSetEntry = dataSetEntry->sibling;
+                }
 
-            self->goEna = true;
+                self->goEna = true;
 
 #if (CONFIG_IEC61850_SERVICE_TRACKING == 1)
-            MmsDataAccessError retVal = DATA_ACCESS_ERROR_SUCCESS;
-            copyGCBValuesToTrackingObject(self);
-            updateGenericTrackingObjectValues(self, IEC61850_SERVICE_TYPE_SET_GOCB_VALUES, retVal);
+                MmsDataAccessError retVal = DATA_ACCESS_ERROR_SUCCESS;
+                copyGCBValuesToTrackingObject(self);
+                updateGenericTrackingObjectValues(self, IEC61850_SERVICE_TYPE_SET_GOCB_VALUES, retVal);
 #endif /* (CONFIG_IEC61850_SERVICE_TRACKING == 1) */
+            }
+            else {
+                if (DEBUG_IED_SERVER)
+                    printf("IED_SERVER: Failed to create GOOSE publisher!\n");
+            }
+
         }
 
     }
@@ -475,8 +484,15 @@ MmsGooseControlBlock_checkAndPublish(MmsGooseControlBlock self, uint64_t current
 }
 
 void
-MmsGooseControlBlock_observedObjectChanged(MmsGooseControlBlock self)
+MmsGooseControlBlock_setStateChangePending(MmsGooseControlBlock self)
+{
+    self->stateChangePending = true;
+}
+
+void
+MmsGooseControlBlock_publishNewState(MmsGooseControlBlock self)
 {
+    if (self->stateChangePending) {
 #if (CONFIG_MMS_THREADLESS_STACK != 1)
     Semaphore_wait(self->publisherMutex);
 #endif
@@ -498,9 +514,12 @@ MmsGooseControlBlock_observedObjectChanged(MmsGooseControlBlock self)
 
     GoosePublisher_publish(self->publisher, self->dataSetValues);
 
+    self->stateChangePending = false;
+
 #if (CONFIG_MMS_THREADLESS_STACK != 1)
     Semaphore_post(self->publisherMutex);
 #endif
+    }
 }
 
 static MmsVariableSpecification*
@@ -608,6 +627,20 @@ createDataSetReference(char* domainName, char* lnName, char* dataSetName)
     return dataSetReference;
 }
 
+void
+GOOSE_sendPendingEvents(MmsMapping* self)
+{
+    LinkedList element = self->gseControls;
+
+    while ((element = LinkedList_getNext(element)) != NULL) {
+        MmsGooseControlBlock gcb = (MmsGooseControlBlock) element->data;
+
+        if (MmsGooseControlBlock_isEnabled(gcb)) {
+            MmsGooseControlBlock_publishNewState(gcb);
+        }
+    }
+}
+
 MmsVariableSpecification*
 GOOSE_createGOOSEControlBlocks(MmsMapping* self, MmsDomain* domain,
         LogicalNode* logicalNode, int gseCount)
@@ -718,6 +751,8 @@ GOOSE_createGOOSEControlBlocks(MmsMapping* self, MmsDomain* domain,
 
         mmsGCB->mmsMapping = self;
 
+        mmsGCB->stateChangePending = false;
+
         LinkedList_add(self->gseControls, mmsGCB);
 
         currentGCB++;
diff --git a/src/iec61850/server/mms_mapping/mms_mapping.c b/src/iec61850/server/mms_mapping/mms_mapping.c
index 253753b8..798c1d47 100644
--- a/src/iec61850/server/mms_mapping/mms_mapping.c
+++ b/src/iec61850/server/mms_mapping/mms_mapping.c
@@ -3509,6 +3509,8 @@ MmsMapping_triggerGooseObservers(MmsMapping* self, MmsValue* value)
 {
     LinkedList element = self->gseControls;
 
+    bool modelLocked = self->isModelLocked;
+
     while ((element = LinkedList_getNext(element)) != NULL) {
         MmsGooseControlBlock gcb = (MmsGooseControlBlock) element->data;
 
@@ -3516,7 +3518,11 @@ MmsMapping_triggerGooseObservers(MmsMapping* self, MmsValue* value)
             DataSet* dataSet = MmsGooseControlBlock_getDataSet(gcb);
 
             if (DataSet_isMemberValue(dataSet, value, NULL)) {
-                MmsGooseControlBlock_observedObjectChanged(gcb);
+                MmsGooseControlBlock_setStateChangePending(gcb);
+
+                if (modelLocked == false) {
+                    MmsGooseControlBlock_publishNewState(gcb);
+                }
             }
         }
     }
diff --git a/tools/model_generator/genmodel.jar b/tools/model_generator/genmodel.jar
index ec65eae5aa25d625e974f1d929fe189670011dc6..25fb74dffc431bf1e83a7168ab7cec2468e07b86 100644
GIT binary patch
delta 18513
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
Ef8GP4pa1{>

delta 18562
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

diff --git a/tools/model_generator/src/com/libiec61850/tools/StaticModelGenerator.java b/tools/model_generator/src/com/libiec61850/tools/StaticModelGenerator.java
index 6f0a41b3..4e1ae291 100644
--- a/tools/model_generator/src/com/libiec61850/tools/StaticModelGenerator.java
+++ b/tools/model_generator/src/com/libiec61850/tools/StaticModelGenerator.java
@@ -1028,77 +1028,83 @@ public class StaticModelGenerator {
         for (GSEControl gseControlBlock : gseControlBlocks) {
 
             GSE gse = connectedAP.lookupGSE(logicalDeviceName, gseControlBlock.getName());
-
-            PhyComAddress gseAddress = gse.getAddress();
             
-            String gseString = "";
+            if (gse != null) {
+                PhyComAddress gseAddress = gse.getAddress();
+                
+                String gseString = "";
 
-            String phyComAddrName = "";
+                String phyComAddrName = "";
 
-            if (gseAddress != null) {
-                phyComAddrName = lnPrefix + "_gse" + gseControlNumber + "_address";
+                if (gseAddress != null) {
+                    phyComAddrName = lnPrefix + "_gse" + gseControlNumber + "_address";
 
-                gseString += "\nstatic PhyComAddress " + phyComAddrName + " = {\n";
-                gseString += "  " + gseAddress.getVlanPriority() + ",\n";
-                gseString += "  " + gseAddress.getVlanId() + ",\n";
-                gseString += "  " + gseAddress.getAppId() + ",\n";
-                gseString += "  {";
+                    gseString += "\nstatic PhyComAddress " + phyComAddrName + " = {\n";
+                    gseString += "  " + gseAddress.getVlanPriority() + ",\n";
+                    gseString += "  " + gseAddress.getVlanId() + ",\n";
+                    gseString += "  " + gseAddress.getAppId() + ",\n";
+                    gseString += "  {";
 
-                for (int i = 0; i < 6; i++) {
-                    gseString += "0x" + Integer.toHexString(gseAddress.getMacAddress()[i]);
-                    if (i == 5)
-                        gseString += "}\n";
-                    else
-                        gseString += ", ";
+                    for (int i = 0; i < 6; i++) {
+                        gseString += "0x" + Integer.toHexString(gseAddress.getMacAddress()[i]);
+                        if (i == 5)
+                            gseString += "}\n";
+                        else
+                            gseString += ", ";
+                    }
+
+                    gseString += "};\n\n";
                 }
 
-                gseString += "};\n\n";
-            }
+                String gseVariableName = lnPrefix + "_gse" + gseControlNumber;
 
-            String gseVariableName = lnPrefix + "_gse" + gseControlNumber;
+                gseString += "GSEControlBlock " + gseVariableName + " = {";
+                gseString += "&" + lnPrefix + ", ";
 
-            gseString += "GSEControlBlock " + gseVariableName + " = {";
-            gseString += "&" + lnPrefix + ", ";
+                gseString += "\"" + gseControlBlock.getName() + "\", ";
 
-            gseString += "\"" + gseControlBlock.getName() + "\", ";
+                if (gseControlBlock.getAppID() == null)
+                    gseString += "NULL, ";
+                else
+                    gseString += "\"" + gseControlBlock.getAppID() + "\", ";
 
-            if (gseControlBlock.getAppID() == null)
-                gseString += "NULL, ";
-            else
-                gseString += "\"" + gseControlBlock.getAppID() + "\", ";
+                if (gseControlBlock.getDataSet() != null)
+                    gseString += "\"" + gseControlBlock.getDataSet() + "\", ";
+                else
+                    gseString += "NULL, ";
 
-            if (gseControlBlock.getDataSet() != null)
-                gseString += "\"" + gseControlBlock.getDataSet() + "\", ";
-            else
-                gseString += "NULL, ";
+                gseString += gseControlBlock.getConfRev() + ", ";
 
-            gseString += gseControlBlock.getConfRev() + ", ";
+                if (gseControlBlock.isFixedOffs())
+                    gseString += "true, ";
+                else
+                    gseString += "false, ";
 
-            if (gseControlBlock.isFixedOffs())
-                gseString += "true, ";
-            else
-                gseString += "false, ";
+                if (gseAddress != null)
+                    gseString += "&" + phyComAddrName + ", ";
+                else
+                    gseString += "NULL, ";
+                
+                gseString += gse.getMinTime() + ", ";
+                gseString += gse.getMaxTime() + ", ";
 
-            if (gseAddress != null)
-                gseString += "&" + phyComAddrName + ", ";
-            else
-                gseString += "NULL, ";
-            
-            gseString += gse.getMinTime() + ", ";
-            gseString += gse.getMaxTime() + ", ";
+                currentGseVariableNumber++;
+                
+                if (currentGseVariableNumber < gseVariableNames.size())
+                    gseString += "&" + gseVariableNames.get(currentGseVariableNumber);
+                else
+                    gseString += "NULL";
 
-            currentGseVariableNumber++;
-            
-            if (currentGseVariableNumber < gseVariableNames.size())
-                gseString += "&" + gseVariableNames.get(currentGseVariableNumber);
-            else
-                gseString += "NULL";
+                gseString += "};\n";
 
-            gseString += "};\n";
+                this.gseControlBlocks.append(gseString);
 
-            this.gseControlBlocks.append(gseString);
+                gseControlNumber++;
+            }
+            else {
+                System.out.println("GSE not found for GoCB " + gseControlBlock.getName());
+            }
 
-            gseControlNumber++;
         }
     }