Setting General Connection Properties

This section discusses:

Default connector properties.
Node-specific Oracle Jolt connect string properties.
Default Oracle Jolt connect string properties.

The general connection properties include default connector properties and Oracle Jolt connect strings for nodes that designate this gateway as their local gateway. You can find these properties in the section of the integrationGateway.properties file labeled DELIVERED CONNECTOR CONFIGURATION Section.

Default Connector Properties

Property Description

Property	Description
ig.connector.prefix	Identifies the universal resource indicator (URI) prefix added to any target connector name. This property instantiates the connector classes on the system. The default connector prefix is: `com.peoplesoft.pt.integrationgateway. targetconnector.` Note: Do not change this value.
ig.connector.defaultremoteconnector	Identifies the connector that the gateway uses to send messages to a remote gateway. The default value of this property is: `HttpTargetConnector` Note: Do not change this value.
ig.connector.ibtargetconnector	Identifies the connector that the gateway uses by default to send messages to a PeopleSoft Integration Broker application server node. The gateway uses this connector to link to the integration engine running on the node's application server. When the content of a message reaching the gateway doesn't specify a connector (this is often the case with third-party senders), the gateway automatically uses the connector specified by this property. The default value is: `PeopleSoftTargetConnector` Note: Do not change this value.

ig.connector.prefix

Identifies the universal resource indicator (URI) prefix added to any target connector name. This property instantiates the connector classes on the system. The default connector prefix is:

com.peoplesoft.pt.integrationgateway.
targetconnector.

Note: Do not change this value.

ig.connector.defaultremoteconnector

Identifies the connector that the gateway uses to send messages to a remote gateway. The default value of this property is:

HttpTargetConnector

Note: Do not change this value.

ig.connector.ibtargetconnector

Identifies the connector that the gateway uses by default to send messages to a PeopleSoft Integration Broker application server node. The gateway uses this connector to link to the integration engine running on the node's application server. When the content of a message reaching the gateway doesn't specify a connector (this is often the case with third-party senders), the gateway automatically uses the connector specified by this property. The default value is:

PeopleSoftTargetConnector

Note: Do not change this value.

Default Oracle Jolt Connect String Properties

Within any inbound message, the integration gateway requires only the names of the message and the requesting node. If the message was sent by a PeopleSoft Integration Broker system, it also includes the name of the target node. The gateway searches the integrationGateway.properties file for the Jolt connect string properties for the specified target node, so it can properly direct the message.

However, the integration gateway cannot determine the target node in the following cases:

The Jolt connect string settings for the specified target node are missing from the integrationGateway.properties file.
The message format does not include a To node specification.

This can include general HTTP calls to listening connectors other than the PeopleSoft listening connector.
When using Send Master for testing purposes.

To handle these cases, you can specify a default target node for the gateway if no valid target node can be determined.

Note:

You can set these properties in the integration gateway properties file or use the PeopleSoft Node Configuration page in PIA.

Use the default Jolt connect string properties:

#ig.isc.serverURL=//<machine name>:<jolt port>
#ig.isc.userid=<database user id>
#ig.isc.password=<database password>
#ig.isc.toolsRel=<peopletools release version>

Uncomment these four lines and enter values to designate a PeopleSoft Integration Broker node as the gateway's default (backup) target node. It typically is one of the nodes for which you already created node-specific Jolt connect string properties.

There's only one set of these default properties. They specify the same parameters as the node-specific properties, except that you don't include a node name; for example:

ig.isc.serverURL=//MYSERVER01:9000
ig.isc.userid=<database user id>
ig.isc.password=<database password>
ig.isc.toolsRel=8.55

You can also specify a comma-separated list of server URLs. Each URL in the string will use the user ID, password, and PeopleTools release defined:

ig.isc.serverURL=//MYSERVER01:9000,//MYSERVER02:9250,//MYSERVER03:9500,//MYSERVER04:9750 
ig.isc.userid=<database user id>
ig.isc.password=<database password>
ig.isc.toolsRel=8.55

Oracle Jolt Connect String Properties for Known Nodes

You must set four Oracle Jolt connect string properties for each PeopleSoft Integration Broker application server node with which the integration gateway communicates. The gateway uses this information to access each node's database through a Oracle Jolt connection with its PeopleSoft target connector.

Note:

You can set these properties in the integration gateway properties file or use the PeopleSoft Node Configuration page in PIA.

Note:

These properties apply only to communications that don't cross a firewall and for which the gateway uses the PeopleSoft target connector.

The integrationGateway.properties file contains a template for these properties:

ig.isc.$NODENAME.serverURL=//<machine name>:<jolt port>
ig.isc.$NODENAME.userid=<application server user id>
ig.isc.$NODENAME.password=<application server password>
ig.isc.$NODENAME.toolsRel=<peopletools release version>

For each node, make a copy of this template and replace $NODENAME with the name of the node definition. Enter appropriate values for each property as described in the following table:

Property	Description
ig.isc.$NODENAME.serverURL	Enter the URL of the application server node, consisting of the machine name and Oracle Jolt port; for example: `ig.isc.MYNODE.serverURL=//MYMACHINE:9000` Note: You can determine the Jolt port of the application server by examining the JOLT Listener section in the psappsrv.cfg file located in <PS_CFG_HOME>\appserv\<DOMAIN_NAME>.
ig.isc.$NODENAME.userid	Enter the User ID that you defined when you created the application server domain.
ig.isc.$NODENAME.password	Enter user password that you defined when you created the application server domain. This password must be encrypted. See Encrypting Passwords.
ig.isc.$NODENAME.toolsRel	Enter the version number of PeopleTools installed on the application server node to two decimal places; for example: `ig.isc.MYNODE.toolsrel=8.55`

You can also specify a comma-separated list of server URLs. Each URL in the string will use the user ID, password, and PeopleTools release defined:

ig.isc.QEDMO.serverURL=//MYSERVER20:9000,//MYSERVER21:9100,//MYSERVER23:9200,//MYSERVER24:9300
ig.isc.QEDMO.userid=<user ID>
ig.isc.QEDMO.password=<password>
ig.isc.QEDMO.toolsRel=8.55