Public Instance Methods : IuSstApplicationContext

* addRemoteSpace: spaceName at: urlList
	"ACTION
		Add a remote space named @spaceName to the receiver.  The 
		space is created so it is contactable at the URLs given by @urlList.  
		If the space already exists then it is modified to ensure that 
		its location is the machine named @machineName.  Answer the
		newly added space.

	PARAMETERS
		spaceName : <IuSstComponentName>
		urlList : <Collection of <String> | <IuSstUrl>>

	RETURN VALUE
		<IuSstRemoteSpace>

	NOTES
		This method is intended to be used to add new spaces to a context
		which has already been #setupFor:using:'d.  Use #addSpace:at: to 
		add a space to the context before it has been setup.

	EXCEPTIONS
		ExSstSetupError : Thrown if a machine called @machineName cannot
			be found or the receiver has not been setup."
* addSpace: spaceName at: urlList
	"ACTION
		Add to the receiver a specification for a space named @spaceName.
		The space's location is described by @urlList.  

	PARAMETERS
		spaceName : <IuSstComponentName>
		urlList : <Collection of <String> | <IuSstUrl>>

	NOTES
		This method is intended to be used when before setting up the 
		receiver (#setupFor:using:) and should not be used after the 
		receiver has been started.  Use #addRemoteSpace:at: to add 
		new remote spaces."
* name
	"ACTION
		Answer the name of the receiver.

	RETURN VALUE
		<String>"
* properties
	"ACTION
		Answer the <Dictionary> of keys and values associated with the 
		receiver.  The contents and semantics of the return value are defined 
		by the user.   Users are expected to directly manipulate this collection
		to effect changes in the receiver's property settings.

	RETURN VALUE
		<Dictionary>

	NOTES
		Certain SST subsystems require that the user to set context properties
		(e.g, the type repository in RMI).  Specific API is provided for setting these
		values."
* removeSpace: oldSpace
	"ACTION
		Remove space @oldSpace from the receiver's list of available 
		spaces.  Note that requests to remove the receiver's %space (i.e., 
		the local space) are ignored.  All transient references to objects in 
		@oldSpace are invalidated and @oldSpace's machine is also 
		removed.

	PARAMETERS
		oldSpace : <IuSstRemoteSpace>"
* reset
	"ACTION
		Reset the receiver to its initial state (i.e., that when it was 
		instantiated).  Related processes, state and resources will be 
		released or emptied as required.  From this state the receiver 
		can be sent #startUp.

	NOTES
		This method assumes that the receiver has been #shutDown."
* restartMode
	"ACTION
		Return the receiver's current restart configuration setting.  See
		#restartMode: for details.

	RETURN VALUE
		{SstClearMode, SstCleanUpMode, SstRestartMode}"
* restartMode: value
	"ACTION
		Configure what is done with any SST components related to the 
		receiver when the image is restarted (i.e. image load time).  
		The choices here are: 
			SstClearMode - Clear out the whole system using #clear.  This 
				overrides the settings of the receiver's components.
			SstCleanUpMode - Clean up the receiver according to the 
				configuration of its components.
			SstRestartMode - SstCleanUpMode then restart the system 
				using #startUp.

	PARAMETERS
		value : {SstClearMode, SstCleanUpMode, SstRestartMode}"
* setupFor: spaceName using: config
	"ACTION
		Setup the receiver to run in the object space named @spaceName 
		configured according to @config.  This method can only be called once
		and should be done after all statically known space/machine 
		specifications have been added (see #addSpace:*). Once this 
		method has completed the receiver may be #startUp'd.  Note that 
		further remote spaces can be added using #addRemoteSpace:*.

	PARAMETERS
		spaceName : <IuSstComponentName>
		config : <SstSpaceConfiguration>

	EXCEPTIONS
		ExSstSetupError : Thrown if the receiver (or its constituents) are not 
			properly configured to be setup."
* space
	"ACTION
		Answer the space in which the receiver is running.

	RETURN VALUE
		<IuSstLocalSpace>"
* spaceFor: id
	"ACTION
		Answer the space registered under the name @id.  If is none, 
		answer nil.

	PARAMETERS
		id : <IuSstComponentName>

	RETURN VALUE
		<IuSstObjectSpace> | nil"
* spaceFor: id ifNone: absentHandler
	"ACTION
		Answer the space registered under the name @id.  If there is 
		none, answer the result of evaluating @absentHandler with no
		arguments.

	PARAMETERS
		id : <IuSstComponentName>

	RETURN VALUE
		<IuSstObjectlSpace> | <Object>"
* spaces
	"ACTION
		Answer a collection of all spaces managed by the receiver.

	RETURN VALUE
		<Collection of <IuSstObjectSpace>>"

[FIRST] [PREV] [NEXT] [LAST]