GRIDCOPY_DIR Configuration Parameter

Specifies the default directory used by the ifx_grid_copy procedure.

onconfig.std value
$INFORMIXDIR
default value if not present in the onconfig file
$INFORMIXDIR
values
pathname = $INFORMIXDIR or a valid file path that is relative to $INFORMIXDIR.
takes effect
After you edit your onconfig file and restart the database server.
When you reset the value dynamically in your onconfig file by running the onmode -wf command.
When you reset the value in memory by running the onmode -wm command.
The ifx_grid_copy() procedure copies files from a grid database server to the other nodes of the same grid. The GRIDCOPY_DIR value is the default directory of file paths in the ifx_grid_copy() command:
  • On a database server running the ifx_grid_copy() procedure, the GRIDCOPY_DIR value and the ifx_grid_copy() command source_path_and_filename is the location from which files are copied.
  • On a database server sharing the same grid with a node running the ifx_grid_copy() procedure, the GRIDCOPY_DIR value and the ifx_grid_copy() command's target_path_and_filename is the location to which files are copied. If target_path_and_filename is not specified as part of the ifx_grid_copy() command, the GRIDCOPY_DIR value and the ifx_grid_copy() command's source_path_and_filename is the location to which files are copied.

If a node directory specified by a GRIDCOPY_DIR value does not exist, the node directory is created by the ifx_grid_copy() procedure.

Example

To specify $INFORMIXDIR/usr/informix/copydir as a node's default directory for ifx_grid_copy() procedure actions, set the following value in the onconfig file:

GRIDCOPY_DIR usr/informix/copydir

Copyright© 2019 HCL Technologies Limited