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

Basic Format

This Basic format is:

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

opcode

Currently, supports only uppercase L for 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 (or later if no message occurs at the indicated time).
• If select is a positive integer, it indicates an absolute message number. Messages 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 five 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 returned is the number of lines retrieved.

msgid

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