   S E N D M A P   -  Platform: VM/CMS


   This utility allow a REXX program to do full screen maps in CMS
environment, setting some REXX variables and recalling this program.


   In this distribution file (CMSSNDMP.ZIP) there is:

SENDMAP.TEXT             executable for VM/CMS mainframe, in obj form
SENDMAP.HIL              Hilmas source of this file
README.TXT               this help file 
TESTSNDM.REX             a REXX example of use of SENDMAP



OBJ installation:

- SEND obj module from PC to your CMS machine in BINARY form, with your
  3270 emulation; the most important thing is a binary transfer (therefore 
  without ASCII CRLF)
  Use this PC command (in a PC with IBM/PCOMM 4.1 3270 emulation installed):

     SEND SENDMAP.TEXT SENDMAP TEXT A (RECFM F LRECL 80

- Use these CMS commands to generate the executable (MODULE) file:
     LOAD  SENDMAP
     GENMOD SENDMAP
  and now in your minidisk A you have the file SENDMAP MODULE A

- Bring the REXX sample program TESTSNDM.REX in CMS with:

     SEND TESTSNDM.REX TESTSNDM REXX A (ASCII CRLF

  and run it to see an example of the use of SENDMAP.


Program instruction:

  Recalled by a REXX program, SENDMAP read REXX variables with fields
  descriptions of the 3270 map, send the map, wait for input of the
  unprotected fields and return these values to the REXX variables.
 
  Use:
         SENDMAP  <map-name>  <number-of-fields>  <options>

  Every REXX variable of name <map-name>.1, <map-name>.2, etc.
  must contain:
         <mode>,<row>,<column>,<length>,<attribute>,<name>
  <mode> can be:      C : <name> is a constant in Output (without quote)
                      O : <name> is a REXX variable only in Output
                      I : <name> is a REXX variable in Input/Output
  <row> and <column> show field position (mandatory)
  <length>           is field length; if is 0 or X is used the length
                     of the REXX variable
  <attribute> can be:       X (or nothing) :  normal
                            H Hilight (white or red)
                            D Dark    (invisible)

  <option>    can be:       NOWAIT : don't wait input from terminal
                            BEEP or ALARM  : play a short beep
                            UPPER  : translate into uppercase input fields

  No parameter can be omitted.
  Maximum length of a 'C' field or of a REXX variable is 256 bytes.
  Maximum length of a REXX variable NAME is 32.

  Optionally, variable <map-name>.0 can contain order number of Input
  field on which put the cursor (default field is 1).

