URL path components for 3270 display applications

Attention: This topic contains Product-sensitive Programming Interface and Associated Guidance Information.

To invoke a CICS® 3270 application from a Web browser, you must enter a URL with a path component that starts by invoking the application program name DFHWBTTA, DFHWBTTB, or DFHWBTTC, together with an appropriate alias transaction and converter program (if required). Note that this alias transaction does not apply to the 3270 application itself, which runs under its own transaction.

Using an analyzer program
If you are using an analyzer program like the CICS-supplied sample analyzer DFHWBADX to handle requests, the path component of the URL includes the name of the application program (DFHWBTTA, DFHWBTTB or DFHWBTTC). It also includes the name of any converter program that you are using, and the name of the alias transaction for request processing (such as the default CICS-supplied alias transaction CWBA). As explained in CICS-supplied sample analyzer program DFHWBADX , these elements of the path are extracted by the analyzer program and used to invoke subsequent processing stages.
Start of changeUsing a URIMAP definitionEnd of change
Start of changeIf you are using a URIMAP definition to handle requests, the path component of the URL is specified in the PATH attribute. With URIMAP definitions, the path component of the URL does not need to include explicit information about the application program, converter program and alias transaction (although it can still do so). All these elements can be specified in the URIMAP definition, using the PROGRAM, CONVERTER, and TRANSACTION attributes. This part of the path component can then be replaced by any path of your choice. To satisfy the requirements of DFHWBTTA itself, use an asterisk as a wildcard character at the end of the path that you specify in the URIMAP definition. This allows the remainder of the path component to be varied to control DFHWBTTA.End of change
Start of changeUsing both a URIMAP definition and an analyzer programEnd of change
Start of changeYou can use an analyzer program in the processing path for a request by specifying the ANALYZER(YES) option in the URIMAP definition. The analyzer program can dynamically modify the converter program, alias transaction ID and program name that are specified by the URIMAP definition, and DFHWBTTA can see these changes. End of change
After providing the information needed to invoke the application program, the next part of the path component of the URL is used to provide control information to DFHWBTTA. This information includes: Figure 1 shows the syntax of the path component that is interpreted by DFHWBTTA.
Figure 1. Syntax of the path interpreted by DFHWBTTA
Read syntax diagramSkip visual syntax diagram
>>-/--ignored--+-------------+--/--transaction ID--------------->
               '-/--UNFORMAT-'                      

>--+-------------------+--+----------+-------------------------><
   | .---------------. |  '-?--token-'   
   | V               | |                 
   '--- + -parameter-+-'                 

DFHWBTTA interprets the path component of the URL as follows:
ignored
The first part of the path is ignored by DFHWBTTA. This is the part that is interpreted by the analyzer, or matched to a URIMAP definition, to provide the information needed to invoke the application program.
UNFORMAT
The 3270 display can operate in two modes, formatted mode, and unformatted mode. If this keyword is present, DFHWBTTA simulates a 3270 display operating in unformatted mode. If this keyword is omitted, DFHWBTTA simulates a 3270 display operating in formatted mode.

For more information about how the 3270 display operates in unformatted mode, see the CICS Application Programming Guide.

transaction ID
On the initial request, this information specifies the CICS transaction to be run. This element of the path is ignored on a continuation request.
parameter
Specifies an input parameter for the transaction. Use plus signs (+), not spaces, as a delimiter to separate the transaction id and this data, and between elements of this data.
token
This is ignored by DFHWBTTA. It can be used by an analyzer program.
The URL must always be coded in this form.
For example, if you are using the CICS-supplied analyzer program DFHWBADX, you could use the following URL path to issue the CEMT INQ TAS command:
/cics/cwba/dfhwbtta/CEMT+INQ+TAS
In this example:
Start of changeAlternatively, you could set up a URIMAP definition that includes the following attributes:
Path:	       /terminal/*
Transaction:  CWBA
Program:      DFHWBTTA
With this URIMAP definition enabled, you could use the following URL path to issue the CEMT INQ TAS command:
/terminal/CEMT+INQ+TAS
In this example: End of change