INQUIRE REQUESTMODEL

Retrieve information about a REQUESTMODEL.

Read syntax diagramSkip visual syntax diagramINQUIRE REQUESTMODEL
 
>>-INQUIRE REQUESTMODEL(data-value)----------------------------->
 
   .----------------------------.
   V                            |
>----+------------------------+-+------------------------------><
     +-BEANNAME(data-area)----+
     +-CORBASERVER(data-area)-+
     +-INTERFACE(data-area)---+
     +-INTFACETYPE(cvda)------+
     +-MODULE(data-area)------+
     +-OPERATION(data-area)---+
     +-TRANSID(data-value)----+
     '-TYPE(cvda)-------------'
 

Conditions: END, ILLOGIC, NOTAUTH

Description

A REQUESTMODEL resource definition maps an inbound request that is formatted using the Internet Inter-ORB PROTOCOL (IIOP) to a CICS transaction that is to be started to process the request. The INQUIRE REQUESTMODEL command returns information about an installed REQUESTMODEL.

Browsing

You can also browse through all the REQUESTMODELs that are installed on your system by using the browse options (START, NEXT, and END) on INQUIRE REQUESTMODEL commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples. You can specify the following options on the INQUIRE request:

Options

REQUESTMODEL(data-value)
specifies an 8-character request model name.
BEANNAME(data-area)
returns the 240-character field containing the (possibly generic) bean name that matches the name of an enterprise bean in an XML deployment descriptor. This field is blank if the TYPE attribute is CORBA.
CORBASERVER(data-area)
returns a 4-character field containing the (possibly generic) name of the destination CorbaServer for this REQUESTMODEL.
INTERFACE(data-area)
returns a (possibly generic) name, of up to 255 characters, matching the IDL interface name. This field is blank if the TYPE attribute is EJB.
INTFACETYPE(cvda)
returns the CVDA value of the Java interface type for this REQUESTMODEL. CVDA values are:
HOME
specifies that this is the home interface for the bean.
REMOTE
specifies that this is the component interface for the bean.
BOTH
matches both the home and component interfaces for the bean.
NOTAPPLIC
returned if the TYPE attribute is CORBA.
MODULE(data-area)
returns a (possibly generic) name, of up to 255 characters, matching the IDL module name. This field is blank if the TYPE attribute is EJB.
OPERATION(data-area)
returns a 255-character field containing a (possibly generic) name matching the IDL operation or bean method name.
TRANSID(name)
returns the 4-character name of the CICS transaction to be executed when a request matching the specification of the REQUESTMODEL is received.
TYPE(data-area)
returns a CVDA value indicating the type of the REQUESTMODEL. CVDA vlaues are:
EJB
matches enterprise bean requests as specified by the EJB parameters.
CORBA
matches CORBA requests as specified by the CORBA parameters.
GENERIC
matches both enterprise bean and CORBA requests.

Conditions

END
RESP2 values:
2
All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged.
ILLOGIC
RESP2 values:
1
A START has been given when a browse is already in progress, or a NEXT or an END, has been given without a preceding START.
NOTAUTH
RESP2 values:
100
The user is not authorized for this command.
NOTFND
RESP2 values:
1
The specified request model was not found.
[[ Contents Previous Page | Next Page Index ]]