The Mainframe Connection can both be configured with global settings as with DID specific settings. Some settings are meaningful for all types of mainframe connections. Some settings are only meaningful when using CPIC while other settings are only meaningful when using MQSeries. Using the CPI-C API for the Mainframe Connection is deprecated and will not be supported in future versions of the ITP software.
The following general settings are available:
Setting |
Default |
Description |
Codepage |
37 |
The code page for the mainframe data. |
Disconnect |
Normal |
Disconnect the host (end the transaction) after every entry, model or when a DID change takes place. Must be Entry, Model or Normal. |
Protocol |
MQS |
The interface type that must be used. This can be either CPI-C for CPI-C communication or MQS for MQSeries. |
UserId |
Empty |
The UserId for the host login process. |
Password |
Empty |
The password for the host login process.
|
The following settings are available for mainframe connections that use MQSeries:
Setting |
Default |
Description |
MQS.ConnectionName |
No default |
This is either the hostname or the network address of the remote machine. |
MQS.ServerChannelName |
No default |
This is the name of the server connection channel that will be used for the Client-Server MQI connection. |
MQS.QueueManagerName |
Empty |
The name of the queue manager on the host that manages the request queue and the reply model queue. If no queue manager is specified this setting defaults to empty, which means that the default queue manager of the host will be used. |
MQS.RequestQueueName |
No default |
The name of the request queue. |
MQS.ReplyQueueModelName |
Empty |
The name of the model queue name that is used to dynamically create a private reply queue. If no name is specified the ReplyQueueName is taken as the model queue name. |
MQS.ReplyQueueName |
No default |
The name that will be used for the dynamically created reply queue. This name will be extended with the userid and a unique id. So if Client 'John' has set the ReplyQueueName to 'ITP.REPLY' the actual reply queue will be named 'ITP.REPLY.John.<UniqueId>'. |
MQS.Timeout |
15000 |
The time (in milliseconds) that the client will wait for an answer.
|
The following settings are available for mainframe connections that use CPI-C:
Setting |
Default |
Description |
|||
SideInfo |
No default |
The name of the CPI-C side-info entry when using external side-info. When this setting is empty, ITP will generate an internal side-info entry on the fly. |
|||
Plu |
No default |
The SNA Partner Logical Unit name of the host. Only for internal side-info. |
|||
Tpn |
No default |
Transaction Program Name of the ITP Host DataManager. Only for internal side-info. |
|||
APPCMode |
QPCSUPP |
The APPC mode for the SNA conversation. Only for internal side-info. |
|||
SvcKey |
Empty |
Key/password to use when creating a side-info entry. This setting is very rarely used. |
|||