com.ibm.as400.access

Class NetServerConnection

  • All Implemented Interfaces:
    Serializable

    Deprecated. 
    This class has been replaced by the ISeriesNetServerConnection class and may be removed in a future release.

    public class NetServerConnection
    extends Resource
    The NetServerConnection class represents a NetServer share connection.

    Note: A session (represented by class NetServerSession) 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 (represented by this class) 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 the getAttributeValue method 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 system 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 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();
     }
    
    See Also:
    NetServer.listSessionConnections(), NetServer.listShareConnections(), NetServerSession, Serialized Form
    • Field Detail

      • CONNECT_TIME

        public static final String CONNECT_TIME
        Deprecated. 
        Attribute ID for "connect time". This identifies a read-only Integer attribute, which represents the number of seconds that have elapsed since a connection was established.
        See Also:
        Constant Field Values
      • FILES_OPEN_COUNT

        public static final String FILES_OPEN_COUNT
        Deprecated. 
        Attribute ID for "number of files open". This identifies a read-only Integer attribute, which represents the number of files that are currently open on a connection.
        See Also:
        Constant Field Values
      • NAME

        public static final String NAME
        Deprecated. 
        Attribute ID for "connection name". This identifies a read-only String attribute, which represents the name of the share or workstation that is associated with a connection.
        See Also:
        Constant Field Values
      • TYPE_DISK_DRIVE

        public static final Integer TYPE_DISK_DRIVE
        Deprecated. 
        TYPE attribute value indicating a connection type of "disk drive".
      • TYPE_SPOOLED_OUTPUT_QUEUE

        public static final Integer TYPE_SPOOLED_OUTPUT_QUEUE
        Deprecated. 
        TYPE attribute value indicating a connection type of "spooled output queue".
      • USER

        public static final String USER
        Deprecated. 
        Attribute ID for "user name". This identifies a read-only String attribute, which represents the name of the user that opened the connection.
        See Also:
        Constant Field Values

    • Method Detail

      • establishConnection

        protected void establishConnection()
                                    throws ResourceException
        Deprecated. 
        Establishes the connection (of this object) to the system.

        The method is called by the resource framework automatically when the object connection needs to be established.

        Overrides:
        establishConnection in class Resource
        Throws:
        ResourceException - If an error occurs.
      • freezeProperties

        protected void freezeProperties()
                                 throws ResourceException
        Deprecated. 
        Freezes any property changes. After this is called, property changes should not be made. Properties are not the same thing as attributes. Properties are basic pieces of information which must be set to make the object usable, such as the system and the name.

        The method is called by the resource framework automatically when the properties need to be frozen.

        Overrides:
        freezeProperties in class Resource
        Throws:
        ResourceException - If an error occurs.
      • getID

        public int getID()
        Deprecated. 
        Returns the connection ID for connection.
        Returns:
        The connection ID.