MAP prints a map of the virtual storage pages locked and the real
page that is assigned for each page locked. The response to
the MAP operand is: VIRTPG virt-firstpage
virt-Iastpage REALPG real-firstpage
real-Iastpage !Qte: If you omit the MAP operand from a LOCK com.and and you later want to find the real page, reissue the LOCK command with the MAP operand. No intervening UNLOCK is required.
The SYSTEM and MAP operand are useful when you wish to examine (via DCP) or Bodify (via STCP) a page that is normally not resident (such as
console function routines). The KAP operand locates the real page for
display purposes. Page numbers are defined as follows:
Storage Locations
(in hexadeci.al) OOO-OFFF 1000-1FFF 2000-2FFF 12000-12FFF Page Number o
1
2
12
1. For firstpage and lastpage, only the page numbers are specified.
For example, to locK USERA's virtual storage locations X'12000' to X'2eooo' in real storage, the following command should be given: LOCK USERA 12 2C
To lock the first three pages of a USERA's storage, enter: LOCK USERA 0 2
2. To lock a CP page for display purposes, key in the following LOCK SYSTEM 2A 2A KAP VIRTPG REILPG} response to the MAP operand 021000 04FOOO DCP 4F038- 4F048 etc. UNLOCK SYSTEK 21 2A COMMAND COMPLETE Section 3. CP Commands 91

MESSAGE Use the MESSAGE co.mand to transmit message text to a specified userid
or to the primary system operator, or as the primary system operator, to send text te ene er all logged-en users. If the user designated to receive the aessage is not logged on or has suppressed the receiving
of messages, the aessage is not transaitted and the sender receives a
diagnostic aessage to this effect. If you send a aessage to ALL you
receive a diagnostic aessage for every user with message typing
suppressed. A message that is not received by a user is not saved and
aust be sent at a later tiae when the user is receiving messages. The is displayed at the terminal when the terminal is ready to
rece1ve output. If a typewriter terminal, or a display terminal having AUTOREAD set ON, is entering data, the aessage is held until a carriage
return is received. If you want the users to receive aessages automatically when they log on. see the class B SET command. The foraat
of the Class A and B MSG command is: Message MSG !here:
{
ALL. } asgte xt user1d
* OPerator ALL is for operator use only. It allows hia to broadcast a message to all logged-on users.
userid
*
is a single user who is to receive the message.
the asterisk (*) specifies that the user is sending the message to himself. OPERATOR specifies that the message is to be sent to the priaary system operator regardless of his userid. msgtext specifies the text of the message that is to be transmitted. hh:aa:ss
As many characters may be entered as will fit on the remainder of the input line. !SG FROK OPERATOR: msgtext is the format of the message received by a specified users or all users
fro. the system operator. hh:ma:ss !SG FROK userid: asgtext is the format of the message sent to another user or to the system
operator, where userid is the name of the sender.
92 VM/370 Operator's Guide