Account Manager Utility

The CONTROL-M Option for the R/3 Account Manager utility is used to
define user accounts that are authorized to work with CONTROL-M
Option for R/3 on the R/3 Client machine. The Account Manager utility
is the same for both Standard and Extended modules.

Note
The procedure shown below describes how to work with user accounts
by using a set of Account Manager menus. In addition to these menus,
certain actions can be requested directly from the command line (without
requiring navigation of the Account Manager menus). For more
information about these special command lines, see “Account Manager
Shortcuts” below.

Note
For Windows Users: Before defining a new account, the following path
<r3 installation full path>/exe must be added to your environment.

To invoke the Account Manager utility:

Step 1 Log in to the machine and go to the following directory:

<controlm interface directory>/r3/exe/

Step 2 Specify the following command:

ctm_r3_acc_man

Step 3 The Account Manager Main menu is displayed:

CONTROL-M Option for R/3 Interface

Account Manager

Main Menu

Current Account Definition File: /home/users/ctmagent/r3.3/acc_file

BMC Software, Inc., Confidential and Proprietary Information

3-4 CONTROL-M Option for R/3

 1) Set Administrator Password
2) Add R/3 Account
3) Change/Show R/3 Account
4) Remove R/3 Account
5) Check R/3 Account
q) Quit
==>

Step 4 To add user accounts, select option 2 from the Main menu. The following
screen is displayed:

CONTROL-M Option for R/3 Interface

Account Manager
Add Account
Enter Account Name or leave blank for cancel
Account Name :user1

Step 5 Enter an Account name. The Account name has no connection to either
the operating system login name or SAP login name.

Step 6 After you press Enter, a screen similar to the following is displayed:

CONTROL-M Option for R/3 Interface

Account Manager
Select Account
1) controlm 2) user1
Enter q for quit or number 1 -> 2 for add-template : 1

The Account Manager allows you to copy account details from one user
account (template) to another.

If you specify q to exit the screen, you will need to specify details for the
new account using option 3, Change/Show R/3 Account, on the Main
menu.

Step 7 Specify the account to copy and press Enter. A details screen similar to
the following is displayed:

BMC Software, Inc., Confidential and Proprietary Information

Interface Utilities 3-5

 CONTROL-M Option for R/3 Interface
Account Manager
Change/Show Account
1) Account Name : controlm
2) R/3 System Name : CTM
3) R/3 System Number : 01
4) R/3 Client : 010
5) R/3 User : controlm
6) R/3 User Password : *****
7) R/3 Language : EN
8) R/3 Server IP Name : atlas
9) OS-User for Account: *

s) save
q) quit

Specify the number of each detail you wish to change. You are prompted
for the required information. Specify Save (s) to save the details for the
account. Even if you do not make any changes to the copied template,
you must specify Save to save the account details.

Specify Quit (q) to exit the screen. You can return to this screen, at any
time, by selecting option 3, Change/Show R/3 Account, from the main
menu.

Step 8 To verify that an account has been logged in to R/3, that the system
exists, or that the client machine is connected, select option 5, “Check
R/3 Account”, from the main menu. A screen similar to the following is
displayed.

CONTROL-M Option for R/3 Interface

Account Manager
Select Account
1) controlm 2) user1 3) user2
Enter q for quit or number 1 -> 3 for check : 1

Specify the account to check and press Enter. Messages similar to the
following are displayed.

Sun, 24.06.01, 12:41:03 M0005 XBP_logon: R3 Version=45, Interface=XBP, XBP

Version=1.0 , Company=BMC, Product=ctm_r3

Sun, 24.06.01, 12:41:11 M0005 Logon to SAP R/3 46C XBP - Interface
successfull (ID C0A8E4D80810)

Communication OK !

BMC Software, Inc., Confidential and Proprietary Information

3-6 CONTROL-M Option for R/3

 Press enter to continue

Step 9 Press Enter to continue, and press q to exit the “Select Account” screen.

Step 10 Select Quit (q) to exit the Account Manager.

Account Manager Shortcuts

Certain special command lines enable you to perform Account Manager

tasks without requiring navigation of the Account Manager menus.

To list minimal information about user accounts:

Use the following command line to list basic information about either a
specified account, or a list of accounts in the specified file.

./ctm_r3_acc_man -list <account-names-file>

For example:

./ctm_r3_acc_man -list

Produces the following output:

Using File: /marius/ctmagent/r3/data/acc_file

Defined Accounts:
1. SAP
1 accounts found

To list detailed information about user accounts:

Use the following command line to list detailed information about either
a specified account, or a list of accounts in the specified file.

./ctm_r3_acc_man -list <account-names-file> -full

BMC Software, Inc., Confidential and Proprietary Information

Interface Utilities 3-7

 For example:

./ctm_r3_acc_man -list SAP -full

Produces the following output:

Using File: /marius/ctmagent/r3/data/acc_file

Account Name : SAP
R/3 System Name : S45
R/3 System Number : 03
R/3 Client : 020
R/3 User : CONTROLM1
R/3 User Password : ******
R/3 Language : EN
R/3 Server IP Name : atlas
OS-User for Account : *

1 accounts found

To copy a user account:

Use the following command line to copy a user account.

./ctm_r3_acc_man -copy <source account name> <target account name>

All account information is copied to the new account with the specified
name.

For example:

./ctm_r3_acc_man -copy SAP SAP1

Produces the following output:

Using File: /marius/ctmagent/r3/data/acc_file

Account SAP1 created (copy from account SAP)
1 accounts created
2 Accounts saved !

BMC Software, Inc., Confidential and Proprietary Information

3-8 CONTROL-M Option for R/3