getmasterproperty

Use the getmasterproperty subcommand to retrieve the master properties for the database set specified by the setmasterproperty subcommand.

Applicability

Platform: Windows (Its value is honored by all clients on all platforms, but installutil can only be run on Windows.)

Command type: installutil subcommand

Synopsis

installutil getmasterproperty
dbset_name [ -user_db_name user_db_name] cq_login cq_password master_property | -all

Description

The getmasterproperty subcommand retrieves the master property for the database set specified by the setmasterproperty subcommand. Use the getmasterproperty subcommand with the following master_property features.

  • HOOKS_SEE_ALL_RECORDS. Specifies whether queries executed by hooks should ignore security contexts in order to filter result sets. When TRUE, records are included in the result set even if their security contexts would have prevented the user from normally accessing them. When FALSE, the queries executed by hooks behave as they would if run by the current user. Thus, records the user would not normally be allowed to see are not in the result set.
    Note: Feature level 5 schema sets this value to TRUE, by default. Feature level 6 schema sets this value to FALSE, by default.
  • HOOKS_SEE_ALL_USERS. Specifies whether user and group queries executed by hooks should ignore group membership in order to filter result sets. When TRUE, user and group information (depending on query type) are included in the result set even if the current user is not a member. When FALSE, the user and group queries executed by hooks behave as they would if run by the current user.
    Note: Feature level 5 schema sets this value to TRUE, by default. Feature level 6 schema sets this value to FALSE, by default.
  • REMEMBER_PASSWORD. Specifies the Remember Password master property for the database set. The master property determines if any Rational® ClearQuest® Client connecting to any user database in that database set can save their password.
  • SOFT_QUERY_LIMIT. Specifies the number of rows equal to the soft limit for queries to return. Setting a limit of 0 for the property value is interpreted as allowing an unlimited number of rows.
  • HARD_QUERY_LIMIT. Specifies the absolute number of rows equal to the hard limit for queries to return. Setting a limit of 0 for the property value is interpreted as allowing an unlimited number of rows.

Options and Arguments

dbset_name
Name of the database set or connection that contains the database to be enabled for LDAP.
-user_db_nameuser_db_name
Specifies the user database to which the property applies. Default: the property applies to all user databases.
cq_login
Rational ClearQuest login name of the administrative user. This user must have Super User privileges and be marked for Rational ClearQuest authentication.
cq_password
Rational ClearQuest password for the administrative user. To specify a null password enter an empty set of double quotes.
master_property
Specifies the name of the master property to get.
new_value
Specifies the value for the master property.

Example

In the following example, the getmasterproperty subcommand returns the REMEMBER_PASSWORD property for the mydbset database set. This master property determines if any Rational ClearQuest Client connecting to any user database in that database set can save their password.
installutil getmasterproperty mydbset admin "" REMEMBER_PASSWORD
Starting test getmasterproperty
REMEMBER_PASSWORD="TRUE"
Exit code 0 for test getmasterproperty

Upon any login, the Rational ClearQuest Client checks the REMEMBER_PASSWORD property and if false, the client clears any password from the disk and sets any password in memory to zero associated with that database set.

The client can cache this value along with the rest of the connection information. This saved flag is then used by the client to determine if users are allowed to save passwords.

See also

installutil


Feedback