-set_owner_info

Syntax: -set_owner_info

You can use the -set_owner_info parameter to specify the owner information that appears on the screen of the BlackBerry device when it is locked.

-set_owner_info : set owner information
    -u <user name> : user name
        [-b <instance>] : instance name of the BlackBerry Enterprise Server
                          component
        [-utype <type>] : user type - display_name, email_address,
                          login_name, canonical_name
    [-name <name>] : user name that appears on the BlackBerry device
    [-info <info>] : owner information that appears on the BlackBerry
                     device
    or
    [-infofile <filename>] : filename that contains owner information

Subparameter

Description

-b <server_name>

This subparameter specifies the BlackBerry Enterprise Server instance for the action.

You use the name of the BlackBerry Enterprise Server instance as it appears in the BlackBerry Administration Service.

-info <owner_information>

This subparameter specifies the owner information to display on the screen of the user's device when it is locked. If the text contains spaces, enclose the text in quotation marks (" ").

Use this subparameter with the -name subparameter. You can use the -info and -name subparameters instead of the -infofile subparameter.

-infofile <infofile.txt>

This subparameter specifies the name of the input text file that contains the owner information text.

You can use this subparameter instead of the -name and -info subparameters.

-name <name>

This subparameter specifies the user name that appears on the device when it is locked.

Use this subparameter with the -info subparameter. You can use the -info and -name subparameters instead of the -infofile subparameter.

-u <user_name>

This subparameter specifies the user account for the action. Searches are not case-sensitive. If the value that you specify contains a space, enclose the value in quotation marks (for example "Julie Palmer").

Examples of specifying a user account:

  • -u "Julie Palmer" -utype display_name
  • -u jpalmer@test.net -utype email_address
  • -u JPalmer -utype login_name
  • -u “CN=Julie Palmer/O=Server01” -utype canonical_name

If you do not specify a type using the -utype subparameter, the tool searches for user accounts using the display name first, then the email address, then the login name, and then the canonical name. Searching by canonical name is available for the BlackBerry Enterprise Server for IBM Lotus Domino only, and is the least preferred method of searching for user accounts.

Searches (except by canonical name) match on substrings. For example, if you specify -u jpalmer@test.rim.net, and your organization's environment contains the user accounts jpalmer@test.rim.net, ojpalmer@test.rim.net, and rjpalmer@test.rim.net, the search identifies all three user accounts as valid results. If the tool finds more than one user account, the tool selects the user account that matches the value that you specified exactly (in this case, jpalmer@test.rim.net).

If the tool finds more than one user account, and none of the user accounts match the value that you specified exactly, the tool returns an error message stating that multiple matches were found. If you do not want searches to match on substrings, specify the value using the following format: "\"<user>\"" (for example, "\"jpalmer@test.rim.net\"").

-utype <type>

This subparameter specifies which of the following options the tool uses to search for the user account:
  • display_name
  • email_address
  • login_name: name that the account uses to log in to the BlackBerry Administration Service
  • canonical_name


Was this information helpful? Send us your comments.