ZCOM C I/F Library Routines

 

 

LTQDPUT (3X)

PARAMETERS

 

 

 

zap

ZCOM address of the terminal ZLU to store data

 

 

into.

 

queue

Terminal data queue number (specifies which

 

 

data queue is to be used):

 

 

0 - Sub-packet holding queue (reserved)

 

 

1 - Data holding queue A

 

 

2 - Data holding queue B

 

 

3 - Data holding queue C

 

 

4 - Data holding queue D

 

ibuf

Data buffer to be stored.

 

len

Length in bytes of ibuf.

NOTES

Normally, the data queue number used should be allocated by ZMON

 

(see the man page for zltqueue on how to get a data queue number).

 

There is no queue ownership validation within this routine; it is up to the

 

user to make sure that the queue usage is valid and consistent.

RETURN VALUE

Routine ltqdput returns 0 if successful. Otherwise, a non-zeroerror

 

code is returned. See /opt/acc/include/zcom/zcomsys.h for the list of

 

ZCOM error codes and their meanings.

EXAMPLE

#include

<zcom/zcomsys.h>

 

#include

<zcom/zcomcall.h>

 

int32

ierr;

 

zaddr_type

zaddr;

 

uint32

queue;

 

char

ibuf[size];

 

int32

len;

if (ierr = ltqdput (&zaddr, queue, ibuf, len)) { /* error return code */

}

else {

/* good return code */

}

Chapter 4

157