Name

DECEDI_TRACK − This enables the caller to track objects within the DEC/EDI Server. It can provide lists of objects that match certain selection criteria, and it can return different types of information for the objects that meet the selection criteria, for example routing information or object status. 

 
The Track command can track only one kind of object at a time. The type of object being tracked must be specified and may be one of the following:
 

•Application_file -- files that have been posted or fetched via the Mapper on the Server. These files are also known as Structured files. 
 
 

•Transmission_file -- files that have been sent or received via the Communications Service on the Server, or are waiting to be sent via the Communications Service. These files are also known as Unstructured files. 
 
 

•Document -- files that have gone through or are waiting to go through the Translation Service on the Server. This also includes documents that are involved in Application-to-application agreements. These files are also known as ’ihf’ files. 
 

C Binding

 #include    <decedi_api_def.h>
 unsigned long int DECEDI_TRACK (application,
                                filters,
                                match_count,
                                selections,
                                results)
  char                    ∗application;
decedi_t_item_list      filters;
unsigned long int       ∗match_count;
decedi_t_item_list      selections;
decedi_t_track_list     ∗results;

Arguments

application
The name of the client application submitting the request to the Server.  This is a null-terminated character string. This argument is used by DEC/EDI as a means of authenticating the request; the client application must be registered as an authorized application on the Server. Applications are registered by using the CommandCenter Management Services editor. For more information, refer to DEC/EDI Configuring.
 
 

filters
An item list specifying the selection criteria for the objects that are to be tracked. Build up the item list using one or more calls to DECEDI_ADD_ITEM_LIST. The valid item identifier values allowed in the item list for this request are given in Table 1. If no filters are specified then all objects are selected.
 

Table 1: DECEDI_TRACK Object Selection Criteria

Table 2: DECEDI_TRACK Object Status Values

Table 3: DECEDI_TRACK Object Direction Values

Table 4: DECEDI_TRACK Object Database Values

Table 5: DECEDI_TRACK Object Standard Values

Table 6: DECEDI_TRACK Object Test Indicator

Table 7: Values for File Type

match count
This parameter returns the number of matches found.
 

selections
An item list specifying the type of data to return to the caller. The item identifier values allowed in the item list for this request are given in Table 8. If not specified then only the number of objects in the system is returned.

No value is associated with any of the identifiers in Table 8. 
 

Table 8: Selection Identifiers

results
A dynamic list structure that is returned on completion with the object data requested. Deallocate the list’s memory using DECEDI_FREE_TRACK_LIST.
 
 
 

Description

 
 
This routine issues a request to the Server to fetch details of one or more objects in the DEC/EDI system. It returns data for only those objects that match the selection criteria.
 

 
Build this request using one or more calls to DECEDI_ADD_ITEM_LIST.  Once this call has been completed, you can release the associated item lists using DECEDI_FREE_ITEM_LIST.
 

 
The results, if any have been requested, are placed in a dynamically allocated list. Once all the results have been processed, free this list using DECEDI_FREE_TRACK_LIST.
 
 

Return Values

DECEDI_BADITMLST
The request was rejected as the call had invalid, or missing item lists.
 

DECEDI_BADPARAM
The request was rejected as the call had invalid, or missing parameters.
 

DECEDI_INSUFVMInsufficient virtual memory available to complete request. 
 

DECEDI_INTERROR
Internal error.
 

DECEDI_NOCLIENTLIC
No active client license was found.
 

DECEDI_ORBBADNODE
Bad server selection node.
 

DECEDI_ORBBUSYObjectBroker busy. 
 

DECEDI_ORBCOMMFAIL
Communications to server failed.
 

DECEDI_ORBDOWN
ObjectBroker not running.
 

DECEDI_ORBERROR
ObjectBroker failure.
 

DECEDI_ORBSAKERR
ObjectBroker "SAK" error.
 

DECEDI_ORBSRVDIED
Server process died.
 

DECEDI_ORBSRVNOTFND
No server found.
 

DECEDI_ORBTIMEOUT
Server timeout.
 

DECEDI_ORBVERMISM
ObjectBroker version mismatch.
 

DECEDI_SUCCESSThe request was successfully processed by the server. 
 
 
 
 

Example

  #include    <decedi_api_def.h>
 unsigned long int status;
decedi_t_item_list filters = (decedi_t_item_list) NULL;
decedi_t_item_list selections = (decedi_t_item_list) NULL;
decedi_t_track_list ∗results;
decedi_t_ulong status_value = DECEDI_AVAILABLE;
decedi_t_ulong ∗match_count
 status = DECEDI_ADD_ITEM_LIST (&filters,
             (unsigned long int) DECEDI_ITM_APPLICATION_NAME,
             (unsigned long int) DECEDI_STRING,
             (unsigned long int) strlen("MY-APPLICATION"),
             (char ∗) "MY-APPLICATION",
             (unsigned long int DECEDI_READ_ONLY);
if (status != DECEDI_SUCCESS)
{
}
 status = DECEDI_ADD_ITEM_LIST (&filters,
                     (unsigned long int) DECEDI_ITM_CURRENT_STATUS,
                     (unsigned long int) DECEDI_UINTEGER,
                     (unsigned long int) sizeof(status_value),
                     (char ∗) &status_value,
                     (unsigned long int DECEDI_READ_ONLY);
 if (status != DECEDI_SUCCESS)
{
}
 status = DECEDI_ADD_ITEM_LIST (&selections,
                     (unsigned long int) DECEDI_SEL_TRACKING_REFERENCE,
                     (unsigned long int) DECEDI_UINTEGER,
                     (unsigned long int DECEDI_READ_ONLY,
                     (char ∗) NULL,
                     (unsigned long int DECEDI_READ_ONLY);
 if (status != DECEDI_SUCCESS)
{
}
 status = DECEDI_TRACK ( "MY-APPLICATION",   /∗ Application name ∗/
                        filters,            /∗ Filters ∗/
                        &match_count,       /∗ Number of matches found ∗/
                        selections,         /∗ Data required ∗/
                        &results            /∗ Returned results ∗/
                        );
 status = DECEDI_FREE_ITEM_LIST (&selections);
 status = DECEDI_FREE_ITEM_LIST (&filters);
 status = DECEDI_FREE_TRACK_LIST (&results);