Previous Topic: RESET SYSTEM Command—Resets a SystemNext Topic: SETALERT Command – Enables User Alerts for a Switch


SET Command—Modifies Parameters

The SET command modifies the operating parameters of the SOF server.

This command has the following syntax:

SET  [Autoopen={YES|NO}]
  [CCIApplname=name]
  CheckInterval=minutes]
  [CHECKPOINTFile=list]
  [CHECKPOINTInterval=seconds]
  [CmdRespRemoteLog]={YES|NO}]
  [enablePPRC]={YES|NO}]
  [Heartbeatinterval=minutes]
  [LOGFile=logspec]
  [LOGLevel=level]
  [Minccidelay=milliseconds]
  [MSGprefix=prefix]
  [Portsettletime=secs]
  [PprcPrimaryDevices=deviceRange]
  [PprcSecondaryDevices=deviceRange]
  [RELoadcheckpoint={YES|NO}]
  [RESultsinterval=minutes]
  [RUnopt=opts]
  [SHaredevices={YES|NO}]
  [SToragesize=bytes]
  [TImerinterval=secs]
  [TRace=types]
  [UserAlertMode={YES|NO}]
  [Varyclass=varyspec]
Autoopen=YES|NO

Controls whether the SOF server automatically allocates and opens each discovered switch. Unless a switch is allocated and open, connectivity changes to the switch are not possible.

Default: YES

Note: The status of individual switches may be modified using the REMOVE and RESTORE commands.

CCIApplname=name

Specifies the CCI application name for CCI communication.

All SOF servers using the same CCI application name become members of an SOF complex and share their configuration information. Multiple SOF complexes can be run simultaneously by using a different CCI application name for each SOF complex.

Place a SET CCIAPPLNAME command in the INITCMDS file to define an SOF server to an alternate SOF complex using an alternate CCI application name. To facilitate the use of OPSVIEW option 3.5, the CCI application name should begin with OPsof. The CCI application name is not case-sensitive.

Default: OPsofServer

CHECKInterval=nn

Specifies the number of minutes between automatic checks for an external modification. Each time this interval expires, SOF queries each managed switch to determine whether any port or options have been modified externally. This modification can be either by other host software, or by a user at the Enterprise Fabric Connectivity Server console.

Default: 15

Minimum: 1

Maximum: 60

CHECKPOINTFile=list

Specifies a list of one to four file specifications for the checkpoint files. Each specification may be a ddname reference of the form DD:ddname, the name of a file within a mounted HFS or zFS in compatibility mode, or the name of a z/OS data set of the form //dsname.

Abbreviation: CKPTFile

CHECKPOINTInterval=minutes

Specifies the minimum number of minutes between automatic checkpoints.

Default: 10

Minimum: 1

Maximum: 60

CmdRespRemoteLog=YES|NO

This parameter controls whether output for commands routed to a remote SOF server is also written to the remote server log. The response is always logged in the local SOF server regardless of this option.

Default: NO

EnablePPRC=YES|NO

Specifies whether SOF can enable the PPRC functions.

YES

Specifies that SOF can enable the PPRC functions.

NO

Specifies that SOF cannot enable the PPRC functions.

Default: NO

Heartbeatinterval=minutes

Specifies, in minutes, the amount of time between heartbeat messages.

When SOF detects that a peer has not sent a heartbeat message within the allotted time, the system is placed into a late state. As long as any system is late, SOF will reject all connectivity commands, until the late systems send a heartbeat, or until the late system is reset through a RESET SYSTEM command.

Default: 15 minutes

LOGFile=logspec

Specifies the name for the SOF log file, which may be a ddname reference of the form DD:ddname, the name of a file within a mounted HFS or zFS in compatibility mode, the z/OS data set name of the form //dsname, or OPS:OPSLOG, which represents the OPS/MVS log.

Default: 'DD:OPIOLOG'

LOGLevel=level

Specifies the level of SOF messages written to the SOF LOG file. This excludes SOF trace messages activated by the TRACE option, which are always written. Each possible level is listed here from least to most amount of messages written. Each successive level in the list includes messages written for every prior listed level:

Fatal

Indicates fatal error messages are logged.

CRitical

Indicates critical error messages are logged.

Error

Indicates all error messages are logged.

Warning

Indicates warning messages are logged.

COmmands

Indicates input commands and responses are logged.

Normal

Indicates informational messages are logged.

Verbose

Indicates extra informational messages are logged, mostly details of discovery.

Default: Normal

Minccidelay=milliseconds

Specifies, in milliseconds, the minimum time between outgoing CCI messages. This is necessary on some platforms, to avoid CCI errors caused by sending messages too quickly.

Default: 0

MSGprefix=prefix

Specifies the three-byte message prefix for all SOF messages.

Default: OPS

Portsettletime=secs

Specifies, in seconds, the amount of time allotted for switch port changes to resolve before bringing dependent paths and devices online.

Default: 1

Note: If you frequently encounter message OPS5966 after port changes, increase the time.

PprcPrimaryDevices=deviceRange

Specifies, as a hexadecimal device number pair, a continuous range of DASD volumes, which then become the only allowable primary volumes in a mirror volume pair relationship. This parameter can be used while testing to ensure that production volumes are not overwritten.

Alias: PprcPDev

Default: 0000:ffff

Note: The primary and secondary volumes are reversed during a Disaster Recovery or Planned Outage situation. Therefore, CA OPS/MVS does not currently check whether volumes are primary or secondary.

PprcSecondaryDevices=deviceRange

Specifies, as a hexadecimal device number pair, a continuous range of DASD volumes, which then become the only allowable secondary volumes in a mirror volume pair relationship. This parameter can be used while testing to ensure that production volumes are not overwritten.

Alias: PprcSDev

Default: 0000:ffff

Note: The primary and secondary volumes are reversed during a Disaster Recovery or Planned Outage situation. Therefore. CA OPS/MVS does not currently check whether volumes are primary or secondary.

RELoadcheckpoint=YES|NO

Controls the use of checkpoint data at SOF restart. If YES is specified, SOF reloads the environment from the most recently written checkpoint file. If NO is specified, SOF ignores all checkpoint data. This is normally specified in the PARM field for the SOF server, not in a SOF PARM data set.

RESultsinterval=minutes

Specifies, in minutes, the amount of time to retain the connectivity command results after command completion.

Default: 15

Note: Use the PURGE command to remove the results from individual commands.

RUnopt=opts

Indicates opts is a string of runtime options which should be passed to all subtasks.

Default: trap(on)

SHaredevices=YES|NO

Controls whether device information is shared among the SOF servers. Specifying NO reduces the amount of virtual storage used by each of the servers, which makes some of the displays less informative.

Default: YES

SToragesize=bytes

Specifies, in kilobytes, the amount of storage to be acquired whenever additional storage is needed. Each acquired block is subdivided as needed by SOF.

Default: 1024, which is the minimum amount that may be specified.

TImerinterval=secs

Specifies, in seconds, the length of the timer used to periodically awaken time-driven SOF components.

Default: 60

Trace=types

Specifies the types of SOF generated trace messages written to the SOF LOG file. Trace messages are written to the SOF LOG file regardless of the setting of the LOGLEVEL option. Specification of any combination of the following types will turn on the described tracing:

ALL

All tracing

CCI

CCI tracing 

CHECKpoint

Checkpoint read/write routine tracing

COMMands

Operator command processor tracing

CONTROLblocks

Formatted control block tracing

Abbreviation: CB

DATa

Formatted data buffer tracing

Discovery

Configuration discovery tracing

ENF

ENF processor tracing

ENTRy

Module/function entry tracing

EVENTs

Event processor tracing

EXIT

Module/function exit tracing

NONE

No tracing

RETURNcodes

Non-zero return code tracing

Abbreviation: RC

SwitchIO

Switch-related channel programs tracing

Vary

Vary online or offline tracing

Note: To turn off an individual trace type, prefix the type with NO. For example, the following command turns on all tracing except for CCI:

'Set Trace=(ALL,NOCCI)'

The following types may be specified to toggle tracing off or on while retaining all of the previously specified trace types:

OFF

Toggle tracing off while retaining all previously specified trace types.

ON

Toggle tracing on of all previously specified trace types.

UserAlertMode=YES|NO

Specifies whether SOF can automatically enable User Alert Mode for each switch immediately after completing configuration discovery. When User Alert mode is enabled, the Enterprise Connectivity Server (EFC) sends a general warning indication to the EFC user when the user attempts an action which updates the switch status or parameters.

Note: The message is a reminder that the switch is being managed by host software, namely SOF.

YES

Specifies that SOF can enable User Alert mode for each managed switch.

NO

Specifies that SOF cannot change the status of User Alert mode for each managed switch.

Default: NO

Varyclass=varyspc

Specifies the device classes that are eligible for VARY ONLINE processing. You can specify any combination of the following, enclosed in parentheses if more than one is specified:

None

Specifies no devices should be varied online.

ALL

Varies all devices online.

CHAR

Varies character devices online.

CTC

Varies CTC devices online.

COMM

Varies communication devices online.

DASD

Varies direct access storage devices online.

DISPLAY

Varies display devices online.

TAPE

Varies tape devices online.

UR

Varies unit record devices online.

Default: None.

Note: During VARY ONLINE processing, device paths are varied online unless the NOVARY option is in effect. Devices are varied online by SOF only if the appropriate device class is enabled. However, an API rule can selectively bring devices online by acting on the OPSOFVARYxx events.