|
|||||||||
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.LogicalDataArea
The LogicalDataArea class represents a logical data area on the AS/400.
The following example demonstrates the use of LogicalDataArea:
// Prepare to work with the AS/400 system named "My400". AS400 system = new AS400("My400"); // Create a LogicalDataArea object. QSYSObjectPathName path = new QSYSObjectPathName("MYLIB", "MYDATA", "DTAARA"); LogicalDataArea dataArea = new LogicalDataArea(system, path.getPath()); // Create the logical data area on the AS/400 using default values. dataArea.create(); // Clear the data area. dataArea.clear(); // Write to the data area. dataArea.write(true); // Read from the data area. boolean data = dataArea.read(); // Delete the data area from the AS/400. dataArea.delete();
Constructor Summary | |
LogicalDataArea()
Constructs a LogicalDataArea object. |
|
LogicalDataArea(AS400 system,
java.lang.String path)
Constructs a LogicalDataArea object. |
Method Summary | |
void |
clear()
Clears the data area. |
void |
create()
Creates a logical data area on the AS/400. |
void |
create(boolean initialValue,
java.lang.String textDescription,
java.lang.String authority)
Creates a logical data area with the specified attributes. |
void |
delete()
Removes the data area from the system. |
java.lang.String |
getPath()
Returns the integrated file system path name of the object represented by the data area. |
boolean |
read()
Returns the value in the data area. |
void |
setPath(java.lang.String path)
Sets the fully qualified data area name. |
void |
write(boolean data)
Writes the value in 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 LogicalDataArea()
public LogicalDataArea(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(boolean 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
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 java.lang.String getPath()
public boolean 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 LogicalDataArea object. LogicalDataArea dataArea = new LogicalDataArea(); // 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(boolean data) throws AS400SecurityException, ConnectionDroppedException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException, ServerStartupException, java.net.UnknownHostException
data
- The data to be written.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |