Define an RPC to execute in the specified region. The SYM2 transaction is a simple CICS transaction that fabricates data and does not require external resources such as DB2 UDB.
At the prompt, enter a command similar to the one shown below.
exec sgw_addrpc rpc_name, tran_id, region, security
where:
rpc_name is the name of the remote procedure that the client uses to call this RPC. The name can be up to 30 characters.
tran_id is the name of the associated mainframe transaction that is called when a client requests the named procedure. The value of this field must be in uppercase. For CICS, use 4 characters. For IMS, use up to 8 characters.
region (LU 6.2 only) specifies the remote LU name of the region in this parameter. Set this value to match the VTAM APPLID of the CICS or IMS region (the destination subsystem) in which the transaction (specified in tran_id) executes.
At least one defined connection must have this value specified as its region. See also “Adding a connection configuration”. An entry in this field is required.
region (TCP/IP only) is used within TRS only to represent the CICS region name. It must match the value you specify for the region parameter in the sgw_addregion procedure. See “Defining regions to TRS”. An entry in this field is required.
security specifies the type of user login information to be passed to the transaction processing region:
Using LU 6.2, the information is passed in the conversation-level security fields of the SNA LU 6.2 Function Management Header 5 (FMH-5).
Using TCP/IP, these fields are sent to the CICS Listener Transaction when the CICS transaction is started.
The security parameter can have any of the following values to specify which information is sent:
none – do not send login information to the mainframe.
userid – send only the user ID to the mainframe.
both – send both the user ID and the password to the mainframe.
For example, if you use native CICS security, the none value corresponds to the CICS security option NONE, userid corresponds to IDENTIFY, and both corresponds to the security option VERIFY.
exec sgw_addrpc SYM2, SYM2, CICSQA, none
where:
SYM2 (first entry) is the RPC name.
SYM2 (second entry) is the transaction ID at the mainframe.
CICSQA is the CICS region name.
none indicates that user IDs are not passed to the mainframe.
The CICS region name (CICSQA in the preceding example) must match the following:
For TCP/IP, the region name given in the sgw_addregion procedure
For LU 6.2, the region parameter in the sgw_addcon procedure