iFileshare Environment Variables

The following environment variables are specific to using iFileshare.

Variable Description
ES_HA_VSAM Determines if a region is configured as an iFileshare server. The possible values are:
N (No)
The region is not configured as an iFileshare server. This is the default.
S (Single)
The region is configured as an iFileshare server in single mode (that is, no High Availability options enabled).
Y (Yes)
The region is configured as an iFileshare (High Availability) server. Additional configuration is required when using this setting; see Configuring Servers in an High Availability Group.
T (Yes & ISC Tracing)
The region is configured as an iFileshare (High Availability) server, and also includes ISC tracing. Additional configuration is required when using this setting; see Configuring Servers in an High Availability Group.
ES_USR_DFLT_IFS The default iFileshare user is IFSUSER; this is the user that is set when you start the iFileshare server region without specifying a user. Use this variable to set a different default user name (maximum 8 characters).
FSCHKLFH Determines if a check is performed when a high availability group is started, to test the consistency of the data files within the group.

When set to FSCHKLFH=Y (the default), the data files that are specified in the group (according to the dbase.ref file) are tested to ensure that:

  • The data files on the primary server exist on all other backup servers within the group.
  • No data files exist on a backup server that are not also present on the primary server.
  • The file header information for each data file is consistent on each server within the group.

If any of these tests fail, the offending backup server is removed from the group, and the following message is displayed in the console log:

FS309-S iFS Engine INIT failed, file <filename> in inconsistent state

To disable this check when the group is started, set FSCHKLFH=N for your primary server.

FSLOGCOMP If your iFileshare server uses data compression, set FSLOGCOMP=Y to also compress the data in the transaction log files. Default is N.
FSWRKDIR Specifies the Fileshare working directory. If this variable is not set (which is the default), the working directory defaults to the system directory of the region.
IFS_USER_EXIT The path and file name of the iFileshare user exit procedure (if one is used). If this variable is not set, iFileshare will attempt to locate IFSEXITPROC in the current working directory, and use that.