Direct Results Access

PCL Reference Manual > Results Postprocessing Functions > Direct Results Access

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">


res_dra_get_res_file_by_name	(szFilename,iSourceFileId,iFileType,iParamSetId)


Description:
This function returns information about an attached file.
Input:
STRING	szFileName [max 256]	The attached source file name.
Output:
INTEGER	iSourceFileId	Internal database ID of the attached file.
INTEGER	iFileType	Internal handle not intended for usage for the PCL programmer.
INTEGER	iParamSetId	Internal handle not intended for usage for the PCL programmer.
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
MSG_RES_CANNOTOPENFILE – File does not exist. MSG_RES_DRA_SRC_FILE_UNKNOWN – Filename not saved in the Patran database.

Remarks:

This function is to be used to retrieve information needed to call the res_dra_detach_file. The undocumentred parameters are not to be used anywhere as their values are internal to DRA and they are subject to change without any notification.

Example:

None .


res_dra_detach_file	(src_file_id,result_type,paramrset_id)


Description:
This function returns information about an attached file.
Input:
Output:
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
None.

Remarks:

This function is to be uszed in conjuction with “res_dra_get_res_file_by_name” to automate the process of detaching various attached files.

Example:

None.


res_data_function	(register, location, register_type, function)


Description:
This function specifies a format function used to determine the data values of a register.
Input:
Output:
INTEGER	<Return Value>	This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
None.

Remarks:

The registers specified in the function must be of the same location and type and must have been previously loaded with a res_data_load() function.

Example:

None.