Package com.ibm.as400.access

Class NetServerShare

java.lang.Object

com.ibm.as400.resource.Resource

com.ibm.as400.resource.ChangeableResource

com.ibm.as400.access.NetServerShare

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

NetServerFileShare, NetServerPrintShare

public abstract class NetServerShare
extends ChangeableResource

Deprecated.

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

The NetServerShare class represents a NetServer share.

See Also:

NetServer.listFileShares(), NetServer.listPrintShares(), Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static String	DESCRIPTION	Deprecated. Attribute ID for "description".
static String	USER_COUNT	Deprecated. Attribute ID for "user count".

Method Summary

Modifier and Type	Method	Description
abstract void	add()	Deprecated. Adds the share to the NetServer.
protected void	commitAttributeChanges(Object[] attributeIDs, Object[] values)	Deprecated. Commits the specified attribute changes.
protected abstract void	establishConnection()	Deprecated. Establishes the connection to the system.
protected void	freezeProperties()	Deprecated. Freezes any property changes.
Object	getAttributeUnchangedValue(Object attributeID)	Deprecated. Returns the value of an attribute, disregarding any uncommitted changes.
String	getName()	Deprecated. Returns the network name of the share.
ResourceList	listConnections()	Deprecated. Lists the connections currently associated with this share.
void	refreshAttributeValues()	Deprecated. Refreshes the values for all attributes.
void	remove()	Deprecated. Removes this share from the NetServer.
void	setName(String name)	Deprecated. Sets the network name of the share.

Methods inherited from class com.ibm.as400.resource.ChangeableResource

cancelAttributeChanges, commitAttributeChanges, commitAttributeChanges, fireAttributeChangesCanceled, fireAttributeChangesCommitted, fireAttributeValueChanged, fireResourceCreated, fireResourceDeleted, getAttributeUnchangedValue, getAttributeValue, getAttributeValue, hasUncommittedAttributeChanges, initializeAttributeValue, setAttributeValue, setAttributeValue

Methods inherited from class com.ibm.as400.resource.Resource

addActiveStatusListener, addPropertyChangeListener, addResourceListener, addVetoableChangeListener, arePropertiesFrozen, equals, fireAttributeValuesRefreshed, fireBusy, fireIdle, firePropertyChange, fireVetoableChange, getAttributeMetaData, getAttributeMetaData, getPresentation, getResourceKey, getSystem, isBidiEnabled, isConnectionEstablished, removeActiveStatusListener, removePropertyChangeListener, removeResourceListener, removeVetoableChangeListener, setPresentation, setResourceKey, setSystem, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DESCRIPTION

public static final String DESCRIPTION

Deprecated.

Attribute ID for "description". This identifies a String attribute, which represents the text description of a share.

See Also:

Constant Field Values

USER_COUNT

public static final String USER_COUNT

Deprecated.

Attribute ID for "user count". This identifies a read-only Integer attribute, which represents the number of connections that are currently made to a share.
Note: If the NetServer has not been started, this attribute's reported value will be -1. See NetServer.isStarted() and NetServer.start().

See Also:

Constant Field Values

Method Detail

add

public abstract void add()
                  throws ResourceException

Deprecated.

Adds the share to the NetServer. This method fires a resourceCreated() ResourceEvent.

Throws:

ResourceException - If an error occurs.

commitAttributeChanges

protected void commitAttributeChanges(Object[] attributeIDs,
                                      Object[] values)
                               throws ResourceException

Deprecated.

Commits the specified attribute changes.
This method requires *IOSYSCFG special authority on the system. This method fires an attributeChangesCommitted() ResourceEvent.

Overrides:

commitAttributeChanges in class ChangeableResource

Parameters:

attributeIDs - The attribute IDs for the specified attribute changes.

values - The specified attribute changes

Throws:

ResourceException - If an error occurs.

See Also:

Subclass notes

establishConnection

protected abstract void establishConnection()
                                     throws ResourceException

Deprecated.

Establishes the connection to the system.

The method is called by the resource framework automatically when the 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, job name, job number, and user 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.

getAttributeUnchangedValue

public Object getAttributeUnchangedValue(Object attributeID)
                                  throws ResourceException

Deprecated.

Returns the value of an attribute, disregarding any uncommitted changes.

Overrides:

getAttributeUnchangedValue in class ChangeableResource

Parameters:

attributeID - Identifies the attribute.

Returns:

The attribute value, or null if the attribute value is not available.

Throws:

ResourceException - If an error occurs.

See Also:

Subclass notes

getName

public String getName()

Deprecated.

Returns the network name of the share.
Note: All share names are uppercase on the system.

Returns:

The share name.

listConnections

public ResourceList listConnections()
                             throws ResourceException

Deprecated.

Lists the connections currently associated with this share. The returned ResourceList contains NetServerConnection objects.

Returns:

The current connections to the share.

Throws:

ResourceException - If an error occurs.

refreshAttributeValues

public void refreshAttributeValues()
                            throws ResourceException

Deprecated.

Refreshes the values for all attributes. This does not cancel uncommitted changes. This method fires an attributeValuesRefreshed() ResourceEvent.

Overrides:

refreshAttributeValues in class ChangeableResource

Throws:

ResourceException - If an error occurs.

remove

public void remove()
            throws ResourceException

Deprecated.

Removes this share from the NetServer.
To use this method, the user profile must either have *IOSYSCFG special authority, or own the integrated file system directory or output queue that the share references.
This method fires a resourceDeleted() ResourceEvent.

Throws:

ResourceException - If an error occurs.

setName

public void setName(String name)

Deprecated.

Sets the network name of the share.
Note: All share names are uppercase on the system. Share names are limited to 12 characters in length. This method fires a PropertyChangeEvent.

Parameters:

name - The name of the share.