Start task in the 3270 bridge environment and associate it
with the named bridge exit.

See also:


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 may be executing inside or outside of CICS.
See CICS External Interfaces Guide for
more information about the 3270 bridge and its interfaces.
The attached
task cannot be CANCELled; 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
will be started in the 3270 bridge environment, and will execute in association
with the bridge exit specified in BREXIT.
- USERID(data-value)
- Specifies
the userid under whose authority the started transaction is to run.
Conditions
- INVREQ
- RESP2
values:
- 11
- An attempt was made to route a START BREXIT request.
- 12
- A START BREXIT request has failed..
- 18
- A USERID is specified and the CICS external security manager interface
is not initialized.
Default action: terminate the task abnormally.
- LENGERR
- occurs
if BRDATALENGTH is not greater than zero.
Default action: terminate the
task abnormally.
- 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.
- 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.
- 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.
- USERIDERR
- RESP2
values:
- 8
- The specified USERID 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 USERID is valid.
Default action: terminate the task abnormally.
Passing data to the bridge exit
Data can be passed
to the bridge exit 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)
⋮