Maintaining Ports 

Use

You use the port maintenance in the IDoc adapter to establish an RFC connection to the system that contains the metadata that the IDoc adapter requires to convert IDocs (Intermediate Documents) that have been sent to it to IDoc XML format. This system is defined by the sender port and the client in the IDoc control record. It is either the sender SAP system or an SAP reference system.

The metadata comprises the IDoc structures for the corresponding IDoc types. Using this port you can call this data either directly at runtime or you can load it to the Integration Server (the system with the IDoc adapter) beforehand.

You must maintain a port in the IDoc adapter for all clients in each SAP system that you want to connect to the Integration Server using IDocs.

This is also the case for receiver systems if they are subsystems (non-SAP systems). Systems of this kind are defined using the receiver port in the respective communication channel.

Creating a Port

To establish an RFC connection using the port maintenance in the IDoc adapter, proceed as follows:

...

       1.      Call the transaction Port Maintenance in IDoc Adapter (IDX1).

On the left-hand side the system displays a list of ports that are already defined, for example SAPABC_123, and a description.

       2.      Choose Create () to create a new port (a new RFC connection) for the selected system.

The system converts the display area on the right-hand side of the screen into an input area where you can enter the specifications for the new port.

Specifications for Port to Be Created

Specification	Meaning
Port	Port name. For SAP systems this comprises the type and ID of the connected system, for example, SAPABC.
Client	Three figure number of the respective client, for example, 123.
Description	A short description of the port.
RFC Destination	The RFC destination for the connected system. This comprises, for example, the system ID and the client, for example, ABC_123.
Receiver of Status Messages	Partner number and partner type of receiver.

The specifications for Port and Client correspond to the sender port and the client in the IDoc control record.

       3.      Enter the required data for the new port and save the data.

The system creates the new entry and places it alphabetically in the list of already defined ports. The system displays a corresponding message.

Changing a Port

To change the specifications for a port, proceed as follows:

...

       1.      Select the port from the port list and choose Change ().

The system converts the display area on the right-hand side of the screen into an input area where you can make your changes. The port name and the client cannot be changed.

       2.      Make your changes to the selected port and save the data.

The system returns the input area on the right-hand side of the screen to display mode and displays the selected port with your changes.

Deleting a Port

To delete a port, proceed as follows:

...

       1.      Select the port from the port list and choose Delete ().

The system displays a dialog box asking if you really want to delete the port.

       2.      To delete the port, choose Yes.

The system deletes the entry and displays a corresponding message.