Space announcement This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Commands for managing SSI options

XBM provides SSI options that you can specify at startup (xbmxinit) or through a console command to override some hardware device settings.

These commands include:

  • DISPLAY SETTINGS
  • SET DATAMOVER
  • SET ENQWAIT
  • SET EXTALLOC
  • SET vendorFCTOPPRCPRIMARY
  • SET MAXTASKS
  • SET MAXVOLS
  • SET NOTIFYWHENCOMPLETE
  • SET OUTDYNAM
  • SET VOLS

SSI commands syntax

The basic syntax for these options is as follows.

ssid optionName keyword

The following figure displays the syntax for the commands.

Syntax for SSI override options

GUID-E5848539-74C5-4F9E-ACF9-D33DCCBF9208-low.png

SSI commands descriptions

The following table describes the commands in more detail.

Commands for setting SSI override settings

SSI command

Description

Keywords

DISPLAY SETTINGS

Displays the SSI override settings that are enabled for the specified XBM subsystem identifier (SSID)

The following example illustrates how this information is displayed:

BMC73050I 18.04.18 XBMG DISPLAY SETTINGS
BMC73087I 18.04.18 XBMG MAXTASKS is 3
BMC73087I 18.04.18 XBMG OUTDYNAM/VOLS is ON
BMC73087I 18.04.18 XBMG EXTALLOC is OFF
BMC73087I 18.04.18 XBMG ENQWAIT is OFF
BMC73087I 18.04.18 XBMG DATAMOVER is NONE

SET DATAMOVER

Sets the DATAMOVER option for hardware devices

  • NONE
  • FDR
  • DSS

SET ENQWAIT

Sets the ENQWAIT option for hardware devices

  • ON (enables)
  • OFF (disables)

SET EXTALLOC

Sets the EXTALLOC option for hardware devices

Note

For EMC devices, the AUTO value specifies to try the snapshot with the OFF value first. If the snapshot fails, it falls back to using the ON mode.

  • ON (enables)
  • OFF (disables)
  • AUTO

SET vendorFCTOPPRCPRIMARY

Specifies whether to generate the FCTOPPRCPRIMARY DFDSS keyword

The command keyword differs based on the vendor of the storage device to which XBM is issuing the command:

  • SET IBMFCTOPPRCPRIMARY for IBM storage devices
  • SET HTCFCTOPPRCPRIMARY for Hitachi storage devices
  • SET EMCFCTOPPRCPRIMARY for EMC storage devices

Before using this command, review the vendor documentation to determine which settings your hardware supports.

To use these commands, you must have the appropriate support in the DASD controller.

Warning

Enable vendorFCTOPPRCPRIMARY only if your controller and storage device software support this feature. Otherwise, Instant Snapshot requests might fail.

If you specify the PMN, PMP, or PMR keyword for this command, all storage devices for the specified vendor in your environment must support that feature or jobs will fail. These commands set the option globally for all devices in your environment.

  • OFF, the default, does not generate the DFDSS keyword FCTOPPRCPRIMARY.
  • ON generates the default for the DFDSS keyword FCTOPPRCPRIMARY.
  • PMN generates the DFDSS keyword FCTOPPRCPRIMARY(PMN), which suspends the mirror to perform the job.
  • PMP generates the DFDSS keyword FCTOPPRCPRIMARY(PMP), which suspends the mirror only if necessary to perform the job.
  • PMR generates the DFDSS keyword FCTOPPRCPRIMARY(PMR), which fails if the mirror cannot be preserved when satisfying the request.

SET MAXTASKS

Sets the number of tasks to use for hardware devices during Instant Snapshot processing

Warning

Increase this value only in small increments while carefully assessing performance. Setting this value too high for your environment can cause abends or other problems due to insufficient storage in the XBM subsystem.

Any integer from 1 through 9

This value specifies the number of tasks to use during Instant Snapshot processing. Increasing the value might improve performance for Instant Snapshot processing.

SET MAXVOLS

Specifies the number of volumes that are available for snapshot processing

Example

The command SET MAXVOLS 32 results in 32 volumes being made available to snapshot jobs that use XBMX subsystem ID.


Any integer from 4 to 56

The default value is 16. If you specify a value of 3 or less, XBM sets the value to 4. If you specify a value of 57 or higher, XBM sets the value to 56.

SET NOTIFYWHENCOMPLETE

Sets the NOTIFYWHENCOMPLETE option for EMC hardware devices

This option specifies that EMC devices issue a message when the copy completes.

  • ON (enables)
  • OFF (disables)

SET OUTDYNAM

Specifies whether to generate volume lists during hardware snapshots that use FlashCopy

  • ON (enables)
  • OFF (disables)

SET VOLS

Specifies whether to generate volume lists during hardware snapshots

  • ON (enables)
  • OFF (disables)

For more information about the hardware settings or option keywords, see your hardware vendor’s documentation.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*