com.ibm.as400.access
Class BinaryFieldDescription

java.lang.Object
  com.ibm.as400.access.FieldDescription
      com.ibm.as400.access.BinaryFieldDescription

All Implemented Interfaces:

Serializable

public class BinaryFieldDescription
extends FieldDescription
implements Serializable

The BinaryFieldDescription class represents the description of the data in a binary (integer) field. It allows:

• The user to describe a binary field to the RecordFormat object.
• The RecordFormat object to describe a binary field to the user.

Click hereto see an example.

As of OS/400 V4R5, DDS supports up to 8-byte (18-digit) binary field descriptions. Using any of the data types that result in a byte length greater than 4 or a number of digits greater than 9 on a release prior to V4R5 may give unexpected results.

See Also:

Serialized Form

Field Summary

Modifier and Type	Field and Description

Fields inherited from class com.ibm.as400.access.FieldDescription

ALIGN_LEFT, ALIGN_RIGHT

Constructor and Description

BinaryFieldDescription()
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400Bin2 dataType, String name)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400Bin2 dataType, String name, String ddsName, int length)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400Bin4 dataType, String name)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400Bin4 dataType, String name, String ddsName, int length)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400Bin8 dataType, String name)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400Bin8 dataType, String name, String ddsName, int length)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400UnsignedBin2 dataType, String name)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400UnsignedBin2 dataType, String name, String ddsName, int length)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400UnsignedBin4 dataType, String name)
Constructs a BinaryFieldDescription object.

BinaryFieldDescription(AS400UnsignedBin4 dataType, String name, String ddsName, int length)
Constructs a BinaryFieldDescription object.

Method Summary

Modifier and Type	Method and Description
void	setDataType(AS400Bin2 dataType) Sets the AS400DataType object describing this field.
void	setDataType(AS400Bin4 dataType) Sets the AS400DataType object describing this field.
void	setDataType(AS400Bin8 dataType) Sets the AS400DataType object describing this field.
void	setDataType(AS400UnsignedBin2 dataType) Sets the AS400DataType object describing this field.
void	setDataType(AS400UnsignedBin4 dataType) Sets the AS400DataType object describing this field.
void	setDFT(Integer defaultValue) Sets the value for the DFT keyword for this field.
void	setDFT(Long defaultValue) Sets the value for the DFT keyword for this field.
void	setDFT(Short defaultValue) Sets the value for the DFT keyword for this field.
void	setDFTNull() Sets the value for the DFT keyword to be *NULL for this field.
void	setLength(int length) Sets the length of this field.

Methods inherited from class com.ibm.as400.access.FieldDescription

getALIAS, getALWNULL, getCOLHDG, getDataType, getDDSName, getDFT, getDFTCurrentValue, getFieldName, getKeyFieldFunctions, getLayoutAlignment, getLayoutLength, getLength, getREFFLD, getTEXT, isDFTCurrent, isDFTNull, setALIAS, setALWNULL, setCOLHDG, setDataType, setDDSName, setFieldName, setKeyFieldFunctions, setLayoutAlignment, setLayoutAttributes, setLayoutLength, setREFFLD, setTEXT

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BinaryFieldDescription

public BinaryFieldDescription()

Constructs a BinaryFieldDescription object.

BinaryFieldDescription

public BinaryFieldDescription(AS400Bin4 dataType,
                              String name)

Constructs a BinaryFieldDescription object. It uses the specified data type and name of the field. The length of this field is represented by the number of digits it can contain. This constructor defaults the length (as returned by getLength()) to 9. The length is used by the Record Level Access classes when creating a file from a RecordFormat object. The maximum number of digits allowed for a binary field by DDS is 18.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

BinaryFieldDescription

public BinaryFieldDescription(AS400Bin4 dataType,
                              String name,
                              String ddsName,
                              int length)

Constructs a BinaryFieldDescription object. It uses the specified data type, name, DDS name, and length of the field. This constructor is used when the field description will be used with the record level access classes.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

ddsName - The DDS name of this field. This is the name of the field as it would appear in a DDS description of the field. The length of ddsName must be 10 characters or less.

length - The number of digits that the field will hold. This is the length of the field as it would appear in a DDS description. The length must be greater than 0.

BinaryFieldDescription

public BinaryFieldDescription(AS400Bin8 dataType,
                              String name)

Constructs a BinaryFieldDescription object. It uses the specified data type and name of the field. The length of this field is represented by the number of digits it can contain. This constructor defaults the length (as returned by getLength()) to 18. The length is used by the Record Level Access classes when creating a file from a RecordFormat object. The maximum number of digits allowed for a binary field by DDS is 18.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

BinaryFieldDescription

public BinaryFieldDescription(AS400Bin8 dataType,
                              String name,
                              String ddsName,
                              int length)

Constructs a BinaryFieldDescription object. It uses the specified data type, name, DDS name, and length of the field. This constructor is used when the field description will be used with the record level access classes.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

ddsName - The DDS name of this field. This is the name of the field as it would appear in a DDS description of the field. The length of ddsName must be 10 characters or less.

length - The number of digits that the field will hold. This is the length of the field as it would appear in a DDS description. The length must be greater than 0.

BinaryFieldDescription

public BinaryFieldDescription(AS400UnsignedBin4 dataType,
                              String name)

Constructs a BinaryFieldDescription object. It uses the specified data type and name of the field. The length of this field is represented by the number of digits it can contain. This constructor defaults the length (as returned by getLength()) to 9. The length is used by the Record Level Access classes when creating a file from a RecordFormat object. The maximum number of digits allowed for a binary field by DDS is 18.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

BinaryFieldDescription

public BinaryFieldDescription(AS400UnsignedBin4 dataType,
                              String name,
                              String ddsName,
                              int length)

Constructs a BinaryFieldDescription object. It uses the specified data type, name, DDS name, and length of the field. This constructor is used when the field description will be used with the record level access classes.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

ddsName - The DDS name of this field. This is the name of the field as it would appear in a DDS description of the field. The length of ddsName must be 10 characters or less.

length - The number of digits that the field will hold. This is the length of the field as it would appear in a DDS description. The length must be greater than 0.

BinaryFieldDescription

public BinaryFieldDescription(AS400Bin2 dataType,
                              String name)

Constructs a BinaryFieldDescription object. It uses the specified data type and name of the field. The length of this field is represented by the number of digits it can contain. This constructor defaults the length (as returned by getLength()) to 4. The length is used by the Record Level Access classes when creating a file from a RecordFormat object. Four (4) is the maximum number of digits allowed for a binary field (when represented by a bin2) by DDS.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

BinaryFieldDescription

public BinaryFieldDescription(AS400Bin2 dataType,
                              String name,
                              String ddsName,
                              int length)

Constructs a BinaryFieldDescription object. It uses the specified data type, name, DDS name, and length of the field. This constructor is used when the field description will be used with the record level access classes.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

ddsName - The DDS name of this field. This is the name of the field as it would appear in a DDS description of the field. The length of ddsName must be 10 characters or less.

length - The number of digits that the field will hold. This is the length of the field as it would appear in a DDS description. The length must be greater than 0.

BinaryFieldDescription

public BinaryFieldDescription(AS400UnsignedBin2 dataType,
                              String name)

Constructs a BinaryFieldDescription object. It uses the specified data type and name of the field. The length of this field is represented by the number of digits it can contain. This constructor defaults the length (as returned by getLength()) to 4. The length is used by the Record Level Access classes when creating a file from a RecordFormat object. Four (4) is the maximum number of digits allowed for a binary field (when represented by a bin2) by DDS.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

BinaryFieldDescription

public BinaryFieldDescription(AS400UnsignedBin2 dataType,
                              String name,
                              String ddsName,
                              int length)

Constructs a BinaryFieldDescription object. It uses the specified data type, name, DDS name, and length of the field. This constructor is used when the field description will be used with the record level access classes.

Parameters:

dataType - Describes the field and provides the conversion capability for the contents of the field.

name - The name of the field.

ddsName - The DDS name of this field. This is the name of the field as it would appear in a DDS description of the field. The length of ddsName must be 10 characters or less.

length - The number of digits that the field will hold. This is the length of the field as it would appear in a DDS description. The length must be greater than 0.

Method Detail

setDataType

public void setDataType(AS400Bin2 dataType)

Sets the AS400DataType object describing this field.

Parameters:

dataType - The AS400DataType that describes this field. The dataType cannot be null.

setDataType

public void setDataType(AS400UnsignedBin2 dataType)

Sets the AS400DataType object describing this field.

Parameters:

dataType - The AS400DataType that describes this field. The dataType cannot be null.

setDataType

public void setDataType(AS400Bin4 dataType)

Sets the AS400DataType object describing this field.

Parameters:

dataType - The AS400DataType that describes this field. The dataType cannot be null.

setDataType

public void setDataType(AS400UnsignedBin4 dataType)

Sets the AS400DataType object describing this field.

Parameters:

dataType - The AS400DataType that describes this field. The dataType cannot be null.

setDataType

public void setDataType(AS400Bin8 dataType)

Sets the AS400DataType object describing this field.

Parameters:

dataType - The AS400DataType that describes this field. The dataType cannot be null.

setDFT

public void setDFT(Integer defaultValue)

Sets the value for the DFT keyword for this field. Use this version of setDFT() when an AS400Bin4 or AS400UnsignedBin2 object was used to construct the object.

Parameters:

defaultValue - The default value for this field. The defaultValuecannot be null. To set a default value of *NULL, use the setDFTNull() method.

setDFT

public void setDFT(Long defaultValue)

Sets the value for the DFT keyword for this field. Use this version of setDFT() when an AS400UnsignedBin4 or AS400Bin8 object was used to construct the object.

Parameters:

defaultValue - The default value for this field. The defaultValuecannot be null. To set a default value of *NULL, use the setDFTNull() method.

setDFT

public void setDFT(Short defaultValue)

Sets the value for the DFT keyword for this field. Use this version of setDFT() when an AS400Bin2 object was used to construct the object.

Parameters:

defaultValue - The default value for this field. The defaultValuecannot be null. To set a default value of *NULL, use the setDFTNull() method.

setDFTNull

public void setDFTNull()

Sets the value for the DFT keyword to be *NULL for this field. Calling this method will replace the DFT keyword that was previously set on a call to setDFT(). Note: This field must also have its ALWNULL keyword set to true to prevent DDS errors.

setLength

public void setLength(int length)

Sets the length of this field.

Parameters:

length - The length of this field. The length must be greater than zero.