Skip to main content

Software  >  WebSphere  >  WebSphere Portal Family  >  

Workspace Validation utility to verify JCR Workspace database views are in sync for DB2 on z/OS

 Product documentation
 
Abstract
The following document explains how to use DB2 on z/OS backup procedures in conjunction with WebSphere Portal. If you are using DB2 on z/OS and WebSphere Portal and you want to backup only the data in the tables without any actual schema information you will find issues after the restore of the tables as this procedure conflicts with the WCM/JCR runtime strategy whereby Portal
creates Database Views for every dynamic workspace (DWS).
The Database Views don't get backed up as part of this simple backup. Thus if a restore were to occur, we will likely have Database views created in the DB that don't yet exist as allocated Dynamic Workspaces yet. In such a restored system, eventually the creation of new content will cause JCR to create an "existing" Database view which will cause an error.
The document explains how to solve this issue and so allow the DB2 on z/OS backup procedure to be used with WebSphere Portal.
 
 
Content

Usage instructions:
To remedy the problem explained above after a restore, JCR is providing a Workspace Validation utility which will verify that the JCR Workspace database views are in sync with the allocated workspaces. The Workspace Validation utility is designed to run when WebSphere Portal is started. The action of the utility is controlled by a setting in the icm.properties file with the following settings:

# Workspace Validation Support
# Controls workspace validation option for JCR startup. This option determines whether or not JCR will validate
# the existence of the proper number of database views used by JCR Workspaces. There are three option. SKIP is
# the default if no value is specified.
# SKIP - Peform no validation
# REPORT - Log to the SystemOut log any necessary corrections
# FIX - Make and Log to the SystemOut log the necessary corrections
#jcr.workspace.view.validation=REPORT

The utility to remove unused views is also available via APAR PK69082 on the 6.0.1.3 and 6.0.1.4 fix pack level.
On previous levels it is also possible to delete the database views via the following SQL:
By running the SQL below the names of the views (SYSVIEWNAME column) are returned and can then be deleted.
PLEASE NOTE that all instances of JCRU0000 will need to be replaced with the appropriate schema name for the customer.

SELECT JCRVIEWNAME, WSFLAG, WSTYPE, SYSVIEWNAME
FROM
(
SELECT 'ICMSTJCRL'||RIGHT(RTRIM('0000'||CAST(WSID AS CHAR(11))),5) AS JCRVIEWNAME, WSFLAG, WSTYPE
FROM JCRU0000.ICMSTJCRWS
UNION ALL
SELECT 'ICMSTJCRLV'||RIGHT(RTRIM('0000'||CAST(WSID AS CHAR(11))),5) AS JCRVIEWNAME, WSFLAG, WSTYPE
FROM JCRU0000.ICMSTJCRWS
UNION ALL
SELECT 'ICMSTJCRLR'||RIGHT(RTRIM('0000'||CAST(WSID AS CHAR(11))),5) AS JCRVIEWNAME, WSFLAG, WSTYPE
FROM JCRU0000.ICMSTJCRWS
UNION ALL
SELECT 'ICMSTJCRN'||RIGHT(RTRIM('0000'||CAST(WSID AS CHAR(11))),5) AS JCRVIEWNAME, WSFLAG, WSTYPE
FROM JCRU0000.ICMSTJCRWS
) JCRVIEWLIST
FULL OUTER JOIN
(
SELECT RTRIM(NAME) AS SYSVIEWNAME FROM SYSIBM.SYSVIEWS WHERE CREATOR='JCRU0000'
AND ( NAME LIKE 'ICMSTJCRL%' OR NAME LIKE 'ICMSTJCRN%')
) AS SYSVIEWLIST
ON JCRVIEWNAME = SYSVIEWNAME
WHERE
(WSFLAG IS NOT NULL OR (WSFLAG IS NULL AND JCRVIEWNAME IS NULL ))
AND
( (JCRVIEWNAME IS NULL AND SYSVIEWNAME IS NOT NULL ) OR (JCRVIEWNAME IS NOT NULL AND SYSVIEWNAME IS NULL ) ) ;
 
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Organizational Productivity, Portals & Collaboration
 Portals
 WebSphere Portal
 Operating system(s):
  AIX, HP-UX, Linux, Solaris, Windows, z/OS
 Software version:
  6.0.1.5
 Software edition:
  Enable, Extend, Server
 Reference #:
  7014153
 IBM Group:
 Software Group
 Modified date:
 2009-10-27

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.