Host Environment Commands › ADDRESS OPSCTL Commands for OPSLOG › OPSLOG ACTIVATE—Activates an OPSLOG

OPSLOG ACTIVATE—Activates an OPSLOG

The OPSLOG ACTIVATE command makes a previously defined OPSLOG definition active for use. If the OPSLOG is DIV-backed, the data set must exist at the time it is activated.

This command has the following format:

ADDRESS OPSCTL "OPSLOG ACTIVATE(logname) optional-keywords"
  [BROWSEMAX(nnnnnn)][READONLY|READWRITE]
  [SYSTEM(sysid)]
  [SYSWAIT(nnn)]

ACTIVATE(logname)

Defines the log name of one to sixteen characters.

BROWSEMAX

(Optional) Defines the maximum number of messages in the OPSLOG message area.

It lets you override the BROWSEMAX value specified on the OPSLOG DEFINE command or defaulted from the BROWSEMAX product parameter.

Value: A numeric value in the range from 1 to 4925000

READONLY|READWRITE

(Optional) Overrides any settings from the earlier DEFINE command.

These keywords are mutually exclusive.

READONLY

Indicates that the OPSLOG cannot be updated. This keyword is typically used when activating a restored OPSLOG.

READWRITE

(Default) Indicates that the OPSLOG can be updated. An OPSLOG must have the READWRITE attribute to be eligible for the OPSLOG SETLIVE command.

SYSTEM and SYSWAIT

Lets you specify the common keywords described in Keywords Common to All ADDRESS OPSCTL OPSLOG Commands in this chapter.

Note: The OPSLOG ACTIVATE 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. One example of such an error is attempting to activate an OPSLOG where the specified DIV data set does not exist. The OPSLOG status will be pending active until the activation is complete. In the case where a large DIV-backed OPSLOG is being used for the first time, it may take a minute or even longer for the asynchronous execution to complete. REXX code that needs to validate that the activation has completed should wait for a short period of time and then check the output from an OPSLOG LIST command to validate that the activation completed successfully.

Example: ACTIVATE command

• This command activates an already defined OPSLOG with a log name of DivLog2 (the log name is not case sensitive and could be specified as DIVLOG2 with the same results). The BROWSEMAX and read/write settings specified or defaulted, on the prior DEFINE statement for this OPSLOG, are used.

  ADDRESS OPSCTL "OPSLOG ACTIVATE(DivLog2)"
  

• This command activates an already defined OPSLOG with a log name of DivLog2. Any BROWSEMAX and READWRITE values set for this OPSLOG on the prior DEFINE statement are overridden by this command.

  ADDRESS OPSCTL "OPSLOG ACTIVATE(DivLog2) BROWSEMAX(100000)READONLY"