Defining the test region (TCP/IP only)

1. Log in to TRS as “sa” using isql or your preferred dynamic SQL utility:

   isql -Sservice_name -Usa -P
   

   where service_name is the unique name of this TRS.

2. At the isql prompt, enter a command similar to the following, replacing the parameter values shown here with values that are appropriate for your installation.

   exec sgw_addregion region, hostname, portnumber, regiontype
   

   where:

   • region is the value used within TRS only. The value you specify here must match the value you specify in the region parameter of the sgw_addrpc procedure. This name can be up to eight characters.

   • hostname is the value you specify for the TCP/IP network host name. This is the name corresponding to the mainframe in your /etc/hosts file or in your NIS map. This name can be up to 30 characters.

   • portnumber is the number you specify that must match the port number on which the CSKL transaction listens. It can be any number between 1024 and 9996. (This is not the same as the port number used to configure the interfaces file.)

   • regiontype is the type of the mainframe processing environment specified by the region parameter. Valid values are CICS, MVS, and IMS. If you do not specify a value, the region type defaults to CICS.

In this example, “CICSQA” is the region, “BLUES” is the host name, “3003” is the port number that the CICS Listener transaction is running on, and “CICS” is the region type:

exec sgw_addregion CICSQA, BLUES, "3003", CICS