scc Command

Use scc.bat (Windows) or scc.sh (UNIX) to start and stop Sybase Control Center agents and servers and to perform administrative tasks like configuring ports and enabling and disabling services.

Syntax

scc[.bat | .sh] [-a | --address RMI-service-address] 
[-b | --bitwidth] 
[--dbpassword]
[-disable | --disable service-name,service-name...] 
[-enable | --enable service-name,service-name...]
[-h | --help] 
[-I | --info [information-category]]
[-instance [instance-name]] 
[-m | --message message-level] 
[-password | --password password] 

[-p | --port {port-name=port-number | 
    service-name:property-name=port-number}]
[{-start | --start} | {-stop | --stop}] 
[-status | --status] 
[-user | --user login-name] 
[-v | -version | --version]

Parameters

-a | --address RMI-service-address – the address for the RMI service to use; must be an IP address on this machine or the name of this machine (which is the default).
-b | --bitwidth – returns a string identifying the bit width (32 or 64) of the underlying platform; Sybase Control Center uses this option to determine which libraries to use for its internal database. If you use this option, the scc command does not start Sybase Control Center.
--dbpassword – changes the password of the default dba account provided for the repository database. It prompts you for the new password, validates it, and starts the Sybase Control Center server. This option does not work if you start Sybase Control Center in the background—the server fails to start if there is no console.
-disable | --disable service-name,service-name... – disable the specified Sybase Control Center services. This option does not work while Sybase Control Center is running or as part of a command that starts SCC. To use it, shut down SCC, execute scc --disable, then restart. See under --ports for service names; separate each service from the next with a comma.
-enable | --enable service-name,service-name... – enable the specified Sybase Control Center services. See under --ports for service names; separate each service from the next with a comma. When you use this option, scc does not start Sybase Control Center—use a separate command to start SCC.
-h | --help – display help and usage information for the scc command. If you use this option, scc does not start Sybase Control Center.
-I | --info [information-category] – display the specified categories of information about Sybase Control Center. Separate each category from the next with a comma. The information categories are:
- all – returns all the information provided by the sys, ports, and services categories. Default option.
- sys – returns general information about this instance of Sybase Control Center, including the version, the home (installation) directory, the host machine’s name and IP address, the RMI port number, the messaging level, and details about the platform and Java installation.
- ports – lists all the ports on which the Sybase Control Center agent and its services listen, indicates whether each port is in use, and shows the service running on each port.
- services – lists all the services known to the Sybase Control Center agent, indicates whether each service is enabled, and lists other services on which each service depends.
- sysprop – lists all the Java system properties known the Java VM and their values.
- env – lists the complete Java VM process environment.
-instance [instance-name] – use with other options (-start and -stop, for example) to specify a Sybase Control Center instance in a shared disk deployment. If you do not enter a name for the instance, it defaults to the host name.
-m | --message message-level – set the amount of detail recorded in system logs; also known as the logging level. Valid values are OFF, FATAL, ERROR, WARN, INFO, DEBUG, and ALL. WARN is the default.
-password | --password – specify the password of the user account Sybase Control Center will use to stop servers or query them for status. Use this option with --user. When you enter a command with --user but without --password, the console prompts you to enter a password.

-p | --port {port-name=port-number | service-name:property-name=port-number} – configure the specified service to run on the specified port. Changing ports is useful if you discover a port conflict between Sybase Control Center and other software on the same system. When you use this option, scc does not start Sybase Control Center—use a separate command to start SCC.

Valid port names, service names and property names are:

Port Name	Description	Service Names	Property Names	Default Port
db	Database port Present on SCC server	SccSADataserver Messaging Alert Scheduler	com.sybase.asa.server.port messaging.db.port alert.database.port org.quartz.dataSource.ASA.URL	3638
http	Web HTTP port Present on SCC server	EmbeddedWebContainer	http.port	8282
https	Web HTTPS (secure HTTP) port Present on SCC server	EmbeddedWebContainer	https.port	8283
jiniHttp	JINI HTTP server Present on SCC server and SCC agent	Jini	httpPort	9092
jiniRmid	JINI remote method invocation daemon Present on SCC server and SCC agent	Jini	rmidPort	9095
msg	Messaging port Present on SCC server	Messaging	messaging.port	2000
rmi	RMI port Present on SCC server and SCC agent	RMI	port	9999
tds	Tabular Data Stream™ port (used to communicate with other Sybase products) Present on SCC server and SCC agent	Tds	tdsPort	9998

You can also execute scc --info ports to display service names and associated property names; they appear in the first two columns of the output.

-start | --start – start the Sybase Control Center server. This is the default option—if you execute scc with no options, it starts SCC. This option cannot be combined in the same command with options that set ports or enable or disable services; use a separate scc command to start SCC.
-status | --status – display a status message indicating whether the Sybase Control Center server is running.
-stop | --stop – shut down the Sybase Control Center server if it is running.
-user | --user [login-name] – specify the user account Sybase Control Center will use to stop managed servers or query them for status. Use this option with --password. If you do not enter a login name, the console prompts you to enter one.
-v | -version | --version – display the version of Sybase Control Center software running on this server. If you use this option, scc does not start Sybase Control Center.

Examples

Set the RMI port – each of these commands sets the RMI port to 9999 (the default). The first command illustrates the port name syntax; the second illustrates the service name:property name syntax.
```
scc --port rmi=9999
scc --port RMI:port=9999
```
Set the RMI port and start SCC – these commands set the RMI port to 9996, then start SCC. Two commands (separated by a semicolon here) are needed because scc does not start Sybase Control Center when it includes any of the port-setting options.
```
scc -p rmi=9996; scc
```
Set all database ports – this command sets all four of the SQL Anywhere database ports (data server, messaging, database alert, and scheduler) to 3638. (SQL Anywhere is the Sybase Control Center internal repository.)
```
scc --port db=3638
```
Set the TDS port – this command sets the TDS port to 9998 (the default):
```
scc --port Tds:tdsPort=9998
```
Enable a service and start SCC – the first scc command enables the TDS service; the second starts SCC. (The two commands are separated by a semicolon.) The second command is needed because scc does not start Sybase Control Center when it includes the -enable option.
```
scc -enable Tds; scc
```
Start an SCC instance – this command starts the SCC instance called kalamazoo. -start is optional because it is the default.
```
scc -start -instance kalamazoo
```

Permissions

scc permission defaults to all users. No permission is required to use it.