src.com.ibm.as400.access.NetServerConnection Maven / Gradle / Ivy

Use any of the above attribute IDs with the {@link com.ibm.as400.resource.ChangeableResource#getAttributeValue(java.lang.Object) 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();
* }

• {@link #TYPE_DISK_DRIVE TYPE_DISK_DRIVE} - Disk drive.
• {@link #TYPE_SPOOLED_OUTPUT_QUEUE TYPE_SPOOLED_OUTPUT_QUEUE} - Spooled output queue.

The method is called by the resource framework automatically when the object connection needs to be established. @exception ResourceException If an error occurs. **/ protected void establishConnection() throws ResourceException { // Internal check: Verify that the ID has been set. if (! idWasSet_) { throw new ExtendedIllegalStateException("id", ExtendedIllegalStateException.PROPERTY_NOT_SET); } // Call the superclass. super.establishConnection(); // Initialize the PCML document. AS400 system = getSystem(); document_ = (ProgramCallDocument)staticDocument_.clone(); try { document_.setSystem(system); String connectionName = (String)getAttributeValue(NAME); document_.setValue(OLST0600_+".informationQualifier", connectionName); document_.setValue(OLST0700_+".informationQualifier", connectionName); // Initialize the attribute getter. attributeGetter_ = new ProgramAttributeGetter(system, document_, getterMap_); } catch (PcmlException e) { Trace.log(Trace.ERROR, "PcmlException when establishing connection.", e); throw new ResourceException(e); } } /** 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. @exception ResourceException If an error occurs. **/ protected void freezeProperties() throws ResourceException { // Internal check: Verify that the ID has been set. if (! idWasSet_) { throw new ExtendedIllegalStateException("id", ExtendedIllegalStateException.PROPERTY_NOT_SET); } // Update the presentation. Presentation presentation = getPresentation(); presentation.setName(Integer.toString(id_)); presentation.setFullName(Integer.toString(id_)); // Update the resource key. if (getResourceKey() == null) { setResourceKey(computeResourceKey(getSystem(), id_)); } // Call the superclass. super.freezeProperties(); } // Returns the attribute metadata for the class. static ResourceMetaData[] getAttributeMetaDataStatic() { return attributes_.getMetaData(); } /** Returns the current value of an attribute. @param attributeID Identifies the attribute. @return The attribute value, or null if the attribute value is not available. @exception ResourceException If an error occurs. **/ public Object getAttributeValue(Object attributeID) throws ResourceException { if (! isConnectionEstablished()) { establishConnection(); } Object value = super.getAttributeValue(attributeID); if (value == null) { value = attributeGetter_.getValue(attributeID); } return value; } /** Returns the connection ID for connection. @return The connection ID. **/ public int getID() { return id_; } /** Lists connections currently associated with the NetServer. The returned ResourceList contains {@link NetServerConnection NetServerConnection} objects. @param sys The system. @param type Type of connections to list: SHARE or SESSION. @return Information about current connections. @exception ResourceException If an error occurs. **/ static ResourceList list(AS400 sys, int type) throws ResourceException { if (type != SHARE && type != SESSION) { Trace.log(Trace.ERROR, "Invalid type of connection: " + type); throw new InternalErrorException(InternalErrorException.UNEXPECTED_EXCEPTION); } // First get the list of the specified type of resource, and then for each resource get its list of connections. ResourceList resources; if (type == SHARE) resources = NetServerFileShare.list(sys); else resources = NetServerSession.list(sys); resources.waitForComplete(); Vector connList = new Vector(); for (int i=0; i