Tracelink

Functions
TCCORE_API int	TL_find_in_context_trace_links_for_complying (tag_t bom_window, int *tracelink_count, tag_t **bom_lines, tag_t **tracelinks)
TCCORE_API int	TL_find_in_context_trace_links_for_defining (tag_t bom_window, int *tracelink_count, tag_t **bom_lines, tag_t **tracelinks)
TCCORE_API int	TL_find_trace_links_for_complying (tag_t target, int *tracelink_count, tag_t **tracelink_tags)
TCCORE_API int	TL_find_trace_links_for_defining (tag_t source, int *tracelink_count, tag_t **tracelink_tags)

Detailed Description

This module defines the required ITK interface for Tracelink related operations.

Function Documentation

TCCORE_API int TL_find_in_context_trace_links_for_complying	(	tag_t	bom_window,
		int *	tracelink_count,
		tag_t **	bom_lines,
		tag_t **	tracelinks
	)

Searches all the in-context Tracelinks present under the TopLine of given BOM Window, only the Tracelinks from complying end will be returned.
It will return only the Tracelinks which are created in context of topline of given BOM Window. User needs to provide the configured BOM Window as input and Tracelinks will be returned on that configured structure only.

Returns

• ITK_ok on success
• TL_null_value_passed, if bom_window object is NULLTAG or invalid.

Parameters

bom_window	(I) Configured BOM Window tag
tracelink_count	(O) Count of Tracelinks present under BOM Window considering top line as context line
bom_lines	(OF) tracelink_count List of bom line tags where Tracelinks are present
tracelinks	(OF) tracelink_count List of Tracelinks present for each BOM Line in bom_lines there is one to one mapping between bom_lines and tracelinks

TCCORE_API int TL_find_in_context_trace_links_for_defining	(	tag_t	bom_window,
		int *	tracelink_count,
		tag_t **	bom_lines,
		tag_t **	tracelinks
	)

Searches all the in-context Tracelinks present under the TopLine of given BOM Window, only the Tracelinks from defining end will be returned.
It will return only the Tracelinks which are created in context of topline of given BOM Window. User needs to provide the configured BOM Window as input and Tracelinks will be returned on that configured structure only.

Returns

• ITK_ok on success
• TL_null_value_passed, if bom_window object is NULLTAG or invalid.

Parameters

bom_window	(I) Configured BOM Window tag
tracelink_count	(O) Count of Tracelinks present under BOM Window considering top line as context line
bom_lines	(OF) tracelink_count List of BOM Line tags where Tracelinks are present
tracelinks	(OF) tracelink_count List of Tracelinks present for each BOM Line in bom_lines there is one to one mapping between bom_lines and tracelinks

TCCORE_API int TL_find_trace_links_for_complying	(	tag_t	target,
		int *	tracelink_count,
		tag_t **	tracelink_tags
	)

Searches for all Tracelink objects in the database that point to the given complying tags.
The target object can either be a BOM Line or the secondary object of Tracelink, which can be Workspace object or Absoccdata.

Returns

• ITK_ok on success
• GRM_invalid_secondary_object, if target is NULLTAG or invalid.

Parameters

target	(I) Tracelink target tag
tracelink_count	(O) Number of Tracelinks found
tracelink_tags	(OF) tracelink_count The found Tracelink objects

TCCORE_API int TL_find_trace_links_for_defining	(	tag_t	source,
		int *	tracelink_count,
		tag_t **	tracelink_tags
	)

Searches all Tracelink objects in the database that point to the given defining tags.
The source object can either be a BOM Line or the primary object of Tracelink, which can be Workspace object or Absoccdata.

Returns

• ITK_ok on success
• GRM_invalid_primary_object, if source is NULLTAG or invalid.

Parameters

source	(I) Tracelink source tag
tracelink_count	(O) Number of Tracelinks found
tracelink_tags	(OF) tracelink_count The found Tracelink objects