iWay Service Manager Console Commands

In this section:

 

iWay Service Manager (iSM) provides console commands to assist you during server operation and while troubleshooting runtime problems. This section lists the available iSM console commands that you can use. Commands are not case sensitive, however names (for example, a channel name to be displayed) are case sensitive.


Top of page

x
Diagzip

This command creates a diagnostic information file for use by iWay Support.


Top of page

x
Errors

This command lists the last ten errors that are traced by the server.


Top of page

x
Func

This command lists the available iWay Functional Language (iFL) functions available in the server. Some functions are provided by special product components while others may be written by the user.

For more information about iFL functions, see the iWay Service Manager Component and Functional Language Reference Guide.

_ADD

_AFTER

_ALL

_ANY

_ATTCNT

_ATTHDR

_ATTHDRIC

_BASE64

_BEFORE

_CEIL

_CONCAT

_COND

_CONTAINS

_COUNT

_DECODE64

_DEENTITY

_DIV

_ENCODE64

_ENDSWITH

_ENTITY

_EVAL

_EXIST

_EXISTS

_FBN

_FILE

_FLATOF

_FLOOR

_FMTINT

_FROMBASE64

_FTSTAMP

_HASRULEERR

_HASSCHEMAERR

_IDIV

_INT

_ISEOS

_ISERROR

_ISFLAT

_ISROOT

_ISWELLFORMED

_ISXML

_IWXPATH

_LCASE

_LDAP

_LENGTH

_MOD

_MUL

_NORMALIZESPACE

_NOW

_PROPERTIES

_PROPERTY

_QVAL

_RANDOM

_ROOT

_SREG

_STARTSWITH

_SUB

_SUBSTR

_TOKEN

_TPA

_TPN

_TPP

_TRIM

_TSTAMP

_UCASE

_UNQ

_URL

_URLDECODE

_URLENCODE

_URLPARSE

_XFLAT

_XLOOK

_XML

_XPATH

     

A list of the parameters for any function can be obtained by entering its name. For example:

func _ldap

The following is returned:

_ldap     Get attribute from LDAP repository
   1   filter     required	   Selection expression
   2   attribute  required	   Attribute to be accessed from the repository
   3   context    optional	   Context to be applied to the search


x
GC

This command runs the Java garbage collector. This command does not fix memory issues and should not be used or needed.


Top of page

x
Help

This command displays a list of available console commands.

help <command>

Displays information on the specific command.

help <command><subcommand>

Displays information on the subcommand.


Top of page

x
Info

This command reports the status of a channel.

info [<name>]

Reports on one or all channels. If the name is included, the configuration is reported.


Top of page

x
License

Displays available iWay license codes. For example:

All authorized features
	AIPO, EXML, I11A, I14A, I15A, I15B, I16A, I17A, I18A, I19B
	I2DP, I2FP, I2IP, I2RP, I2SP, IA12, IABY, IAR, IAS2, IASE
	IAXN, IBBC, IBEA, IBOO, IBRC, IBSE, ICEB, ICLA, ICMS, ICOR
	IEDC, IEDI, IEPA, IFA, IFIX, IGOG, IHLA, IHPP, IIEA, IJAC
	IJB2, IJB5, IJCA, IJDE, ILAW, IMB2, IMFG, IMNA, IMQA, IMSX
	IODB, IODC, IORF, IPC, IPFLW, IPS7, IPS8, IRJD, IRPS, IRSA
	IRSB, ISAA, ISAB, ISAM, ISI7, ISIE, ISIR, ISJE, ISMO, ISO1
	ISWF, ISXI, ITA, ITPL, ITPM, IUA, IUCA, IVAN, IWAEA, IWAEJ
	IWAES, IWAR, IWCC, IWEE, IWSB, IXDA, IXMC, IXTS, IXTW, SAIC
	XMLS

Top of page

x
Line

This command prints one or more lines in a trace. You can use this to regulate reading a long trace file.

line <count>

Displays a number of lines. The default is one.


Top of page

x
Memory

This command displays memory statistics. Interpretation of memory usage statistics are beyond the scope of this document. For display purposes, some of the repetitive portions of the examples have been omitted.

Memory

Provides a simple display.

memory max 65088K used 9336K, free 464K,
	nodes: total allocated 7441 namespace 3604
	Maps: funcs 0, xpath 0
	Heap: init 0K, used 8932K, commit 9336K, max 65088K
	Non-Heap: init 28864K, used 22852K, commit 32096K, max 118784K
	Garbage Collection Info
	Name: Copy   Collection count: 203   time: 454ms
	Name: MarkSweepCompact   Collection count: 0   time: 0ms
Memory detail

Provides a more comprehensive display.

memory max 65088K used 9336K, free 899K,
	nodes: total allocated 7441 namespace 3604
	Maps: funcs 0, xpath 0
	Heap: init 0K, used 8438K, commit 9336K, max 65088K
	Non-Heap: init 28864K, used 22860K, commit 32096K, max 118784K
	Garbage Collection Info
	Name: Copy   Collection count: 204   time: 455ms
	   Memory Pools:
	     Eden Space
	     Survivor Space
	Name: MarkSweepCompact   Collection count: 0   time: 0ms
	   Memory Pools:
	     Eden Space
	     Survivor Space
	     Tenured Gen
	     Perm Gen
	     Perm Gen [shared-ro]
	Memory Pools Info
	Name: Code Cache
	  Usage: init 192K, used 1613K, commit 1632K, max 32768K
	  Peak Usage: init 192K, used 1613K, commit 1632K, max 32768K
	  Type: Non-heap memory
	  Memory Manager Names: CodeCacheManager
	Name: Eden Space
	  	.
		.
		
	Name: Perm Gen [shared-rw]
	  Usage: init 12288K, used 5821K, commit 12288K, max 12288K
	  Collection Usage: init 12288K, used 0K, commit 0K, max 12288K
	  Peak Usage: init 12288K, used 5821K, commit 12288K, max 12288K
	  Type: Non-heap memory
	  Memory Manager Names: MarkSweepCompact

The system controls Java memory, which falls into four major categories.

Field

Description

init

Represents the initial amount of memory (in bytes) that the Java virtual machine requests from the operating system for memory management during startup. The Java virtual machine may request additional memory from the operating system and may also release memory to the system over time. The value of init may be undefined (0) on some platforms.

used

Represents the amount of memory currently used.

committed

Represents the amount of memory (in bytes) that is guaranteed to be available for use by the Java virtual machine. The amount of committed memory may change over time (increase or decrease). The Java virtual machine may release memory to the system and committed could be less than init. Committed will always be greater than or equal to used.

max

Represents the maximum amount of memory (in bytes) that can be used for memory management. Its value may be undefined. The maximum amount of memory may change over time if defined. The amount of used and committed memory will always be less than or equal to max if max is defined. A memory allocation may fail if it attempts to increase the used memory such that used is greater than committed even if used is less than but equal to max would still be true (for example, when the system is low on virtual memory).



x
Pull

This command can be used to load information from another iSM configuration/installation.


Top of page

x
Quit

This command terminates the iSM configuration. The quit command cannot be issued by a remote management console. All channels must be stopped for the quit command to be used.


Top of page

x
Refresh

This command reinitializes one named channel. If the channel is currently operating, it is stopped and then restarted. This command is useful if configuration parameters on a channel change in a way that cannot be automatically detected by the server. For example, a change may occur in a referenced property file or special register that is referenced by the configuration.


Top of page

x
Run

This command runs a command file.


Top of page

x
Set

This command is used to set a parameter.

set help

Displays a help line of the objects that can be set.

set display

Shows the current settings.

set <travelevel> on|off [-save] [-master <name>]

Sets a trace level. The trace level change can be saved in the dictionary such that it becomes permanent. A setting can be applied to a single master/channel by name, but master-level settings cannot be saved.

set time on|off

Adds the current time to all traces displayed at the console.


Top of page

x
Shell

This command attempts to run an operating system command.


Top of page

x
Show

This command displays server information.


Top of page

x
Start

This command starts one or more (named) channels.

The formats are:

start [all]

Starts all active channels.

start <name>

Starts one listener.

start (<name>,<name>*)

Starts one or more specific channels.


Top of page

x
Stats

This command reports statistics on the current activity of the server. The Ehrlang coefficient is shown as a constant until enough information is available to compute a valid value other than 1.0. The number per second computation assumes a steady input and is used for guidance purposes only. It is based on wall clock time.

in secs    count   low   high   mean variance std.dev.   ehr  n/sec
SOAP1
    wall:     0   0.0000   0.0000   0.0000   0.0000   0.0000     -       
    cpu :         0.0000   0.0000   0.0000   0.0000   0.0000     -       
    user:         0.0000   0.0000   0.0000   0.0000   0.0000     -       
filein
    wall:     3   0.0000   0.0160   0.0103   0.0001   0.0073 const 196.77
    cpu :         0.0000   0.0156   0.0052   0.0001   0.0074 const       
     user:         0.0000   0.0156   0.0052   0.0001   0.0074 const  
stats reset

Sets the statistics counters to zero.


Top of page

x
Stop

This command stops one or more (named) channels.

stop [all]

Stops all listeners active channel.

stop <name>

Stops one channel.

stop (<name>[,<name>*)

Stops one ore more specific channels.


Top of page

x
Threads

This command is used to display thread information.

thread dump filename

Places the output into a file that is specified.

threads [monitor | dump]

Displays thread information.

thread (no operands)

Each channel is shown. Under the manager, there is one thread for each channel name (called listener, SOAP1, and filein). Each has a set of threads for its message channel. For example, there are three message channels for the filein listener, called W.filein.1, W.filein.2, and W.filein.3. The state of each thread is shown below.

SOAP1:
	Thr-HSOAP1  [runnable]
	Thr-FSOAP1  [timed_waiting]
filein:
	W.filein.1  [timed_waiting]
	W.filein.2  [timed_waiting]
	W.filein.3  [timed_waiting]
manager:
	console0  [blocked]
	console1  [runnable]
	console2  [blocked]
	console3  [blocked]
	console4  [blocked]
	SOAP1  [timed_waiting]
	filein  [timed_waiting]
thread monitor [on | off]

Controls a check of deadlocked threads. Using this command can significantly affect system performance. As a result, It is set to no by default. To monitor deadlocks, first issue the thread monitor on command. Once issued, the thread deadblock monitor is activated. Afterwards, issue thread monitor to check for deadlocks. When you are finished testing, set the monitor off.


Top of page

x
Time

This command displays the current time in Greenwich Mean Time.


Top of page

x
Tool

iWay Service Manager provides a set of tools available to users for special purposes. These are more complex than simple commands, and each tool can maintain its own dialog with the user. An example of such a tool is testfuncs, which enables a user to test an iFL expression against a specific document or set of special registers.


Top of page

x
Type

This command types/displays the contents of a text file.


Top of page

x
Version

This command displays the product version and all later versioned .JAR files.


iWay Software