George James Software logo

KB0135

How can I Manage Percent Routines on a Remote Caché System?

Applies to: VC/m 3.1 onwards

From version 3.1, VC/m is able to manage %-routines directly on a remote Caché system connected via DCP or ECP networking. Prior to 3.1 a remote task server process was needed in order to achieve this. (This functionality is also available as patch reference L3825 for VC/m 3.0.3.)

This requires only that the local system has a namespace with suitable mappings and that the remote system is running as a DCP or ECP server.

Set-up Procedure

For two Caché systems, named LOCAL and REMOTE, with a full copy of VC/m installed on the LOCAL system:

  1. Ensure that the REMOTE system is enabled as a DCP or ECP server.
  2. On the LOCAL system, create a new namespace called REMOTE-SYS.
  3. Map the new namespace to a database called REMOTE-SYS. This should be defined as a remote database which references the CACHESYS database on the REMOTE system.
  4. For the REMOTE-SYS namespace, add an explicit mapping for the routines you need to manage (eg %Z* routines) to the REMOTE-SYS database.
  5. For the REMOTE-SYS namespace, add the normal VC/m routine and global mappings of %vc* to the VC/m database.

    The cpf file should look something like this:

    [Datasets] DataSet_1=CACHESYS,,,0,P,0,0 DataSet_2=VCM,d:\vcm\,,0,P,0,0 DataSet_3=REMOTE-SYS,c:\cachesys\mgr\,REMOTE,0,P,0,0 [Namespaces] Nsp_1=%SYS,CACHESYS,CACHESYS,CACHESYS,CACHESYS,CACHELIB,CACHETEMP Nsp_2=VCM,VCM,CACHESYS,VCM,CACHESYS,CACHELIB,CACHETEMP Nsp_3=REMOTE-SYS,REMOTE-SYS,CACHESYS,REMOTE-SYS,CACHESYS,CACHELIB,CACHETEMP [NspMap.VCM] GloMap_1=%vc*,VCM,VCM,0,-1, RouMap_1=%vc*,ALL,VCM [NspMap.REMOTE-SYS] GloMap_1=%vc*,VCM,VCM,0,-1, RouMap_1=%Z*,ALL,REMOTE-SYS RouMap_2=%vc*,ALL,VCM

  6. Create a VC/m location which maps to the REMOTE-SYS namespace and use it as you would a normal location.

Last reviewed: Feb 10, 2005

Back to top