Name

bstr_env_show − This command displays information about the environment components (Nodes and Realms) and services (server activities, PODB and Application Management Services servers currently started up in the BASEstar Open environment. 

Syntax

bstr_env_show -q  query [-s]  |   -d

Description

The bstr_env_show command allows you to display information about the components active in your BASEstar Open environment. It displays information on Nodes, Realms, or services, depending on what is specified in the query argument of the --q qualifier. 

The bstr_env_show command displays the components that are active at the time the command is executed (it does not provide information on components that have been set up but not started). 

To execute the bstr_env_show command:

•Log in as a generic user. 

•Check that the BASEstar Open environment has been started up successfully on the Node on which you want to execute the bstr_env_show command. Note that this command accesses the Node where the Name Service server is active. 

•Ensure that the BASEstar Open installation-dependent global variables have been appropriately set, by  executing the bstrusers.sh or  bstrusers.csh script file. 

If the command completes successfully, a zero value is returned in the command exit status, otherwise a value other than zero is returned. 

Options

-q queryThe query expression specifies the kind of information displayed by the bstr_env_show command. The following expressions are valid:

•N

Displays a list of available BASEstar Open Nodes, that is, the Nodes for which the bstr_node_start command has been executed, and whose components have been started up successfully. 

•R

Displays, for each Realm, a list of the BASEstar Open Nodes on which the Realm is available. (In this context, a Realm is considered to be available on a given Node if the Communication Service is found active and running on that Node.) 

•n[:node_name]

Displays a list of the Realms currently available on the node_name Node. The services currently available for each Realm are also shown, together with the resources made available by each type  of service. (In this context, a Realm is considered to be available on a given Node if the Communication Service component is found active and running on that Node.) 

Several lines may be displayed, each containing the name of a Realm, the identifier of a service currently available on that Realm (ams, dtm, dvm, evm, or podb), and the associated resource (if significant). 

If you do not specify the node_name argument, BASEstar Open assumes by default the name of the Node on which you are executing the command. 

•
 r[:realm_name]

Displays, for the realm_name Realm, a list of the services available on the Nodes where realm_name is available, together with the list of resources that are made available by each  service. (In this context, a Realm is considered to be available on  a given Node if the Communication Service component is found active  and running on that Node.) 

Several lines may be displayed, each containing the identifier of an available service (ams, dtm, dvm, evm, or podb), the name of the Node on which the corresponding server is started up, and the associated resource (if significant). 

If you do not specify the realm_name argument, the name of the Realm set in the BSTR_REALM global variable is assumed by default. 
 

•
 s:[realm_name ]:ams|dtm|dvm|evm|mgm|podb

Displays, for the realm_name Realm, a list of the available services of a specified type (ams, dtm, dvm, evm, or podb), and informs you of the Node on which they are available. The resource (Domain or VMD) made available by each  service is also displayed, where applicable. 

Several lines may be displayed, each containing the name of the Node  on which the  corresponding server is started up, and the associated resource (if significant). 

If you do not specify the realm_name argument, the name  of the Realm set in the BSTR_REALM global variable is assumed by default. 

•d:[realm_name]:domain_name

Displays, for the domain_name Domain belonging to the realm_name Realm, which Event Services server and Data Services server Activities (evm or dtm) are available and on which Node the corresponding server has been started up. You must supply the full name of a Domain in the domain_name  argument. 

Several lines may be displayed, each containing the identifier of the available service and the name of the Node where the service is available. 

If you do not specify the realm_name argument, the name of the Realm set in the BSTR_REALM global variable is assumed by default. 

-s
  Eliminates the display of the requested information. This option is useful when the bstr_env_show command is executed from a command file. To find out the result of the command execution, examine the command exit status. 

-d
  Displays a set of formatted records, which contain all the information that can be returned by the bstr_env_show command. 

Examples

$ bstr_env_show -q N<Return>

∗∗∗     BASEstar Nodes Started     ∗∗∗
NODE
∗∗∗∗
sabato
dennix

This command displays the names of all the Nodes that are currently available in the BASEstar Open environment.

$ bstr_env_show -q R<Return>

∗∗∗     BASEstar Realms Started     ∗∗∗
REALM   NODE
∗∗∗∗∗   ∗∗∗∗
PEASANTsabato
TEST    sabato
TEST    dennix

This command  displays the names of all the Realms that are currently available in your BASEstar Open environment. The name of the Node (or Nodes)  on which the Realms are started is also displayed. The TEST Realm is started on both sabato and dennix  Nodes, while the PEASANT Realm is started on the sabato Node only.

$ bstr_env_show -q n:sabato<Return>

∗∗∗     BASEstar Realms and Services for Node sabato     ∗∗∗
REALM   SERVICEDOMAINVMD
∗∗∗∗∗   ∗∗∗∗∗∗∗∗∗∗∗∗∗∗∗∗
PEASANTAMS
PEASANTPODB
TEST    AMS
TEST    DTM    /DTM_1
TEST    DTM    /DTM_2
TEST    DTM    /DTM_3
TEST    EVM    /EVM_1
TEST    EVM    /EVM_2
TEST    MGM    /MGM_1

This command displays the list of services that are available on Node sabato, sorted by Realm.

$ bstr_env_show -q r:TEST<Return>

∗∗∗     BASEstar Services for Realm TEST     ∗∗∗
  SERVICENODE  DOMAINVMD
∗∗∗∗∗∗∗∗∗∗∗  ∗∗∗∗∗∗∗∗∗
AMS    sabato
DTM    sabato/DOMAIN_1
DTM    sabato/DOMAIN_2
DTM    dennix/DOMAIN_3
EVM    sabato/DOMAIN_1
EVM    dennix  /DOMAIN_2

This command displays the names of all  the services that are started up in the TEST Realm. For each service, the command also displays the name of the  Node where the service has been started up, and the name of the resource (or resources) made available by that service. In the example,  both the Data Services server and the Event Services server have been started for the /DOMAIN_1 domain, and both on Node sabato.

$ bstr_env_show -q s:TEST:evm<Return>

∗∗∗     BASEstar Service EVM for Realm TEST     ∗∗∗
 
NODE  DOMAIN
∗∗∗∗  ∗∗∗∗∗∗
sabato/DOMAIN_1
dennix/DOMAIN_2

This command shows that there are two active Event Services in the TEST Realm, for /DOMAIN_1 and /DOMAIN_2, respectively.  It also shows the names of the Nodes where  the corresponding Event Services servers have been started up (sabato and dennix Nodes, respectively).

$ bstr_env_show -q d:TEST:/DOMAIN_2<Return>

∗∗∗     BASEstar Services for Domain /DOMAIN_2 of Realm TEST     ∗∗∗
SERVICENODE
∗∗∗∗∗∗∗∗∗∗∗
EVM    sabato

This command shows that the server for the DOMAIN_2 Domain is currently available on Node sabato.

See Also