Name

bstr_realm_check_env − Checks whether the BASEstar Open environment has been set up and started up successfully. 
 

Syntax

bstr_realm_check_env[realm_name]

Parameters

realm_nameSpecifies the local name of the Realm that you want to check. If you specify this parameter, bstr_realm_check_env checks that realm_name matches the value of the BSTR_REALM global variable. 

Description

The check is performed on the Node on which the command is issued. Once invoked, the bstr_realm_check_env command performs the following:

•If the realm_name parameter is specified, it checks  whether the BSTR_REALM global variable has been set and whether its value is equal to realm_name. 

•Checks whether the installation-dependent  global variables have been set (that is, if the appropriate bstrusers script has been executed successfully). 

•Checks whether the directories specified in the installation-dependent global variables exist and have appropriate contents (that is, if the bstr_realm_setup_node command has been executed successfully on the Node). 

•Checks whether the account you are using is authorized for performing operations on the BASEstar Open environment. 

If any of the above checks fails, the bstr_realm_check_env command displays an error message and returns control to the command interpreter.  Otherwise, a series of messages are  displayed to inform you that the realm_name Realm  has been set up successfully on the Node. In addition, the bstr_realm_check_env command tells you whether or not the Realm has been started up successfully on the Node. 

To issue the bstr_realm_check_env command:

•Log in as a generic user on the Node for which you wish to check the BASEstar Open environment. 

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

•Set BSTR_REALM with the name of the Realm to be checked. 

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

Examples

$ setenv BSTR_REALM MY_REALM<Return>

bstr_realm_check_env <Return>

          BASEstar Open
Realm Environment Check for the Realm: MY_REALM
Global Environment Variables: Correctly Set.
Working Environment Existence: Correctly built.
Working Environment access: Accessible.
          REALM : MY_REALM
Currently Active

If you are logged in to NODE2,  this command checks whether the MY_REALM Realm has been set up successfully.

All preliminary checks were successful and MY_REALM has been started up on NODE2. 

See Also