Adding the license for Real-Time Data Services  Known problems with RTDS using Adaptive Server

Installation and Release Bulletin Real-Time Data Services Version 3.0

Configuring Real-Time Data Services

StepsConfiguring your installation

  1. Run the installmsgsvss script to install system stored procedures for real-time messaging services:

    isql -Usa -Psa_password -Sserver_name -n
        -i$SYBASE/$SYBASE_ASE/scripts/installmsgsvss
        -ooutput_file
    
  2. Add your local server:

    sp_addserver, <local server name>
    
  3. Restart your server.

  4. Assign messaging_role permissions to users. For example:

    grant role messaging_role to <login>
    
  5. Real-Time Data Services, as a messaging services feature, uses these Adaptive Server configuration parameters. Set these when you configure Adaptive Server:

    This example assumes that current 'max online engines' is 4.

    -- Add 2 more to 'max online engines'.
    sp_configure 'max online engines', 6
    go
    sp_configure 'max online Q engines', 2
    go
    sp_configure 'number of Q engines at startup, 2
    go
    

    MQSeries only – set the path for the MQ client shared libraries to the dynamic linker’s search path using the information in Table 2 for your platform.

    Table 2: MQ client shared libraries and their paths

    Platform

    Environment variable

    Path

    Solaris 64-bit

    LD_LIBRARY_PATH

    /opt/mqm/lib64

    Solaris 32-bit

    LD_LIBRARY_PATH

    /opt/mqm/lib

    Linux 32-bit

    LD_LIBRARY_PATH

    /opt/mqm/lib

    HPUX 64-bit

    SHLIB or LD_LIBRARY_PATH

    /opt/mqm/lib64

    AIX 64-bit

    LIBPATH

    /usr/mqm/lib64

    NoteYour MQ client shared library path must be correct before you start Adaptive Server.

StepsSetting up MQ

  1. Create a Queue Manager and start it up. In this example, the queue manager is called QM1:

    % crtmqm QM1
    
    WebSphere MQ queue manager created.
    Creating or replacing default objects for QM1.
    Default objects statistics : 31 created. 0 replaced. 
    0 failed.
    Completing setup.
    Setup completed.
    
    % strmqm QM1
    
    WebSphere MQ queue manager 'QM1' started.
    
  2. Use the MQSC tool to create a queue. This example creates a queue on the QM1 Queue Manager called Q1:

    % runmqsc QM1
    
    5724-B41 (C) Copyright IBM Corp. 1994, 2002.  ALL
    RIGHTS RESERVED.
    Starting WebSphere MQ script Commands.
    define qlocal(Q1)
           1 : define qlocal(Q1)
    AMQ8006: WebSphere MQ queue created.
    end
           2 : end
    No MQSC commands read.
    No commands have a syntax error.
    All valid MQSC commands were processed.
    
  3. Use the MQSC tool to define a server channel in the Queue Manager. This example defines a channel on QM1 called CH1:

    % runmqsc QM1
    
    5724-B41 (C) Copyright IBM Corp. 1994, 2002.  ALL RIGHTS RESERVED.
    Starting WebSphere MQ script Commands.
    define channel(CH1) chltype(SVRCONN)
           1 : define channel(CH1) chltype(SVRCONN)
    AMQ8014: WebSphere MQ channel created.
    end
           2 : end
    No MQSC commands read.
    No commands have a syntax error.
    All valid MQSC commands were processed.
    
  4. Add authorizations for the SYBASE user login and ASE logins. In this example, Adaptive Server runs as user “sybase,” and the Adaptive Server messaging user is “login1” and the queue is “Q1”:

    % setmqaut -m QM1 -t qmgr -p sybase +connect +altusr +inq +setid
    % setmqaut -m QM1 -t q -n Q1 -p login1 +inq +get +browse +put
    
  5. Start an MQ listener. This example starts a listener on port 8765:

    % runmqlsr -t tcp -p 8765 -m QM2 &
    

The following shows endpoint URL for the objects created in these examples, with “myhost” as the hostname:

ibm_mq:CH1/tcp/myhost(8765)?qmgr=QM1,queue=Q1




Copyright © 2005. Sybase Inc. All rights reserved. Known problems with RTDS using Adaptive Server

View this release bulletin as PDF