Allocating a bridge facility name for a pseudoconversation when using the Link3270 bridge for transaction routing

In this example the application is controlled by a bridge client on the host.

About this task

This is described in Select Link3270 client scenarios.

Before running your client program:
  1. Set the AIBRIDGE system initialization parameter to "yes" in the router region. This causes CICS® to call the autoinstall user-replaceable program when a terminal ID has been allocated.
  2. Ensure that your autoinstall user-replaceable program contains code to change the last character of the terminal ID in SELECTED-BRFAC-TERMID if it is set to "}". This character must be changed to a character that is unique to the system and can be an alphanumeric character or one of the following special characters: ¢@#./_$?!:|"=¬,;<>

    If you are using NETNAME change it by copying SELECTED-BRFAC-TERMID to SELECTED-BRFAC-NETNAME.

Your client program should contain the following steps:

Procedure

  1. Call the Link3270 bridge with an allocate-facility request. This bridge facility is referred to as the primary bridge facility in this example.
  2. Set BRIH-FACILITYKEEPTIME to the time the application will take to run. If in doubt set it to the maximum value allowed. The maximum value is given in the description of BRMAXKEEPTIME in Defining Link3270 system initialization parameters.
    CICS calls the autoinstall user-replaceable program when the terminal ID for the bridge facility has been allocated.
  3. When the transaction completes you may want to route to a different AOR:
    1. Keep the terminal ID and NETNAME which are returned from the Link3270 call in BRIH-TERMINAL and BRIH-NETNAME and do not delete the primary bridge facility.
    2. Allocate a new bridge facility using a Link3270 allocate-facility request. Before issuing this request, set BRIH-TERMINAL to the value of the primary bridge facility. Set BRIH-NETNAME also if you need NETNAME to be the same throughout. The facility allocated by this request is referred to as the secondary bridge facility in this example.
    3. When the autoinstall user-replaceable program is called for the new facility, SELECTED-BRFAC-TERMID is set to the value in BRIH-TERMINAL. Note that this name does not have "}" as the last character and the program will accept it.
    4. When changing to a third AOR, call Link3270 with a delete-facility request for the secondary bridge facility.
    5. Repeat steps 3a to 3d each time the target AOR changes.
  4. When all transaction routing has finished, call Link3270 with a delete-facility request for the primary bridge facility.