ASPEN_GetInstrumentNumber

 

Related Topics

 

 

Purpose

Look up a financial instrument’s inum in a Server's database.

 

 

Call Syntax

#include <aspen.h>

AspenRequest(GLOBAL_session, ASPEN_GetInstrumentNumber, symbol, &insNumber);

 

 

Parameters

Input

The input parameter for this service is a pointer to a null terminated character string that contains the symbol whose instrument number will be returned.

 

Output

The output parameter for this service is a pointer to a 32-bit (long int) created using the ASPEN_INUM data type. This pointer receives the instrument number.

 

 

Structures

None.

 

 

Remarks

ASPEN_GetInstrumentNumber provides a service for searching a Server's master table (MTAB.DAT file) of financial instruments. The search looks for the ticker symbol provided. Additional information about a ticker symbol is available by calling AspenRequest() with the ASPEN_GetInstrumentInfo service.

 

 

Return Value

ASPEN_OK

a financial instrument whose symbol matches input was found and it's instrument number was successfully returned.

ASPEN_SV_NO_SYMBOL

The ticker symbol could not be found.

 

 

See Also

ASPEN_GetInstrumentInfo

AspenRequest()

ASPEN_INUM

 

 

Example

int CAspenRequestDlg::DoASPEN_GetInstrumentNumber(){

   server_list *slp = list;

   int retval;

   char symb[40];

 

   strcpy(symb,strSymb);

   retval = AspenRequest(slp->server_session, ASPEN_GetInstrumentNumber, symb, &a_inum);

   return retval;

}

 

©2006 Aspen Research Group, Ltd. All rights reserved. Terms of Use.