gtpi1m5gSystem Installation Support Reference

User Command Processor

This exit, UME1, allows you to implement message processing for user defined commands or for the ZDIAG command. UME1 works together with UMET, the user command table.

Input

EBX000-EBX013
User command table entry.

D0
Pointer to the input command in output message (OMSG) format. The input command stored in this area has been converted to uppercase characters and ended by the end-of-message character (X'4E').

CE2CRSMSG
Pointer to a copy of the input command that has not been converted to uppercase characters. The input command stored in this area can contain uppercase, lowercase, or other special characters and ends with a null character (X'00').

Programming Considerations

  1. CVAA only passes the command table entry to UME1, the command table is not passed.
  2. The released version of UME1 contains sample code which will validate the message, using TPF validation routines, and activate the indicated program. You need only code command table entries in UMET (refer to the prologue).
  3. CE2CRSMSG is a 4-byte field located in page 2 of the entry control block (ECB) and defined in data area IEQCE2. (Page 2 of the ECB is the 4 KB of protected storage located 4 KB beyond the start of the ECB.) Use base registers 9 and 11 (R9 and R11) to address this field.