OPSLOG DEACTIVATE—Deactivate an OPSLOG

Host Environment Commands › ADDRESS OPSCTL Commands for OPSLOG › OPSLOG DEACTIVATE—Deactivate an OPSLOG

OPSLOG DEACTIVATE—Deactivate an OPSLOG

The OPSLOG DEACTIVATE command makes a previously active OPSLOG definition inactive for use.

This command has the following format:

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

DEACTIVATE(logname): Defines the log name of one to sixteen characters.
SYSTEM and SYSWAIT: (Optional) Lets you specify the common keywords described in Keywords Common to All ADDRESS OPSCTL OPSLOG Commands in this chapter.

Note: The OPSLOG DEACTIVATE command execution is asynchronous. The return code from this command only 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 most likely in a different address space than the one the command was issued from. The status of the OPSLOG will be “pending inactive” until the deactivation is complete. In the case where a DIV-backed OPSLOG is being used, the asynchronous processing includes a final checkpoint to write the data from the OPSLOG data space to the DIV data set. This process may take a few seconds to complete. REXX code that needs to validate that the deactivation has completed should wait for a short period of time and then check the output from an OPSLOG LIST command to validate that the deactivation completed successfully.

Example: DEACTIVATE command

This command deactivates an active OPSLOG with a log name of DivLog2.

ADDRESS OPSCTL "OPSLOG DEACTIVATE(DivLog2)"

When completed, the OPSLOG named DivLog2 can no longer be browsed using either OPSLOG Browse or OPSLOG WebView.