com.ibm.as400.access

Class ISeriesNetServerConnection

  • All Implemented Interfaces:
    Serializable


    public class ISeriesNetServerConnection
    extends Object
    implements Serializable
    The ISeriesNetServerConnection class represents a NetServer share connection.

    Note: A session (represented by class ISeriesNetServerSession) 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.

    ISeriesNetServerConnection objects are created and returned by the following methods:

     import com.ibm.as400.access.*;
    
     // Create a ISeriesNetServer object for a specific system.
     AS400 system = new AS400("MYSYSTEM", "MYUSERID", "MYPASSWORD");
     ISeriesNetServer ns = new ISeriesNetServer(system);
    
     try
     {
       // List all current session connections.
       System.out.println("Session connections:");
       ISeriesNetServerSession[] sessionList = ns.listSessions();
       ISeriesNetServerConnection[] connectionList =
                     ns.listConnectionsForSession(sessionList[0].getID());
       for (int i=0; i<connectionList.length; i++)
       {
         ISeriesNetServerConnection connection = connectionList[i];
         System.out.println(connection.getID() + ": " +
           connection.getName() + "; " +
           connection.getUserName() + "; " +
           connection.getAge());
       }
     }
     catch (AS400Exception e) {
       AS400Message[] messageList = e.getAS400MessageList();
       for (int i=0; i<messageList.length; i++) {
         System.out.println(messageList[i].getText());
       }
     }
     catch (Exception e) {
       e.printStackTrace();
     }
     finally {
       if (system != null) system.disconnectAllServices();
     }
    
    See Also:
    ISeriesNetServer.listConnectionsForSession(long), ISeriesNetServer.listConnectionsForSession(String), Serialized Form
    • Field Summary

      Fields 
      Modifier and Type Field and Description
      static int DISK_DRIVE
      Value of the ISeriesNetServerConnection "connection type" attribute, indicating that the connection is to a disk drive, that is, a file share.
      static int SHARE
      Value of the ISeriesNetServerConnection "resource type" attribute, indicating that the connection is to a specific share.
      static int SPOOLED_OUTPUT_QUEUE
      Value of the ISeriesNetServerConnection "connection type" attribute, indicating that the connection is to a spooled output queue, that is, a print share.
      static int WORKSTATION
      Value of the ISeriesNetServerConnection "resource type" attribute, indicating that the connection is from a specific workstation.
    • Field Detail

      • WORKSTATION

        public static final int WORKSTATION
        Value of the ISeriesNetServerConnection "resource type" attribute, indicating that the connection is from a specific workstation.
        See Also:
        Constant Field Values
      • SHARE

        public static final int SHARE
        Value of the ISeriesNetServerConnection "resource type" attribute, indicating that the connection is to a specific share.
        See Also:
        Constant Field Values
      • DISK_DRIVE

        public static final int DISK_DRIVE
        Value of the ISeriesNetServerConnection "connection type" attribute, indicating that the connection is to a disk drive, that is, a file share.
        See Also:
        Constant Field Values
      • SPOOLED_OUTPUT_QUEUE

        public static final int SPOOLED_OUTPUT_QUEUE
        Value of the ISeriesNetServerConnection "connection type" attribute, indicating that the connection is to a spooled output queue, that is, a print share.
        See Also:
        Constant Field Values

    • Method Detail

      • getID

        public int getID()
        Returns the connection ID.
        Returns:
        The connection ID.
      • getSessionID

        public long getSessionID()
        Returns the session ID for connection.
        Returns:
        The session ID.
      • getAge

        public int getAge()
        Returns the number of seconds elapsed since the connection was established.
        Returns:
        The connect time.
      • getNumberOfFilesOpen

        public int getNumberOfFilesOpen()
        Returns the number of files that are open currently (on the connection).
        Returns:
        The number of files open.
      • getName

        public String getName()
        Returns the network name of the resource. If the resource type is SHARE, this is the name of a share. If the resource type is WORKSTATION, this is the name of a workstation.
        Returns:
        The name of the share or workstation.
      • getResourceType

        public int getResourceType()
        Returns the type of resource for this connection. Possible values are WORKSTATION and SHARE.
        Returns:
        The resource type.
      • getConnectionType

        public int getConnectionType()
        Returns the type of the connection made from the workstation to the shared resource. Possible values are DISK_DRIVE and SPOOLED_OUTPUT_QUEUE.
        Returns:
        The connection type.
      • getUserName

        public String getUserName()
        Returns the name of the user that is associated with the connection.
        Returns:
        The user name.
      • getNumberOfUsers

        public int getNumberOfUsers()
        Returns the number of current users on the connection.
        Returns:
        The number of users.