You can create an execution group
specific environment file, which is used instead of the default broker
environment file when you restart the execution group.
This task forms an optional step
of the larger task of creating a broker on z/OS.
By default a broker has
a single environment file (ENVFILE), which is created from BIPBPROF by
submitting BIPGEN. The main broker address space
and any execution group address spaces use this environment file.
You
might find it necessary to have an execution group specific environment
file and you can achieve this by carrying out the following procedure.
In this situation, on restart, the execution group address space uses
the specific environment file and not the default broker environment
file.
- Review the BIPBPROF member. If
you define parameters required by the broker and all execution group
address spaces, you can configure BIPBPROF to use
these parameters.
- Take a copy of BIPEPROF and
rename the copy of the file to be the same as the execution group
label in the component dataset, using the following rule.
The
name should equal the last eight characters of the execution group
label. Note that any characters that are not valid for a STEPNAME
are replaced with the @ character.
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 execution group
address space with the label MyExecutionGroup, has
an execution group specific profile called IONGROUP.
- Customize the renamed BIPEPROF file to
include any environment variable settings specific to the execution
group.
- Edit BIPGEN, adding an additional step
at the end for the new execution group specific profile, for example:
//BIPEG01 EXEC PROC=BIPEGEN,EG=IONGROUP
- Submit member BIPGEN to
re-create the default broker environment file, and to create the new
execution group 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 BIPEPROF file, or system-wide parameters,
you must submit BIPGEN again to pick up the changes.
Multiple Execution Group specific environment files
If
you have a requirement for multiple execution group specific files,
carry out the following tasks:
- Create an execution group specific profile for each, following
the naming rules specified in Step 2 above.
- Add additional steps to the end of BIPGEN giving
each step a different name, and specifying the correct eight character
execution group label.
- Resubmit BIPGEN to create all the environment
files.