External Product Interface › OMMVS—Sample OMEGAMON Interface Routine

OMMVS—Sample OMEGAMON Interface Routine

The routine OMMVS in the REXX library (data set SYS1.OPS.CCLXEXEC documented in the Administration Guide) is an OPS/REXX program that issues OMEGAMON commands and gets responses returned in the external data queue of the calling program. For example, to issue the EXSY OMEGAMON command, use:

CALL OMMVS 'EXSY|EXECUTE'

The vertical bar | is the default command separator. Editing the OMMVS separator parameter can modify the default command separator. The EXECUTE command is the equivalent of pressing the Enter key. A DO WHILE QUEUED() loop can process the returned response lines.

You can stack multiple commands, including major and minor command combinations. For example, the following CALL command executes the LLT minor command (LinkList Table) of the XSYS major command, which returns a list of data sets in the system link list:

CALL OMMVS 'XSYS|LLT|EXECUTE'

You can make multiple calls to OMMVS and cause commands to be stacked until you call OMMVS with the EXECUTE command. The previous example could have been written:

CALL OMMVS 'XSYS'
CALL OMMVS 'LLT'
CALL OMMVS 'EXECUTE'

or

CALL OMMVS 'XSYS|LLT'
CALL OMMVS 'EXECUTE'

or

CALL OMMVS 'XSYS'
CALL OMMVS 'LLT|EXECUTE'

By default, EXECUTE presses the Enter key, which can be overridden by specifying a PF key or other attention key (PF1, ..., PF24, PA1, PA2, PA3, CLEAR, or Enter).

For example:

CALL OMMVS 'EXECUTE CLEAR'
CALL OMMVS 'EXSY|EXECUTE ENTER'