This book describes how to use the MIDI Rexx functions. The section entitled Function Reference lists (in alphabetic order) all of the MIDI Rexx functions that you can call. Each function is on its own page. The name of the function is listed first. Listed below is its syntax (ie, what arguments you pass to it and what it returns), as well as examples of its use. Arguments that you must supply are in blue, and arguments that you may omit are in red.

You'll note that all functions begin with the letters MIDI. To avoid conflicts with MIDI Rexx function names, do not name any of the functions in your REXX script starting with those 4 letters (neither upper nor lower case).

If any of the functions are called before a MIDI file is created/loaded, then they usually perform no work and raise a REXX SYNTAX condition. Failure to supply required arguments (or supplying invalid arguments) also raises a SYNTAX condition. Other errors do not raise a SYNTAX condition, but instead return an appropriate error indication to your script, or may even raise the ERROR condition if you trap that. For example, if you tell MIDIGetEvent() to return the next event of a certain type, and there is no more of that type, then MIDIGetEvent() returns an error message. It's up to your script to check returned values for any errors in performing an operation. Always do error checking upon the return from a MIDI Rexx function where appropriate.

The sections of this book leading up to the list of functions describe how to do various tasks with the MIDI Rexx functions. So, they are overviews (ie, tutorials) of how to use MIDI Rexx in various ways, whereas the list of functions are more of a reference complete with incidental notes/details.