The MFBSIEMX module must be defined as an Event Manager user exit and the variable MFBSI_DIR must be specified in the Configuration Information field under the General tab, similar to following example:
[ES-Environment] ES_EMP_EXIT_1=mfbsiemx BASE=/home/pringo/mfcobol/mfbsi MFBSI_DIR=$BASE/$ES_SERVER
Where:
ES_EMP_EXIT_1=mfbsiemx ES_EMP_EXIT_2=mfmonemx ES_EMP_EXIT_3=...
By default, the MFBSIJCL component that is submitting jobs to the enterprise server requires the MFBSI_DIR environment variable with the same folder setting.
When running inside a Performance and Availability Cluster (PAC):
When not running in a PAC, there are two ways to specify MFBSI_DIR for a specific enterprise server instance:
When STRIPSPACE=OFF is set in your global EXTFH configuration file, an exception is required for MFBSI. You need to add the following to your extfh.cfg file:
[FOLDER:FullPathtoMFBSI_DIR] STRIPSPACE=ON
For example:
[FOLDER:D:\mf\MFBSI\ES\MFBSI] STRIPSPACE=ON
[FOLDER:/mf/MFBSI/ES/MFBSI] STRIPSPACE=ON
See the following examples of how to specify MFBSI_DIR:
MFBSI_DIR supports long and spacey folder names. However, Micro Focus recommends that you avoid using them.
Micro Focus recommends that you use the default settings for MFBSIJCL to specify the enterprise server instance name as part of MFBSI_DIR:
To set MFBSI_DIR to a path that ends with a folder that has the same as the enterprise server instance name and with the default settings for MFBSIJCL:
set MFBSI_DIR=x:\MF\…\MFBSI\ESRegionName
To set MFBSI_DIR to any folder:
set MFBSI_DIR=x:\MF\...\MYDIR mfbsijcl ... REGION=ESRegionName
REGION=ESRegionName
set MFBSI_DIR=x:\MF\...\MYDIR
REGION=ESRegionName
set MFBSI_DIR=x:\MF\...\MYDIR
mfbsijcl ... CFG=x:\MF\...\MFBSICFG\custom.cfg
Or, without specifying the CFG parameter:
mfbsijcl ... export MFBSI_CFG=x:\MF\...\MFBSICFG\custom.cfg
After making these settings in the region configuration, restart the server and check the console log for the message CASAM3006I/CASAM3001I to verify successful initialization of MFBSIEMX. Log entries are similar to:
CASAM3006I Event Filter for (mfbsiemx) has been enabled. Filter string: "1:1,3&3:*&4:1,2" CASAM3001I Event Manager exit enabled (mfbsiemx)
If an issue occurs, check the messages in the Enterprise Server console.log file to see what the issue is. For example:
JCLSI0300E mfbsiemx initialization failed: MFBSI_DIR not defined in [ES-Environment]
JCLSI0301E STRIPSPACE=OFF set in EXTFH. Not allowed for MFBSI .sem files
Server initialization creates a file named ESRegionName.Started in the MFBSI_DIR location. When the server shuts down, a file named ESregion.shutdown replaces this file, where ESRegionName is the name of the region being used.
In order to restart any submitted jobs, you need to add some additional configuration settings in your enterprise server instance. See Job Restart for more information.