Package com.ibm.cics.server

Class DataHolder

java.lang.Object

com.ibm.cics.server.DataHolder

All Implemented Interfaces:

IHolder

public class DataHolder
extends Object
implements IHolder

This class holds an array of bytes that is the data read from a TDQ. The actual data is an instance variable of type byte[] with the name value.This instance variable can be accessed using getters getValue() and getStringValue() and setters setValue(byte[]) and setStringValue(String)

The reason for this extra holder class is that the data is returned from a method and the return value of the method is used to indicate the number of items in the TDQ.

Since CICS TS version:

1.3

Constructor Summary

Constructors

Constructor	Description
DataHolder()	Constructs a DataHolder without a value.

Method Summary

Modifier and Type	Method	Description
String	getStringValue()	Returns a String derived from the data in the IHolder, assuming that the data is encoded in the LOCALCCSID.
byte[]	getValue()	Returns the raw byte array from the IHolder
void	setStringValue(String valueToSet)	Set a value into the DataHolder
void	setValue(byte[] value)	Set a value into the DataHolder
String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

DataHolder

public DataHolder()

Constructs a DataHolder without a value.

Since CICS TS version:

1.3

Method Details

getValue

public byte[] getValue()

Description copied from interface: IHolder

Returns the raw byte array from the IHolder

Specified by:

getValue in interface IHolder

Returns:

- the raw byte value stored in the IHolder

See Also:

• IHolder.getValue()

Since CICS TS version:

5.1

getStringValue

public String getStringValue()

Description copied from interface: IHolder

Returns a String derived from the data in the IHolder, assuming that the data is encoded in the LOCALCCSID. The behavior of this method when the bytes are not valid in the LOCALCCSID encoding is unspecified.

Specified by:

getStringValue in interface IHolder

Returns:

- a String representation of the byte-array in the CICS LOCALCCSID.

See Also:

• IHolder.getStringValue()

Since CICS TS version:

5.1

setValue

public void setValue(byte[] value)

Set a value into the DataHolder

Parameters:

value - the value to set

Since CICS TS version:

5.1

setStringValue

public void setStringValue(String valueToSet)

Set a value into the DataHolder

Parameters:

valueToSet - the value to set. The text is converted into the LOCALCCSID encoding.

Since CICS TS version:

5.1

toString

public String toString()

Overrides:

toString in class Object