EMS Manual

EMS Programs
EMS Manual—426909-005
13-16
EMSCCTRL—Control Collector Utility
SWITCH { COLL cpu }
{ CDIST cpu }
designates which process of a process pair is to become the primary
process. You specify the process by its CPU number, which must
designate the processor in which the backup process is currently running.
(You specify cpu so two attempts to switch primary processes out of CPU
7, for example, do not cancel each other. The first attempt succeeds; the
second attempt gets an error but is otherwise ignored.)
TEXTOUT [ console ]
specifies a console device (CONSOLE), in place of the default console
selected at system load, to which $Z0 routes event messages. The EMS
CONTROL command, described in Section 19, Collector Commands and
Responses, (or the PUP CONSOLE command on a D-series RVU) can
make the same change.
To find out the current or default console device for $Z0, use the
EMSCINFO—Collector Information Utility on page 13-18.
Note. Use the SWITCH CDIST option only with the primary collector.
Note. Use the TEXTOUT option only with the primary collector.
Note. Block mode applications cannot be started on the current $0 CONSOLE device.
Attempting to start a block mode application, such as ViewSys or TEDIT, results in an error
549. Conversely, if a block mode application is running on a device, that device cannot be the
$0 CONSOLE device. Attempting to switch the CONSOLE device using the EMSCCTRL $0
TEXTOUT command (or the PUP CONSOLE command on a D-series RVU) results in terminal
error of 12 (indicated in the EMSCINFO display and in the EMS logs).
To run block mode applications on the CONSOLE device, do one of:

Use another device for either the block mode application or the console. If the designated
console device is actually a 6530 emulation window on a desktop computer (for example,
a PC, Macintosh, or UNIX workstation), open another 6530 window.

Encapsulate the invocation of a block mode application in a TACL macro that first issues
an EMSCCTRL $0 TEXTOUT $0 (or PUP CONSOLE $0 on a D-series RVU) and later
issues EMSCCTRL $0 TEXTOUT $0 [#MYTERM] (or the PUP CONSOLE [#MYTERM]
command on a D-series RVU) after the block mode application stops.