ANSI C, C++

#include <dcist.h>
int  dc_ist_read (int istid, struct DC_ISTKEY *keyptr,
                  int keyno, char *bufadr, int bufsize,
                  DCLONG flags)

K&R C

#include <dcist.h>
int  dc_ist_read (istid, keyptr, keyno, bufadr, bufsize,
                  flags)
int        istid;
struct  DC_ISTKEY  *keyptr;
int        keyno;
char       *bufadr;
int        bufsize;
DCLONG     flags;

The function dc_ist_read() inputs a record in a specified range from a specified internode shared table. If multiple records are collectively specified and an error occurs with any of the specified records, the function dc_ist_read() returns with an error without inputting the records to the input buffer.

When inputting an internode shared table record, specify the table descriptor which is the return value of the function dc_ist_open().

istid

Specify the table descriptor of the internode shared table to be accessed.

keyptr

Specify the address of the structure (IST key) indicating the range of the relative record numbers of the record to be referenced. For the structure, specify the record range with the first and last relative block numbers. The structure formats are as follows:

struct  DC_ISTKEY {
                   int  fstrecno;
                   int  endrecno;
                   };

• fstrecno
  Specify the first relative record number of the record to be accessed.
  
• endrecno
  Specify the last relative record number of the record to be accessed. If 0 is specified, only the record with the relative record number specified with fstrecno is input.
  

keyno

Specify the number of structures (number of arrays in the structure) to be specified for keyptr.

bufadr

Specify the input buffer address.

bufsize

Specify the input buffer length. The value must be (input record length x number of input records) or greater.

flags

Specify DCNOFLAGS.