Creating an integration server-specific environment file
An integration server-specific environment file can be used instead of the default integration node environment file when you restart the integration server.
Before you begin
About this task
This task forms an optional step of the larger task of creating an integration node on z/OS.
By default, an integration node has a single environment file
(ENVFILE), which is created from
BIPBPROF by submitting
BIPGEN. The main integration node
address space and any integration server address spaces use this environment
You might find it necessary to have an integration server-specific environment file. In this situation, when the integration server is restarted, the integration server address space uses the specific environment file and not the default integration node environment file.
BIPBPROFmember.If you define parameters that are required by the integration node and all integration server address spaces, you can configure
BIPBPROFto use these parameters.
BIPEPROFand rename the copy of the file to be the same as the integration server label in the component data set, by using the following rule.
The name must equal the last eight characters of the integration server label. Any characters that are not valid for a STEPNAME are replaced with the
Furthermore, if the first character of a STEPNAME is not an alphabetic character, that character is replaced with an
A. (For more information about characters that you can use, see Administration in z/OS.)
For example, an integration server address space with the label
MyExecutionGroup, has an integration server-specific profile called
Customize the renamed
BIPEPROFfile to include any environment variable settings that are specific to the integration server.
BIPGENby adding a step at the end for the new integration server-specific profile; for example:
//BIPEG01 EXEC PROC=BIPEGEN,EG=IONGROUP
BIPGENto re-create the default integration node environment file, and to create the new integration server-specific environment file.Review the job output and make sure that the environment file in the output contains the parameters that you expect.
If you change
BIPBPROF, or the renamed
BIPEPROFfile, or system-wide parameters, you must submit
BIPGENagain to pick up the changes.
What to do next
- Create an integration server-specific profile for each file, following the naming rules that are specified in step 2.
- Add extra steps to the end of
BIPGEN, giving each step a different name, and specifying the correct eight-character integration server label.
BIPGENto create all the environment files.