Entering content frameSyntax documentation start_link_server Locate the document in its SAP Library structure

You use this method to start an instance with reference to the interface i_oi_link_server:

CALL METHOD link_server->start_link_server
     EXPORTING link_server_mode   = link_server_mode
               server_name_suffix = server_name_suffix
               no_flush           = no_flush
     IMPORTING error              = error
               retcode            = retcode.

Description of parameters

Parameter

Optional

Description

link_server_mode

X

link_server->link_server_inactive: The link server instance is created but not registered (see note).

link_server->link_server_standardname: The link server is created with the standard identifier

link_server->link_server_customname: The link server is created with the additional identifier server_name_suffix.

server_name_suffix

X

Suffix to name of link server

Caution

You should always use link_server_customname with a suffix. If a link server with the same name (for example, the standard name) is already running, an error occurs when you call the method. See also Strategies for Working with the Link Server).

Note that links in all OLE documents opened in the SAP Document Container Control must be created with this server name.

Note

If you specify link_server->link_server_inactive as a link server mode, the system creates an instance of the link server in the SAP Document Container Control. You can then add items to the link server using add_xxx_item. These items are only accessible using automation. However, you can also release the data for linking later on by calling start_link_server with another session.

Leaving content frame