25
8.5 Entity Commands
Entities allow the user to define a group of input or output ports that should be
connected together. This allows resources to be switched as a group to an end
user. Inputs are grouped together in source entities, while outputs are grouped
together in destination entities. Any number of inputs or outputs may be included
in an entity, but there must be a one to one match-up between input ports in a
source entity and output ports in a destination entity. Entities are one of the two
predefined connection methods that level two password users may use.
EH
List entity commands
EL [<entity>]
List all entities [or entity definitions]
EN <entity>
Create new entity
ED <entity>
Delete entity
ES [<entity>]
Show entity status [for a single entity]
The
EH
command lists all the commands that are used with entities.
The
EL
command either lists all entities in memory, or one entity’s definitions. If
EL
is used by itself, the type (source or destination) and name of the entities
defined in memory will be listed. Specifying the name of an entity after
EL
lists
the type of entity (source or destination) and the chassis and port number of the
inputs or outputs that are associated with that entity name.
The
EN
command creates new entities. The name of the new entity must be
entered at the same prompt as the command. The Matrix-Hub will prompt the
user for the type of entity (source or destination), and then will ask for the internal
chassis number and port number of the inputs or outputs that are to be
associated with that entity. The user may enter as many ports as exist on the
Matrix-Hub. The user should press
<ENTER>
at the prompt to enter an entity
item to exit back to the system prompt when done.
The
ED
command will delete a single entity. The name of the entity must follow
the command on the same line. The Matrix-Hub will prompt the user for
confirmation before deleting the entity. Once an entity is deleted, it is not
recoverable.
The
ES
command lists all cur rently connected entities and the port to port
connections for those entities, or the port to port connections made for a single
entity if that entity is specified in the command line. If there are no entities
currently connected then the Matrix-Hub will only echo
success
and return to
the command prompt. The
ES
command will also list entities with identical
connection lists to the entity specified at the command line (but those entities will
not have been used to make the connections).