> # Configuring SequeLink® Services

> This chapter describes how to create and manage SequeLink services with the SequeLink Manager MMC Snap-in.

> To do this... | See...
> --- | ---
> Start and stop SequeLink services | "Starting and Stopping SequeLink® Services"
> Create a SequeLink service | "Creating a SequeLink® Service"
> Delete a SequeLink service | "Deleting a SequeLink® Service"
> View service attributes | "Viewing Service Attributes"
> Change a service attribute | "Changing a Service Attribute"
> Add a service attribute | "Adding a Service Attribute"
> Delete a service attribute | "Deleting a Service Attribute"
> Configure monitoring | "Configuring Monitoring"
> Configure event tracing | "Configuring Event Tracing"

> NOTE: SequeLink services for DB2 on z/OS must be created, started, stopped, and deleted locally using the SequeLink Manager for z/OS. See "Configuring SequeLink® Services Using the SequeLink® Manager for z/OS" for more information about creating and managing SequeLink services on z/OS.

> ### Starting and Stopping SequeLink® Services

> NOTE: You can only start and stop the SequeLink Agent locally from the SequeLink Server on which it runs.

> 1. From the MMC, right-click the Connected or Not Connected icon and select Start Agent to start (or Stop Agent to stop) the SequeLink Agent.

> 2. You are prompted to confirm that you want to stop or start the service. The following dialog box shows an example of the message that appears when you stop a service.

> 3. Click the Yes button to stop or to start the service.

> ### Creating a SequeLink® Service

> When you install SequeLink Server, at least one SequeLink data access service, and one or more service templates determined by the SequeLink Server, are installed. You can use the SequeLink Manager to create additional services based on the SequeLink service templates and to modify the default service attributes defined in the service templates:

> | [SequeLink 6.0] Agent service
> | [SequeLink 6.0] Agent service for z/OS
> | [SequeLink 6.0] DB2 service for z/OS
> | [SequeLink 6.0] DB2 UDB LUW service
> | [SequeLink 6.0] DB2 UDB LUW service (enhanced code page support)
> | [SequeLink 6.0] Informix service (32-bit only)
> | [SequeLink 6.0] JDBC Socket service (32-bit only)
> | [SequeLink 6.0] ODBC Socket service
> | [SequeLink 6.0] ODBC Socket service (enhanced code page support)
> | [SequeLink 6.0] ODBC Socket service (enhanced code page support - UTF8 encoding)
> | [SequeLink 6.0] ODBC Socket service (enhanced code page support - UTF16 encoding)
> | [SequeLink 6.0] Oracle 9 service (32-bit only)
> | [SequeLink 6.0] Oracle 9 service (enhanced code page support - 32-bit only)
> | [SequeLink 6.0] Oracle 10 service
> | [SequeLink 6.0] Oracle 10 service (enhanced code page support)
> | [SequeLink 6.0] SQL Server service
> | [SequeLink 6.0] SQL Server service (enhanced code page support)
> | [SequeLink 6.0] Sybase service
> | [SequeLink 6.0] Sybase service (enhanced code page support)
> | [SequeLink 6.0] Sybase service (enhanced code page support - UTF8 encoding)
> | [SequeLink 6.0] Sybase service (enhanced code page support - UTF16 encoding)

> NOTE: Unicode ODBC drivers can be written with either UTF-8 or UTF-16 encoding. When configuring SequeLink Server for ODBC Socket, choose the appropriate SequeLink service for the ODBC driver that you will be using. See "Configuring Transliteration" for more information about choosing a template.

> NOTE: SequeLink DB2 services for z/OS must be created with the SequeLink Manager for z/OS. See "Configuring SequeLink® Services Using the SequeLink® Manager for z/OS" for more information.

> In most cases, the SequeLink service templates provide a configuration that can be used without any modification. Not all SequeLink service attributes are defined in the templates. See "SequeLink® Service Attributes" for a list of all SequeLink service attributes.

> To create a SequeLink data access service:

> 1. In the console tree, select the SequeLink Agent to service the new SequeLink data access service.
> 2. In the Details pane, click the Create a Service wizard. The wizard prompts you to choose the type of service to create.

> From the Service drop-down list, select the type of SequeLink service you want to create; then, click Next.

> 3. The wizard prompts you for service information.

> Perform the following actions:

> 1. In the Service Name field, type the service name you want to use for the new service. The service name must be unique (not used by another service).
> 2. In the TCP port field, type the number of the TCP/IP port on which the new service will be listening. The port must be an available port (cannot be used by another service).
> 3. Click Next.
> 4. The wizard prompts you to register the service on the host machine. The default is to register the service, which makes the service information available to the operating system. This is required on Windows if you want to start your service through the SequeLink Manager or the Service Control Manager.

> 5. Click Finish to create the new SequeLink service.

> ### Deleting a SequeLink® Service

> NOTE: Before deleting a SequeLink service, you must stop the service you want to delete.

> 1. Right-click the service you want to delete in the left pane, and select Delete.
> 2. You are prompted to confirm the deletion. Click OK to confirm. The service is deleted.

> ### Viewing Service Attributes

> To view SequeLink service attributes, select an attribute category from the Service Settings node. The Details pane shows all attributes in that category and their current values. For example, if you select the General category, the ServiceDescription and ServiceConnectInfo attributes are displayed in the Details pane.

> NOTE: Only commonly used attributes are included in the configuration of a newly created SequeLink service. To configure other attributes, you must add the attribute explicitly to your SequeLink configuration.

> See "SequeLink® Service Attributes" for a description of the service attributes.

> ### Changing a Service Attribute

> 1. Right-click any service attribute and select Properties. The properties window for that attribute appears.

> For example, to change the ServiceMaxThreads attribute, right-click ServiceMaxThreads, and select Properties. The ServiceMaxThreads Properties window appears.

> 2. Type a new value for the attribute in the Value field, and click OK. The attribute is changed.
> 3. Save the configuration.

> NOTE: When you add or change a static attribute, you must restart the SequeLink service before the change takes affect. Dynamic attributes become effective after the attribute is added or changed and the configuration is saved.

> "SequeLink® Service Attributes" describes the service attributes and specifies whether each attribute is static or dynamic.

> ### Adding a Service Attribute

> 1. Right-click any service attribute category, and select New / Attribute. The New Attribute window appears.

> NOTE: If you do not know the attribute category, you can right-click the Service Settings node, and select New / Attribute. In this case, the drop-down list displays all attributes.

> 2. From the Attribute drop-down list, select the attribute you want to add to the service. The Type field adjusts to show the type of value required.

> NOTE: If an attribute is already defined and only one instance of the attribute is allowed, the attribute is not displayed in the drop-down list.

> 3. In the Value field, type a value for the attribute (or in some cases, select an option), and click OK. The attribute is added to the service.
> 4. Save the configuration.

> NOTE: When you add or change a static attribute, you must restart the SequeLink service before the change takes affect. Dynamic attributes become effective after the attribute is added or changed and the configuration is saved.

> See "SequeLink® Service Attributes" for a description of the service attributes.

> ### Deleting a Service Attribute

> 1. Right-click the SequeLink service attribute you want to delete, and select Delete.
> 2. You are prompted to confirm the deletion. Click OK to confirm. The attribute is deleted from the service configuration.
> 3. Save the configuration.

> NOTE: When you delete a static attribute, you must restart the SequeLink service before the change takes affect. Deletion of dynamic attributes becomes effective after the attribute is deleted and the configuration is saved.

> See "SequeLink® Service Attributes" for a description of the service attributes.