Host Environment Commands › ADDRESS OPSCTL Commands for OPSLOG › OPSLOG DEFINE—Define an OPSLOG

OPSLOG DEFINE—Define an OPSLOG

The OPSLOG DEFINE command creates a new OPSLOG definition.

This command has the following format:

ADDRESS OPSCTL "OPSLOG {DEFINE(logname)} optional-keywords"
  [DSNAME(divdsname)]
  [BROWSEMAX(nnnnnn)] [READONLY|READWRITE]
  [SYSTEM(sysid)]
  [SYSWAIT(nnn)]

DEFINE(logname)

Defines a unique log name of one to sixteen characters.

The name must be 1-16 characters in length, and must contain only alphabetic, numeric, or any of the following special characters:

• $ - dollar sign
• * - pound sign or hash
• @ - at sign
• . - period
• _ - underscore
• ! - exclamation point  
• ? - question mark

The name is not case sensitive. It cannot start with a numeric character, an underscore (_) or a question mark (?), and cannot end with an underscore (_). Imbedded blanks are not allowed. The LOGNAME must be unique for each CA OPS/MVS subsystem.

The following name is reserved and should not be used: INSTAUTODEFINED.

DSNAME

(Optional) For DIV data sets, defines the actual data set name of the physical data set. In this case, the data set name must conform to standard z/OS data set naming restrictions.

For an in-storage OPSLOG, you must start the pseudo- data set name with the character string 'IN-STORAGE' and it is not required to conform to standard z/OS data set naming restrictions.

Do not use the following reserved name: IN-STORAGEAUTO.

For a DIV-backed data set name, it is possible to define the OPSLOG prior to the data set being created. The data set must actually exist at the time the OPSLOG is activated.

BROWSEMAX

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

It lets you override the default value which is the BROWSEMAX parameter value. For a DIV-backed OPSLOG that has already been used, the value you specify will be overridden by the existing BROWSEMAX value in the data set.

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

READONLY|READWRITE

(Optional) Indicates the mode in which the data set is to be accessed. These keywords are mutually exclusive. The value can be subsequently overridden on a future OPSLOG ACTIVATE command.

READONLY

Specifies that the OPSLOG cannot be updated. This keyword is typically used when defining an OPSLOG that will be used to hold a restored OPSLOG.

READWRITE

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

SYSTEM and SYSWAIT

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

Example: DEFINE command

• This command defines a new in-storage OPSLOG named InstLog2. Unless the BROWSEMAX value is subsequently overridden on an ACTIVATE command, this OPSLOG will use the value specified by the BROWSEMAX product parameter. Unless the read/write status is subsequently overridden on an ACTIVATE command, this OPSLOG will be READWRITE.

  ADDRESS OPSCTL "OPSLOG DEFINE(InstLog2) DSNAME(IN-STORAGE)"
  

• This command defines an OPSLOG with a log name of RestLog1 and a DIV data set name of OPSMVS.REST.OPSLOG for the purpose of being able to browse a restored OPSLOG. As recommended the restored log is defined as being READONLY. Assuming that the data set already contains a restored OPSLOG, the BROWSEMAX value will be automatically determined at activation from the values stored in the restored OPSLOG.

  ADDRESS OPSCTL "OPSLOG DEFINE(RestLog1) DSNAME('OPSMVS.REST.OPSLOG') READONLY"
  

• This command defines an OPSLOG with a log name of DivLogTemp and a DIV data set name of OPSMVS.TMP.OPSLOG. The DIV data is not required to exist at the time the DEFINE command is executed. Unless overridden at activation time, the BROWSEMAX value is set at 100000 and the data set will be used as READWRITE.

  ADDRESS OPSCTL "OPSLOG DEFINE(DivLogTemp) DSNAME(OPSMVS.TMP.OPSLOG) BROWSEMAX(100000)"