File_Field_Pointer_Entry - DataDictionary
Called to move data from an entry source to the DataDictionary (DD) extended buffer
Type: Procedure Set
Parameters
| Parameter | Type | Description |
|---|---|---|
| iFile | Integer | Number of the table in the current filelist |
| iField | Integer | Number of the field in the table |
| iLen | Integer | Length of pData |
| bShowErr | Integer | Determines whether to display errors |
| pData | Address | Address of data to set |
Syntax
Procedure Set File_Field_Pointer_Entry Integer iFile Integer iField Integer iLen Integer bShowErr Address pData
Call Example
Set File_Field_Pointer_Entry iFile iField iLen bShowErr pData
Description
The File_Field_Pointer_Entry procedure is called to move data from an entry source to the DataDictionary (DD) extended buffer. This is identical to the File_Field_Entry message except that a pointer to the data is passed instead of the data itself.
You should rarely need to use this method. The File_Field_Entry method will also move data to an extended field as required (if the field type needs an extended field and extended fields are defined in the DD). For example, if you are need to pass a string value to a comment field you could simply use File_Field_Entry as follows:
Set File_Field_Entry of hDD iCustFile iCustCommentField True to sComment
You will only use File_Field_Pointer_Entry when the data you need to pass data from memory.
Set File_Field_Pointer_Entry of hDD iCustFile iCustCommentField iLengthOfData True to pCommentPointer
See Also