Apar Oa34066

z/OS

SMB_NO_ZFS_SYSPLEX_AWARE Health Check Change APAR OA34066

ZSL03119-USEN-00

Chapter 1. Introduction

APAR OA34066 modifies SMB_NO_ZFS_SYSPLEX_AWARE, which is a z/OS health check for the z/OS Distributed File Service Server Message Block (SMB) server.

SMB_NO_ZFS_SYSPLEX_AWARE attempts to determine if SMB can export a zSeries File System (zFS) read/write (R/W) file system. Because zFS allows you to specify if an individual file system is sysplex-aware, this SMB health check can no longer pre-determine if a zFS R/W file system can be exported. As such, SMB_NO_ZFS_SYSPLEX_AWARE may produce exception messages that are not valid.

To more-accurately detect if a zFS R/W file system can be exported, this APAR changes the way SMB processes the SMB_NO_ZFS_SYSPLEX_AWARE health check. In addition, several messages that are related to this health check have been modified. v SMB checks the zFS sysplex-aware status of the sysplex member on which it is running. v Exception messages are no longer issued for valid configurations; the SMB messages that are valid will vary, depending on the status of the sysplex member.

Sysplex= value System sysplex-awareness Message issued sysplex=on sysplex-aware on a system Exception message IOEWH0011E, basis which states that SMB cannot export any zFS R/W file systems owned by this system. sysplex=off non shared file system Message IOEWH0010I, which environment indicates that SMB can export all zFS R/W file systems. sysplex=filesys sysplex-aware on a file IOEWH0012I, which indicates that system basis SMB can export all zFS R/W file systems; however, individual file systems need to be mounted correctly.

The health check is inactive when it is shipped. After SMB is started, you will need to activate the health check by issuing the following command: F HZSPROC,ACTIVATE,CHECK=(IBMSMB,SMB_NO_ZFS_SYSPLEX_AWARE)

Releases supported This APAR applies to SMB that is running on z/OS Version 1 Release 11 or z/OS Version 1 Release 12.

For more information See the following documentation for more detailed information about the topics discussed in this APAR. v For details about z/OS health checks, see IBM Health Checker for z/OS: User's Guide, SA22-7994.

v For more information about SMB, refer to z/OS Distributed File Service SMB Administration, SC24-5918. v For details about other SMB messages, refer to z/OS Distributed File Service Messages and Codes, SC24-5917. v For more information about zFS file systems, see z/OS Distributed File Service zSeries File System Administration, SC24-5989.

2 APAR OA34066

Chapter 2. Messages

The following sections describe the SMB message changes that are associated with this APAR.

Changed messages The following SMB messages have been modified by this APAR.

alternative, you can run as non-sysplex aware IOEWH0010I The DFS/SMB Server will be able to (sysplex=off). export/share all zFS R/W file systems that are owned by this system. Problem determination: N/A Explanation: The health check ran successfully with Source: DFS/SMB File Server no errors. Reference documentation: See “Sharing files” in z/OS System action: The system continues processing. Distributed File Service SMB Administration, SC24-5918. Also, see “Enabling the zFS sysplex-aware function” in Operator response: N/A z/OS Distributed File Service zSeries File System System programmer response: N/A Administration, SC24-5989. Problem determination: N/A Automation: N/A Source: DFS/SMB File Server Module: IOESHCK1 Reference documentation: See z/OS Distributed File Routing code: N/A Service SMB Administration, SC24-5918. Also, see Descriptor code: N/A “Enabling the zFS sysplex-aware function” in z/OS Distributed File Service zSeries File System Administration, SC24-5989. IOEWH0012I The DFS/SMB Server is running in a shared file system environment and will Automation: N/A be able to export/share zFS R/W file Module: IOESHCK1 systems owned by this system. Routing code: N/A Explanation: When the DFS/SMB Server is running in a shared file system environment in which zFS is Descriptor code: N/A configured as sysplex-aware on a file system basis (sysplex=filesys), the DFS/SMB server can export/share IOEWH0011E The DFS/SMB server is running in a the zFS R/W file system only if the zFS file system is shared file system environment and mounted non-sysplex aware. cannot export/share any zFS R/W file System action: The system continues processing. systems. Operator response: N/A Explanation: zFS is configured to run as sysplex-aware on a system basis (sysplex=on) but the System programmer response: N/A DFS/SMB server cannot export/share any zFS R/W file Problem determination: N/A systems Source: zSeries File System System action: The system continues processing. Reference documentation: See “Enabling the zFS Operator response: Report this problem to the system sysplex-aware function” in z/OS Distributed File Service programmer. zSeries File System Administration, SC24-5989. System programmer response: When running in a Automation: N/A shared file system environment, if you need to export/share zFS R/W file systems, you should Module: IOESHCK1 configure zFS to run sysplex-aware on a file system basis (sysplex=filesys) and ensure that the zFS file Routing code: N/A system is mounted non-sysplex aware. As an Descriptor code: N/A

Deleted message The following message was deleted; however, it is included here as a reference. System programmer response: N/A IOEWH0014I A DFS/SMB Server exists in a shared file system environment with all Problem determination: N/A members having a zFS sysplex_state of 1 or lower. This ran successfully and Source: DFS/SMB File Server found no exceptions. Reference documentation: z/OS Distributed File Service Explanation: The DFS/SMB Server is running in a SMB Administration, SC24-5918 shared file system environment where all members are Automation: N/A running at a zFS sysplex state of 1 or lower. The DFS/SMB File Server can export/share all file systems Module: IOESHCK1 owned by this system if the zFS sysplex state is less Routing code: N/A than 2. Descriptor code: N/A System action: The system continues processing. Operator response: N/A

4 APAR OA34066

Product Number: 5694-A01

Printed in USA