The CO (CONTROLLER Options) command enables individual sites to set CONTROLLER functions according to the specific needs of that site. CONTROLLER options can be set or reset and include diagnostic functions as well as the capability to suppress deimplementation warning messages.

Options specified using the CO command are maintained after a halt/load. If the ??RJ (Remove JOBDESC file) primitive command is used to remove the JOBDESC file, the CONTROLLER option settings are reset.

Syntax

── CO ─┬─────────────────────────────────────┬─────┤
       │ ┌←─────────────── , ──────────────┐ │
       └─┴─┬───────────────────────────┬───┴─┘
           ├─ + ─┬─┬─ BINARYPREFIXES ──┤
           └─ - ─┘ ├─ COMPACTSQ ───────┤
                   ├─ ERRORDP ─────────┤
                   ├─ INPUT ───────────┤
                   ├─ MONITOR ─────────┤
                   ├─ SEPARATEMGS ─────┤
                   ├─ SPRWARN ─────────┤
                   ├─ SUPPRESSWARNING ─┤
                   └─ TRACE ───────────┘

Explanation

Option values are set using the plus sign (+) and reset using the minus sign (–). The default value for all CONTROLLER options is reset.

CO

Displays the current settings for all the CONTROLLER options.

CO + BINARYPREFIXES

CO – BINARYPREFIXES

Enables and disables the use of binary (base-2) units in the DU (Disk Utilization) and OL (Display Label and Paths) command output.

When BINARYPREFIXES is set (+), byte counts display in binary (base-2) units, for example, kibibyte (KiB) and mebibyte (MiB).

When BINARYPREFIXES is reset (–), byte counts display in decimal (base-10) values and International System of Units (SI) units, for example, kilobyte (kB) and megabyte (MB).

The default value is reset (–).

CO + COMPACTSQ

CO – COMPACTSQ

Controls the response to the SQ command. When this option is reset, the QUEUED and STARTTIME times are shown in long format on separate lines. When this option is set, the times are shown in short format on a single line.

CO + ERRORDP

CO – ERRORDP

Cause a program dump of the CONTROLLER stack whenever the CONTROLLER scanner detects a syntax or semantic error, or whenever a CONTROLLER internal error occurs. When this option is set and an error occurs, all processing stops until the program dump completes. The dumps are not released for printing until the option is reset.

CO + INPUT

CO – INPUT

Cause a program dump whenever any input other than another CO command is sent to the CONTROLLER.

CO + MONITOR

CO – MONITOR

Currently reserved for use only by your Unisys service representative.

CO + SEPARATEMSGS

CO – SEPARATEMSGS

Control the response of the MSG command. When this option is reset, the MSG command returns both system and network messages. When this option is set, the MSG command returns only system messages.

CO + SUPPRESSWARNING

CO + SPRWARN

CO – SUPPRESSWARNING

CO – SPRWARN

Control the display of deimplementation warning messages for system commands. When this option is set, the messages are not displayed. A deimplementation message is an advisory that the command just entered will be deimplemented in a future release. The command is still executed.

CO + TRACE

Enables the CONTROLLER tracing facility. When this command is entered, the system attempts to create a memory-resident trace table in save memory. If memory space is successfully allocated, then CONTROLLER tracing commences. If memory space cannot be successfully allocated, then the system issues the following message:

Unable to obtain memory for TRACE - Request Aborted

When the tracing facility is running, the system stores data in the trace table in a cyclical manner from the end of the table with the lowest index to the end with the highest index. When the high end of the table is reached, then the next trace table entry is placed at the low end of the table, thus overwriting the oldest trace table entry.

You can retrieve CONTROLLER trace data with the System CONTROLLER Trace Information (Type 18) call in SYSTEMSTATUS. Refer to the SYSTEMSTATUS Programming Reference Manual.

You can analyze the CONTROLLER trace data in a memory dump with the CTRACE command in the DUMPANALYZER utility. Refer to the System Software Utilities Manual.

CO – TRACE

Disables the CONTROLLER tracing facility if it is active. The save memory space assigned to the CONTROLLER trace table is returned to the system.

Examples

Example 1

The following CO command example displays the current option settings:

CO

  ---------------------CONTROLLER OPTIONS--------------------
 
  Compile time options are:
  Diagnostics
 
  Run time options: (CO+ will SET, CO- will RESET the option)

       Binaryprefixes is  RESET.
       Errordp is         RESET.
       Input   is         RESET.
       Monitor is         RESET.
       Suppresswarning is RESET.
       Trace is           RESET.
       Separatemsgs is    SET.
       CompactSQ is       RESET.

Example 2

The following example sets the ERRORDP and SUPPRESSWARNING options:

CO +ERRORDP, +SPRWARN

  ---------------------CONTROLLER OPTIONS--------------------
 
  Compile time options are:
  Diagnostics
 
  Run time options: (CO+ will SET, CO- will RESET the option)
 
       Binaryprefixes is  RESET.
       Errordp is         SET.
       Input   is         RESET.
       Monitor is         RESET.
       Suppresswarning is SET. 
       Trace is           RESET.
       Separatemsgs is    SET.
       CompactSQ is       RESET.

Example 3

The following example resets the ERRORDP option and sets the SUPPRESSWARNING option:

CO - ERRORDP, + SUPPRESSWARNING

  --------------------CONTROLLER OPTIONS-------------------
 
Compile time options are:
Diagnostics
 
Run time options: (CO+ will SET, CO- will RESET the option)
 
     Binaryprefixes is  RESET.
     Errordp is         RESET.
     Input   is         RESET.
     Monitor is         RESET.
     Suppresswarning is SET. 
     Trace is           RESET.
     Separatemsgs is    SET.
     CompactSQ is       RESET.