17.10 - Interface with the Data Connector - Access Module

Teradata® Tools and Utilities Access Module Reference

Product
Access Module
Release Number
17.10
Published
October 2021
Language
English (United States)
Last Update
2021-11-02
dita:mapPath
uur1608578381725.ditamap
dita:ditavalPath
obe1474387269547.ditaval
The Teradata Access Module for JMS must provide a main function called PIDMMain(), which is called by the Data Connector to request I/O operations. This function contains two parameters, opts and OptParms:
void PIDMMain (pmiCmdBlock_t *Opts, void *OptParms)
  • opts – Specifies one of the access module functions in the following table.
  • OptParms – Contains context specific information for each of the functions specified in the table.
Opts Parameter Values for PIDMMain
Access Module Function Description
Access Module Initialization Initializes the Teradata Access Module for JMS and parses the initialization string.
Access Module Identification Identifies the Teradata Access Module for JMS and version.
File Open Opens the queue or topic connection.
File Close Closes the queue or topic connection.
File Read Gets and processes data messages from a specified queue or topic.
File Write Puts and processes data messages to a specified queue or topic.
File Get Position Returns the current position of a data file for checkpoint and restart purposes.
File Set Position Restart at a given point of a data file for checkpoint and restart purposes.
Get Attribute Returns an attribute to the Teradata load/export utilities. Primarily for exchanging information between the Teradata Access Module for JMS and the load/export utilities.
Put Attribute Sends an attribute to the Teradata Access Module for JMS. This is for exchanging information.
Shutdown Terminates the access module.