scc Command

Syntax

scc[.bat | .sh] [-a | --address RMI-service-address] 
[-b | --bitwidth] 
[-disable | --disable service-names] 
[-enable | --enable service-names]
[-h | --help] 
[-I | --info [information-category]] 
[-m | --message message-level] 
[-password | --password password] 
[-p | -port | -ports | --port | --ports {port-name=port-number | 
    service-name:property-name=port-number}]
[{-start | --start} | {-stop | --stop}] 
[-status | --status] 
[-user | --user login-name] 
[-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.
• -disable | --disable service-names – disable the specified Sybase Control Center services. This option does not work while Sybase Control Center is running or as part of a start command. To use it, shut down SCC, execute scc --disable, then restart. Separate each service from the next with a comma.
• -enable | --enable service-names – enable the specified Sybase Control Center services. Separate each service from the next with a comma. If you use this option, scc does not start Sybase Control Center.
• -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.
• -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 | -ports | --port | --ports {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. Valid port names, service names and property names are:

  Short name	Description	Service names	Property names	Default port number
  db	Database port	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	EmbeddedWebContainer	http.port	8282
  https	Web HTTPS (secure HTTP) port	EmbeddedWebContainer	https.port	8283
  jiniHttp	JINI HTTP server	Jini	httpPort	9092
  jiniRmid	JINI Remote Method Invocation daemon	Jini	rmidPort	9095
  msg	Messaging port	Messaging	messaging.port	2000
  rmi	RMI port	RMI	port	9999
  tds	Tabular Data Stream™ port (used to communicate with other Sybase products)	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 the server.
• -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.
• -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

• Example 1 – both of these commands set the RMI port to 9999 (the default)

  scc --port rmi=9999
  scc --port RMI:port=9999

• Example 2 – 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
  

• Example 3 – this command sets the TDS port to 9998

  scc --ports Tds:tdsPort=9998
  

Permissions

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