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.
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
This command runs the Java garbage collector. This command does not fix memory issues and should not be used or needed.
This command displays a list of available console commands.
Displays information on the specific command.
Displays information on the subcommand.
This command reports the status of a channel.
Reports on one or all channels. If the name is included, the configuration is reported.
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
This command prints one or more lines in a trace. You can use this to regulate reading a long trace file.
Displays a number of lines. The default is one.
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.
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
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). |
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.
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.
This command is used to set a parameter.
Displays a help line of the objects that can be set.
Shows the current settings.
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.
Adds the current time to all traces displayed at the console.
This command starts one or more (named) channels.
The formats are:
Starts all active channels.
Starts one listener.
Starts one or more specific channels.
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
Sets the statistics counters to zero.
This command stops one or more (named) channels.
Stops all listeners active channel.
Stops one channel.
Stops one ore more specific channels.
This command is used to display thread information.
Places the output into a file that is specified.
Displays thread information.
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]
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.
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.
iWay Software |