Universal Programming, Inc.


Product Data Sheet

MCNET - TCP/IP Applications Programming Interface to Modcomp Max Systems

MCNET software API and server toolkit provide client applications in Windows NT, OpenVMS , or UNIX environment high volume TCP/IP access to Modcomp Max IV or Max 32 based global commons, RAD files, disk partitions, and other applications data. These Modcomp systems should be equipped with Logical Data Corporationís IPC Model 3210 TCP/IP support.

MCNET API functions communicate with a server task in the Modcomp providing real time read/write access to Modcomp data. These functions perform task to task communications with the server using TCP/IP by way of IPC socketed logical devices, providing an extremely reliable, efficient, and flexible method of accessing Modcomp data.

The MCNET API for Windows is provided as a 32 bit DLL, while the OpenVMS or UNIX API is provided as C/C++ subroutine library. Client applications may be written in C/C++, Visual C++, Visual Basic, Access Basic, Power Builder , or any other applications builder which can call the MCNET API functions.

The Modcomp server task comes off the shelf as binary object code or optionally a complete FORTRAN coded server source package supporting MAX global shared memory region, RAD file, and disk partition read/write access for a configurable number of client socket connections. Coding techniques employed provide compatibility with FORTRAN 66 or 77, running on either 16 or 32 bit MAX operating systems.

Configuration of the Modcomp server task is specified in a BLOCK DATA subprogram, an associated task build procedure, and a MAX IV/32 SYSGEN. This configuration predefines all shared regions and sockets that may be accessed by MCNET clients. Hooks are provided to enable access to virtually any conceivable data source in the Modcomp.

Data Access Specification

Data access requests from a client are specified using a string that identifies the data type, data area, data area identifier, start index, and number of data elements.

i.e. F,GSR,PVTBL,3,4

This definition will access four floating point elements in global shared region PVTBL ( points 3 through 6, words 6-13 ). For client read operations, the conversion performed will be from Modcomp real*4 to Clientís native real*4 notation.

I,RAD,375,1,200

This definition is a request to access record number 1 of RAD file 375 as 16 bit integers. Logical record blocking is 200 integer words per record.

MCNET API functions

mcnet_start

start a session

mcnet_stop

stop a session

mcnet_connect

connect to Modcomp server for read/write access

mcnet_disconnect

disconnect from Modcomp server

mcnet_read

read and convert data from a Modcomp

mcnet_read_with_status

read and convert data (with quality) from a Modcomp

mcnet_write

format and send data to a Modcomp

mcnet_write_with_status

format and send data ( with quality ) to a Modcomp

mcnet_waitio

performs timed wait for a read/write function to complete

mcnet_geterror

returns the latest known error code for the connection

mcnet_remoteerror

returns the latest known error code from a remote Max server

mcnet_getstatus

returns the latest known error code for the session

mcnet_getbusy

returns the busy status for the connection

mcnet_socketerror

returns the latest known error from accessing the socket library

mcnet_computedcount

returns the latest computed data byte count to send or receive

mcnet_errortext

returns a short descriptive string for an error code

mcnet_socketerrortext

returns a descriptive string for an error code generated by a network error

mcnet_setremotefloat

sets the format of the floating point data for the remote host

mcnet_getremotefloat

returns a code for the format of the floating point data for the remote host.

mcnet_getarea

returns a code for the data area used for the most recent data access

mcnet_gettype

returns a code for the data type used for the most recent data access

mcnet_getfunc

returns a code for the function code used on the most recent data access

mcnet_mcf2ieee

converts a buffer of Modcomp floating point data to IEEE notation

mcnet_ieee2mcf

converts a buffer of IEEE floating point data to Modcomp floating point

mcnet_ntohl

converts a buffer with long (32-bit integer) values from network byte order to host (native) byte order

mcnet_htonl

converts a buffer with long (32-bit integer) values from host (native) byte order to network byte order

mcnet_ntohs

converts a buffer with short (16-bit integer) values from network byte order to host (native) byte order

mcnet_htons

function converts a buffer with short (16-bit integer) values from host (native) byte order to network byte order

mcnet_version

returns a descriptive string for the version of MCNET that is being used

mcnet_setoffset

sets a word offset to be applied to the calculated offset for all GSR accesses.

mcnet_setminrec

sets the minimum record number (e.g., ptid) for GSR references

mcnet_setmaxrec

sets the maximum record number (e.g., ptid) so record numbers within a GSR can be validated

 

Currently Available API Implementations

Window NT or later(OPC),  AIX,  Hp UX, OpenVMS, Linux

 

Ordering Information - Basic MCNET Package

MCNET API

Specify Target OS & hardware

contact us

per client cpu

MCNET Max IV or 32 Server Object Code

Specify Target OS & concurrent users

contact us

per server cpu

For more information,

Contact Universal Programming today:
mailto:info@uniprog.com