Control-O Monitor and CMEM Modify Commands

ABEND

Terminate Control‑O with abend

AUTOLOG

Enable or disable the Automation log

=Yes/No

C

Order the rules in a CMEM table

=LIB(table)

COSDB

Set a COSMOS table to a specific mode of operation

=TABLEID,xxxxxxxx

where xxxxxxxx = FREE

   HELD

   NOPRE

   FORCE_OK

   DISPLAY

COSMOSSTART

Start COSMOS

COSMOSSTOP

Stop COSMOS

D

Delete a rule table

=Yes/No

DISABLEALT

Stop using alternate subsystem name

DISPCOMM

Display Control‑O network connections

DISPFILES

Display the allocated file

DISPLAY

Display 1st 1000 rules

DISPLAY=DETAIL

Display all rules with details of each rule

DUMPXAE

Dump the Control‑O areas of the Coupling facility (XES)

F

Force Control‑O table rules

=LIB[(mem)],D=date

=ALL[,REBUILD]

INTERVAL

Change the Control‑O sleeping interval

=ss

where ss is the number of seconds
(range: 1 – 99)

LOADGLOBAL

Load global variable memname from the global variable database or library

WARNING: Issuing LOADGLOBAL is hazardous in a live system!

1. 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

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

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

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

NEWCONLIST

Reload all CMEM tables from DACTMLST DDNAME

NEWDEST

Reload the destination table

NEWMAILDT

Reload the mail destination table

NEWSECDEF

Reload security definitions

O

Order Control‑O table rules

=LIB[(mem)],D=date

=ALL[,REBUILD]

REFRESH

Sysplex and communication map

=XCF
Refresh Sysplex and communication (Control-O) map

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.

RESETSTAT

Reset Control‑O message statistics

RULETHRESHOLD

Set new values for the Control‑O rules threshold

=nnn where nnn is a number (0 through 999999)

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

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

SHOWPARM

Display Control‑O major blocks

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

SNAP

Take a snapshot dump of Control‑O internal data areas

=xxxxx

where xxxxx is the list of blocks that can be snapped
For more information see the topic about Control‑O problem determination in Chapter 5, "Control‑O"

STARTAAO

Start the interface with AutoOPERATOR

STARTCOMM

Start Control‑O communication through IOAGATE

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

STARTSMS

Start the SMS interface

STARTSTAT

Start Control‑O message statistics

STARTMVI

Start the interface with the MAINVIEW Alarm product

STOP

Stop the Control‑O function and take down the Control‑O monitor

STOPAAO

Stop the interface with AutoOPERATOR

STOPCOMM

Stop Control‑O communication through IOAGATE

STOPMVI

Stop the interface with the MAINVIEW Alarm product

STOPOE

Stop the Unix interface

STOPSMS

Stop the SMS interface. ON SMS rules are not triggered.

STOPSTAT

Stop Control‑O message statistics

STORAGETABLE

Display Control‑O E/CSA usage and the major Control‑O module address

SVCDUMP

Make a Control‑O monitor SVC dump. Optional: To disable CTOZ01I dumps, code =CTOZ01I,DISABLE

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

USAGESTATS

Display Internal Resource Utilization Statistics

=type

where type is the type of a specific internal resource.

WATERMARKS

Display watermarks for Control‑O internal elements and queues

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.