The following table gives the complete list of bridge facility return codes and their meanings as of CICS TS 5.3.

These codes can be found embedded in various HostBridge error messages.  Click here for a list of these messages and their meanings.   

Note that the internal fields mentioned in the descriptions below are only for HostBridge Technical Support to use to determine the cause of a reported problem.

Return CodeReturn Code DescriptorDescription
0BRIHRC_OKThe request completed successfully.
20BRIHRC_AI_TERMID_INVALIDThe terminal id returned by the terminal autoinstall URM is invalid.
21BRIHRC_AI_NETNAME_INVALIDThe netname supplied by the terminal autoinstall URM is invalid.
22BRIHRC_AI_REJECTEDThe terminal autoinstall URM rejected the bridge install request.
23BRIHRC_LINK_FAILEDThe link to the autoinstall URM failed.
24BRIHRC_CLIENT_NETNAME_INVALIDThe client supplied an invalid netname.
25BRIHRC_CLIENT_TERMID_INVALIDThe client supplied an invalid terminal id.
26BRIHRC_FACILITYLIKE_INVALIDThe client supplied an invalid facilitylike (pseudo-terminal) name.
40BRIHRC_ROUTING_URM_LINK_FAILEDThe link to the dynamic routing URM failed.  The internal field BRIH_COMPCODE contains a value that further pinpoints the error:  3=URM abended, 4=AMODE error, 5=No program definition, 6=Fetch error, 7=Disabled, 8=Program defined as remote.
41BRIHRC_ROUTING_URM_REJECTEDThe dynamic routing URM rejected the bridge routing request.  The internal field BRIH_COMPCODE contains a value that further pinpoints the error:  3=Select rejected, 4=SYSID not found, 5=SYSID not in service, 6=allocate rejected, 7=Queue purged, 8=Function not shipped, 9=Netname not found, 10=SYSID/netname mismatch.  The internal field BRIH_REASON contains the return code from the dynamic routing URM.
42BRIHRC_ROUTING_TRANDEF_ERRORThe transaction resource definition in the routing region does not allow the transaction to be routed to the chosen target region.
43BRIHRC_ROUTING_CONNECTIONThe LINK3270 request could not be routed to the remote region because of a connection error.   The internal field BRIH_COMPCODE contains the EIBRESP value for the failed connection.  The internal field BRIH_REASON contains the EIBRESP2 value for the failed connection.  The internal field BRIH_FUNCTION contains the EIBFN value for the failed connection.
44BRIHRC_ROUTING_TERMERRThe EXEC CICS LINK from the DFHL3270 to the AOR failed with a TERMERR.   The internal field BRIH_COMPCODE contains the EIBRESP value for the failed link.  The internal field BRIH_REASON contains the EIBRESP2 value for the failed link.  The internal field BRIH_FUNCTION contains the EIBFN value for the failed link.
45BRIHRC_ROUTING_BACKLEVEL_CICSThe LINK3270 request was routed to a back level CICS system that does not support LINK3270.  The internal field BRIH_COMPCODE contains the EIBRESP value for the failed routing request.  The internal field BRIH_REASON contains the EIBRESP2 value for the failed routing request.  The internal field BRIH_FUNCTION contains the EIBFN value for the failed routing request.
61BRIHRC_INVALID_FACILITY_TOKENThe bridge facility token in the BRIH is invalid.
62BRIHRC_NO_FREE_NAMEAll available bridge facilities have been allocated. 
63BRIHRC_FACILITYTOKEN_IN_USEA transaction is already running with the requested facility token.
64BRIHRC_NO_STORAGEThere is insufficient available storage in either the router region or the AOR to run the request.
65BRIHRC_DFHBRNSF_UNAVAILABLEThe required file DFHBRNSF is not found, disabled, or otherwise unavailable.
66BRIHRC_CICS_TERMINATIONThe CICS region is terminating and the LINK3270 request has therefore been rejected.
80BRIHRC_NOT_SHUTDOWN_ENABLEDAn attempt was made to run a transaction at shutdown that is not enabled for running at shutdown. 
82BRIHRC_STATE_SYSTEM_ATTACHThe user transaction can only be system attached, and so cannot be run under a bridge facility.
84BRIHRC_TRANSACTION_DISABLEDThe user transaction to be run under the bridge is disabled.
85BRIHRC_TRANSACTION_NOT_FOUNDThe user transaction to be run under the bridge was not found.
86BRIHRC_TRANSACTION_NOT_RUNNINGThe next leg of a pseudo-conversation cannot be run because there is no transaction running on the bridge facility.
87BRIHRC_PROFILE_NOT_FOUNDThe transaction PROFILE for the target transaction was not found.
100BRIHRC_SECURITY_ERRORA LINK3270 request in session mode has been issued with a different user id than that used in the request that allocated the bridge facility token.
120BRIHRC_NO_DATAA 'Get more message' request failed because there was no more data to send.
121BRIHRC_RETRIEVE_NOT_SUPPORTEDRetrieve vectors are only supported in the initial request.
140BRIHRC_INVALID_BRIH_DATALENGTHThe BRIH data length value supplied by the client is not valid.
141BRIHRC_VALIDATION_ERROR_BRIVA BRIV is invalid.  The internal field BRIH_ERROROFFSET points to the field in error.
142BRIHRC_INVALID_KEEPTIMEA KEEPTIME of zero (0) was set on an allocate request.
143BRIHRC_INVALID_CONTINUE_REQThe message contained no BRIVs.
144BRIHRC_ROUTER_BACKLEVELThe router region does not support the version of the LINK3270 message.
145BRIHRC_AOR_BACKLEVELThe bridge driver task in the AOR does not suppor the version of the LINK3270 message.
160BRIHRC_APPLICATION_ABENDThe user transaction abended.   The internal field BRIH_ABENDCODE contains the actual abend code.

© 2022 HostBridge Technology, LLC
Unless otherwise noted, all rights reserved.