CEMT INQUIRE BRFACILITY
Retrieve information about a virtual terminal (bridge facility) used by the 3270 bridge mechanism.
Description
The INQUIRE BRFACILITY command returns information about a bridge facility. This is a virtual terminal used by the 3270 bridge mechanism to simulate a real 3270 when running a CICS® 3270 application in a bridged environment.
Input
Press the Clear key to clear the screen.
You can start this transaction in two ways:
- Type
CEMT INQUIRE BRFACILITY
(or suitable abbreviations for the keywords). The resulting display lists the status of any currently allocated bridge facilities. - Type
CEMT INQUIRE BRFACILITY
(or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enterCEMT I BR S
, the resulting display shows the details of only those bridge facilities that were allocated for Link3270 requests (SHARED). To find out which options you can enter on theCEMT I BR
request, you can enter?CEMT I BR
, for example.
You can change various attributes in the following ways:
- Overtype your changes on the INQUIRE screen after tabbing to the appropriate field (see Overtyping a display).
- Use the CEMT SET BRFACILITY command.
Sample screen
If you place the cursor against a specific entry in the list and press ENTER, CICS displays an expanded format, as shown:
Displayed fields
- (value)
- The 8-byte bridge facility token of a specific bridge facility to be displayed.
- ALL
- The default. All bridge facilities are displayed.
- KEEPTIME (value)
- Displays
a full word binary field that shows the length of time (in seconds)
that the bridge facility is kept if it is inactive.
- If the bridge facility being displayed is a Link-Bridge, this
value is the keep time specified when the facility was allocated,
or a default value of 5 minutes if no keep time was specified. :
If the keep time is larger than the value of SIT parameter BRMAXKEEPTIME, it is reduced to BRMAXKEEPTIME.
- If the facility being displayed is a Web-Bridge, the keep time is initially set as the web delay terminal keep time (the second part of the WEBDELAY SIT parm).
- If the bridge facility being displayed is a Link-Bridge, this
value is the keep time specified when the facility was allocated,
or a default value of 5 minutes if no keep time was specified. :
- LINKSYSNET(value)
- Displays the 8-byte applid of the AOR if the Link3270 bridge request is routed to another region. If the request is processed in the same region as the Link3270 router, this field is blank. This field might change if dynamic transaction routing makes more than one attempt at running the first transaction in a Link3270 session. This field is only set in the router region.
- LINKSYSTEM(value)
- Returns the 4-byte sysid of the AOR if the Link3270 bridge request is routed to another region. If the request is processed in the same region as the Link3270 router, this field is blank. This field migh change if dynamic transaction routing makes more than one attempt at running the first transaction in a Link3270 session. This field is only set in the router region.
- NAMESPACE
- Displays
the scope of the namespace used to allocate bridge facility names.
Values are as follows:
- LOCAL
- The bridge facility was allocated by the START BREXIT bridge mechanism, so its name is unique only in the local region where it is created.
- SHARED
- The bridge facility was allocated by the Link3270 bridge mechanism, so its name is unique across all CICS router regions in the CICSplex who have access to a shared DFHBRNSF namespace file.
- NETNAME(value)
- Displays the 8-byte virtual netname name of the bridge facility about which you are inquiring.
- REMOTESYSNET(value)
- Displays an 8-byte field that shows the applid of the bridge router region. This field is only set in the AOR region. It is blank if the request is processed in the router region and not sent to an AOR.
- REMOTESYSTEM(value)
- Displays a 4-byte field that shows the sysid of the bridge router region. This field is only set in the AOR region. It is blank if the request is processed in the router region and not sent to an AOR.
- TASKID(value)
- Displays a full word binary field showing the number of the task running the user transaction. This field is only set in the AOR. This field is zero the bridge facility is currently not in use.
- TERMID(value)
- Displays the 4-byte virtual terminal name of the bridge facility about which you are inquiring.
- TERMSTATUS
- Displays
the status of the bridge facility. Values are as follows:
- ACQUIRED
- The bridge facility is currently in use.
- AVAILABLE
- The bridge facility is not in use. It can be reused by the client.
- RELEASED
- SET BRFACILITY RELEASED has been issued for the bridge facility. It will be deleted on the next cleanup cycle.
- TRANSACTION(value)
- Displays a 4-byte field that shows the name of the user transaction being run by the 3270 bridge, as known in the current region. This is blank if the bridge facility is currently not in use.
- USERID(value)
- Displays an 8-byte field that shows the userid associated with this bridge facility.