Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Messages : tibemsBytesMsg : tibemsBytesMsg_Read

tibemsBytesMsg_Read
Function
Purpose
Read primitive datatypes from the byte stream in the message body.
C Declaration
tibems_status tibemsBytesMsg_ReadBoolean(
    tibemsBytesMsg message,
    tibems_bool* value );
 
tibems_status tibemsBytesMsg_ReadByte(
    tibemsBytesMsg message,
    tibems_byte* value );
 
tibems_status tibemsBytesMsg_ReadChar(
    tibemsBytesMsg message,
    tibems_wchar* value );
 
tibems_status tibemsBytesMsg_ReadDouble(
    tibemsBytesMsg message,
    tibems_double* value );
 
tibems_status tibemsBytesMsg_ReadFloat(
    tibemsBytesMsg message,
    tibems_float* value );
 
tibems_status tibemsBytesMsg_ReadInt(
    tibemsBytesMsg message,
    tibems_int* value );
 
tibems_status tibemsBytesMsg_ReadLong(
    tibemsBytesMsg message,
    tibems_long* value );
 
tibems_status tibemsBytesMsg_ReadShort(
    tibemsBytesMsg message,
    tibems_short* value );
 
tibems_status tibemsBytesMsg_ReadUnsignedByte(
    tibemsBytesMsg message,
    tibems_int* value );
 
tibems_status tibemsBytesMsg_ReadUnsignedShort(
    tibemsBytesMsg message,
    tibems_int* value );
COBOL Call
CALL "tibemsBytesMsg_ReadBoolean"
 USING BY VALUE message,
       BY REFERENCE  tibems-Boolean,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadByte"
 USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadChar"
USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadDouble"
USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadFloat"
USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadInt"
 USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadLong"
 USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadShort"
 USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadUnsignedByte"
 USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
CALL "tibemsBytesMsg_ReadUnsignedShort"
 USING BY VALUE message,
       BY REFERENCE value,
       RETURNING tibems-status
END-CALL.
 
message has usage pointer in all calls.
Parameters
 
Remarks
The JMS specification defines eleven calls to extract data from the byte stream body of a tibemsBytesMsg. Each call reads a unit of data from the stream, and advances the read position so that the next read call gets the next datum.
 
tibemsBytesMsg_ReadUnsignedShort
See Also
tibemsBytesMsg_ReadBytes on page 82

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved