About DFC Environment

I did some DFC environment surveys today. Below I think it may be useful.Article.

 

Deploying a standalone DFC app in Windows 2000 (only using DFC components) I did the following...

Javareg/register/control/class: com.documentum.com. dfclientx/codebase: "C: \ Program Files \ Documentum \ shared \ DFC. jar "/typelib: DFC. TLB/nomktyplib CLSID: {EFAC2dD80-175B-112D-006097C27C31}/progid: Documentum. DFC

I copied dmcl40.dll (version 4.2.1.18) and DFC. TLB (dated 12/3/2001) into the c: \ winnt \ system32 directory and the DFC. jar (dated 4/26/2001) into the c: \ Program Files \ Documentum \ shared directory.

When I run my VB 6 app. I get an error on the line

Set dcx = Createobject ("Documentum. DFC ")

Classfactory cannot supply requested class.

For anyone with a similar problem, here was the solution that worked for me.

I added a user environment variable called classpath and pointed it at the DFC. jar file. Worked great!
Classpath: D: \ DFC \ dll \ dctm. jar; D: \ DFC \ dll \ DFC. jar; C: \ Documentum \ config

 

Http://www.bluefishgroup.com/library/2002/configuring-the-dfc-standalone/

Introduction

A common problem and/or question I see is "How do I use/install the DFC standalone ?", Albeit in different forms. if you install the Documentum Intranet client or other Documentum applications that utilize the DFC, the DFC and required supporting libraries or DLL's will be properly installed. if however, you want to access Documentum using the DFC on a machine that has no other Documentum applications, you will need to correctly configure your environment.

This article describes how to properly configure your environment to use the DFC standalone, addresses some errors you may encounter and discusses possible causes of those errors. additionally, I have written a Java application that can be used to validate your environment. you can download it at: check42dfenvironment Application

You can also download the DFC environment for Windows/NT and DFC environment for Solaris which include dctm DLL's, Solaris library, and DFC. Jar required to use the 4.2 version of the DFC.

• You need to determine if you have the required DLL installed and that it is the correct version for the version of the DFC. jar you are using. you can use the supplied Java application to determine whether or not you have the appropriate DLL installed and if it is the correct version. download the application, install, and run it. for installation instructions, see installing check42dfenvironment
• Run the application. If the application fails, download the ZIP file DFC environment for Windows/NT
• UnzipDfcenv.zipTo some folder.
• Move the file, dmcl40.dll, to the C: \ winnt \ system32 folder or create a folder (e.g. c: \ dctm \ libs), move dmcl40.dll into it and add the folder to the path system variable.
• Rerun the Java application. It shoshould now complete successfully.
• If it does not succeed, make note of the location of the dmcl40.dll that is being used. it is reported in the standard of the check42dfenvironment application as "library path: C: \ Documentum \.... \... \ Dmcl40.dll"
• If this isn't the location to where you copied the dmcl40.dll from the ZIP file, you have another dmcl40.dll on your machine that doesn't support the 4.2 version of the DFC. you can problably remove it or replace it with the dmcl40.dll from the ZIP file, or modify search order of the path system variable.

Solaris installation

1. if you haven't already, download the check42dfenvironment application and the DFC environment for Solaris. For installation instructions, see installing check42dfenvironment
2. unjar dfcenv. jar to some directory (e.g. /home/username/dfcenv) and install check42dfenvironment to some other directory (e.g. /home/username/dctmapp ).
3. set the LD_LIBRARY_PATH to include the directory where you unjarred dfcenv. jar . how you do this depends on the shell you are using. assuming you unjarred dfcenv. jar to/home/username/dfcenv,
   • if you are using ksh, export LD_LIBRARY_PATH =/home/username/dfcenv
   • if you are using CSH, setenv LD_LIBRARY_PATH/home/username/dfcenv
4. 'cd' to the location where you installed the check42dfenvironment application and run it
5. the application shocould report it completed sucessfully

Common Errors and possible causes

 
 Java. Lang. noclassdeffound: COM/Documentum/FC/common /.... 
 

Indicates that you probably haven' t encoded the DFC. jar in your Java classpath or the DFC. jar file itself does not exist in any directories/folders that are part of your classpath

 
 [Dm_dfc_e_init_dmcl] error: "error occurred while trying to initialize the dmcl: Java. Lang. unsatisfiedlinkerror: Initialize."; errorcode: 205; next: NULL 
 

This error message can indicate a number of problems with the set up of your environment. These include:

In Solaris,

• You have not set the LD_LIBRARY_PATH environment variable or,
• If it has been set, the libdmcl40.so library is not in any of the directories listed in LD_LIBRARY_PATH
• The libdmcl40.so you are using cannot be used with the version of DFC. jar you are using

In Windows/NT,

• Dmcl40.dll Is Not Installed
• Dmcl40.dll is not installed in a folder that is wrongly ded in the path system variable
• The dmcl40.dll cannot be used with the version of DFC. jar you are accessing

Installing and running the check42dfenvironment Application

Installing and running on Windows/NT

• Unjar the file, test42dfcenvironment. Jar
• Open the file check42dfenvironment. bat, and modify the line "set java_home = c: \ jdk1.2.2" to point to the location where you have the JDK installed
• Open up a DOS Shell
• Run application using check42dfenvironment. bat
• Note the output

Installing and running on Solaris

• unjar the file, test42dfcenvironment. Jar
• open the file check42dfenvironment, and modify the line "Export java_home =/opt/jdk1.2.1 _ 03" to point to the location where you have the JDK installed and save the file
• run application using check42dfenvironment
• note the output