|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.as400.resource.Resource | +--com.ibm.as400.access.NetServerConnection
The NetServerConnection class represents a NetServer share connection.
Note: A session corresponds to a workstation. A workstation could be a Windows Terminal Server or it could be a single PC on someone's desktop. A connection corresponds to a specific user who has mapped a drive and has files opened or spooled output on a print queue. Since a session can have multiple users, a connection shows a particular user's statistics on that session.
NetServerConnection objects are created and returned by the following methods:
The following attribute IDs are supported:
Use any of the above attribute IDs with
getAttributeValue
to access the attribute values for a NetServerConnection.
Note: For the above attributes, getAttributeValue() should never return null.
For String-valued attributes, if the current actual value of the corresponding property on the server is blank, getAttributeValue() will return "" (an empty String).
import com.ibm.as400.access.*;
import com.ibm.as400.resource.*;
// Create a NetServer object for a specific server system.
AS400 system = new AS400("MYSYSTEM", "MYUSERID", "MYPASSWORD");
NetServer ns = new NetServer(system);
try
{
// List all current session connections.
System.out.println("Session connections:");
ResourceList connectionList = ns.listSessionConnections();
connectionList.waitForComplete();
for (int i=0; i<connectionList.getListLength(); i++)
{
NetServerConnection connection =
(NetServerConnection)connectionList.resourceAt(i);
System.out.println(connection.getID() + ": " +
(String)connection.getAttributeValue(NetServerConnection.NAME) + "; " +
(String)connection.getAttributeValue(NetServerConnection.USER) + "; " +
((Integer)connection.getAttributeValue(NetServerConnection.CONNECT_TIME))
.intValue() );
}
}
catch (ResourceException e) {
e.printStackTrace();
}
finally {
if (system != null) system.disconnectAllServices();
}
NetServer.listSessionConnections()
,
NetServer.listShareConnections()
,
NetServerSession
, Serialized Form
Field Summary | |
static java.lang.String |
CONNECT_TIME
Attribute ID for "connect time". |
static java.lang.String |
FILES_OPEN_COUNT
Attribute ID for "number of files open". |
static java.lang.String |
NAME
Attribute ID for "connection name". |
static java.lang.String |
TYPE
Attribute ID for "connection type". |
static java.lang.Integer |
TYPE_DISK_DRIVE
Attribute value indicating "read only" permission to a share. |
static java.lang.Integer |
TYPE_SPOOLED_OUTPUT_QUEUE
Attribute value indicating "read/write" permission to a share. |
static java.lang.String |
USER
Attribute ID for "user name". |
Method Summary | |
protected void |
establishConnection()
Establishes the connection (of this object) to the server. |
protected void |
freezeProperties()
Freezes any property changes. |
java.lang.Object |
getAttributeValue(java.lang.Object attributeID)
Returns the current value of an attribute. |
int |
getID()
Returns the connection ID for connection. |
void |
refreshAttributeValues()
Refreshes the values for all attributes. |
Methods inherited from class java.lang.Object |
clone,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
Field Detail |
public static final java.lang.String CONNECT_TIME
public static final java.lang.String FILES_OPEN_COUNT
public static final java.lang.String NAME
public static final java.lang.String TYPE
TYPE_DISK_DRIVE
- Disk drive.
TYPE_SPOOLED_OUTPUT_QUEUE
- Spooled output queue.
public static final java.lang.Integer TYPE_DISK_DRIVE
TYPE
public static final java.lang.Integer TYPE_SPOOLED_OUTPUT_QUEUE
TYPE
public static final java.lang.String USER
Method Detail |
protected void establishConnection() throws ResourceException
The method is called by the resource framework automatically when the object connection needs to be established.
protected void freezeProperties() throws ResourceException
The method is called by the resource framework automatically when the properties need to be frozen.
public java.lang.Object getAttributeValue(java.lang.Object attributeID) throws ResourceException
attributeID
- Identifies the attribute.public int getID()
public void refreshAttributeValues() throws ResourceException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |