Documentation Issues and Updates for Sybase Mobile SDK

• The public keys need to be encapsulated in a PEM encoded X509 certificate and be supplied with an E2EE private key.
• This certificate needs to be included in the Resource folder in the application Xcode project.
• The e2ee_public_key option needs to be specified in the network stream parameter, either in SCC Application Connection Properties, or in the application code.

• Trusted certificates need to be included into the Resource folder in the application Xcode project.
• The trusted_certificates option needs to be specified in the network stream parameter, either in SCC Application Connection Properties, or in the application code.

SUPConnectionProfile *sp = [SUP101SUP101DB getSynchronizationProfile];
[sp setNetworkStreamParams:@"e2ee_public_key=publickeyCertificate;trusted_certificates=trustedCertificate"];

• Android and BlackBerry –

  SUP101DB.getConnectionProfile().setProperty("allowConcurrentWrite", "true"); 

• iOS –

  [ [SUP101DB getConnectionProfile]  setBoolean:@"allowConcurrentWrite"
        :YES]; 

• WindowsMobile –

  SUP101DB.GetConnectionProfile().SetProperty("allowConcurrentWrite", "true"); 

• 1 = Tracing is disabled
• 3 = SQL Trace without payload
• 5 = SQL Trace with payload (values displayed)

• Via Sybase Control Center through the Applications folders:
  1. Click on the Applications folder in the Sybase Unwired Platform Cluster frame.
  2. In the Applications tab, select the application you wish to enable tracing for.
  3. Select the Application Connections tab and select the user you wish to enable tracing for.
  4. Click on the Properties button to open the Application Connection Properties window.
  5. Click on Device Advanced to display advanced connection properties.
  6. Change the value of the Device Level Trace property to the appropriate level.
  7. Click OK to save your changes.
• Via code by calling the appropriate API for your platform:
  • iOS – in the SUPConnectionProfile class, there are two APIs that can be used:

    - (void) enableTrace:(BOOL)enable
    - (void) enableTrace:(BOOL)enable withPayload:(BOOL)withPayload

    The application in the initialization code can invoke these APIs to enable/disable tracing:

    SUPConnectionProfile *cp = [SUP101SUP101DB getConnectionProfile];
    
    // To enable trace of client database operations (SQL statements, etc.)
    [cp enableTrace:YES];
    
    // To enable trace of client database operations with values also displayed
    [cp enableTrace:YES withPayload:YES];
    
    // To disable trace of client database operations
    [cp enableTrace:NO];
    
    // To enable trace of message headers sent to the server and received from the server
    // (this replaces the MBODebugLogger and MBODebugSettings used in earlier versions of SUP)
    [cp.syncProfile enableTrace:YES];
    
    // To enable trace of both message headers and content, including credentials
    [cp.syncProfile enableTrace:YES withPayload:YES];
    
    // To disable messaging trace
    [cp.syncProfile enableTrace:NO];
    

  • Android and BlackBerry – in the ConnectionProfile class, there are two APIs that can be used:

    - enableTrace(boolean enable)
    - enableTrace(boolean enable, boolean with Payload)

    The application in the initialization code can invoke these APIs to enable/disable tracing:

    ConnectionProfile *cp = SUP101DB.getConnectionProfile();
    
    // To enable trace of client database operations (SQL statements, etc.)
    cp enableTrace(true);
    
    // To enable trace of client database operations with values also displayed
    cp enableTrace(true, true);
    
    // To disable trace of client database operations
    cp enableTrace(false);
    

  • Windows and Windows Mobile – in the ConnectionProfile class, there are two APIs that can be used:

    - EnableTrace(bool enable)
    - EnableTrace(bool enable, bool withPayload)

    The application in the initialization code can invoke these APIs to enable/disable tracing:

    ConnectionProfile cp = SampleDB.GetConnectionProfile();
    
    // To enable trace of client database operations (SQL statements, etc.)
    cp.EnableTrace(true);
    
    // To enable trace of client database operations with values also displayed
    cp.EnableTrace(true, true);
    
    // To disable trace of client database operations
    cp.EnableTrace(false);