You can use the following commands and interfaces to obtain information
about the Link3270 bridge environment and the bridge facility:
- INQUIRE/SET AUTOINSTALL
- INQUIRE/SET BRFACILITY
- INQUIRE TERMINAL/NETNAME
- INQUIRE TASK
- INQUIRE/SET TRACETYPE
- INQUIRE TRANSACTION
- CEMT
- The exit programming interface (XPI)
Note:
The BRIDGE option of the ASSIGN command returns the name of
the transaction that issued the Link3270 command. It returns blanks if the
transaction is not run in a bridge environment.
You can use the AIBRIDGE option of the INQUIRE AUTOINSTALL command and CEMT INQUIRE AUTOINSTALL to indicate
whether the autoinstall URM is called when bridge facilities are allocated.
You can change this setting using the SET AUTOINSTALL command and CEMT SET AUTOINSTALL.
You can use the INQUIRE BRFACILITY command and CEMT INQUIRE BRFACILITY to return the following information
about a bridge facility:
- The terminal name associated with the bridge facility (TERMID)
- The netname associated with the bridge facility
- The name of the user transaction running with this bridge facility
- The number of the task running the user transaction
- The applid of the AOR
- The sysid of the AOR
- The applid of the router region
- The sysid of the router region
- An indicator showing whether the Link3270 or START BREXIT bridge mechanism
is being used
- The length of time this bridge facility will be kept if unused
- The current status of the bridge facility
You can change the status setting of the bridge facility to RELEASED
using the SET BRFACILITY command and CEMT SET BRFACILITY.
You can use the BRFACILITY option of the INQUIRE
TASK command and CEMT INQUIRE TASK to return
an 8-byte field containing the facilitytoken for the bridge facility in use
by the task.
Note:
The BRIDGE and IDENTIFIER options return information about
the START BREXIT bridge mechanism, and are not used with Link3270.
You can use the INQUIRE TRACETYPE command to
indicate whether tracing is enabled for the bridge (BR) and partner (PT) domains.
You can change this setting using the SET TRACETYPE command .
You can use the FACILITYLIKE option of the INQUIRE
TRANSACTION command and CEMT INQUIRE TRANSACTION to return the 4-character name of the terminal defined by the FACILITYLIKE
parameter of the PROFILE associated with the named transaction resource definition.
If FACILITYLIKE is not defined, blanks are returned.
Note:
The BREXIT option returns information about the START BREXIT
bridge mechanism, and is not used with Link3270.
You can use the INQUIRE_CONTEXT function of the DFHBRIQX call to return
the following information:
- The name of the bridge exit program used by a task running the START
BREXIT bridge mechanism.
- The bridge facilitytoken associated with a user transaction running in
a bridge environment.
- The address of the bridge facility. This has the same format as a TCTTE
and can be mapped using the DSECT DFHTCTTE.
- The name of the bridge monitor transaction used to start a user transaction
using the START BREXIT bridge mechanism.
- A token that contains the address of the bridge exit area used by a task
running the START BREXIT bridge mechanism.
- The type of environment in which the transaction is running. This can
be :
- NORMAL
- A transaction that is not running in a bridge environment.
- BRIDGE
- A user transaction that was started using a bridge.
- BREXIT
- A bridge exit program.
See the CICS® Customization Guide for full details of the
INQUIRE-CONTEXT interface.
[[ Contents Previous Page | Next Page Index ]]