Host Environment Commands › ADDRESS OPSCTL Commands for OPSLOG › OPSLOG RESET—Reset Active OPSLOG

OPSLOG RESET—Reset Active OPSLOG

The OPSLOG RESET command tells CA OPS/MVS to reset an active OPSLOG.

This command has the following format:

ADDRESS OPSCTL "OPSLOG {RESET(logname)} optional-keywords"
  SYSTEM(sysid)
  SYSWAIT(nnn)

RESET(logname)

Defines the one- to sixteen-character log name.

SYSTEM and SYSWAIT

(Optional) You may specify the SYSTEM and SYSWAIT keywords described in Keywords Common to ADDRESS OPSCTL OPSLOG Commands in this chapter.

Usage Notes:

• Do not reset an OPSLOG until you are certain that you no longer need to browse the events in that log.
• If you are archiving OPSLOG data you should wait until after the final archive has completed for this OPSLOG before resetting the log. The archival system schedules the final archive some time (up to two minutes) after the SETLIVE command was executed that switched the live OPSLOG away from this log.
• The OPSLOG RESET command execution is asynchronous. The return code indicates that the command syntax used is valid and that initial command checking did not find any errors. Actual command execution is performed later (after the issuing REXX program or AOF rule resumes execution) under a different task and in a different address space than the one the command was issued from. The OPSLOG status will be pending reset until the reset is complete. The reset process is normally very fast and unless there is a delay in the OPSLOG Execute Processor subtask in the OPS/MVS main address space it is unlikely that any delays will be noticed. Nevertheless REXX code that needs to validate that the reset has completed should wait for a short period of time and then check the output from an OPSLOG LIST command to validate that the reset completed successfully and that the OPSLOG is in Active status.

Example: RESET command

Reset empties the OPSLOG with a log name of TempLog. If this OPSLOG is made live, it will begin recording with event sequence number 1. After a previously live log completes its final archive and is no longer needed for browsing, you should reset this log before making it live again.

ADDRESS OPSCTL "OPSLOG RESET(TempLog)”