1.Functional Description
This function is used to build a linked list of the child/parent Item hierarchy for a given Component
Item and Branch from the Pegging table (F3412). After the original list is built, the function
assigns a level number to each node in the list. The function should be called multiple times for a given
component so that the function can determine if additional branches exist in the tree due to a node in
the list having multiple parents. On subsequent calls, the function will recurse through all
branches of the child/parent tree and update the list for each branch. New child/parent level values are
assigned each time the list is modified.
1.1Purpose
The purpose of this function is to build a linked list of each child/parent hierarchy path for a
given Component Item and Branch from the Lower Level Requirements table (F3412). As each path is
traversed and stored in a linked list, the function assigns level values to each record. The calling
application can use GetPeggingChildParentNode to retrieve the records sequentially from the list built by this
function.
1.2Setup Notes and Prerequisites
• Initially, this function should be called with the Pass parameter = '1'. After the initial
child/parent linked list is returned, the function should be called again with Pass = '2' until the function
returns End Of Parent Search = '1'. This signals that all child/parent branches for this Component
have been traversed and returned.
• The calling application must call the business function FreeHUserAndHRequest (C4102A1) to release
the User handle allocated by the function.
1.3Special Logic
This function will not trace a child/parent branch past the 25th level. Therefore, the linked list
will contain a maximum of 25 nodes.
2.Technical Specifications
Wk Linked List = Linked List Ptr
End Of Records = '0'
If Wk Linked List <> NULL
If Pass = '1'
Wk Node = the first node in the list
Pass = '2'
Else
Wk Node = the next node in the list
EndIf
Create a string for the level value saved in Wk Node. Look at Indent Level Flag to determine
how to format the level string.
Copy the Pegging record values from Wk Node to the output fields
If List Current Node Ptr = the last node in the list
End Of Records = '1'
EndIf
EndIf
^
D3400350 - Get Pegging Child Parent Structure
Data Item Data Structure DescriptionI/ORequiredNotes
ITM Short Item Number I/OY
MCU Business Unit IY
KIT Parent Item Number I/OY
EV01 Indent Level Flag I
EV01 Pass I/OY '1' = Build a new list for
the given component '2' = Use
the existing list and check for
different branches
GENLNG hUser Pointer I/OY
GENLNG Linked List Ptr I/OY
EV03 Suppress Error Messages I '1' = Suppress run time error
message
handling '0' = Allow run time error
message handling
INDL Level O Level value as string
EV02 End Of Parent Search O '1' = End of the child/parent
search reached '0' = Continue
checking child/parent
hierarchy
EV03 End Of Records O
DTAI Error Message ID O
^
| Parameter Name | Data Item | Data Type | Req/Opt | I/O/Both |
|---|---|---|---|---|
| mnShortItemNumber | ITM | MATH_NUMERIC | NONE | NONE |
An inventory item number. The system provides three separate item numbers plus an extensive cross-reference capability to other item
| ||||
| szBusinessUnit | MCU | char | NONE | NONE |
An alphanumeric code that identifies a separate entity within a business for which you want to track costs. For example, a business unit
| ||||
| mnParentItemNumber | KIT | MATH_NUMERIC | NONE | NONE |
The system provides for three separate item numbers.
1. Item Number (short) - An eight-digit, computer assigned, completely
| ||||
| cIndentLevelFlag | EV01 | char | NONE | NONE |
An option that specifies the type of processing for an event. | ||||
| cPass | EV01 | char | NONE | NONE |
An option that specifies the type of processing for an event. | ||||
| idhUserPtr | GENLNG | ID | NONE | NONE |
General purpose ID variable. | ||||
| idLinkedListPtr | GENLNG | ID | NONE | NONE |
General purpose ID variable. | ||||
| cSuppressErrorMessages | EV03 | char | NONE | NONE |
A radio button that specifies the level at which trace/track result is to be displayed. Select the Detail to display all transactions except IB, IX,
| ||||
| szLevel | INDL | char | NONE | NONE |
A number indicating the level of a child in the relationship to its parent in a hierarchy. | ||||
| cEndOfParentSearch | EV02 | char | NONE | NONE |
An option that specifies the type of processing for an event. | ||||
| cEndOfRecords | EV04 | char | NONE | NONE |
PeopleSoft event point processing flag 04. | ||||
| szErrorMessageID | DTAI | char | NONE | NONE |
A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or
| ||||
| None |
| None |