|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.as400.access.DataArea | +--com.ibm.as400.access.DecimalDataArea
The DecimalDataArea class represents a decimal data area on the AS/400.
The following example demonstrates the use of DecimalDataArea:
// Prepare to work with the AS/400 system named "My400". AS400 system = new AS400("My400"); // Create a DecimalDataArea object. QSYSObjectPathName path = new QSYSObjectPathName("MYLIB", "MYDATA", "DTAARA"); DecimalDataArea dataArea = new DecimalDataArea(system, path.getPath()); // Create the decimal data area on the AS/400 using default values. dataArea.create(); // Clear the data area. dataArea.clear(); // Write to the data area. dataArea.write(new BigDecimal("1.2")); // Read from the data area. BigDecimal data = dataArea.read(); // Delete the data area from the AS/400. dataArea.delete();
Constructor Summary | |
DecimalDataArea()
Constructs a DecimalDataArea object. |
|
DecimalDataArea(AS400 system,
java.lang.String path)
Constructs a DecimalDataArea object. |
Method Summary | |
void |
clear()
Resets the data area to contain 0.0. |
void |
create()
Creates a decimal data area on the AS/400. |
void |
create(int length,
int decimalPositions,
java.math.BigDecimal initialValue,
java.lang.String textDescription,
java.lang.String authority)
Creates a decimal data area with the specified attributes. |
void |
delete()
Removes the data area from the system. |
int |
getDecimalPositions()
Returns the number of digits to the right of the decimal point in this data area. |
java.lang.String |
getPath()
Returns the integrated file system path name of the object represented by the data area. |
java.math.BigDecimal |
read()
Returns the data read from the data area. |
void |
setPath(java.lang.String path)
Sets the fully qualified data area name. |
void |
write(java.math.BigDecimal data)
Writes data to the data area. |
Methods inherited from class com.ibm.as400.access.DataArea |
addDataAreaListener,
addPropertyChangeListener,
addVetoableChangeListener,
getLength,
getName,
getSystem,
refreshAttributes,
removeDataAreaListener,
removePropertyChangeListener,
removeVetoableChangeListener,
setSystem |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
public DecimalDataArea()
public DecimalDataArea(AS400 system, java.lang.String path)
system
- The AS/400 that contains the data area.path
- The fully qualified integrated file system path name. The
integrated file system file extension for a data area is DTAARA. An example of a
fully qualified integrated file system path to a data area "MYDATA" in library
"MYLIB" is: /QSYS.LIB/MYLIB.LIB/MYDATA.DTAARAMethod Detail |
public void clear() throws AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException, ServerStartupException, java.net.UnknownHostException
public void create() throws AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectAlreadyExistsException, ObjectDoesNotExistException, ServerStartupException, java.net.UnknownHostException
public void create(int length, int decimalPositions, java.math.BigDecimal initialValue, java.lang.String textDescription, java.lang.String authority) throws AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectAlreadyExistsException, ObjectDoesNotExistException, ServerStartupException, java.net.UnknownHostException
length
- The maximum number of digits in the data area. Valid
values are 1 through 24.decimalPositions
- The number of digits to the right of the decimal
point. Valid values are 0 through 9.initialValue
- The initial value for the data area.textDescription
- The text description for the data area. The maximum length is 50 characters.authority
- The public authority level for the data area. Valid
values are *ALL, *CHANGE, *EXCLUDE, *LIBCRTAUT, *USE, or the
name of an authorization list. The maximum length is 10 characters.public void delete() throws AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException, ServerStartupException, java.net.UnknownHostException
public int getDecimalPositions() throws AS400SecurityException, ErrorCompletingRequestException, IllegalObjectTypeException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
public java.lang.String getPath()
public java.math.BigDecimal read() throws AS400SecurityException, ErrorCompletingRequestException, IllegalObjectTypeException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
public void setPath(java.lang.String path) throws java.beans.PropertyVetoException
// Create a DecimalDataArea object. DecimalDataArea dataArea = new DecimalDataArea(); // Set its path to be the data area "MYDATA" in the library "MYLIB". dataArea.setPath("/QSYS.LIB/MYLIB.LIB/MYDATA.DTAARA");
path
- The fully qualified integrated file system path name of the data area.public void write(java.math.BigDecimal data) throws AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException, ServerStartupException, java.net.UnknownHostException
data
- The decimal data to be written.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |