Operation void getSubordinateOS (Name subordinateOSName = NA, OperationsSystem subordinateOS = NA), in Class OperationsSystem

Documentation
This operation returns the data structure associated with a given subordinate OS identified by the provided subordinateOSName.
The operation can only be directed to a top-level OS and not to a subordinate OS.
Operation Exceptions:
1. INTERNAL_ERROR - Raised in case of non-specific OS internal failure.
2. NOT_IMPLEMENTED - Raised when the OS does not support this operation.
3. INVALID_INPUT - Raised when subordinateOSName does not reference a subordinate OS object.
4. ENTITY_NOT_FOUND - Raised when subordinateOSName references a subordinate OS object that does not exist.
5. COMM_FAILURE - Raised when communication to an entity (needed to help fulfill the request) is lost.

Protocol |  | Qualification |
Exceptions |  | Size |
Time |  | Concurrency | Sequential
Export Control | PublicAccess |  |

Preconditions
None
Postconditions
No change in the system.
Semantics

Arguments

subordinateOSName
/* in */ The name of the subordinate OS to retrieve.
subordinateOS
/* out */ The object associated with the addressed subordinate OS.