WebSphere Message Brokers
File: ae22460_
Writer: Bill Oppenheimer

Task topic

This build: July 31, 2007 21:28:23

Customizing the broker JCL

This is part of the larger task of creating a broker on z/OS.

Before you start

Before starting this task, you must have completed Customizing the broker component data set.

All JCL has a standard header, comprising:
  • A brief description of its function.
  • A description where further information can be found, relating to the function of the JCL.
  • If appropriate, a topic number.
  • The section listing the JCL variables themselves.
Each JCL file defines its own STEPLIB. Some JCL files, for example BIPRELG, might require DB2 defined in the STEPLIB for a broker component. This must be removed from the JCL if the component is either a Configuration Manager or User Name Server, because it is not required.

You can customize the files using an ISPF edit macro that you have to tailor, or you can make changes to each of the PDSE members manually.

BIPEDIT is a REXX program that you can use to help you customize your JCL. After you have customized BIPEDIT you can run this REXX program against the other JCL files to change their JCL variables.

When you update BIPBPROF (the broker profile), the changes are not accessible until you run BIPGEN to copy the profile to the file system and create the ENVFILE. You must do this each time you update BIPBPROF for the changes to take effect.

  1. Customize the renamed BIPEDIT file. Use the information you collected in:
  2. Activate the renamed BIPEDIT file before you customize any other JCL files. Do this by running the following TSO command:
        ALTLIB ACTIVATE APPLICATION(EXEC) DA('COMPONENTDATASET')
    where 'COMPONENTDATASET' is identical to ++COMPONENTDATASET++.

    This command is active for the local ISPF session for which it was issued. Note that if you have split screen sessions, the other sessions are not able to use this. If you use ISPF option 6 to issue the command, use ISPF option 3.4 to edit the data set; this enables you to use the edit command.

  3. Edit each JCL file. Run the renamed BIPEDIT exec by typing its name on the command line (for example MQ01EDBK). Instead of editing a member, you might want to View it until you have resolved any problems in your REXX program. Alternatively, you can Cancel the Edit session instead of saving it.

    You must set a value for all the variables listed in the JCL; if you do not do so, the JCL will not work correctly.

Some JCL files include ++OPTIONS++ for a command; you must replace them with additional optional parameters specific to the command on z/OS, or remove them. It is likely that you will have to do this in addition to running BIPEDIT. If you do not require any additional options, remove ++OPTIONS++ using the following command:
     "c ++OPTIONS++ '' all" 
where ' ' represents two single quotation marks.

Save the edit macro and run this macro against all of the members except the edit macro itself.

If the user ID submitting the BIPCBRK command has the appropriate DB2 and WebSphere MQ authorities, you can ignore the optional mqsicreatebroker parameters -1, -2, and -3.

If you intend to have different administrators create the DB2 and WebSphere MQ resources, you can consider using one of these optional parameters; see mqsicreatebroker command for further information.

You need to be aware that another process might be using the current ENVFILE, so you need to consider whether updating the current ENVFILE in the file system will have any impact.

Related concepts
Brokers
Broker domains
Related tasks
Creating a broker on z/OS
Customizing the broker component data set
Related reference
mqsicreatebroker command
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:28:23

ae22460_ This topic's URL is: