Start task in the 3270 bridge environment and associate
it with the named bridge exit.
START BREXIT
>>-START--+-BREXIT-------+--TRANSID(name)----------------------->
'-BREXIT(name)-'
>--+-------------------------------------------------+---------->
'-BRDATA(data-area)--+--------------------------+-'
'-BRDATALENGTH(data-value)-'
>--+--------------------+--------------------------------------><
'-USERID(data-value)-'
Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR, TRANSIDERR,
USERIDERR
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.
The following example shows how to start a specified
task, in the 3270 bridge environment and pass data to its bridge exit:
EXEC CICS START BREXIT('DFH0CBRE')
TRANSID('TRNL')
BRDATA(BRSD)
BRDATALENGTH(72)
⋮