put

Name

putdb, putsdb, putkdb — Write datasets to database

Synopsis

subroutine putdb(handle,name,idiv,buffer,type,size,status)
integer*4 handle
character*(*) name
integer*4 idiv
integer*4 | integer*8 buffer(*)
real*4 | real*8 buffer(*)
complex real*4 | complex real*8 buffer(*)
character*4 type
integer*4 size
integer*4 status

subroutine putsdb(handle,name,ipos,buffer,type,size,status)
integer*4 handle
character*(*) name
integer*4 ipos
integer*4 | integer*8 buffer(*)
real*4 | real*8 buffer(*)
complex real*4 | complex real*8 buffer(*)
character*4 type
integer*4 size
integer*4 status

subroutine putkdb(handle,name,idiv,buffer,type,size,status)
integer*4 handle
character*(*) name
integer*4 idiv
character*(*) buffer
character*4 type
integer*4 size
integer*4 status

Description

The putdb functions transfer the content of buffer to a dataset name on a database identified by handle. If the sub-division index idiv is set to 0, the sub-division structure is ignored. If idiv > 0, the idiv^th sub-division will be addressed if the set has been initialized with dssdb. If not, an error is reported.

putsdb transfers the content of bufferr to a relative position of a dataset name on a database identified by handle. size data elements of the buffer are transferred to the database starting at the dataset offset ipos. ipos is counted in data elements, the count starting with 1. putsdb only works for dataset types I, J, E, C, F, Z, and U. putsdb does not support K sets (characters).

putkdb transfers the content of the character string buffer to a dataset. putkdb only works for dataset types K (character strings).

Parameters

handle: Database handle (input). The file handle handle may not exceed the maximum number of simultaneously open databases.
name: Name of dataset (input). The string may not exceed the maximum dataset name length.
idiv: Sub-division number (input). idiv must be greater than or equal to 0.
buffer: Data buffer from which data are copied to the database.
type: Dataset type (input). Dummy variable in case of putkdb.
ipos: Dataset offset, count starting at relative word address 1 (input). putsdb only.
size: Number of data elements to be transferred (input).
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.