2012 - CM OnDemand Product Update

© 2012 IBM Corporation

Enterprise Content Management

Content Manager OnDemand Product Update Greg Felderman

IBM Software Solutions | Enterprise Content Management Software



October 24, 2012

Please Note:

IBM’s statements regarding its plans, directions, and intent are subject to

change or withdrawal without notice at IBM’s sole discretion.

Information regarding potential future products is intended to outline our

general product direction and it should not be relied on in making a

purchasing decision.

The information mentioned regarding potential future products is not a

commitment, promise, or legal obligation to deliver any material, code or

functionality. Information about potential future products may not be

incorporated into any contract. The development, release, and timing of any

future features or functionality described for our products remains at our

sole discretion.

Performance is based on measurements and projections using standard

IBM benchmarks in a controlled environment. The actual throughput or

performance that any user will experience will vary depending upon many

factors, including considerations such as the amount of multiprogramming

in the user's job stream, the I/O configuration, the storage configuration,

and the workload processed. Therefore, no assurance can be given that an

individual user will achieve results similar to those stated here.



October 24, 2012

Acknowledgements and Disclaimers:

© Copyright IBM Corporation 2012. All rights reserved.

– U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule

Contract with IBM Corp.

IBM, the IBM logo and ibm.com and CICS, DB2, Tivoli and FileNet are trademarks or registered trademarks of International

Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are

marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered

or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be

registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at

“Copyright and trademark information” at www.ibm.com/legal/copytrade.shtml

Other company, product, or service names including Windows, Oracle, Datawatch and Monarch may be trademarks or

service marks of others.

Availability. References in this presentation to IBM products, programs, or services do not imply that they will be available

in all countries in which IBM operates.

The workshops, sessions and materials have been prepared by IBM or the session speakers and reflect their own views.

They are provided for informational purposes only, and are neither intended to, nor shall have the effect of being, legal or

other guidance or advice to any participant. While efforts were made to verify the completeness and accuracy of the

information contained in this presentation, it is provided AS-IS without warranty of any kind, express or implied. IBM shall

not be responsible for any damages arising out of the use of, or otherwise related to, this presentation or any other

materials. Nothing contained in this presentation is intended to, nor shall have the effect of, creating any warranties or

representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license

agreement governing the use of IBM software.

All customer examples described are presented as illustrations of how those customers have used IBM products and the

results they may have achieved. Actual environmental costs and performance characteristics may vary by customer.

Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities

undertaken by you will result in any specific sales, revenue growth or other results.

http://www.ibm.com/legal/copytrade.shtml



October 24, 2012 4 Content Manager OnDemand Update

Prerequisites

All the listed versions are the minimum versions – all later versions to the minimum are considered to be supported

OD Server/ODWEK – AIX

• 6.1 TL7 (change from 5.3) – HP-UX

• 11iV3 – Linux/x64

• Red Hat 5 U6 (change from RH 5 U0) • SUSE 10.3 (change from 10)

– Linux on System z • Red Hat 5 U6 (change from RH5 U0) • SUSE 10.3 (change from 10)

– Sun Solaris • 10 Update 9 (change from 10)

– Windows (OD Server) • Windows 2008 (no change) • 64bit HW only (change from previously allowing 32bit HW for ODWEK)

– zOS • zOS 1.13 (change from 1.11)

– iSeries (OD V8.5) • iSeries 7.1




Prerequisites

All the listed versions are the minimum versions – all later versions to the minimum are considered to be supported

OD/MP Server – DB2 - V9.7 (change from V9.5) – Oracle - 11g (no change) – SQL Server - 2008 R2 (change from 2008) – TSM - 5.5 (no change)

OD/zOS Server

– DB2 - V9 (no change) – TSM - 5.5 (no change)

OD/i Server (V8.5)

– TSM - 5.5 (no change)

OD Admin/Client – Windows XP SP3 (change from XP SP2)

ODWEK Java Api’s/Servlet/Linedata applet

– Java 1.6 (change from 1.5)




Platform Changes/Deprecation

OnDemand for HPUX with Oracle

– Deprecated, last supported version will be 8.5.X

– Oracle no longer supports HPUX

ODWEK Servlet/CGI

– Announced (and documented) as deprecated – although we continue to ship

– Customers should move to ODWEK Java api’s

ODWEK AFP2HTML Applet

– Deprecated, last supported version will be 8.5.X

ODWEK for Windows

– Only can be installed on 64bit system

– Java api’s still 32bit and 64bit

No support for clients prior to V8.4.1 accessing V9.0 server

– II4C (IBM Information Integrator for Content), incl/eClient will not work

• Should be using IBM Content Navigator




Platform Changes/Deprecation (continued)

Supported client/server versions

– The OD 9.0 Server - will only accept requests coming from a 8.4.1.0 or newer client.

– The OD 9.0 Server will only accept admin requests from Win Admin or ARSXML at the

9.0 level

– An OD 9.0 Client (Windows, ODWEK, etc) will only work against an 8.4.1.0 or later

server

– The OD 9.0 Windows Admin/ARSXML will work against any V8.5 or V9.0 server, but

nothing earlier

OnDemand for AIX requires Cobol run time environment

– cobol.rte 4.1.0.0 COMMITTED IBM COBOL for AIX Runtime

– cobol.rte.msg.en_US 4.1.0.0 COMMITTED IBM COBOL for AIX Runtime

– SdU.sfs 4.1.0.0 COMMITTED SMARTdata UTILITIES SFS Record

– SdU.vsam 4.1.0.0 COMMITTED SMARTdata UTILITIES VSAM

IBM GSKit (MP)

– Version 8.0.14.21 or later




Separately Priced Feature Enablement

In order to use any OnDemand Separately Priced Feature – you must install the appropriate

feature install image – assuming the customer has purchased it – the install images will be

available thru Passport Advantage/ShopZ

– Full Text Indexing

– Enhanced Retention Management

– PDF Indexer

– Report Distribution Facility

– OnDemand Distribution Facility

– AFP2WEB Transforms

In the case of ERM, PDF, RDF – the commands will still exist in the server install, however

attempting to run them will result in a message.

– (i.e.) The OnDemand report distribution feature has not been installed.

Please ensure that the feature has been purchased and properly installed.




Full Text Indexing/Search

Full text index (FTI) / Full text search (FTS)

Search complete text of document, not just meta data or document parts (title, abstracts, etc..)

Complex query support

FTS server platforms (same pre-reqs as OD):

– AIX

– Linux/x64

– Linux on System z

– Sun Solaris

– Windows

Searching the index supported by all OD V9 servers

Documents grouped by “collections”



October 24, 2012

Full Text Index/Search Overview



October 24, 2012


One to one mapping between OD data table and FTS collection

Collection name is instance name plus table name



October 24, 2012


Enable FTS indexing for an application group



October 24, 2012


Enable FTS indexing for an application group

Server and port must be specified

Default port 8191

Choose whether to automatically index all new loads



October 24, 2012


Add Full Text Index field

– Small Int

– Full Text Index mask



October 24, 2012


Search

– Query

Score

– Query, Hit list

– 1 to 100

– Relative to other results only

Highlight

– Hit list

– Context of found text

Summary

– Hit list

– First 80 characters of doc



October 24, 2012


FTS Exporter

– ODFTIExporter.jar

– Ships with OD server

• jars subdirectory

Indexing legacy data

– ODWEK Java Api's

• Search for documents

• Call FTIAddHits(Vector hits)

– arsdoc fti_add

• Entire load (-X <load_id>)

• Subset of documents (-i <sql_query>)

OnDemand Full Text Search technical document

– http://www.ibm.com/support/docview.wss?rs=129&uid=swg21606305

http://www.ibm.com/support/docview.wss?rs=129&uid=swg21606305



October 24, 2012

FileNet Systems Monitor Integration

FileNet Systems Monitor (FSM) is a purchased product which can monitor other programs

OnDemand is integrated with FSM in two ways – FSM can monitor the OnDemand system log and report when errors occur. This is done through an ODWEK module provided to and shipped by FSM. FSM can also monitor the status of the arssockd program via the new command-line options to provide thread listings and “ping” status.

The second way is through the FSM listener which is directly implemented in the arssockd program and can be attached to via a network port to relay information to FSM. The port is defined in the ars.cfg file (or registry section on Windows) for the appropriate server. The environment variable is ARS_LISTENER_PORT. If not defined then the listener is inactive. If defined as 0, the default port of 32775 is used.

– Login durations – Activity counts – Cache stores and retrieves (bytes and durations) – Login counts (SSL and non-SSL) – Logoff counts – Queries (hits and durations) – Retrieve counts (documents and resources) – Storage manager stores and retrieves (type, bytes, and durations)



October 24, 2012




October 24, 2012




October 24, 2012




October 24, 2012

Database Timestamp Support

Date

– 0001/01/01 – 9999/12/31

Date/Time

– 0001/01/01 00:00:00 – 9999/12/31 23:59:59

Date/Time w/TZ

– 0001/01/01 00:00:00.000000 – 9999/12/31 23:59:59.999999

OnDemand System Tables

– All OD system tables will be updated (during arsdb -u) to use database timestamps

(values will be populated during this process for all OD system tables except for the

ARSLOAD table)



October 24, 2012


For OD application group data

– To leverage new date/time types, all OD clients (ODWEK, Windows, CICS, etc) must be

at V9

System Log/System Load

– By default, existing definitions will not be modified to take advantage

• To modify, use -u option to arssyscr (ie. arssyscr -l -u)

– New definitions will take advantage of new time stamps

– Benefit is that now the Time Stamp will include fractional seconds

• 2012-07-31 12:41:35.596138



October 24, 2012


For Date/Time w/TZ – value in database is always in GMT

Option to 'upgrade' existing application group to leverage new formats without creating new

application group

Recommend all new application groups use new time stamp types only (assuming V9 clients

are used)

Recommend all display of dates include year as a 4 digit year

Recommended SQL Syntax

– Old style look like “where crd_date = 15575”

– New style looks like “where ODDAT_crd_dt = '2012-08-22'

• OnDemand server parses ODDAT_<db_name> such that it can map old style date

and new style date as well as deal with differences in how the underlying databases

(ie. Oracle) expect the value to be formatted.

http://www.ibm.com/support/docview.wss?uid=swg27036188




October 24, 2012

Installation Changes

AIX, HPUX, Sun

– /opt/IBM/ondemand/V9.0

– /opt/IBM/odwek/V9.0

Linux on x64, Linux on System z

– /opt/ibm/ondemand/V9.0

– /opt/ibm/odwek/V9.0

Windows

– C:\Program Files\IBM\OnDemand for Windows\V9.0

– C:\Program Files\IBM\OnDemand Web Enablement Kit\V9.0



October 24, 2012

Installation Changes

Possible issues

– Custom scripts for starting/stopping OD, crontab, etc

– ACIF user exits

• If it used ICU (ie. apka2e or asciinpe), need to evaluate and recompile in order to

find OD locale directory (ICU .dat file)

– Indexer parameters in Application definition best practice

• Old: INPUTDD=/usr/lpp/ars/exits/acif/apka2e

• New: INPUTDD=$(OD_ACIF_EXIT_DIR)apka2e

• arsload will use $(OD_ACIF_EXIT_DIR) if it finds a pre-V9 installation path name

– db2uext2 is probably a link from the users home db2 directory to the old install path (ie.

sqllib/bin/db2uext2) – they will have to be modified to point to the correct location





October 24, 2012

Security Enhancements

OnDemand Stash File – Encrypted file used to store userids/passwords – Eliminates use of userid and/or password on command line – arsload.cfg no longer exists – LDAP and Oracle userid/password no longer in ars.cfg – arsload will default to userid/password found in stash file listed in ars.ini [@SRV@_ARCHIVE] ... SRVR_OD_STASH=/opt/IBM/ondemand/V9.0/config/ars.stash

– Default userid/passwords for arsload, RDF, ODF, PDD, LDAP, DB2, Oracle – To create default userid/password for arsload command

• arsstash -a 3 -s ars.stash -u oduser

You would then be prompted to input the password – If you do specify a password to a command, you will get the following message:

• ARS1609W Warning: Passing passwords on the command line is being deprecated and is not recommended due to the text being visible. Please use the arsstash command to generate an OnDemand stash file and pass the stash file name as the password to this command.



October 24, 2012


New security functionality

– User Proxy

• Ability for login with normal userid, but not have to be defined to OD. (ie. Login with

LDAP userid/passwd but then use a generic role based userid in OD)

– User token

• Ability to pass thru ODWEK a security token (unlimited size) which can be passed to

OD security exit in which to validate user

– User login inactivity (ie. If no login within 90 days then user becomes disabled)

– Validate against 0-10 previously used passwords

– Notify user within n days of password expiring

– Disable a user after n failed login attempts

– Lock out user after n failed login attempts for x minutes



October 24, 2012


OnDemand SQL Macros

– $ODUSERID

– $ODALIAS

– $ODAGNAME

– $ODAGID

Example: WHERE ag_field in (SELECT value FROM <customer_table> where userid = '$ODUSERID')

if I logon to OnDemand as USER1, the SQL becomes:

WHERE ag_field in (SELECT value FROM <customer_table> where userid = 'USER1')





October 24, 2012

Server Enhancements

Usage

– arssockd -?

Start

– arssockd -I OD_INSTANCE -S

Stop

– arssockd -I OD_INSTANCE -T

Process info

– arssockd -I OD_INSTANCE -p

Ping

– arssockd -I OD_INSTANCE -P

Display config

– arssockd -I OD_INSTANCE -q



October 24, 2012

Server Enhancements

arssockd -I ARCHIVE -p

PID TID START TIME CPU MEM STYPE USERID INFO

16973958 - 07/26/12 06:28:22 0:59.930369 54740 Program - ARCHIVE

16973958 1 07/26/12 06:28:22 0:3.435463 - Main - Accepting

16973958 515 07/26/12 06:28:23 0:2.287192 - Activity - 4

16973958 1286 07/26/12 06:28:24 0:11.829909 - DB - Idle

16973958 1543 07/26/12 06:28:24 0:11.438182 - DB - Idle

16973958 1800 07/26/12 06:28:24 0:11.953004 - DB - Idle

16973958 2057 07/26/12 06:28:24 0:12.261124 - DB - Idle

arssockd -I ARCHIVE -P

od9lib.boulder.ibm.com Okay 0.010

od9obj1.boulder.ibm.com Okay 0.014

od9obj2.boulder.ibm.com Okay 0.012



October 24, 2012

Server Enhancements

All commands now issue messages with prefix – ARS<num><sev>

• where <num> is 4 digit message number • where <sev> is E (error), W (warning), I (informational)

No longer have 'license' server – Bad terminology, really just a way to show usage – Now uses Activity

• 201 Message (still every 30 minutes) -> Activities: Current(12) • 185 Message no longer used (ie. Max Exceeded) • 202 Message no longer used (ie. Max Occurred)

186 Message – OnDemand started - Version <9.0.0.0> Operating System <AIX> <6.1> Database <DB2>

<09.07.0000> Install Location </opt/IBM/ondemand/V9.0/>

66 Message – Application Group Document Get: … ObjName(1FAAA) Off(0) Len(5864) CompOff(0)

CompLen(2093) Size(5864) Seg(1) Total Segs(1) Flds()

67 Message – Application Group Resource Get: … Rid(2) Size(4795682)

87 Message – Application Group Load: … InputFileSize(1000234)



October 24, 2012

Server Enhancements

arsafpd command

– Dump AFP structure fields (incl/TLE’s)

– Data sniffer

ARS7100I Usage: arsafpd [-d [-t] [-w] | -s] -i <file>

Version: 9.0.0.0

-d Display of AFP structured fields

-i <in_file> Input filename

-s Document sniffer

-t Process structure field triplets (only for -d)

-w Disable warning messages (only for -d)

Examples:

arsafpd -s -i source.afp

ARS7104I Document type: AFP

ARS7106W Warning: No group TLE structured fields were encountered



October 24, 2012

Server Enhancements

Examples

arsafpd -s -i source.pdf

ARS7104I Document type: PDF

arsafpd -s -i loan.lin

ARS7104I Document type: LINE

ARS7114I Records appear to be delimited by hex character(s): 0x0A

ARS7115I Codepage appears to be: ASCII

ARS7110I Carriage control type appears to be: ANSI (ASCII)

arsafpd -s -i apkivp.inp

ARS7104I Document type: LINE

ARS7113I Records appear to be fixed length: 80

ARS7115I Codepage appears to be: EBCDIC

ARS7110I Carriage control type appears to be: ANSI (EBCDIC)



October 24, 2012

Server Enhancements

arsdoc command

– Inherit index values

– Brackets in parameter file (allow for different delimiter than ‘[‘ and ‘]’)

arsdb command

– DB2 backups will default using compression



October 24, 2012

Server Enhancements

ACIF – Support for 128 fields and indexes – Support for 16 triggers – Fields based on group triggers can be combined in an index – Message prefix changed to match align with ACIF on z/OS

• APK440I ACIF AT IM43P11 HAS COMPLETED NORMALLY WITH RETURN CODE 0

OS390 Indexer – Now supported on AIX – Sample exits provided in both COBOL and C – 128 Indexes (prior release was 32) – 128 Fields (prior release was 32) – 144 Triggers (prior release was 48) – 32 “New document decision makers” (prior release was 8)

• Triggers with TYPE=GROUP • Indexes with BREAK=YES

– Exits – additional parameters added for indexes 33-128 • Index Exit • Anystore Exit

PDF Indexer – Support for 128 fields and indexes – Metadata Date Formatting – Support for floating triggers



October 24, 2012

z/OS Server Enhancements

F ARSSOCKD,D,STATUS

– Displays information similar to arssockd –p

ARS0396I 15.19.06 DISPLAY STATUS 476

INSTANCE=ARC90037 PID=67109422 MEM=06E05000

THREAD_ID TYPE USERID START CPU

20989D0000000000 M 07/11/12 07:17:43 0:51.330861

Info=Accepting

209B340000000005 A 07/11/12 07:17:43 0:08.882602

Info=3



October 24, 2012


F ARSSOCKD,D,CONFIG

– Displays the resolved configuration from the ars.ini and ars.cfg

ARS0391I 15.30.56 DISPLAY CONFIG 979

<@SRV@_ARC90037>

PROTOCOL=2

PORT=1937

DIRECTORY=/ars

SRVR_INSTANCE=ARSDB937

SRVR_INSTANCE_OWNER=ARSUS937

SRVR_OD_CFG=/usr/lpp/ars/V9R0M0/config/ars937.cfg

SRVR_SM_CFG=/usr/lpp/ars/V9R0M0/config/ars937.cache

SRVR_FLAGS_SECURITY_EXIT=0

SRVR_FLAGS_FOLDER_APPLGRP_EXIT=0

SRVR_FLAGS_DOCUMENT_EXIT=0

SRVR_FLAGS_SQL_QUERY_EXIT=0

SRVR_FLAGS_FORCE_SECURITY=0

HOST=SVLSPIZ8

<CFG>

ARS_ORIGINAL_CODEPAGE=0037

ARS_NUM_LICENSE=1

ARS_LANGUAGE=ENU

ARS_NUM_DBSRVR=4

ARS_TMP=/ars/ars937/tmp

ARS_PRINT_PATH=/ars/ars937/tmp

DB_ENGINE=DB2



October 24, 2012


F ARSSOCKD,D,ENVAR

– From ars.cfg, LE ENVAR on PARM= or CEEOPTS, or set by program

ARS0392I 16.07.38 DISPLAY ENVAR 473

ARS_INSTALL_SERVER_V90_DIR=/usr/lpp/ars/V9R0M0/

ARS_CODEPAGE=0037

ARS_ORIGINAL_CODEPAGE=0037

ARS_NUM_LICENSE=1

ARS_LANGUAGE=ENU

ARS_NUM_DBSRVR=4

ARS_TMP=/ars/ars937/tmp

ARS_PRINT_PATH=/ars/ars937/tmp

DB_ENGINE=DB2

ARS_DB_TABLESPACE=ARSTSPAC

ARS_NUM_OAMSRVR=8

ARS_OAM_DB2SSID=DB1M

ARS_OAM_PLAN=CBRIDBS

ARS_NUM_OAMSRVR_SLOW_RETRIEVE=1

ARS_OAM_SLOW_RETRIEVE_THRESHOLD=1600



October 24, 2012


128 Field Support – Length of the INDEXER, PREPROCESSOR, FIXED_VIEW columns of ARSAPP limited

to 10,000 bytes on z. MP has a limit of 32,000 – Changed to CLOB(32700)

Password phrase support (password > 8) – Implemented in ARSUSECZ – If the password is >8, PHRASE= is used instead of PASSWORD= on RACROUTE – Must use the 9.0 ARSUSECZ – Password phrases are always mixed case

• Use admin client to set mixed case passwords

Shutdown/startup enhancements – If a DB -STOP DB2 is issued, ARSSOCKD will immediately terminate. – If DB2 is not available when ARSSOCKD is started, it will wait for DB2 to start (-START

DB2) or an operator response • If DB2 is started, WTOR will automatically be deleted • ARSSOCKD can be told to terminate, or try and continue initializing without DB2

being available. The later is the pre 9.0 behavior.

z/OS Installation Wizard Enhancements



October 24, 2012

Win32 Client Enhancements

Export Field Data to a Comma Separated File

– Allows end user to export the field details for the selected document list items in a

comma delimited format.

– CSV file will launch in a separate program window according to windows file association

settings for the *.CSV extension. (Association is set to use MS Excel in the following

screen shots.)



October 24, 2012




October 24, 2012




October 24, 2012


Export Document Data to a Comma Separated File

– Allows end user to export the selected documents to a Comma Separated File.

– Works particularly well with LineData with Logical Views defined.

– Data without a Logical View defined will be exported without any additional comma

separators added to the output.

– CSV file will launch in a separate program window according to windows file association

settings for the *.CSV extension. (Association is set to use MS Excel in the following

screen shots.)

– Multiple documents will be concatenated together into a single CSV file.

– Individual Documents can be exported from the Document View as well.



October 24, 2012




October 24, 2012




October 24, 2012




October 24, 2012


Update Document Metadata

– Enhanced interface allows the end user to update the document metadata from either

the document list or the document view



October 24, 2012




October 24, 2012


Set SQL Wildcard Escape Character

User security notifications

– Added user logon and password expiration details to the client.

– Details of last login and num unsuccessful logins display in the status bar just after a

logon call.

If configured, a warning dialog will notify the user when their password is about to

expire. (See System Parameters -> Login Information in the OD Admin for configuration)

Updated Document Properties Dialog.

– Available from the document list as well as the document view

Print List

– Send entire document list to a printer.

Copy Document Data to File from the document list.

– Allows end user to save off the document file without having to open the document for

viewing.



October 24, 2012

Administrative Client – System Parameters

New status message - last login and number of unsuccessful logins



October 24, 2012


New General parameters – Allow Text Annotations, Allow Graphic Annotations, and Life Of

Annotations



October 24, 2012


New Login Information parameters – User Login Inactivity, Check Previously Used

Passwords, Password Expiration Notification, Disable Or Lock Out After Failed Logins



October 24, 2012

Administrative Client – Folders

Add fields to existing folders

Maximum number of fields increased from 32 to 128

Minimum and Maximum values added to DecFloat(16) and DecFloat(34) fields

Multiple selection enabled for lists – General, Permissions, and Field Mapping tabs

New and changed field types

– Original Date, Date/Time, and Date/Time (TZ) data types include (old style) in name

– New data types are called Date, Date/Time, and Date/Time (TZ)



October 24, 2012

Administrative Client – Application Groups

New and changed field types – Original Date, Date/Time, and Date/Time (TZ) data types include (old style) in name – New data types are called Date, Date/Time, and Date/Time (TZ)

Option to add and map new date/time fields to existing old style date/time fields

New Tablespace type called Automatic Storage

New Compress Table/Tablespace option

New Full Text Index options – New Full Text Index attribute for Small Int (2) type fields – New Full Text Index document authority

New Document Activity Tracking options – Load, Query, Retrieval – Last Load, Last Query and Last Retrieve columns added to application groups list

Use of digital grouping symbol (i.e. comma) in Maximum Rows value

Multiple selection enabled for lists – Permissions and Field Information tabs

New Advanced Mapping Information dialog to define Displayed Values in other languages

New keyboard option to add an SQL query restriction

New option to add an SQL query restriction using a GUI interface



October 24, 2012

ODWEK Enhancements

New methods added to the Java APIs

– ODConfig

• IN_OPERATOR_DELIMITER - Set a character to be used in IN operator queries. The

space character is the default.

• MAX_TRACELOG_SIZE - Used to set the maximum size in MB a trace log (arswww.trace)

can grow to before it is renamed (arswww.trace.YYYYMMDD.HHMMSS) and a new trace

log is created.

• ODWEK_INSTALL_DIR - The ODWEK install directory for non-default install locations.

• RES_CACHE_MAX - Defines the maximum space available for the use of a resource file

cache.

• RESOURCE_CACHE_DIR - This parameter will override the default ODWEK behavior or

caching AFP Resources in memory.

• SQL_WILDCARD_ESCAPE - Set a character to be used as a wild card escape character

during SQL generation.

– ODServer

• getMessageOfTheDay

• getVersion

• get/setMsgsLanguage

• setPassThruToken



October 24, 2012

ODWEK Enhancements

ODUser

– getLastLogonDate

– getLastPasswordChangeDate

– getNumDaysUntilPWExp - This method will return -1 if the Password Expiration

Notification setting is set to Never Notify in the System Parameters

– getNumFailedLogins

ODFolder

– clearAllFields

– restoreCriteriaToDefaults - Restore the ODCriteria values and operators to their defaults

– FTIAddHits - Add documents to the Full Text Index

– FTIReleaseHits - Release documents to the Full Text Index

– StoreDocument – Accepts a byte array as an argument for the storage object

ODCriteria

– getDescription



October 24, 2012

ODWEK Enhancements

ODWEK Java API AFP Resource Caching

– Enhancement to allow developers to more quickly implement a basic file based caching

component with the ODWEK Java APIs

– Completely replaces the current memory based caching implementation

– Can be used to alleviate issues some customers have reported with heavy AFP resource

usage causing massive quantities of native memory to be tied up by the current AFP

resource cache in native memory

– Implementation requires developer to specify the location and size (in megabytes) to be

used for the cache

• Properties Object passed to ODConfig requires 2 parameters

(RESOURCE_CACHE_DIR, RES_CACHE_MAX)

– Cleanup will occur when resource files exceed 80% of RES_CACHE_MAX, and files will

be deleted, based on last used timestamp, until the total filesystem usage is down to

60% of RES_CACHE_MAX

– Only files created by ODWEK are monitored and/or cleaned up.

Best practices for AFP Resource Caching in ODWEK

– http://www.ibm.com/support/docview.wss?uid=swg27023580




October 24, 2012

ODWEK Line Data Viewer Applet

The JLDV will now check version at runtime to make sure it matches the ODWEK mid-tier

version. Mismatched versions will prevent the applet from displaying a document.

Zoom

“Find Previous” functionality has been added to allow reverse searching through the

document

Enhanced sticky notes

– A sticky note is a textual note that is represented on the document by an icon and/or

user ID string.

• Place a note at a specific location within the document

• Delete notes

• Copy the note text to the system clipboard

Graphical Annotations



October 24, 2012

ODWEK Line Data Viewer Applet

Maintain positional integrity between clients – Windows and Java have very different ideas about screen resolution, DPI, and

rendering. These differences required that our internal annotation structure be ‘versioned.’

• Version 1 annotations are those created by a pre-V9 Windows client • Version 2 annotations are those created by V9 Windows client and/or JLDV • V9 JLDV will not display V1 graphical annotations • pre-V9 Windows client cannot display V2 annotations

– Sticky Notes have similar Version 1 and Version 2 considerations • The V9 JLDV will display V1 notes without location (i.e. upper left corner of the

document page). • Moving V1 sticky notes via the JLDV will cause them to be updated to V2

Caveats for sticky notes and graphical annotations – Only supported through web clients using the ODWEK Java APIs – Existing web clients must change their ODServer.viewerPassthru() call to pass the

java.io.InputStream returned from the HttpServletRequest • InputStream inStream = servletRequest.getInputStream(); • byte [] data = odServer.viewerPassthru(queryString, inStream);



October 24, 2012

IBM Content Navigator Overview

IBM Content Navigator (ICN) is a new ECM client and client framework/toolkit

– Provides an out of box common client for CM8, P8 and CMOD

– Supports accessing content from mobile devices

– Extensible and pluggable framework

• Supports adding new actions, panels, viewers, etc.

Built on open standards

– JavaScript, HTML, CSS, Java, etc.

Although ICN does not provide 100% feature parity with all existing clients, it should be

viewed as the next version of WEBi, eClient and Workplace XT



October 24, 2012


Carryover existing CMOD feature set from WEBi

Add new features:

– Append to search results

– Apply & remove holds

– Document download

– Local print from hitlist

– System properties

– Generic transform interface

– SSL

– Tabbed search layout

– Max ODWEK trace file size

Minimum Prerequisites

– OnDemand Server: V8.5.0.0 or later on MP and zOS, V8.5.0.5 or later on IBM i

– ODWEK V8.5.0.5 or later

– 64-bit WebSphere Application Server v7.0.0.21 or later and V8.0.0.2 or later

– AFP2PDF Transform for AFP in order to view and/or print

– Firefox 10 ESR or later, Internet Explorer 8 or later



October 24, 2012




October 24, 2012


Download IBM Content Navigator Version 2.0


IBM Content Navigator Version 2.0 publication library






October 24, 2012

CMIS

Protocol bindings: REST and Web Services

– Read-only services required by CMIS 1.0 spec:

• Get list of CMIS repositories (OD folders)

• Query (search an OD folder)

• Get document metadata

• Download document (content)

Pre-reqs: WebSphere V7, ODWEK V9, CMOD V9

Available on DB2 Content manager Tools and Offerings

https://www14.software.ibm.com/webapp/iwm/web/reg/download.do?source=db2cmto&S_PKG=cics&lang=en_US&cp=UTF-8




Other Information Sources

Information Center http://publib.boulder.ibm.com/infocenter/cmod/v8r5m0/index.jsp

Publication library (All PDF versions of the documentation) – http://www.ibm.com/support/docview.wss?rs=152&uid=swg27017159

– Or search for “7017159” on www.ibm.com

Product system requirements – http://www.ibm.com/support/docview.wss?rs=152&uid=swg27016455


Compatibility matrix for the Content Manger Ondemand client and servers – http://www.ibm.com/support/docview.wss?rs=152&uid=swg21392275


Information Roadmap


Product overview http://www.ibm.com/software/data/ondemand

OnDemand User Group http://www.odusergroup.org

http://publib.boulder.ibm.com/infocenter/cmod/v8r5m0/index.jsp


http://www.ibm.com/


http://www.ibm.com/


http://www.ibm.com/


http://www.ibm.com/software/data/ondemand

http://www.odusergroup.org/



Questions & Closing Remarks

IBM Software Solutions | Enterprise Content Management Software