Overview (OMSLOG command)

OMSLOG creates a log file in either XML or text form for subsequent OMS commands during a session.

  • The log contains one line or main XML element for each destination file and contains the event name, filename, and location, the ID tag value, and a timestamp. The log also contains an entry when an OMS command is started and stopped.
  • The log file remains open, and OMS activity is appended to the log, unless logging is turned off by an OMSEND command or the end of the session.
  • A subsequent OMSLOG command that specifies a different log file ends logging to the file specified on the previous OMSLOG command.
  • A subsequent OMSLOG file that specifies the same log file will overwrite the current log file for the default FORMAT = XML or in the absence of APPEND = YES for FORMAT = TEXT.
  • OMS activity for any OMS commands executed before the first OMSLOG command in the session is not recorded in any log file.

Basic Specification

The basic specification is the command name OMSLOG followed by a FILE subcommand that specifies the log filename and location.

Syntax Rules

  • The FILE subcommand is required. All other specifications are optional.
  • Equals signs (=) shown in the command syntax chart and examples are required, not optional.