wa

Name

wtwadb, rdwadb, putwadb, getwadb — Low-level word-addressable input/output mode

Synopsis

subroutine wtwadb(handle,buffer,ipos,size,status)
integer*4 handle
character*(*) buffer
integer*4 ipos
integer*4 size
integer*4 status

subroutine rdwadb(handle,buffer,ipos,size,status)
integer*4 handle
character*(*) buffer
integer*4 ipos
integer*4 size
integer*4 status

subroutine putwadb(handle,buffer,ipos,type,size,status)
integer*4 handle
character*(*) buffer
integer*4 ipos
character*4 type
integer*4 size
integer*4 status

subroutine getwadb(handle,buffer,ipos,type,size,status
integer*4 handle
character*(*) buffer
integer*4 ipos
character*4 type
integer*4 size
integer*4 status)

Description

wtwadb writes size integer*4 words from buffer to a MemCom database identified by handle, starting at the file word address ipos. wtwadb works in buffered and in unbuffered mode. No data conversion is made, i.e data are transferred in raw mode. rdwadb reads size integer*4 words from a MemCom database identified by handle to buffer, starting at the file word address ipos. rdwadb works in buffered and in unbuffered mode. No data conversion is made, i.e data are transferred in raw mode.

putwadb writes size data elements from buffer to a MemCom database identified by handle. getwadb readssize data elements from a MemCom database identified by handle to buffer, starting at the file word address ipos.

Warning

	Warning
The word address may not be determined by the application, i.e MemCom will determine where to append new data. This is accomplished by setting `ipos` to 0 before calling `wtwadb` or `putwadb`. Forcing `ipos` to a value when calling `wtwadb` or `putwadb` can destroy the database. These functions work with integer*4 (not byte) file address units ('words'), starting at word count 1. Thus, they are compatible with MemCom 6.

The word address may not be determined by the application, i.e MemCom will determine where to append new data. This is accomplished by setting ipos to 0 before calling wtwadb or putwadb. Forcing ipos to a value when calling wtwadb or putwadb can destroy the database.

These functions work with integer*4 (not byte) file address units ('words'), starting at word count 1. Thus, they are compatible with MemCom 6.

Parameters

handle: Database handle (input). The file handle handle may not exceed the maximum number of simultaneously open databases.
buffer: Data array (input,output).
ipos: integer*4 word address on database (input/output) where read/write starts. If ipos is set to 0 before calling, data will be appended to the end of the database nd the start word address will be returned in ipos.
type: Dataset type (input).
size: Number of data elements to be transferred (input). For functions wtwadb and rdwadb, size is counted in integer*4 words. For functions putwadb and getwadb, size is counted in data elements.
status: Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected. A positive value is returned, if a warning has been issued. See MemCom error codes.