ANSI C, C++

#include <xatmi.h>
long tptypes (char *ptr, char *type, char *subtype)

K&R C

#include <xatmi.h>
long tptypes (ptr, type, subtype)
char    *ptr;
char    *type;
char    *subtype;

The function tptypes() takes as its first argument a pointer to a data buffer and returns the type and subtype of that buffer in its second and third arguments, respectively. ptr must point to a buffer obtained from tpalloc(). If type and subtype are non-NULL, the function populates the character arrays to which they point with the names of the buffer's type and subtype, respectively. If the names are of their maximum length (8 for type, 16 for subtype), the character array is not null-terminated. If no subtype exists, then the array pointed to by subtype contains a NULL string ("").

Note that only the first eight bytes of type and the first 16 bytes of subtype are populated.

<<ptr

Specify the pointer to the buffer.>>

<<type

Specify the pointer to the buffer type.>>

<<subtype

Specify the pointer to the buffer subtype.>>

Upon success, tptypes() returns the size of the buffer. Otherwise, it returns -1 upon failure and sets tperrno to indicate the error condition.

Errors

Under the following conditions, tptypes() fails and sets tperrno to one of the following values:

tpalloc(), tpfree(), tprealloc().

1. <<The behavior caused by XATMI errors encountered during OSI TP communication may be different from the behavior caused by errors encountered conventional TCP/IP communication.>>