Loading DLL files

The application's compiler generates DLL files from your source code. In the Windows environment, DLL code is controlled by the operating system. Once a DLL has been loaded, it is locked to the loading process, in this case CICS, and no other process can overwrite the DLL file.

When you modify existing code you need to use the procedure described below to replace an existing DLL file with the new file that you compile. To configure and load a replacement DLL file:

1. Create a staging folder to hold your updated DLL files, and compile your DLLs to this folder.
2. On the enterprise server running the CICS application, from the Enterprise Server Administration screen, select the Server > Properties > General tab.
3. In the Configuration Information field, define an environment variable, ES_STAGING_FOLDER that sets the staging directory. For example, to define the staging directory as D:\CICS\Staging, you would use the following entry:

   [ES-Environment]
   ES_STAGING_FOLDER=D:\CICS\Staging

   See the figure below for an example.

4. Click Apply to set the envfironment variable.
5. Use the CICS CPMT transaction to set that a new version is available.

   The transaction replaces any existing DLLs that your application uses with the DLLs in the staging directory. For example, to load a new version of MYPROG.DLL, you would use the following CPMT CICS transaction:

   CPMT NE MYPROG

Figure 1. Configuring DLL updates