SUPPORT / SAMPLES & SAS NOTES
 

Support

Usage Note 68797: A new option for the removeWorkflowInstances command in the SAS® Risk Governance Framework removes orphaned instances from the workflow registry

DetailsHotfixAboutRate It

You might be unable to start a new workflow instance for a business object even though an existing workflow instance cannot be found. The problem sometimes occurs due to an out-of-sync condition between the workflow_registry table in the SAS Risk Governance Framework database and the workflow tables in the SAS® Shared Services database.

The workflow_registry table might contain a reference to a workflow instance for a business object, but the workflow instance no longer exists in the SAS Shared Services database. This problem could occur if you back up and restore the SAS Risk Governance Framework database but fail to back up and restore the SAS Shared Services database.

A new option for the removeWorkflowInstances command in the SAS Risk Governance Framework enables you to remove workflow instances from the workflow registry. The option removes only workflow instances that no longer exist in the SAS Shared Services database. To remove orphaned workflow instances from the workflow registry, specify the r option, as shown in the example below:

removeWorkflowInstances.sh -c solution-identifier -r

You can specify the r option with the o option to remove orphaned workflow instances from the workflow registry and from the SAS Shared Services database. The orphaned workflow instances that are removed from the SAS Shared Services database are associated with business objects that no longer exist in the SAS Risk Governance Framework database. When the SAS Shared Services database contains orphaned workflow instances, you see warning messages in the SASRiskGovernanceFrameworkMidTier.log file similar to the following:

WARN com.sas.oprisk.server.workflow.FilteredAPIWorklistStrategy - Unrecognized pointer tag in handle string OP_RISK_ISSUE|11560|mrm|
WARN com.sas.oprisk.server.workflow.FilteredAPIWorklistStrategy - Unrecognized pointer tag in handle string AUDIT_INST|11403|mrm|

To remove orphaned workflow instances from the workflow registry and from the SAS Shared Services database, specify the r option and the o option, as shown below:

removeWorkflowInstances.sh -c solution-identifier -r -o

Click the Hot Fix tab in this note to access the hot fix for this issue.



Operating System and Release Information

Product FamilyProductSystemProduct ReleaseSAS Release
ReportedFixed*ReportedFixed*
SAS SystemSAS Risk Governance FrameworkWindows 7 Professional 32 bit7.49.4 TS1M5
Windows 7 Home Premium x647.49.4 TS1M5
Windows 7 Home Premium 32 bit7.49.4 TS1M5
Windows 7 Enterprise x647.49.4 TS1M5
Windows 7 Enterprise 32 bit7.49.4 TS1M5
Microsoft Windows Server 20167.49.4 TS1M5
Microsoft Windows Server 2012 Std7.49.4 TS1M5
Microsoft Windows Server 2012 R2 Std7.49.4 TS1M5
Microsoft Windows Server 2012 R2 Datacenter7.49.4 TS1M5
Microsoft Windows Server 2012 Datacenter7.49.4 TS1M5
Microsoft Windows Server 2008 for x647.49.4 TS1M5
Microsoft Windows Server 2008 R27.49.4 TS1M5
Microsoft Windows Server 20087.49.4 TS1M5
Microsoft Windows 107.49.4 TS1M5
Microsoft Windows 8.1 Pro x647.49.4 TS1M5
Microsoft Windows 8.1 Pro 32-bit7.49.4 TS1M5
Microsoft Windows 8.1 Enterprise x647.49.4 TS1M5
Microsoft Windows 8.1 Enterprise 32-bit7.49.4 TS1M5
Microsoft Windows 8 Pro x647.49.4 TS1M5
Microsoft Windows 8 Pro 32-bit7.49.4 TS1M5
Microsoft Windows 8 Enterprise x647.49.4 TS1M5
Microsoft Windows 8 Enterprise 32-bit7.49.4 TS1M5
Microsoft® Windows® for x647.49.4 TS1M5
Windows 7 Professional x647.49.4 TS1M5
Windows 7 Ultimate 32 bit7.49.4 TS1M5
Windows 7 Ultimate x647.49.4 TS1M5
Linux for x647.49.4 TS1M5
* For software releases that are not yet generally available, the Fixed Release is the software release in which the problem is planned to be fixed.