OPS/REXX Built-in Functions › OPSLOG Function › Basic Format

Basic Format

This Basic format is:

var = OPSLOG(opcode,select,n,msgid)

opcode

Supports only uppercase L, where L is List.

select

Identifies which message is retrieved first:

• If the select value has the form hh:mm:ss, CA OPS/MVS retrieves messages starting at the specified time. (If no message occurs at the indicated time, CA OPS/MVS retrieves messages later.)
• If select is a positive integer, it indicates an absolute message number. Messages that are numbered from select to select+n are retrieved.
• If select is a negative integer, it indicates a relative time offset. OPS/REXX retrieves messages starting from the current time minus the indicated number of seconds. For example, the following function call retrieves two messages starting at the one issued 5 seconds ago:

  var = OPSLOG('L', -5, 2)
  

n

Indicates the maximum number of messages to be retrieved and must be a positive number. The value that is returned is the number of lines retrieved.

msgid

Specifies an optional, specific, or wildcard message ID filter that is applied to the specified range of messages. Wildcard specification is done with a trailing ‘*’.