Gathering API files before calling IBM Support

Edit online

Log files and other important data are created by the IBM Storage Protect application programming interface (API).

Gather as many of the following files before you contact IBM Support:
  • The IBM Storage Protect API error log file. The default API error log file is dsierror.log.
  • Any trace files that are created for the API. The usual trace flags are api, api_detail, or verbdetail.
  • The output from any failed command or operation that might be either console output that is redirected to a file or an actual screen image of the failure.
  • The output from the server QUERY SYSTEM command.
  • The server activity log file. The IBM Storage Protect administrator can view this log file for you if you do not have an IBM Storage Protect administrator user ID and password.
  • If the API client is configured for LAN-free data movement, collect the options file for the IBM Storage Protect storage agent. The default name for the options file is dsmsta.opt.
  • A short program or sections of the application source code that are calling the IBM Storage Protect API function calls and are suspected of causing problems.
  • The IBM Storage Protect API options file.
    The following two options files are used on Linux® and UNIX operating systems:
    dsm.opt
    The client options file
    dsm.sys
    The system options file
    For Windows, find the dsm.opt default options file or the file that is referenced by the DSMI_CONFIG environment variable. For Linux and UNIX, the default options file is dsm.sys and is found in the directory that is referenced by the DSMI_DIR environment variable.
    On other operating systems, the client options file dsm.opt contains all the options. The following definitions are environment variables that describe the location of the option files and other API components:
    DSMI_CONFIG
    The fully qualified name for the client options file.
    DSMI_DIR
    The DSMI_DIR variable points to the API installation directory and is also used to find the dsm.sys file on Linux and UNIX. Wherever the DSMI_DIR is set, ensure that a dsm.sys file exists in the same directory.
    DSMI_LOG
    The DSMI_LOG variable points to the path for the dsierror.log file. If the client errorlogname option is set, the location that is specified by that option overrides the directory that is specified by DSMI_LOG.
    Tip: If the DSMI_LOG variable points to a directory for which the user does not have write permission, dsmSetup and dsmInitEx fail with return code DSM_RC_ACCESS_DENIED (106).

    If the errorlogname option is set in the options file dsm.sys/dsm.opt, its value is used as the error log name instead of the default value dsierror.log.