Service Response Monitor › Configuration › Edit the Control File

Edit the Control File

You can configure SRM options by adding, deleting, or modifying entries in the SRM configuration file (svcrsp.cf). For example, you may need to change the number of active threads at some point and can do this easily by editing svcrsp.cf. Be sure to stop the SystemEDGE before editing the configuration file and then restart it.

When the SystemEDGE starts (and the SRM AIM is configured to load), the agent reads the svcrsp.cf file to determine the configuration. If you are an advanced user who is very familiar with SystemEDGE and SRM, you can use the svcrsp.cf file to specify the services that you want the agent to measure. If you are configuring several systems to measure services throughout an enterprise, you can create a single svcrsp.cf file and deploy that file to all of your systems.

As an alternative to editing svcrsp.cf manually, you can use the svcwatch utility to update the svcrsp.cf file dynamically. For more information, see SRM CLI Commands.

To edit svcrsp.cf manually

1. Stop the SystemEDGE on the system on which you want to edit the file:
   • For UNIX systems, log in as root and enter the following at the command line, depending on your system:

     Solaris and Linux:

     /etc/init.d/sysedge stop  
     

     HP-UX:

     /sbin/init.d/sysedge stop  
     

     AIX:

     /etc/rc.d/sysedge stop
     

   • For Windows systems, use the SystemEDGE Control Panel to stop SystemEDGE.

     Note: For information about the name and location of the SystemEDGE startup script for your operating system, see the SystemEDGE User Guide.

2. Open the svcrsp.cf file for editing. The default locations of svcrsp.cf are as follows:
   • Solaris, HP-UX, AIX, Linux: /opt/CA/SystemEDGE/plugins/svcrsp
   • Windows: drive:\Program Files\CA\SystemEDGE\plugins\svcrsp
3. Restart the SystemEDGE agent as follows:
   • For UNIX systems, enter the following at the command line, depending on your system:

     Solaris and Linux:

     /etc/init.d/sysedge start  
     

     HP-UX:

     /sbin/init.d/sysedge start 
     

     AIX:

     /etc/rc.d/sysedge start
     

   • For Windows systems, use the SystemEDGE Control Panel to start SystemEDGE.

Configuration File Format

The SRM configuration file consists of a series of entries that are delimited by braces ({ }). Each field within an entry is keyword dependent (but not order dependent). You can ignore optional fields. The format for an entry is as follows:

{
index= 
type= 
desc=" " 
dest=" " 
args=" " 
username=" " 
encoded=yes 
password=" " 
interval= 
samples= 
timeout= 
window= 
tos= 
limit= 
status= 
name=
class=
context=
flags=
loglevel=
}

Note: If you want to edit the password field manually, you must first specify encoded=no. You can then type in the password in plain text. After you change the password, reset the encoded field to yes, and then restart SystemEDGE. SRM encodes the password to mask it, but the password is neither encrypted nor secure.

Sample Entries

For sample svcrsp.cf entries for each test type, see the example sections for the following services:

• Active Directory
• Custom
• DHCP
• DNS
• FILE I/O
• FTP
• HTTP
• HTTPS
• IMAP
• LDAP
• MAPI
• NIS
• NNTP
• PING
• POP3
• Round-Trip Email
• SMTP
• SNMP
• SQL Query
• TCP Connect
• TFTP
• Virtual User (Windows only)

For a list of keywords for each test, see Keywords for Tests.