WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Creating an execution group specific environment file

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.

Before you start

Before starting this task, you must have completed Customizing the broker JCL

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.

  1. 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.
  2. 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.

  3. Customize the renamed BIPEPROF file to include any environment variable settings specific to the execution group.
  4. Edit BIPGEN, adding an additional step at the end for the new execution group specific profile, for example:
    //BIPEG01 EXEC PROC=BIPEGEN,EG=IONGROUP
  5. 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:
  1. Create an execution group specific profile for each, following the naming rules specified in Step 2 above.
  2. Add additional steps to the end of BIPGEN giving each step a different name, and specifying the correct eight character execution group label.
  3. Resubmit BIPGEN to create all the environment files.
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:06


Task topicTask topic | Version 8.0.0.7 | be13810_