START BREXIT
Start task in the 3270 bridge environment and associate it with the named bridge exit.
Description
START BREXIT starts a task immediately in the local CICS® region, and initializes the specified transaction (TRANSID) and bridge exit (BREXIT). In the 3270 bridge environment, all 3270 terminal requests issued by the transaction specified by TRANSID, are intercepted and passed to the user-replaceable program (the bridge exit) specified by BREXIT.
The bridge exit (BREXIT) emulates the 3270 interface by passing the terminal requests to a client application that might be executing inside or outside of CICS.
See Introduction to the 3270 bridge for more information about the 3270 bridge and its interfaces.
The attached task cannot be canceled; its STARTCODE is defined by the bridge exit.
Options
- BREXIT(name)
- Specifies the name (1-8 characters) of the bridge exit to be associated with the started task. If no name is specified, the value of BREXIT on the TRANSACTION resource definition for TRANSID is used.
- BRDATA(data-area)
- Specifies the data to be passed to the bridge exit specified by BREXIT when the task is started.
- BRDATALENGTH(data-value)
- Specifies a fullword binary data value that is the length of the BRDATA to be passed to the bridge exit specified by BREXIT when the task is started.
- TRANSID(name)
- Specifies the symbolic identifier (1–4 characters) of the
transaction to be executed by a task started as the result of a START
BREXIT command. The transaction is started in the 3270 bridge environment,
and executes in association with the bridge exit specified in BREXIT.
The TRANSID option is used in previous hop data that is collected. See Association data for more information about using the TRANSID option with previous hop data.
- USERID(data-value)
- Specifies the user ID under whose authority the started transaction is to run.
Conditions
- 16 INVREQ
- RESP2 values:
- 11
- An attempt was made to route a START BREXIT request.
- 12
- A START BREXIT request has failed.
- 18
- A USERID option is specified and the CICS external security manager interface is not initialized.
Default action: terminate the task abnormally.
- 22 LENGERR
- Occurs if BRDATALENGTH is not greater than zero.
Default action: terminate the task abnormally.
- 70 NOTAUTH
- RESP2 values:
- 7
- A resource security check fails on TRANSID (name).
- 9
- A surrogate user security check fails on USERID (name). The security access capabilities of the transaction that issued the command do not allow the command to be performed with the value specified in the USERID option.
Default action: terminate the task abnormally.
- 27 PGMIDERR
- Occurs if no name is supplied by the BREXIT option and the transaction
definition for TRANSID does not provide a default BREXIT name.
Default action: terminate the task abnormally.
- 28 TRANSIDERR
- Occurs if the TRANSID specified in a START BREXIT command has
not been defined to CICS. RESP2 values:
- 11
- The specified transaction is defined as remote.
Default action: terminate the task abnormally.
- 69 USERIDERR
- RESP2 values:
- 8
- The specified user ID is not known to the external security manager.
- 10
- The external security manager is in a state such that CICS cannot determine whether a specified user ID is valid.
Default action: terminate the task abnormally.
Passing data to the bridge exit
Data can be passed to the bridge exit by using the BRDATA and BRDATALENGTH options.
EXEC CICS START BREXIT('DFH0CBRE')
TRANSID('TRNL')
BRDATA(BRSD)
BRDATALENGTH(72)
⋮