$D M

Function

To send a message to a remote workstation operator, a console operator on another multi-access spool (MAS) member, or to a console or remote workstation operator at another node.

Note that an asterisk (*) can be used within a range to indicate the highest-numbered RJE workstation (Rnnnn-*), node (Nnnnn-*), or JES2 member (Mn-*) available.

Syntax


>>-$D--M--+-----------+----------------------------------------->
          +-job_id----+   
          '-'jobname'-'   

>--+----------------------------------------+------------------->
   +-R--nnnn--(-- -nnnn--|-- -*--)----------+   
   +-N--nnnn--(-- -nnnn--|-- -*--)----------+   
   +-M--n--(-- -n--|-- -*--)----------------+   
   '-N--nnnn--R--nnnn--(-- -nnnn--|-- -*--)-'   

>--+-------------------------------+---------------------------->
   '-,D=--+-LOCAL--|--ANYLOCAL---+-'   
          +-N--nnnn--|--nodename-+     
          +-destid---------------+     
          +-N--nnnn--R--mmmm-----+     
          +-U--mmmm--------------+     
          +-node.remote----------+     
          +-node.userid----------+     
          +-node.destid----------+     
          +-remote---------------+     
          +-userid---------------+     
          '-node.*---------------'     

>--+-------------------------------+--+---------------+--------><
   '-,R=--+-LOCAL--|--ANYLOCAL---+-'  +-,'message'--…-+   
          +-N--nnnn--|--nodename-+    '-,…------------'   
          +-destid---------------+                        
          +-N--nnnn--R--mmmm-----+                        
          +-U--mmmm--------------+                        
          +-node.remote----------+                        
          +-node.userid----------+                        
          +-node.destid----------+                        
          +-remote---------------+                        
          +-userid---------------+                        
          '-node.*---------------'

Parameters

M

JES2 sends a message to the specified destination.

job_id

A “job” can actually be a batch job, started task (STC), or time-sharing user (TSU). A job identifier (jobid) is a 1 to 8 character string specified as “JOBnnnnn”, “STCnnnnn”, and “TSUnnnnn”, respectively.

Specify job_id in one of the following ways:

J|JOBn: The batch job whose job log receives the message.
S|STCn: The started task whose job log receives the message.
T|TSUn: The time-sharing user whose job log receives the message.

‘jobname'

The name of the job whose job log receives the message.

Rnnnn[-nnnn|-*]

The remote workstation or range of remote workstations on the local node to which the message is sent.

Note: If R0 is entered, JES2 sends the message to the console with master level authority on the member processing the command. This is how the remote console operator typically sends a message to the system console operator.

Nnnnn[-nnnn|-*]

The node or range of nodes to which the message is sent.

Mn[-n|-*]

The multi-access spool member or range of members on this node to which the message is sent.

NnnnnMn[-n|-*]

The specific member or range of members on node nnnn to which the message is sent.

Only this node can be specified when using the range n-*.

NnnnnRnnnn[-nnnn|-*]

The remote workstation or range of remote workstations on node nnnn to which the message is sent.

Only this node can be specified when using the range n-*.

D=

Specifies a destination for the message. The value for all routing numbers can range from 1 to 32767. Use parentheses if more than one route code is specified. For specification requirements, see Route codes.

If this command originates from another node in the network and the D= operand does not specify a node (first-level destination), the receiving node defaults the first-level destination to the node where the command originated.

If this command is sent to another node in the network using the $N command, be aware that the receiving node will default the node (first-level destination) of the D= operand to the sending node. If another node is desired, specify a destination on the D= operand that will resolve to the desired node (first level destination) at the receiving node.

Note: NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.

LOCAL|ANYLOCAL

Indicates that messages are sent to the local node.

Nnnnn|nodename

Indicates that messages are sent to the node(s) specified by the decimal node identifier or an EBCDIC nodename.

destid

Indicates that messages are sent to the specified node(s). If destid is listed alone, it refers to both the node and the remote.

NnnnnRmmmm|node.remote|node.userid

Indicates that messages are sent to the remote Rmmmm at the node Nnnnn. Rmmmm can also be specified as RMmmmm or RMTmmmm.

Ummmm

Indicates that messages are sent to a special local routing.

node.destid

Indicates that messages are sent to a destination at the specified node. The destid refers to both the node and the remote.

remote

Indicates that messages are sent to a remote. Remote can be specified in any of the following ways:

LOCAL|ANYLOCAL: Indicates that messages are sent to the local node.
Rmmmm: Indicates that messages are sent to the specified remote.
destid: Indicates that messages are sent to a destid referring to a remote.

userid

Indicates sending messages to a valid TSO userid, or a user* (where * means all local, remote, special local unit, and userid output at the specified node).

For more information about specifying userids as remotes, refer to Route codes.

node.*

Indicates sending messages to a nodename modified to the specified node name, but the remote node will remain the same.

R=

The remote workstation on the node specified in the D= parameter (which must precede this) to which the message is sent. If you use the R= parameter to specify a node, it must be the node specified in the D= parameter. You may specify any of the options available through the D= parameter.

Note:

The R= parameter is not valid if the D= parameter specified is a nodal range.
NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.

‘message'

The message text that JES2 sends to the specified destination. If you do not enclose the message in apostrophes, JES2 compresses the message text by removing all blanks. If an apostrophe is desired within the message text, you must use double apostrophes.

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Processing Considerations

The specified batch job, STC, or TSU must be in execution, not awaiting execution or output.
The specified message is not printed if the job's submitter specified that no job log was to be printed (NOLOG), or if the attributes specified at JES2 initialization for the job's execution class indicate that no job log is to be generated.
Use the MVS SEND command to send a message directly to a time-sharing user's terminal.

Scope

MAS-wide. You can issue this command from anywhere in the MAS and the command will be routed appropriately.

Messages

The $HASP001 message displays the operator console or remote terminal value, followed by the operator message.

Examples

 1   $d m j29,'could not find your tape'

  $HASP001 0,COULD NOT FIND YOUR TAPE

JES2 writes the message “COULD NOT FIND YOUR TAPE” on job 29's job log.

 2   $d m 'stanley','next time please increase your output estimate'

  $HASP001 0,NEXT TIME PLEASE INCREASE YOUR OUTPUT ESTIMATE

JES2 writes the message “NEXT TIME PLEASE INCREASE YOUR OUTPUT ESTIMATE” on the job log for the job whose name is STANLEY.

 3   $d m n3r2-5, 'Jobs remaining after 5 PM will be purged.'

  $HASP001 0,JOBS REMAINING AFTER 5 PM WILL BE PURGED

JES2 sends the message “JOBS REMAINING AFTER 5PM WILL BE PURGED” to remote workstations 2 through 5 on node 3.

 4   $d m n4, 'Node 3 requesting network authority.'

  $HASP001 0,NODE 3 REQUESTING NETWORK AUTHORITY

JES2 sends the message “NODE 3 REQUESTING NETWORK AUTHORITY” to the operator's console at node 4.

 5   $D M N2M1-*,'JOBS REMAINING AFTER 5 PM WILL BE PURGED'

  $HASP001 02   ,'JOBS REMAINING AFTER 5 PM WILL BE PURGED'

The command is issued from Node 2. JES2 sends the message “JOBS REMAINING AFTER 5PM WILL BE PURGED” to members, beginning with member 1 through the highest numbered member, on node 2.