com.ibm.as400.resource
Class RSoftwareResource

java.lang.Object
  com.ibm.as400.resource.Resource
      com.ibm.as400.resource.ChangeableResource
          com.ibm.as400.resource.RSoftwareResource

All Implemented Interfaces:

Serializable

Deprecated. Use Product instead, as this package may be removed in the future.

public class RSoftwareResource
extends ChangeableResource

The RSoftwareResource class represents a software product.

The following attribute IDs are supported:

• LEVEL
• LOAD_ERROR_INDICATOR
• LOAD_ID
• LOAD_STATE
• LOAD_TYPE
• MINIMUM_BASE_VRM
• MINIMUM_TARGET_RELEASE
• PRIMARY_LANGUAGE_LOAD_ID
• PRODUCT_ID
• PRODUCT_OPTION
• REGISTRATION_TYPE
• REGISTRATION_VALUE
• RELEASE_LEVEL
• REQUIREMENTS_MET
• SUPPORTED_FLAG
• SYMBOLIC_LOAD_STATE

Use any of these attribute IDs with getAttributeValue() to access the attribute values for an RSoftwareResource.

// Create an RSoftwareResource object to refer to a specific software product.
AS400 system = new AS400("MYSYSTEM", "MYUSERID", "MYPASSWORD");
RSoftwareResource product = new RSoftwareResource(system, "5722JC1");


// Get the load error indicator.
String loadErrorIndicator = (String)product.getAttributeValue(RSoftwareResource.LOAD_ERROR_INDICATOR);

See Also:

Serialized Form

Field Summary

Modifier and Type	Field and Description
static String	LEVEL Deprecated. Attribute ID for level.
static String	LOAD_ERROR_INDICATOR Deprecated. Attribute ID for load error indicator.
static String	LOAD_ERROR_INDICATOR_ERROR Deprecated. Attribute value indicating that an error was found the last time that the state of this load was checked or updated.
static String	LOAD_ERROR_INDICATOR_NONE Deprecated. Attribute value indicating that no error was found the last time that the state of this load was checked or updated.
static String	LOAD_ID Deprecated. Attribute ID for load ID.
static String	LOAD_ID_CODE Deprecated. Attribute value indicating the code load.
static String	LOAD_STATE Deprecated. Attribute ID for load state.
static String	LOAD_TYPE Deprecated. Attribute ID for load type.
static String	LOAD_TYPE_CODE Deprecated. Attribute value indicating that the load is a code load.
static String	LOAD_TYPE_LANGUAGE Deprecated. Attribute value indicating that the load is a language load.
static String	MINIMUM_BASE_VRM Deprecated. Attribute ID for minimum base VRM.
static String	MINIMUM_BASE_VRM_MATCH Deprecated. Attribute value indicating the release of the option matches that of the base.
static String	MINIMUM_TARGET_RELEASE Deprecated. Attribute ID for minimum target release.
static String	PRIMARY_LANGUAGE_LOAD_ID Deprecated. Attribute ID for primary language load ID.
static String	PRODUCT_ID Deprecated. Attribute ID for product ID.
static String	PRODUCT_ID_OPERATING_SYSTEM Deprecated. Attribute value indicating the product ID for the operating system.
static String	PRODUCT_OPTION Deprecated. Attribute ID for product option.
static String	PRODUCT_OPTION_BASE Deprecated. Attribute value indicating the base option.
static String	REGISTRATION_TYPE Deprecated. Attribute ID for registration type.
static String	REGISTRATION_VALUE Deprecated. Attribute ID for registration value.
static String	RELEASE_LEVEL Deprecated. Attribute ID for release level.
static String	RELEASE_LEVEL_CURRENT Deprecated. Attribute value indicating the release level of the currently installed operating system.
static String	RELEASE_LEVEL_ONLY Deprecated. Attribute value indicating the only release level for which a product load is found.
static String	RELEASE_LEVEL_PREVIOUS Deprecated. Attribute value indicating the previous release with modification level 0 of the operating system.
static String	REQUIREMENTS_MET Deprecated. Attribute ID for requirements met.
static String	REQUIREMENTS_MET_ALL Deprecated. Attribute value indicating that the releases of the base and option meet all requirements.
static String	REQUIREMENTS_MET_TOO_OLD_COMPARED_TO_BASE Deprecated. Attribute value indicating that the release of the option is too old compared to the base.
static String	REQUIREMENTS_MET_TOO_OLD_COMPARED_TO_OPTION Deprecated. Attribute value indicating that the release of the base is too old compared to the option.
static String	REQUIREMENTS_MET_UNKNOWN Deprecated. Attribute value indicating that not enough information is available to determine if the release requirements have been met.
static String	SUPPORTED_FLAG Deprecated. Attribute ID for requirements met.
static String	SYMBOLIC_LOAD_STATE Deprecated. Attribute ID for symbolic load state.
static String	SYMBOLIC_LOAD_STATE_CREATED Deprecated. Attribute value indicating that the product load object for this load exists.
static String	SYMBOLIC_LOAD_STATE_DAMAGED Deprecated. Attribute value indicating that the product load object has been damaged.
static String	SYMBOLIC_LOAD_STATE_DEFINED Deprecated. Attribute value indicating that the load is defined.
static String	SYMBOLIC_LOAD_STATE_INSTALLED Deprecated. Attribute value indicating that the product load object was loaded.
static String	SYMBOLIC_LOAD_STATE_LOADED Deprecated. Attribute value indicating that the product load object is being loaded or deleted.
static String	SYMBOLIC_LOAD_STATE_PACKAGED Deprecated. Attribute value indicating that the product load object has been packaged.

Constructor and Description

RSoftwareResource()
Deprecated. Constructs an RSoftwareResource object.

RSoftwareResource(AS400 system, String productID)
Deprecated. Constructs an RSoftwareResource object.

RSoftwareResource(AS400 system, String productID, String releaseLevel, String productOption)
Deprecated. Constructs an RSoftwareResource object.

RSoftwareResource(AS400 system, String productID, String releaseLevel, String productOption, String loadID)
Deprecated. Constructs an RSoftwareResource object.

Method Summary

Modifier and Type	Method and Description
protected void	establishConnection() Deprecated. Establishes the connection to the system.
protected void	freezeProperties() Deprecated. Freezes any property changes.
Object	getAttributeUnchangedValue(Object attributeID) Deprecated. Returns the unchanged value of an attribute.
String	getLoadID() Deprecated. Returns the load ID.
String	getProductID() Deprecated. Returns the product ID.
String	getProductOption() Deprecated. Returns the product option.
String	getReleaseLevel() Deprecated. Returns the release level.
void	refreshAttributeValues() Deprecated. Refreshes the values for all attributes.
void	setLoadID(String loadID) Deprecated. Sets the load ID.
void	setProductID(String productID) Deprecated. Sets the product ID.
void	setProductOption(String productOption) Deprecated. Sets the product option.
void	setReleaseLevel(String releaseLevel) Deprecated. Sets the release level.

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

cancelAttributeChanges, commitAttributeChanges, 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

LEVEL

public static final String LEVEL

Deprecated.

Attribute ID for level. This identifies a read-only String attribute, which represents the level identifier of the product. The format is Lxx for the operating system and Licensed Internal Code, or "" for all other products.

See Also:

Constant Field Values

LOAD_ERROR_INDICATOR

public static final String LOAD_ERROR_INDICATOR

Deprecated.

Attribute ID for load error indicator. This identifies a read-only String attribute, which indicates if there is a known error for this load. Possible values are:

• LOAD_ERROR_INDICATOR_ERROR - An error was found the last time that the state of this load was checked or updated.
• LOAD_ERROR_INDICATOR_NONE - No error was found the last time that the state of this load was checked or updated.

See Also:

Constant Field Values

LOAD_ERROR_INDICATOR_ERROR

public static final String LOAD_ERROR_INDICATOR_ERROR

Deprecated.

Attribute value indicating that an error was found the last time that the state of this load was checked or updated.

See Also:

LOAD_ERROR_INDICATOR_ERROR, Constant Field Values

LOAD_ERROR_INDICATOR_NONE

public static final String LOAD_ERROR_INDICATOR_NONE

Deprecated.

Attribute value indicating that no error was found the last time that the state of this load was checked or updated.

See Also:

LOAD_ERROR_INDICATOR_NONE, Constant Field Values

LOAD_ID

public static final String LOAD_ID

Deprecated.

Attribute ID for load ID. This identifies a read-only String attribute, which represents the load ID of the product load for which information was returned. Possible values are:

• "5050" - The code load.
• A load ID.

See Also:

Constant Field Values

LOAD_ID_CODE

public static final String LOAD_ID_CODE

Deprecated.

Attribute value indicating the code load.

See Also:

LOAD_ID, Constant Field Values

LOAD_STATE

public static final String LOAD_STATE

Deprecated.

Attribute ID for load state. This identifies a read-only String attribute, which represents the state of the load.

See Also:

Constant Field Values

LOAD_TYPE

public static final String LOAD_TYPE

Deprecated.

Attribute ID for load type. This identifies a read-only String attribute, which represents the type of the load. Possible values are:

• LOAD_TYPE_CODE - The load is a code load.
• LOAD_TYPE_LANGUAGE - The load is a language load.

See Also:

Constant Field Values

LOAD_TYPE_CODE

public static final String LOAD_TYPE_CODE

Deprecated.

Attribute value indicating that the load is a code load.

See Also:

LOAD_TYPE, Constant Field Values

LOAD_TYPE_LANGUAGE

public static final String LOAD_TYPE_LANGUAGE

Deprecated.

Attribute value indicating that the load is a language load.

See Also:

LOAD_TYPE, Constant Field Values

MINIMUM_BASE_VRM

public static final String MINIMUM_BASE_VRM

Deprecated.

Attribute ID for minimum base VRM. This identifies a read-only String attribute, which represents the minimum release level that is allowed for the *BASE option that will run with the current level of the option for the product. Possible values are:

• MINIMUM_BASE_VRM_MATCH - The release of the option matches that of the base.
• The release value in the form VxRxMx.

See Also:

Constant Field Values

MINIMUM_BASE_VRM_MATCH

public static final String MINIMUM_BASE_VRM_MATCH

Deprecated.

Attribute value indicating the release of the option matches that of the base.

See Also:

MINIMUM_BASE_VRM, Constant Field Values

MINIMUM_TARGET_RELEASE

public static final String MINIMUM_TARGET_RELEASE

Deprecated.

Attribute ID for minimum target release. This identifies a read-only String attribute, which represents the minimum release of the operating system to which the Save Licensed Program (SAVLICPGM) command will allow the product to be saved, in the form VxRxMx.

See Also:

Constant Field Values

PRIMARY_LANGUAGE_LOAD_ID

public static final String PRIMARY_LANGUAGE_LOAD_ID

Deprecated.

Attribute ID for primary language load ID. This identifies a read-only String attribute, which represents the primary language of the product option for code loads, or "" if no language is installed, or for language loads.

See Also:

Constant Field Values

PRODUCT_ID

public static final String PRODUCT_ID

Deprecated.

Attribute ID for product ID. This identifies a read-only String attribute, which represents the product ID.

See Also:

Constant Field Values

PRODUCT_ID_OPERATING_SYSTEM

public static final String PRODUCT_ID_OPERATING_SYSTEM

Deprecated.

Attribute value indicating the product ID for the operating system.

See Also:

PRODUCT_ID, Constant Field Values

PRODUCT_OPTION

public static final String PRODUCT_OPTION

Deprecated.

Attribute ID for product option. This identifies a read-only String attribute, which represents the product option. Possible values are:

• PRODUCT_OPTION_BASE - The base option.
• A product option.

See Also:

Constant Field Values

PRODUCT_OPTION_BASE

public static final String PRODUCT_OPTION_BASE

Deprecated.

Attribute value indicating the base option.

See Also:

PRODUCT_OPTION, Constant Field Values

REGISTRATION_TYPE

public static final String REGISTRATION_TYPE

Deprecated.

Attribute ID for registration type. This identifies a read-only String attribute, which represents the registration type, which makes up part of the registration ID of the product.

See Also:

Constant Field Values

REGISTRATION_VALUE

public static final String REGISTRATION_VALUE

Deprecated.

Attribute ID for registration value. This identifies a read-only String attribute, which represents the registration value, which makes up part of the registration ID of the product.

See Also:

Constant Field Values

RELEASE_LEVEL

public static final String RELEASE_LEVEL

Deprecated.

Attribute ID for release level. This identifies a read-only String attribute, which represents the release level.

See Also:

Constant Field Values

RELEASE_LEVEL_CURRENT

public static final String RELEASE_LEVEL_CURRENT

Deprecated.

Attribute value indicating the release level of the currently installed operating system.

See Also:

RELEASE_LEVEL, Constant Field Values

RELEASE_LEVEL_ONLY

public static final String RELEASE_LEVEL_ONLY

Deprecated.

Attribute value indicating the only release level for which a product load is found.

See Also:

RELEASE_LEVEL, Constant Field Values

RELEASE_LEVEL_PREVIOUS

public static final String RELEASE_LEVEL_PREVIOUS

Deprecated.

Attribute value indicating the previous release with modification level 0 of the operating system.

See Also:

RELEASE_LEVEL, Constant Field Values

REQUIREMENTS_MET

public static final String REQUIREMENTS_MET

Deprecated.

Attribute ID for requirements met. This identifies a read-only String attribute, which indicates whether then product requirements are met between a base and option value. Possible values are:

• REQUIREMENTS_MET_UNKNOWN - There is not enough information available to determine if the release requirements have been met, or if LOAD_TYPE is set to LOAD_TYPE_LANGUAGE.
• REQUIREMENTS_MET_ALL - The releases of the base and option meet all requirements.
• REQUIREMENTS_MET_TOO_OLD_COMPARED_TO_BASE - The release of the option is too old compared to the base.
• REQUIREMENTS_MET_TOO_OLD_COMPARED_TO_BASE - The release of the base is too old compared to the option.

See Also:

Constant Field Values

REQUIREMENTS_MET_UNKNOWN

public static final String REQUIREMENTS_MET_UNKNOWN

Deprecated.

Attribute value indicating that not enough information is available to determine if the release requirements have been met.

See Also:

REQUIREMENTS_MET, Constant Field Values

REQUIREMENTS_MET_ALL

public static final String REQUIREMENTS_MET_ALL

Deprecated.

Attribute value indicating that the releases of the base and option meet all requirements.

See Also:

REQUIREMENTS_MET, Constant Field Values

REQUIREMENTS_MET_TOO_OLD_COMPARED_TO_BASE

public static final String REQUIREMENTS_MET_TOO_OLD_COMPARED_TO_BASE

Deprecated.

Attribute value indicating that the release of the option is too old compared to the base.

See Also:

REQUIREMENTS_MET, Constant Field Values

REQUIREMENTS_MET_TOO_OLD_COMPARED_TO_OPTION

public static final String REQUIREMENTS_MET_TOO_OLD_COMPARED_TO_OPTION

Deprecated.

Attribute value indicating that the release of the base is too old compared to the option.

See Also:

REQUIREMENTS_MET, Constant Field Values

SUPPORTED_FLAG

public static final String SUPPORTED_FLAG

Deprecated.

Attribute ID for requirements met. This identifies a read-only Boolean attribute, which indicates whether this load is currently supported.

See Also:

Constant Field Values

SYMBOLIC_LOAD_STATE

public static final String SYMBOLIC_LOAD_STATE

Deprecated.

Attribute ID for symbolic load state. This identifies a read-only String attribute, which represents the symbolic state of the load. Possible values are:

• SYMBOLIC_LOAD_STATE_DEFINED - The load is defined. The product load object for this load does not exist.
• SYMBOLIC_LOAD_STATE_CREATED - The product load object for this load exists.
• SYMBOLIC_LOAD_STATE_PACKAGED - The product load object for this has been packaged.
• SYMBOLIC_LOAD_STATE_DAMAGED - The product load object for this has been damaged.
• SYMBOLIC_LOAD_STATE_LOADED - The product is being loaded or deleted.
• SYMBOLIC_LOAD_STATE_INSTALLED - The product load object was loaded.

See Also:

Constant Field Values

SYMBOLIC_LOAD_STATE_DEFINED

public static final String SYMBOLIC_LOAD_STATE_DEFINED

Deprecated.

Attribute value indicating that the load is defined. The product load object for this load does not exist.

See Also:

SYMBOLIC_LOAD_STATE, Constant Field Values

SYMBOLIC_LOAD_STATE_CREATED

public static final String SYMBOLIC_LOAD_STATE_CREATED

Deprecated.

Attribute value indicating that the product load object for this load exists.

See Also:

SYMBOLIC_LOAD_STATE, Constant Field Values

SYMBOLIC_LOAD_STATE_PACKAGED

public static final String SYMBOLIC_LOAD_STATE_PACKAGED

Deprecated.

Attribute value indicating that the product load object has been packaged.

See Also:

SYMBOLIC_LOAD_STATE, Constant Field Values

SYMBOLIC_LOAD_STATE_DAMAGED

public static final String SYMBOLIC_LOAD_STATE_DAMAGED

Deprecated.

Attribute value indicating that the product load object has been damaged.

See Also:

SYMBOLIC_LOAD_STATE, Constant Field Values

SYMBOLIC_LOAD_STATE_LOADED

public static final String SYMBOLIC_LOAD_STATE_LOADED

Deprecated.

Attribute value indicating that the product load object is being loaded or deleted.

See Also:

SYMBOLIC_LOAD_STATE, Constant Field Values

SYMBOLIC_LOAD_STATE_INSTALLED

public static final String SYMBOLIC_LOAD_STATE_INSTALLED

Deprecated.

Attribute value indicating that the product load object was loaded.

See Also:

SYMBOLIC_LOAD_STATE, Constant Field Values

Constructor Detail

RSoftwareResource

public RSoftwareResource()

Deprecated.

Constructs an RSoftwareResource object.

RSoftwareResource

public RSoftwareResource(AS400 system,
                         String productID)

Deprecated.

Constructs an RSoftwareResource object.

Parameters:

system - The system.

productID - The product ID, or PRODUCT_ID_OPERATING_SYSTEM to refer to the operating system.

RSoftwareResource

public RSoftwareResource(AS400 system,
                         String productID,
                         String releaseLevel,
                         String productOption)

Deprecated.

Constructs an RSoftwareResource object.

Parameters:

system - The system.

productID - The product ID, or PRODUCT_ID_OPERATING_SYSTEM to refer to the operating system.

releaseLevel - The release level. Possible values are:

• RELEASE_LEVEL_CURRENT - Use the release level of the currently installed operating system.
• RELEASE_LEVEL_ONLY - Use the only release level for which a product load is found.
• RELEASE_LEVEL_PREVIOUS - Use the previous release with modification level 0 of the operating system.
• A release level, in the form VxRxMx.

productOption - The option number for which is being requested, or PRODUCT_OPTION_BASE for the base option.

RSoftwareResource

public RSoftwareResource(AS400 system,
                         String productID,
                         String releaseLevel,
                         String productOption,
                         String loadID)

Deprecated.

Constructs an RSoftwareResource object.

Parameters:

system - The system.

productID - The product ID, or PRODUCT_ID_OPERATING_SYSTEM to refer to the operating system.

releaseLevel - The release level. Possible values are:

• RELEASE_LEVEL_CURRENT - Use the release level of the currently installed operating system.
• RELEASE_LEVEL_ONLY - Use the only release level for which a product load is found.
• RELEASE_LEVEL_PREVIOUS - Use the previous release with modification level 0 of the operating system.
• A release level, in the form VxRxMx.

productOption - The option number for which is being requested, or PRODUCT_OPTION_BASE for the base option.

loadID - The load ID, or LOAD_ID_CODE for the code load.

Method Detail

establishConnection

protected 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 and path.

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 unchanged value of an attribute. If the attribute value has a uncommitted change, this returns the unchanged value. If the attribute value does not have a uncommitted change, this returns the same value as getAttributeValue().

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

getLoadID

public String getLoadID()

Deprecated.

Returns the load ID.

Returns:

The load ID.

getProductID

public String getProductID()

Deprecated.

Returns the product ID.

Returns:

The product ID.

getProductOption

public String getProductOption()

Deprecated.

Returns the product option.

Returns:

The product option.

getReleaseLevel

public String getReleaseLevel()

Deprecated.

Returns the release level.

Returns:

The release level.

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.

setLoadID

public void setLoadID(String loadID)

Deprecated.

Sets the load ID. This does not change the software product on the system. Instead, it changes the software product to which this object references.

The default value is LOAD_ID_CODE.

Parameters:

loadID - The load ID, or LOAD_ID_CODE for the code load.

setProductID

public void setProductID(String productID)

Deprecated.

Sets the product ID. This does not change the software product on the system. Instead, it changes the software product to which this object references.

The default value is PRODUCT_ID_OPERATING_SYSTEM.

Parameters:

productID - The product ID, or PRODUCT_ID_OPERATING_SYSTEM to refer to the operating system.

setProductOption

public void setProductOption(String productOption)

Deprecated.

Sets the product option. This does not change the software product on the system. Instead, it changes the software product to which this object references.

The default value is PRODUCT_OPTION_BASE.

Parameters:

productOption - The option number for which is being requested, or PRODUCT_OPTION_BASE for the base option.

setReleaseLevel

public void setReleaseLevel(String releaseLevel)

Deprecated.

Sets the release level. This does not change the software product on the system. Instead, it changes the software product to which this object references.

The default value is RELEASE_LEVEL_CURRENT.

Parameters:

releaseLevel - The release level. Possible values are:

• RELEASE_LEVEL_CURRENT - Use the release level of the currently installed operating system.
• RELEASE_LEVEL_ONLY - Use the only release level for which a product load is found.
• RELEASE_LEVEL_PREVIOUS - Use the previous release with modification level 0 of the operating system.
• A release level, in the form VxRxMx.