Allocating a bridge facility

To allocate a bridge facility, your client program must set the value of the BRIH_TRANSACTIONID field of the bridge message header (BRIH) to BRIHT-ALLOCATE-FACILITY.

See Link3270 message header (BRIH) for a description of the BRIH. The following parameters may also be optionally defined:

BRIH-FACILITYKEEPTIME
BRIH-FACILITYLIKE
BRIH-TERMINAL
BRIH-NETNAME

Other fields in the message are ignored.

For example, to allocate a bridge facility using the supplied default BRIH and constants:

Working-Storage Section
...
copy dfhbrico.
...
Linkage Section
01 msg-area
copy DFHBRIHO.
...
Procedure Division.
...
move brih-default to msg-area.
set briht-allocate-facility to true.
EXEC CICS LINK PROGRAM('DFHL3270') COMMAREA(msg-area)
LENGTH(length of brih) DATALENGTH(len)
END-EXEC
...

Note: The BRIH-FACILITYLIKE value supplied by your client program is not validated until the first application transaction is run. It is only when the first application transaction is processed that the AOR region is determined and the facilitylike value can be validated within the selected AOR.