CACHE 数据库 ccontrol 工具的使用

郑全

--1.查看当前实例名字

[root@cache-server ~]# ccontrol default
CYYY


--2.查看当前实例情况
[root@cache-server ~]# ccontrol view

Instance 'CYYY'   (default)
        directory: /tmp/cyyy
        versionid: 2016.2.0.736.0
        conf file: cache.cpf  (SuperServer port = 1972, WebServer = 57772)
        status:    down, last used Thu Oct 19 10:15:00 2023

--3.启动

ccontrol start cyyy


[root@cache-server ~]# ccontrol start cyyy
Starting CYYY
using 'cache.cpf' configuration file

Now attempting WIJ compare, ./CACHE.WIJ

Starting Control Process
Automatically configuring buffers
Allocated 1094MB shared memory: 956MB global buffers, 35MB routine buffers
This copy of Cache has been licensed for use exclusively by:
License missing or unreadable.
Copyright (c) 1986-2016 by InterSystems Corporation
Any other use is a violation of your license agreement

2 alert(s) during startup. See cconsole.log for details.



--4.停止CACHE 服务

ccontrol stop cyyy

[root@cache-server ~]# ccontrol stop cyyy

                  Cache Shutdown Status: 10:14 am 19 Oct 2023

       1 interactive job (Telnet/Lat)
       0 background jobs (from job command)
       0 Cache Direct server jobs
       0 CSP server jobs
       0 ODBC server jobs
      20 system jobs

Do you want to broadcast a message to anyone? No => No
Do you want to see the Cache status report? No => No
Do you want to run the user defined shutdown routine? Yes => Yes
Are you ready for the system to halt? Yes => Yes

10:15:00 Shutting down Cache
10:15:00 Notifying Clients
10:15:00 No user shutdown routines to execute
10:15:00 Stopping User Jobs
10:15:00 Stopping Network Servers
10:15:00 Withdrawing from License Domain
10:15:00 Waiting for users to stop
10:15:00 Stopping Client Networking
10:15:00 Removing database locks
10:15:00 Updating Journal File
10:15:01 Waiting for database updates to complete
10:15:01 Database updates complete
10:15:01 Stopping System Jobs
10:15:03 Shutdown complete


--5.查看版本号

[root@cache-server ~]# ccontrol version
506

--6.创建实例

[root@cache-server ~]# ccontrol create his directory=/tmp/his

--7.列出所有实例


[root@cache-server ~]# ccontrol qall
    Instance Name     Version ID        Port   Directory
    ----------------  ----------------  -----  --------------------------------
up >CYYY              2016.2.0.736.0    1972   /tmp/cyyy
dn  HIS               2016.2.0.736.0           /tmp/his

--8.查看实例统计信息

[root@cache-server ~]# ccontrol stat cyyy
/tmp/cyyy/bin/cstat -s /tmp/cyyy/mgr
Cache Running version:
Cache for UNIX (Red Hat Enterprise Linux for x86-64) 2016.2 (Build 736U) Fri Sep 30 2016 12:25:56 EDT
From directory:  /source/v2016-2-0/2016_2_0_736_0/built/lnxrhx64uni/release/kernel
CSTAT Compiled with:
Cache for UNIX (Red Hat Enterprise Linux for x86-64) 2016.2 (Build 736U) Fri Sep 30 2016 12:25:56 EDT
From Directory: /source/v2016-2-0/2016_2_0_736_0/built/lnxrhx64uni/release/kernel
The time is: Thu Oct 19 10:39:00 2023
ClientSystemName (clisysname): 'CACHE-SERVER', Client LongId: 'cache-server:CYYY'

SWITCH: 0 (0x0), WDWAKE: 0, NUMCPU: 4
IJULOCK: 0, IJUCNT: 0, IJPANIC: 0, WDSTOP: 0, WDCOND: 0, WDPASS: 6
SHMLBA: 1000, GCCOUNT_MASTER: 3 GCDISMOUNT_CNT 1 GCCOUNT 0 GCTOPPNT: 2 GCCHGRDONLY: 0
BSLAV: 0, ADJWDMX: 0, MSLAV: 7, NDEV: 8, ADEV: 0, MDEV: 16
MASYNC: 0, SASYNC: 0, MWRITV: 16, WDSTGY: 1, # of buffers in wdqinmemoryq: 23

Buffer Size: 8192 Number Buffers: 122368
GWDQSize: 23, GWDQMax: 34263, GWDCurCycle: 0
GAvailBuf: 122345, GMinBuf: 36710, GMinBufBatch: 61184, MinBatch: 560
LRU Queue:  0: TotalBlks: 3824, NowInteractive: 9, NowBatch: 28
               Grequeuecnt: 9, Grequeuecntlow: 28 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667866 (size=3787), BatchQ: 4294669146
LRU Queue:  1: TotalBlks: 3824, NowInteractive: 9, NowBatch: 28
               Grequeuecnt: 9, Grequeuecntlow: 28 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667868 (size=3787), BatchQ: 4294669148
LRU Queue:  2: TotalBlks: 3824, NowInteractive: 10, NowBatch: 27
               Grequeuecnt: 12, Grequeuecntlow: 27 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666782 (size=3785), BatchQ: 4294669278
LRU Queue:  3: TotalBlks: 3824, NowInteractive: 9, NowBatch: 27
               Grequeuecnt: 12, Grequeuecntlow: 27 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666784 (size=3785), BatchQ: 4294669280
LRU Queue:  4: TotalBlks: 3824, NowInteractive: 10, NowBatch: 25
               Grequeuecnt: 11, Grequeuecntlow: 25 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666786 (size=3788), BatchQ: 4294669090
LRU Queue:  5: TotalBlks: 3824, NowInteractive: 9, NowBatch: 26
               Grequeuecnt: 9, Grequeuecntlow: 26 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666788 (size=3789), BatchQ: 4294669028
LRU Queue:  6: TotalBlks: 3824, NowInteractive: 10, NowBatch: 22
               Grequeuecnt: 12, Grequeuecntlow: 22 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294668134 (size=3790), BatchQ: 4294668966
LRU Queue:  7: TotalBlks: 3824, NowInteractive: 7, NowBatch: 26
               Grequeuecnt: 9, Grequeuecntlow: 26 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294668712 (size=3791), BatchQ: 4294667624
LRU Queue:  8: TotalBlks: 3824, NowInteractive: 7, NowBatch: 26
               Grequeuecnt: 9, Grequeuecntlow: 26 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666794 (size=3789), BatchQ: 4294669034
LRU Queue:  9: TotalBlks: 3824, NowInteractive: 8, NowBatch: 27
               Grequeuecnt: 8, Grequeuecntlow: 27 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666796 (size=3789), BatchQ: 4294669036
LRU Queue: 10: TotalBlks: 3824, NowInteractive: 8, NowBatch: 27
               Grequeuecnt: 8, Grequeuecntlow: 27 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666798 (size=3789), BatchQ: 4294669038
LRU Queue: 11: TotalBlks: 3824, NowInteractive: 7, NowBatch: 27
               Grequeuecnt: 7, Grequeuecntlow: 27 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666800 (size=3790), BatchQ: 4294668976
LRU Queue: 12: TotalBlks: 3824, NowInteractive: 7, NowBatch: 26
               Grequeuecnt: 7, Grequeuecntlow: 26 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667186 (size=3791), BatchQ: 4294668914
LRU Queue: 13: TotalBlks: 3824, NowInteractive: 8, NowBatch: 24
               Grequeuecnt: 9, Grequeuecntlow: 25 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667828 (size=3792), BatchQ: 4294668852
LRU Queue: 14: TotalBlks: 3824, NowInteractive: 9, NowBatch: 24
               Grequeuecnt: 11, Grequeuecntlow: 25 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294668854 (size=3790), BatchQ: 4294668982
LRU Queue: 15: TotalBlks: 3824, NowInteractive: 9, NowBatch: 26
               Grequeuecnt: 10, Grequeuecntlow: 27 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666808 (size=3788), BatchQ: 4294669112
LRU Queue: 16: TotalBlks: 3824, NowInteractive: 4, NowBatch: 33
               Grequeuecnt: 4, Grequeuecntlow: 33 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666810 (size=3787), BatchQ: 4294669178
LRU Queue: 17: TotalBlks: 3824, NowInteractive: 7, NowBatch: 28
               Grequeuecnt: 8, Grequeuecntlow: 28 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294668860 (size=3789), BatchQ: 4294669052
LRU Queue: 18: TotalBlks: 3824, NowInteractive: 4, NowBatch: 32
               Grequeuecnt: 5, Grequeuecntlow: 32 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666814 (size=3787), BatchQ: 4294669182
LRU Queue: 19: TotalBlks: 3824, NowInteractive: 3, NowBatch: 32
               Grequeuecnt: 5, Grequeuecntlow: 32 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294668864 (size=3789), BatchQ: 4294669056
LRU Queue: 20: TotalBlks: 3824, NowInteractive: 4, NowBatch: 29
               Grequeuecnt: 6, Grequeuecntlow: 29 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666818 (size=3789), BatchQ: 4294668994
LRU Queue: 21: TotalBlks: 3824, NowInteractive: 6, NowBatch: 29
               Grequeuecnt: 7, Grequeuecntlow: 29 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666820 (size=3788), BatchQ: 4294669060
LRU Queue: 22: TotalBlks: 3824, NowInteractive: 5, NowBatch: 31
               Grequeuecnt: 6, Grequeuecntlow: 31 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666950 (size=3788), BatchQ: 4294669126
LRU Queue: 23: TotalBlks: 3824, NowInteractive: 8, NowBatch: 29
               Grequeuecnt: 8, Grequeuecntlow: 29 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666824 (size=3787), BatchQ: 4294669192
LRU Queue: 24: TotalBlks: 3824, NowInteractive: 8, NowBatch: 28
               Grequeuecnt: 10, Grequeuecntlow: 28 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294668554 (size=3787), BatchQ: 4294669194
LRU Queue: 25: TotalBlks: 3824, NowInteractive: 10, NowBatch: 27
               Grequeuecnt: 11, Grequeuecntlow: 27 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667724 (size=3787), BatchQ: 4294669196
LRU Queue: 26: TotalBlks: 3824, NowInteractive: 8, NowBatch: 28
               Grequeuecnt: 11, Grequeuecntlow: 28 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667918 (size=3786), BatchQ: 4294669262
LRU Queue: 27: TotalBlks: 3824, NowInteractive: 8, NowBatch: 30
               Grequeuecnt: 10, Grequeuecntlow: 30 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667920 (size=3785), BatchQ: 4294669328
LRU Queue: 28: TotalBlks: 3824, NowInteractive: 9, NowBatch: 28
               Grequeuecnt: 10, Grequeuecntlow: 28 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667602 (size=3786), BatchQ: 4294669202
LRU Queue: 29: TotalBlks: 3824, NowInteractive: 7, NowBatch: 30
               Grequeuecnt: 9, Grequeuecntlow: 30 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294666964 (size=3786), BatchQ: 4294669204
LRU Queue: 30: TotalBlks: 3824, NowInteractive: 9, NowBatch: 28
               Grequeuecnt: 11, Grequeuecntlow: 28 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294667286 (size=3786), BatchQ: 4294669206
LRU Queue: 31: TotalBlks: 3824, NowInteractive: 7, NowBatch: 30
               Grequeuecnt: 8, Grequeuecntlow: 30 Gminrequeue: 1912
               Gminrequeuelow: 280 FreeQ: 4294668248 (size=3787), BatchQ: 4294669208

WDSUSPD: 0, BACKUPREQ: 0
NUMRBUF: 1290, RTNSVR=0
MXLKCNV: 70, ExpBufSize: 4194304, Edstrategy: -13 = 1,1,2,4,...
GBLUPDJOBS: [Job #:Pid:reswake]
GACCUPDQ:
GFOWNQ:   
GBFANYQ:  
GBFSPECQ:

PIDTAB for 112 jobs: (Job:PID:reswake:sflg[:D if dead]
Job: PID:resw:SF:D
  1: 3722  :0:0    2: 3723  :0:0    3: 3724  :0:0    4: 3725  :0:0  
  5: 3733  :0:0    6: 3729  :0:0    7: 3726  :0:0    8: 3727  :0:0  
  9: 3728  :0:0   10: 3730  :0:0   11: 3731  :0:0   12: 3732  :0:0  
14: 3735  :0:0   15: 3736  :0:0   16: 3738  :0:0   17: 3739  :0:0  
18: 3740  :0:0   19: 3742  :0:0   22: 3896  :0:0   23: 3897  :0:0  
Hibernation Semaphores:   Job:[Value:LastPid:Cnt:Zcnt:]
2[0: 3723:1:0]  3[0: 3724:1:0]  4[0: 3725:1:0]  6[0: 3729:1:0]
7[0: 3726:1:0]  8[0: 3727:1:0]  9[0: 3728:1:0] 10[0: 3730:1:0]
11[0: 3731:1:0] 12[0: 3732:1:0] 14[0: 3735:1:0] 15[0: 3736:1:0]
22[0: 3896:1:0] 23[0: 3897:1:0]


--9.设置默认实例

[root@cache-server ~]# ccontrol default his
[root@cache-server ~]# ccontrol default
HIS

-10.退出终端
输入h


[root@cache-server ~]# ccontrol session cyyy

Node: cache-server, Instance: CYYY

Username: admin
Password: ******
USER>h
[root@cache-server ~]#



附： ccontrol  工具的用法：

[root@cache-server ~]# ccontrol help

                            **** ccontrol usage ****
Syntax:
        ccontrol start <instance name> [parameters]
Description:
        Run the instance's cstart procedure to bring Cache up.
Optional parameters:
        quietly -> non-interactive, with minimal dialog
        nostu   -> don't run startup routine (^STU)
        help    -> list supported parameters
        Any other value will be taken as a .cpf configuration file name.
Example:
        ccontrol start mystuff quietly
Notes:
        Some instances might not have support for a particular parameter,
        or a new parameter could have been added.  For a list of supported
        parameters for a specific instance, type:
                ccontrol start <instance name> help


Syntax:
        ccontrol stop <instance name> [parameters]
Description:
        Run the instance's cstop procedure to shut Cache down.
Optional parameters:
        quietly -> non-interactive, with minimal dialog
        nouser  -> don't run user shutdown routine
        bypass  -> bypass block against startup incomplete
        restart -> run startup after shutdown completes
        help    -> list supported parameters
Example:
        ccontrol stop mystuff quietly restart
Notes:
        Some instances might not have support for a particular parameter,
        or a new parameter could have been added.  For a list of supported
        parameters for a specific instance, type:
                ccontrol stop <instance name> help


Syntax:
        ccontrol runlevel <instance name> <target-runlevel>
Description:
        Set and attempt to advance the Cache runlevel
        to the specified target.
Example:
        ccontrol runlevel mystuff restorejrn
Notes:
        Some instances might not have support for a particular parameter,
        or a new parameter could have been added.  For a list of supported
        parameters for a specific instance, type:
                ccontrol runlevel <instance name> help


Syntax:
        ccontrol force <instance name> [parameters]
Description:
        Run the instance's cforce procedure to force Cache down.
Optional parameters:
        quietly -> non-interactive, with no dialog
        help    -> list supported parameters
Example:
        ccontrol force mystuff quietly
Notes:
        Some instances might not have support for a particular parameter,
        or a new parameter could have been added.  For a list of supported
        parameters for a specific instance, type:
                ccontrol force <instance name> help


Syntax:
        ccontrol backup <instance name> [parameters]
Description:
        Run the instance's CBACKUP procedure for database backup.
Optional parameters:
        quietly -> non-interactive, with minimal dialog
        help    -> list supported parameters
Example:
        ccontrol backup mystuff quietly
Notes:
        Some instances might not have support for a particular parameter,
        or a new parameter could have been added.  For a list of supported
        parameters for a specific instance, type:
                ccontrol backup <instance name> help


Syntax:
        ccontrol stat <instance name> [options]
Description:
        Run the instance's CSTAT procedure for Cache system statistics.
Options:
        -a[0/1]     All
        -b[bits]    Display all BDBs in the buffer pool
                    Bits: 1=All,2=Cluster,4=ECP Server, 8=ECP Client
                          16=Display block contents
                          64=Check block integrity (will take extra time)
        -c[bits]    Counters: 1=global,2=network,4=lock,8=optim,16=terminal
                              32=symtab,64=journal,128=disk i/o,256=cluster
                              16777216=fsync, 33554432=obj class, 67108864=wd
                              134217728=bigstr, 268435456=swd, 536870912=sort
                              1073741824=symsave
        -d<file>    Dump to file
        -e[0/1/2]   Errors, 2 = extra process info
        -f[bits]    Flags (1=basic, 64=resources, 128=with detail,
                           256=gccount detail, 512=incstrtab,
                           1024=audit)
        -g[0/1]     Glostat
        -h or -?    Print this help
        -i          Print limited information
        -j[0-6]     Journaling System
        -l[bits]    LRU BDB queue, same bits as -b
                        32 (and not 1) = MRU order
        -m[0/1/3/4/8/16]   Global File Table
                     3-more details, 4-volume queues
                     8-display disk device id table
                     16-systems remotely mounting this DB
        -n[0/1]     Network structures
        -o[0/1]     Zero resource statistics
        -p[flags]  Pid tables (2=swcheck,4=pstate and %SS,8=js sum,16=js list
                               32=grefcnt info,64=gstatebits,128=gstate summary
                               256=jrnhib,512=transaction summary,1024=pidflags)
                               2048=pgbdbsav)
        -q[0/1]     Semaphores
        -r<name>    Restore from file
        -s<dir>     Alternate manager's directory
        -t<secs>    Time
        -u[bits]    Lock Table (1=summary,2=waiters,4=intermediate,
                       8=detail,16=watermark,32=buddymemory,64=ResourceInfo)
        -v[0/1]     Version checking
        -w[bits]    Write Daemon queue, same bits as -b
        -A<stuff>   Restore cache.ids, do cstat -A0 -s. for usage
        -B[0/1]     Display contents of blocks in GBFSPECQ
        -C[0/1]     IJC devices
        -D<secs>,<millisec> Res stats over interval,local block collision
                               sample interval
        -F<resource#>  Free up resource number, needs -Q<job>
        -G<bdb #>   Display bdb, block contents and related bdb's
        -H<sfn,block> Find and display bdb from sfn and block num
        -I[0/1]     Incremental backup data structures
        -K<switch #> Emergency switch clear
        -L[0/1]     License token user counts
        -M[0/1]     Mailbox log from MBXRECORD
        -N[bits]    Dump ECP Networking Structures
                       Bits: 1=Cli,2=Srv,4=Client Buffers,8=Server Buffers
                       16=Client Buffers in detail
                       32=User jobs awaiting answer
                       64=srv ans bufs details,
                       128=Req Global
                       256=Server send answer buf detials (not -1),
                       1024=dump the serverrcvd req bufs,
                       2048=client trans bitmap,
                       4096=client GLO Q,
                       8192=Req Global ref hex dump
                       65536=ECP Blocks downloaded to clients
                       131072=client released req bufs details (not -1),
        -P<job>     Send a wakeup poke to specified job
        -Q<job>     Send a wakeup to job & set reswake
        -R[bits]    Dump routine buffer pool
                    Bits: 1=RB inuse,2=RFN,4=RCT,8=RCT detail,16=All,32=LRU Q,
                    64=all CCB, 128=locked CCB, 256=CCB LRU Q, +512=buffaddr
        -S[0/1]     Self-diagnosis for system hangs
        -T[0/1]     Dump shared memory and NLS tables
        -V<pid>     Examine pid.dmp exception dump file
        -W          Freeup suspended WD
        -X[0/1]     Dump numeric device translation table
        -Ykey[=val] Get/Set value of internal parameters (-Y0 for usage)
        -Z<sfn>     Release ownership of a database file
Example:
        ccontrol stat mystuff -a1
Notes:
        Some instances might not have support for a particular option,
        or a new option could have been added.  For a list of supported
        options for a specific instance, type:
                ccontrol stat <instance name> -h or -?


Syntax:
        ccontrol create <instance name> <parameters>
Description:
        Create an instance's entry in the Cache registry.
Parameters:
        directory=<installation directory name>
        versionid=<version identifier>
Example:
        ccontrol create mystuff directory=/usr/cachesys versionid=2008.2.0.357.0


Syntax:
        ccontrol update <instance name> <parameters>
Description:
        Update an instance's entry in the Cache registry.
Parameters:
        versionid=<version identifier>
Example:
        ccontrol update mystuff versionid=2008.2.0.357.0


Syntax:
        ccontrol delete <instance name>
Description:
        Delete an instance's entry from the Cache registry.
Example:
        ccontrol delete mystuff
Notes:
        This is **not** an UNINSTALL procedure.
        The instance's files are not removed.


Syntax:
        ccontrol rename <instance name> <new name>
Description:
        Change an instance's name.
Example:
        ccontrol rename oldstuff newstuff


Syntax:
        ccontrol default
Description:
        Display the name of the default Cache instance,
        if one has been designated.

Syntax:
        ccontrol default <instance name>
Description:
        Designate the default Cache instance.
Example:
        ccontrol default mystuff

Syntax:
        ccontrol default ""
Description:
        A default instance is not assigned.


Syntax:
        ccontrol view
Description:
        View Cache registry information for all instances.

Syntax:
        ccontrol view <instance name>
Description:
        View the instance's Cache registry information.
Example:
        ccontrol view mystuff


Syntax:
        ccontrol list
        ccontrol list <instance name>
Description:
        The 'list' function is the same as the 'view' function.


Syntax:
        ccontrol qlist
Description:
        Quick list Cache registry information for all instances, in a format
        suitable for parsing in command scripts.

Syntax:
        ccontrol qlist <instance name>
Description:
        Quick list the instance's Cache registry information, in a format
        suitable for parsing in command scripts.

        The record for an instance contains fields separated by "^" (carats):
                Field 1: instance name
                Field 2: instance directory
                Field 3: version identifier
                Field 4: current status for the instance
                Field 5: configuration file name last used
                Field 6: SuperServer port number
                Field 7: WebServer port number
                Field 8: JDBC Gateway port number
                Field 9. Instance status (e.g., ok, warn, alert)
Example:
        ccontrol qlist mystuff
        MYSTUFF^/usr/cachesys^2008.2.0.357.0^down, last used Tue Apr 15 09:34:50 2008^cache.cpf^56794^57791


Syntax:
        ccontrol all
Description:
        Show compact summary of all Cache instances.
Notes:
        A display field will wrap to the next line if it exceeds the width
        shown by dashes in its respective column heading.
        Full information can be obtained using the 'ccontrol list' command.

        The status for each instance is indicated by:
                "dn" - Cache is not running
                "up" - Cache is running on this machine
                "xt" - directory in use by a Cache instance on an external node
                "  " - (blank) status unavailable

Syntax:
        ccontrol allw
Description:
        Show wide format compact summary of all Cache instances.
Notes:
        A display field will NOT wrap to the next line if it exceeds the width
        shown by dashes in its respective wider column heading.
        Full information can be obtained using the 'ccontrol list' command.

        The status for each instance is indicated by:
                "dn" - Cache is not running
                "up" - Cache is running on this machine
                "xt" - directory in use by a Cache instance on an external node
                "  " - (blank) status unavailable

Syntax:
        ccontrol qall
Description:
        Show quick compact summary of all Cache instances.
Notes:
        A display field will be truncated if necessary to fit the width shown
        by dashes in its respective column heading.  If this occurs, the
        final character of the field will be displayed as a "~" (tilde).
        This is similar to 'ccontrol all' but with the display compressed to a
        single line for each instance.  See that command for further details.


Syntax:
        ccontrol nodename
Description:
        Display the local node (system) name.  If you have assigned a static
        name to your machine for use by Cache, it will be displayed.
        Otherwise, the O.S. node name (see the uname -n command) is used.

Syntax:
        ccontrol nodename <name>
Description:
        Designate the local node (system) name for your machine.  This is a
        static name that Cache will use to avoid start/stop conflicts among
        instances, even though your current node name might be delivered by a
        remote network service such as DHCP.  The node name you assign should
        be unique.  If your node name (see the uname -n command) is not
        modified by a remote service, you do not need to do this.
Example:
        ccontrol nodename LinuxLab.test1

Syntax:
        ccontrol nodename ""
Description:
        Remove the static local node name.


Syntax:
        ccontrol session <instance name> [parameters]
Description:
        Start a terminal session for the instance.
Optional parameters:
        -B -> emergency login in case logins are disabled
        -U <namespace> -> specify login namespace
        -b <partition> -> maximum partition size for process (in KB)
        "<routine>" ->  a COS program to run in user mode
Example:
        ccontrol session mystuff "^APPMAIN"


Syntax:
        ccontrol version
Description:
        Display the ccontrol program version number.


Syntax:
        ccontrol help
Description:
        Display help for all ccontrol functions.

Syntax:
        ccontrol help [function]...
Description:
        Display help for specific ccontrol functions.
Example:
        ccontrol help start stop