DMSPOR. This parameter is the name of the subroutine contained within the
module that is invoked to perform an action. DMSPOS may be invoked along with
a parameter, which, in this case, is a userid or nickname. DMSPOL may be
invoked with a parameter, which is a routing table name.
Note that new action routines are not required to be in this format. The program­
mable operator facility supports any desired number of action routines. Each one
is loaded separately when the programmable operator facility is initialized, or when
a LOADTBL command is issued.
The following sections describe the action routines that are supplied with the pro­
grammable operator facility. These action routines (or subroutines in the case of DMSPOR) correspond to the programmable operator commands described in the
VM / SP Operator's Guide. DMSPOR - Miscellaneous supplied action routines
GET - Send the indicated file to an authorized user
This routine sends programmable operator files, such as the log and feedback
files, to the user who requested the file via the CMS DISK DUMP command.
QUERY -Return a response to a user query
This routine returns the fileid of the currently active routing table or returns
the status of programmable operator node-checking or logging to the user who
issued the command. SET - Change the status of specific functions
This routine stops or resumes the periodic checking of the distributed systems
or the host system, or the logging of messages in the log file. STOP - Stop the programmable operator facility
This routine stops the programmable operator operation after processing cur­
rently queued messages. The programmable operator virtual machine returns
control to CMS. TOFB - Write a message to the feedback file
This routine attaches the date and time received to the head of the incoming
message and writes it to the feedback file. See "The Feedback File" below for
more information. TOVM - Execute a CP/CMS command
This routine is invoked when the programmable operator CMD command is
issued. The text following "CMD" is regarded as the CP or CMS command to
be executed in the programmable operator machine, according to the CMS IMPCP and IMPEX settings. The response to the executed CP or CMS com­
mand is returned to the authorized user who invoked the CMD command.
Authorized users of the CMD command should be aware of the following:
The Programmable Operator Facility 439

I DMSPOS - Route a message
Issuing commands that alter or overlay CMS storage, such as CP DEFINE
STORAGE, CP IPL CMS, CP SHUTDOWN, and so on, has an adverse
effect on the operation of the programmable operator facility.
Reissuing the PROP command once the programmable operator facility is
running causes the programmable operator facility to stop operating cor­
rectly. The user must re-IPL CMS and restart the programmable operator
facility using the procedure described under "Invoking the Programmable
Operator Facility". Issuing commands that cause a VM READ or CP READ (interactive
commands such as the DDR command) stop the operation of the pro­
grammable operator facility. The programmable operator facility must
then be restarted in the manner described under "Invoking the Program­
mable Operator Facility". Line editing characters (pound sign (#), for example), as defined by the CP TERMINAL command, are not recognized as line editing characters by the
programmable operator facility.
The CMS immediate commands (e.g. HB, HI, HO, HT, HX, RO, RT, SO, TE, and TS) are not recognized by the programmable operator facility. If a
user issues any of these commands, he receives an "UNKNOWN CP /CMS COMMAND" response from the programmable operator facility.
System and user synonyms for EXECs are not recognized by the pro­
grammable operator facility.
In general, the programmable operator facility does no checking to ensure or
prevent any of the above circumstances from occurring. DMSPOS sends (routes) a message to the user specified in the RTABLE
PARAMETER field. The user is identified by a nickname from the CMS userid
NAMES file or by a userid. If the user is on another system, identification must be
through a nickname. LGLOPR may be specified as a keyword in the P ARAME­
TER field of the RTABLE, which would indicate that DMSPOS should take the
value specified in the LGLOPR statement in the RTABLE. This is the default if
the parameter field is left blank.
A message longer than 94 characters (including the 19-character programmable
operator origin id) is split and sent as multiple messages. The first piece is no more
than 94 characters. The remaining pieces are no longer than 91 characters, and
preceded by a continuation mark (" .. "). This splitting ensures that the message is
small enough to be sent through an RSCS network.
If an error occurs because of an invalid target id, for example, the nickname was
not in the "userid NAMES" file, the programmable operator attempts to send the
message to the logical operator.
Messages are sent with the CMS TELL facility. If the programmable operator vir­
tual machine is authorized (class B), the CP MSGNOH command is used. If the
virtuai machine is not authorized to use the CP lviSGNOH command, then the CP MESSAGE command is used. For more information on the CMS TELL facility,
see the VM/SP CMS Command and Macro Reference. 440 VM/SP System Programmer's Guide