InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.0: About user assistance >
6.6.0.2: Command line administration >
6.6.0.2.2: WebSphere Control Program (wscp) >
6.6.0.2.2.2: Command syntax and usage >
6.6.0.2.2.2.2: Invoking and terminating wscp

6.6.0.2.2.2.2: Invoking and terminating wscp

To invoke wscp, use one of the following procedures.

  • To run wscp with its default extensions loaded, enter one of the following at the command prompt:

    • On Unix systems:
      > wscp.sh
      

    • On Window systems:
      C:\ wscp.bat
      

  • To run wscp with different extensions loaded, do the following:

    1. Set up the CLASSPATH environment variable, including the appropriate JAR files.

    2. Run Java, invoking the following:

      • The wscp Tcl shell (the com.ibm.ejs.sm.ejscp.WscpShell class)

      • Desired extensions (the -x option). Extensions can also be loaded interactively.

    3. Optionally, set properties to enable tracing.

When wscp is invoked without specifying the -p option, the property file homeDirectory/.wscprc is loaded if it exists, where homeDirectory is the value of the Java property user.home. The .wscprc file can be used to automatically load settings for various properties, amending or replacing system properties already defined. For example, you can modify the values of the wscp.hostName and wscp.hostPort properties to connect to a remote node. See 6.6.0.2.2.2.4: Connecting to local and remote nodes for details.

Note that the value of the Java user.home property can differ depending on the SDK version level. On Windows NT systems, the SDK 1.2.2 used by WebSphere Application Server sets the user.home property based on the value of the USERPROFILE environment variable.

The following example .wscprc file specifies values for various properties.

#
# primaryNode is used with qualifyHomeNames (default=hostName property)
#
# wscp.primaryNode=pc-dev1
#
# hostName is used for com.ibm.CORBA.BootstrapHost
#
wscp.hostName=pc-dev1
#
# hostPort is used for com.ibm.CORBA.BootstrapPort (default=900)
#
# wscp.hostPort=900
#
# wscp.remotePasswordFile (default : uses random number for password)
# wscp.remoteConnectionTimeout (default = 300 seconds)
# wscp.remoteConnectionsAllowed (default = false)
# wscp.remoteHostListAccept (default = null, colon-separated string)
# wscp.remoteHostListReject (default = null, colon-separated string)
#
wscp.remotePasswordFile=C:/TEMP/password
wscp.remoteConnectionTimeout=300
wscp.remoteConnectionsAllowed=true
wscp.remoteHostListAccept=abc.def.com:abc.com
wscp.remoteHostListReject=dhcp-198-7.abc.def.com
#
# set traceString to enable tracing
#
# wscp.traceString=com.ibm.ejs.sm.client.ui.desc.*=all=enabled
# wscp.traceString=com.ibm.ejs.sm.ejscp.*=all=enabled
##
# Typically, these need to be set if only ContextExtension is loaded
# (otherwise, EjscpExtension sets them as noted above)
#
# com.ibm.CORBA.BootstrapHost=pc-dev1
# com.ibm.CORBA.BootstrapPort=900
# java.naming.factory.initial=com.ibm.ejs.ns.jndi.CNInitialContextFactory

The exit command terminates an wscp interactive session.

Go to previous article: 6.6.0.2.2.2.1: Basic syntax Go to next article: 6.6.0.2.2.2.3: Authenticating to the administrative server

 

 
Go to previous article: 6.6.0.2.2.2.1: Basic syntax Go to next article: 6.6.0.2.2.2.3: Authenticating to the administrative server