IBM Support

JR27540: OSS API CALLED BY SNAPSHOT CODE CAN'T HANDLE WINDOWS RAW DEVICES CONTAINERS PROPERLY

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • DB2 snapshot code calls internal OSS API functions which
    can't properly handle raw device names on Windows OS.
    If you choose a raw device on Windows for your tablespace
    containers (raw device is a NT volume in a non NTFS partition
    of your disk) you may see messages in db2diag.log if you
    perform certain snapshot functions which calls these API
    functions.
    
    Suppose the container name is "\\.\R:", then for example the
    following actions causing the problem:
    
    1- when obtaining tablespace snapshot information ("db2 get
       snapshot for tablespaces on <dbname>") the following may
       be seen:
    
    2007-09-18-12.48.44.462000+120 I10487H404         LEVEL: Error
    (OS)
    PID     : 2724                 TID : 2944
    FUNCTION: DB2 Common, OSSe, ossGetDiskInfo, probe:25
    MESSAGE : ECF=0x9000001E The filename, directory name or volume
    label syntax is incorrect
    CALLED  : OS, -, GetFileAttributes                OSERR:
    ERROR_INVALID_NAME (123)
    ARG  #1 : String, 3 bytes
    \\.
    ARG  #2 : Uint32, 4 bytes
    140
    
    2- or when using the DB2 Storage Management from the Control
       Center GUI (call's snapshot UDFs CAPTURE_STORAGEMGMT_INFO()
       or GET_DBSIZE_INFO()) the following messages are written in
       db2diag.log:
    
    007-09-18-12.41.10.853000+120 I3476H297          LEVEL: Error
    (OS)
    PID     : 3024                 TID : 2512
    FUNCTION: DB2 Common, OSSe, ossGetFileInfo, probe:30
    MESSAGE : ECF=0x90000007 Unknown
    CALLED  : OS, -, _stat                            OSERR: 123
    ARG  #1 : String, 6 bytes
    \\.\R:
    
    2007-09-18-12.41.10.853000+120 I3775H325          LEVEL: Error
    (OS)
    PID     : 3024                 TID : 2512
    FUNCTION: DB2 Common, OSSe, ossGetDiskInfo, probe:25
    MESSAGE : ECF=0x90000007 Unknown
    CALLED  : OS, -, GetFileAttributes                OSERR: 1
    ARG  #1 : String, 6 bytes
    \\.\R:
    ARG  #2 : Uint32, 4 bytes
    1
    

Local fix

Problem summary

  • Users Affected: ALL
    
    Problem Description:
    
    DB2 snapshot code calls internal OSS API functions which
    can't properly handle raw device names on Windows OS.
    If you choose a raw device on Windows for your tablespace
    containers (raw device is a NT volume in a non NTFS partition
    of your disk) you may see messages in db2diag.log if you
    perform certain snapshot functions which calls these API
    functions.
    
    Suppose the container name is "\\.\R:", then for example the
    following actions causing the problem:
    
    1- when obtaining tablespace snapshot information ("db2 get
       snapshot for tablespaces on <dbname>") the following may
       be seen:
    
    2007-09-18-12.48.44.462000+120 I10487H404         LEVEL: Error
    (OS)
    PID     : 2724                 TID : 2944
    FUNCTION: DB2 Common, OSSe, ossGetDiskInfo, probe:25
    MESSAGE : ECF=0x9000001E The filename, directory name or volume
    label syntax is incorrect
    CALLED  : OS, -, GetFileAttributes                OSERR:
    ERROR_INVALID_NAME (123)
    ARG  #1 : String, 3 bytes
    \\.
    ARG  #2 : Uint32, 4 bytes
    140
    
    2- or when using the DB2 Storage Management from the Control
       Center GUI (call's snapshot UDFs CAPTURE_STORAGEMGMT_INFO()
       or GET_DBSIZE_INFO()) the following messages are written in
       db2diag.log:
    
    007-09-18-12.41.10.853000+120 I3476H297          LEVEL: Error
    (OS)
    PID     : 3024                 TID : 2512
    FUNCTION: DB2 Common, OSSe, ossGetFileInfo, probe:30
    MESSAGE : ECF=0x90000007 Unknown
    CALLED  : OS, -, _stat                            OSERR: 123
    ARG  #1 : String, 6 bytes
    \\.\R:
    
    2007-09-18-12.41.10.853000+120 I3775H325          LEVEL: Error
    (OS)
    PID     : 3024                 TID : 2512
    FUNCTION: DB2 Common, OSSe, ossGetDiskInfo, probe:25
    MESSAGE : ECF=0x90000007 Unknown
    CALLED  : OS, -, GetFileAttributes                OSERR: 1
    ARG  #1 : String, 6 bytes
    \\.\R:
    ARG  #2 : Uint32, 4 bytes
    1
    
    Problem Summary:  See Problem Description.
    

Problem conclusion

  • First fixed in DB2 UDB Version 9.1, FixPak 6 (build s081007)
    

Temporary fix

Comments

APAR Information

  • APAR number

    JR27540

  • Reported component name

    DB2 UDB WSE WIN

  • Reported component ID

    5765F3501

  • Reported release

    910

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-10-01

  • Closed date

    2008-11-03

  • Last modified date

    2008-11-03

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    JR29392

Fix information

  • Fixed component name

    DB2 UDB WSE WIN

  • Fixed component ID

    5765F3501

Applicable component levels

  • R810 PSN

       UP

  • R820 PSN

       UP

  • R910 PSN

       UP

  • R950 PSN

       UP

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSEPGG","label":"Db2 for Linux, UNIX and Windows"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"910","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
03 November 2008