This section contains a table of descriptions and parameters for the Control-O Monitor and CMEM Modify commands.
Table 337 Control‑O Monitor and CMEM Modify Commands
Command |
Description |
Parameters |
CMEM |
---|---|---|---|
ABEND |
Terminate Control‑O with abend |
|
Yes |
AUTOLOG |
Enable or disable the Automation log |
=Yes/No |
No |
C |
Order the rules in a CMEM table |
=LIB(table) |
Yes |
COSDB |
Set a COSMOS table to a specific mode of operation |
=TABLEID,xxxxxxxx where xxxxxxxx = FREE HELD NOPRE FORCE_OK DISPLAY |
No |
COSMOSSTART |
Start COSMOS |
|
No |
COSMOSSTOP |
Stop COSMOS |
|
No |
D |
Delete a rule table |
=Yes/No |
Yes |
DISABLEALT |
Stop using alternate subsystem name |
|
Yes |
DISPCOMM |
Display Control‑O network connections |
|
No |
DISPFILES |
Display the allocated file |
|
Yes |
DISPLAY |
Display 1st 1000 rules |
|
Yes |
DUMPXAE |
Dump the Control‑O areas of the Coupling facility (XES) |
|
Yes |
F |
Force Control‑O table rules |
=LIB[(mem)],D=date =ALL[,REBUILD] |
No |
INTERVAL |
Change the Control‑O sleeping interval |
=ss where ss is the number of seconds |
Yes |
LOADGLOBAL |
Load global variable memname from the global variable database or library WARNING: Issuing LOADGLOBAL is hazardous in a live system! Changes to the databases (for example, through %%SET in JCL, DO SET, or SET VAR) are accumulated in memory and are written to disk during the next WRITEGLOBAL command (performed automatically for the IOAVAR database at set intervals). Between the changes and the WRITEGLOBAL command is a time window in which the LOADGLOBAL command will delete the changes. BMC recommends only using the LOADGLOBAL command for updating a database during a scheduled downtime. |
=memname where memname is a specific Global member or variable database |
Yes |
LOG |
Change the MODE of all the rules to TRIGGER or LOG, or reset all rules to their original mode |
=ALL – set all rules to MODE LOG =TRIGGER – set all rules to issue a trace record when a rule is triggered =DEFAULT – set all rules back to the original MODE |
Yes |
MODE |
Control‑O mode of operation |
without parameters: display current MODE =FREEZE – stop all Control‑O actions =LOGONLY – stop all Control‑O actions, but log all rules that must be triggered =TRIGGERONLY – stop only new rules from being triggered =RESUME,CANCEL – reactivate Control‑O operation but IGNORE all pending rules =RESUME,CONTINUE – reactivate Control‑O operation and CONTINUE all pending rules |
Yes |
MSGMON |
Enable the CTMC31I message, relevant when CMEM/Control-O starts monitoring an address space for DSNEVENT and/or STEPEND events. |
without parameters: display current MSGMON status = YES – Message CTMC31I will be issued when monitoring starts. = NO - Message CTMC31I will not be issued when monitoring starts |
Yes |
NEWCONLIST |
Reload all CMEM tables from DACTMLST DDNAME |
|
Yes |
NEWDEST |
Reload the destination table |
|
No |
NEWMAILDT |
Reload the mail destination table |
|
No |
NEWSECDEF |
Reload security definitions |
|
Yes |
O |
Order Control‑O table rules |
=LIB[(mem)],D=date =ALL[,REBUILD] |
No |
REFRESH |
Sysplex and communication map |
=XCF |
Yes (Sysplex only) |
RELOAD |
Reload the Control‑O executor module to apply maintenance without stopping Control‑O |
=xxxxx where xxxxx is the name of the Control‑O module that must be refreshed. Valid values are: CTOAIDT, CTOWTO, CTOJFRQ (Control‑O only) or the keyword, MESSAGES, which implies the messages used by these modules. |
Yes |
RESETSTAT |
Reset Control‑O message statistics |
|
No |
RULETHRESHOLD |
Set new values for the Control‑O rules threshold |
=nnn where nnn is a number (0 through 999999) |
No |
SERVER |
Send a command to Control‑O severs |
=serverid,STOP – stop an active server =serverid,START – start a failing server =serverid,CANCEL – cancel active request =serverid,FORCE – reset and stop the server =serverid,TERM – terminate the server =serverid,DISPLAY – display server status |
No |
SETPARM |
Dynamically change CTOPARM or CMMPARM parameters |
,WSC# set the value of WSC# ,WSC#=rrrrr or +rrrr Add to be rrrrr WSCs blocks or Add additional rrrrr WSCs blocks ,MAXWSC# get the value of MAXWSC# ,MAXWSC#= rrrrr get the maximum number of WSCs that can be dynamically allocated |
Yes |
SHOWPARM |
Display Control‑O major blocks |
|
Yes |
SMODE |
Modify standalone mode when Control‑M is also active |
=F – force standalone operation =N – Control‑O uses only Control‑M to write to the IOA Log =Y – Control‑O writes to the IOA Log using Control‑M when Control‑M is active; otherwise, Control‑O writes to the IOA Log directly |
Yes |
SNAP |
Take a snapshot dump of Control‑O internal data areas |
=xxxxx |
Yes |
STARTAAO |
Start the interface with AutoOPERATOR |
|
Yes |
STARTCOMM |
Start Control‑O communication through IOAGATE |
|
No |
STARTOE |
Start the Unix interface. ON DSNEVENT rules for files that are accessed through Unix for OS/390 or z/OS services (such as IBM FTP) are not triggered |
|
Yes |
STARTSMS |
Start the SMS interface |
|
No |
STARTSTAT |
Start Control‑O message statistics |
|
No |
STARTMVI |
Start the interface with the MAINVIEW Alarm product |
|
No |
STOP |
Stop the Control‑O function and take down the Control‑O monitor |
|
Yes |
STOPAAO |
Stop the interface with AutoOPERATOR |
|
Yes |
STOPCOMM |
Stop Control‑O communication through IOAGATE |
|
No |
STOPMVI |
Stop the interface with the MAINVIEW Alarm product |
|
No |
STOPOE |
Stop the Unix interface |
|
Yes |
STOPSMS |
Stop the SMS interface. ON SMS rules are not triggered. |
|
No |
STOPSTAT |
Stop Control‑O message statistics |
|
No |
STORAGETABLE |
Display Control‑O E/CSA usage and the major Control‑O module address |
|
Yes |
SVCDUMP |
Make a Control‑O monitor SVC dump. Optional: To disable CTOZ01I dumps, code =CTOZ01I,DISABLE |
|
Yes |
TRACE |
Activate Control‑O internal trace using: GTF for the subsystem interface DATRACE and DADUMP in the Control‑O monitor |
=nnn where nnn is a number (000 through 255) supplied by BMC Customer Support |
Yes |
USAGESTATS |
Display Internal Resource Utilization Statistics |
=type where type is the type of a specific internal resource. For more information see Problem Determination |
Yes |
WATERMARKS |
Display watermarks for Control‑O internal elements and queues |
|
Yes |
WISH= |
Enable or disable a Control-O or CMEM optional wish |
=wish_id,ENABLE =wish_id,DISABLE For more information about the Rule Definition Facility and ordering Rule Tables, see the online facilities chapter of the Control-M for z/OS User Guide and the Control‑O User Guide. |
Yes |
WRITEGLOBAL |
Save global variable memname into the global variable database or library |
=memname |
Yes |