1 09/01/77 COBOL Message Control System
  2 
  3 The COBOL Message Control System provides support for the
  4 COBOL Communications Module as described in the ANSI COBOL
  5 X3.23-1974 Standard. In addition, the PURGE verb, as
  6 described in the CODYSYL Journal of Devolopment, is
  7 also supported.
  8 
  9 Command interfaces are provided for terminal input and output,
 10 administration of the CMCS environment, and for application
 11 message processing.
 12 
 13 
 14 Usage, terminal processing:
 15 
 16 For entering/receiving messages into/from the CMCS environment
 17 as an interactive terminal. Command establishes the proper
 18 environment and then enters request mode.
 19 
 20 Syntax:
 21 
 22    cobol_mcs cmcs_dir -terminal (-term) {station_name}
 23 
 24 
 25 Terminal Requests:
 26 
 27 .,   prints "cmcs" and station_name
 28 execute (e), calls the current command processor with the given command line.
 29 quit (q),   returns from cobol_mcs command to command level.
 30 accept_message_count (amc) tree_path,
 31    prints count of msgs available in the subtree.
 32 activate (a) {station_name {path_name}}
 33    process messages sent to station_name as they are placed
 34    in a message queue. Messages may be displayed on the user
 35    terminal or placed in the specified file.
 36 deactivate (d)
 37    terminate the effect of a previously issued activate command.
 38 disable_input (di) tree_path, disables input queues in subtree.
 39 disable_input_terminal (dit) station_name,
 40    disables the station for terminal input.
 41 disable_output (do) dest1 {dest2 ... destn},
 42    disables stations for terminal output.
 43 enable_xxx (exxx), opposite from disable requests.
 44 purge (p) arg, where arg is s, r, or all,
 45    purges input msgs, output msgs, or both.
 46 receive (r) delim tree_path,
 47    prints any message or message segment found in the subtree.
 48 send (s) delim station_name1 {station_name2 ... station_namen},
 49    builds an input message and copies to input queue(s).
 50 
 51 
 52 Usage, administrative processing:
 53 
 54 To administer the CMCS environment for a given CMCS application
 55 directory.
 56 
 57 Syntax:
 58 
 59    cobol_mcs_admin cmcs_dir
 60 
 61 
 62 Administrator requests:
 63 
 64 ., same as above.
 65 execute (e), same as above.
 66 quit (q), same as above.
 67 set_cmcs_password (scpsw), sets the global password for a given
 68    CMCS directory.
 69 change_cmcs_password  (ccpsw), changes the password only if the old
 70    password request is answered correctly.
 71 create_cmcs_queues (ccq), creates the queues and control segments needed
 72    for the CMCS runtime environment. Uses cmcs_tree_control.control.
 73 
 74 
 75 Usage, message processing:
 76 
 77 To establish the process as a COBOL MCS message processor.
 78 Normally run under a daemon (operator initiated) process.
 79 No requests are allowed once the process enters message processing mode.
 80 It will return to command level only on control of CMCS administrator.
 81 
 82 Syntax:
 83 
 84    cobol_mcs cmcs_dir -message_processor (-mp) station_name
 85 
 86 
 87 
 88 
 89 Notes:
 90 
 91 The -message_processor control argument is intended for use only by processes
 92 created to perform COBOL application program message processing.
 93 The cmcs_dir is the directory pathname for the desired application system;
 94 it can be -working_dir (-wd) or a relative pathname.
 95 The delim is either esi (1), emi (2), or egi (3), as appropriate.
 96 
 97 
 98 Documentation:
 99 
100 The COBOL language interfaces are described in the COBOL
101 Reference Manual, AS44. The COBOL MCS user and administrator
102 interfaces are described in the COBOL User's Guide, AS43.