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

Use any of the above attribute IDs with {@link com.ibm.as400.resource.ChangeableResource#getAttributeValue(java.lang.Object) getAttributeValue} to access the attribute values for a NetServerSession.
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 sessions.
*   System.out.println("Sessions:");
*   ResourceList sessionList = ns.listSessions();
*   sessionList.waitForComplete();
*   for (int i=0; i<sessionList.getListLength(); i++)
*   {
*     NetServerSession session =
*       (NetServerSession)sessionList.resourceAt(i);
*     System.out.println(session.getName() + ": " +
*       (String)session.getAttributeValue(NetServerSession.USER) + "; " +
*       ((Integer)session.getAttributeValue(NetServerSession.SESSION_TIME))
*                                                           .intValue() + "; " +
*       ((Boolean)session.getAttributeValue(NetServerSession.IS_GUEST))
*                                                           .booleanValue() );
*   }
* }
* catch (ResourceException e) {
*   e.printStackTrace();
* }
* finally {
*   if (system != null) system.disconnectAllServices();
* }

The method is called by the resource framework automatically when the connection needs to be established. @exception ResourceException If an error occurs. **/ protected void establishConnection() throws ResourceException { if (name_ == null) { throw new ExtendedIllegalStateException("name", ExtendedIllegalStateException.PROPERTY_NOT_SET); } // Call the superclass. super.establishConnection(); // Initialize the PCML document. AS400 system = getSystem(); document_ = (ProgramCallDocument)staticDocument_.clone(); try { document_.setSystem(system); document_.setValue("qzlsolst_zlsl0300.informationQualifier", name_); // 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 { // Verify that the session name has been set. if (name_ == null) { throw new ExtendedIllegalStateException("name", ExtendedIllegalStateException.PROPERTY_NOT_SET); } // Update the presentation. Presentation presentation = getPresentation(); presentation.setName(name_); presentation.setFullName(name_); // Update the resource key. if (getResourceKey() == null) { setResourceKey(computeResourceKey(getSystem(), name_)); } // 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 name of the workstation from which the session to the system was established. @return The workstation name. **/ public String getName() { return name_; } /** Lists the current sessions. The returned ResourceList contains {@link NetServerSession NetServerSession} objects. @return Information about the current sessions. @exception ResourceException If an error occurs. **/ static ResourceList list(AS400 system) throws ResourceException { // Note: The on-line spec says that the 0300 format requires a valid session name. This is not entirely correct. It will also accept *ALL. try { // Set the input parameters and call the API. ProgramCallDocument document = (ProgramCallDocument)staticDocument_.clone(); document.setSystem(system); document.setValue(OLST0300_+".informationQualifier", "*ALL"); // Note: Formats ZLSL0300 returns a list of 64-byte fixed-length records. int expectedInfoLength = 10*64; // Expect about 10 64-byte records. document.setIntValue(OLST0300_+".lengthOfReceiverVariable", expectedInfoLength); NetServer.callListProgram(document, OLST0300_, true); // Note: This method does a retry (with larger buffer) if receiverVariable is overflowed. int recCount = document.getIntValue(OLST0300_+".listInformation.recordsReturned"); int recSize = document.getIntValue(OLST0300_+".listInformation.recordLength"); Vector sessions = new Vector(); String prefix = OLST0300_+".receiverVariable."; int index = 0; int[] indices = new int[1]; Object[] attributeIDs = openListAttributeMap_.getIDs(); for (int i=0; i