db2ccprf - Copy client profile command

You can use this command to copy client configuration files into another directory.

Authorization

None

Required connection

None

Command syntax

Read syntax diagramSkip visual syntax diagramdb2ccprf ?-h-? -tTargetProfilePath ?-sSourceProfilePath ?-f

Command parameters

-h | -?
Display help for the db2ccprf command.
-t TargetProfilePath
Specifies the target location that the client configuration files are copied to. If you want a local client to use the configuration files that are copied by using this command, you must set DB2_APPL_CFG_PATH to this directory.
-s SourceProfilePath
Specify the source location where the client configuration files are copied from. If a location is not specified, client configuration files are copied from the path that is specified in the DB2_NET_CLIENT_PATH environment variable.
-f
Specify this parameter to overwrite existing files in the path that the client configuration files are being copied to.

Usage notes

  • In a network-mounted client environment, you can specify a user-specific client configuration as follows:
    1. Copy the client configuration files from the global location to a local directory by issuing the db2ccprf command. For example, to copy the client configuration to a local directory $HOME/db2, issue the following command.
      db2ccprf -t $HOME/db2
    2. Set the DB2_APPL_CFG_PATH environment variable to this local directory. For example, to set the client configuration path to this local directory $HOME/db2, issue the following command.
      export DB2_APPL_CFG_PATH=$HOME/db2
      If you set the environment variable to a non-default path, any changes that you make to the local client configurations apply only to the local client workstations. Changes to the global client configuration on the network do not impact the local client configurations.
      Tip: For C shell environment, use the setenv command instead of the export command to set the environment variables. For other command shell environments see topic "Setting environment variables outside the profile registries on Linux and UNIX operating systems"
  • If the directory that the client configuration files are being copied to is not empty and the -f option is not specified, an error is returned.