Difference between revisions of "Truxton etl set queue name"

From truxwiki.com
Jump to navigation Jump to search
Line 3: Line 3:
 
=Syntax=
 
=Syntax=
 
<syntaxhighlight lang="C">
 
<syntaxhighlight lang="C">
void truxton_etl_set_queue_name( uint64_t etl_handle, char const * name )
+
void truxton_etl_set_queue_name( uint64_t etl_handle, char const * name );
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
=Parameters=
 
=Parameters=
 
==<code>etl_handle</code>==
 
==<code>etl_handle</code>==
 
 
The handle created by the [[truxton_etl_create]] call.
 
The handle created by the [[truxton_etl_create]] call.
  
Line 19: Line 18:
  
 
=Sample=
 
=Sample=
 
 
<syntaxhighlight lang="C" highlight="15">
 
<syntaxhighlight lang="C" highlight="15">
 
#include <TruxtonCAPI.h>
 
#include <TruxtonCAPI.h>

Revision as of 06:51, 10 June 2020

This tells Truxton which message queue to wait for messages for this ETL.

Syntax

void truxton_etl_set_queue_name( uint64_t etl_handle, char const * name );

Parameters

etl_handle

The handle created by the truxton_etl_create call.

name

A short human readable string that will be used as the message queue name.

Remarks

This name will be normalized to all lower case letters with spaces removed. "My Queue" will be normalized to "myqueue"

Sample

#include <TruxtonCAPI.h>

void main( void )
{
    char file_id[ 65 ];
    char description[ 128 ];

    int exit_loop = 0;

    uint64_t message = 0;
    uint64_t app = truxton_etl_create();

    truxton_etl_set_application_name( app, "Sample C ETL" );
    truxton_etl_set_depot_type_name( app, "custom" );
    truxton_etl_set_queue_name( app, "SampleC" );

    truxton_etl_set_description( app, "A sample of how to write an ETL");
    truxton_etl_get_description( app, description, sizeof(description));

    while( exit_loop == 0 )
    {
        message = truxton_etl_get_message( app );

        if ( message != 0 )
        {
            // Do something with the message

            memset( file_id, 0x00, sizeof( file_id ) );
            truxton_message_get_file_id( message, file_id, sizeof( file_id ) );

            printf( "Received file id %s\n", file_id );

            truxton_message_destroy( message );
        }
        else
        {
            exit_loop = 1;
        }
    }
}