zFS: Ensure sysplex=filesys is available on all zFS R11 and R12 systems in a shared file system environment

Description: Beginning with z/OS V1R13, zFS only runs in sysplex=filesys mode. This requires that all sysplex members in the shared file system environment must run sysplex=filesys, including any z/OS V1R11 and z/OS V1R12 systems.

Element or feature:

z/OS Distributed File Service.

When change was introduced:

z/OS V1R13.

Applies to migration from:

z/OS V1R12.

Timing:

Before installing V2R1.

Is the migration action required?

Yes, if you have a shared file system environment with more than one system in that environment.

Target system hardware requirements:

None.

Target system software requirements:

None.

Other system (coexistence or fallback) requirements:

Install the PTF for APAR OA32925 on z/OS V1R11.

If a problem occurs when zFS is running sysplex=filesys on a z/OS V1R12 system, you can perform the following steps:

Remove the sysplex specification from each system or specify sysplex=off on each system (this is equivalent to the default).
Perform a rolling IPL or restart zFS on each system.

This procedure cannot be done after zFS on the z/OS V1R13 system has joined the sysplex. If you try to start zFS on another z/OS V1R13 system after you have changed zFS to sysplex=off on the z/OS V1R12 system, zFS on z/OS V1R13 will not start. This happens because zFS on z/OS V1R13 requires all other systems be zFS sysplex=filesys.

Also, if you try to bring in zFS z/OS V1R13 when sysplex=filesys is not active on all systems, you will receive message IOEZ00721I Sysplex member sysname is not running sysplex=filesys. zFS on this initializing member will terminate., where sysname is the sysplex member that is not running sysplex=filesys.

Restrictions:

None.

System impacts:

Specifying zFS sysplex=filesys in a shared file system environment causes zFS to run sysplex-aware on a file system basis. This is the preferred mode for zFS in a shared file system environment.

Related IBM Health Checker for z/OS check:

Use check ZOSMIGV1R13_ZFS_FILESYS(available with APAR OA35465 on z/OS V1R12).

Steps to take: Perform the following steps to ensure that sysplex=filesys is available on all zFS z/OS V1R12 systems in a shared file system environment.

If you are currently running zFS sysplex=off, specify sysplex=filesys and make it active on all systems through a rolling IPL.
If you are running sysplex=on, specify sysplex=filesys and sysplex_filesys_sharemode=rwshare and make it active on all systems through a rolling IPL. The health check ZOSMIGV1R13_ZFS_FILESYS verifies that all z/OS V1R12 systems in the shared file system environment have specified sysplex=filesys before z/OS V1R13 is introduced.

To determine if you are running zFS sysplex=filesys, issue the MODIFY ZFS,QUERY,LEVEL operator command. In a shared file system environment, the last line of the response indicates if zFS is running sysplex=filesys. In the following example, zFS is running sysplex=filesys.

f zfs,query,level
IOEZ00639I zFS kernel: z/OS zSeries File System
Version 01.11.00 Service Level OA33895 - HZFS3B0.
Created on Mon Aug 23 14:02:18 EDT 2010.
sysplex(filesys,norwshare) interface(3)
IOEZ00025I zFS kernel: MODIFY command - QUERY,LEVEL completed successfully

If you do not perform these steps on z/OS V1R12 systems, you will receive error messages when you try to bring up zFS on a z/OS V1R13 system. In the examples, DCEIMGVM, DCEIMGVN and DCEIMGVQ are three sysplex members in a shared file system environment.

Example 1: DCEIMGVM (running z/OS V1R13) tries to enter the sysplex environment.

DCEIMGVN and DCEIMGVQ are running z/OS V1R11 but the coexistance APAR has not been installed on either system.

Results: DCEIMGVM (z/OS V1R13) issues:

IOEZ00675E zFS will terminate... system DCEIMGVN does not support the following
           feature(s) used by this system (DCEIMGVM):
           enhanced connect
IOEZ00675E zFS will terminate... system DCEIMGVQ does not support the following
           feature(s) used by this system (DCEIMGVM):
           enhanced connect
IOEZ00057I zFS kernel program IOEFSKN is ending

Example 2: DCEIMGVN (running z/OS V1R11 without coexistence APAR) tries to enter the sysplex environment.

DCEIMGVM and DCEIMGVQ are running z/OS V1R13.

Results: DCEIMGVN (z/OS V1R11) issues the following messages:

IOEZ00677E zFS will terminate... system DCEIMGVM uses feature(s) not supported
           by the initializing system (DCEIMGVN).
IOEZ00677E zFS will terminate... system DCEIMGVQ uses feature(s) not supported
           by the initializing system (DCEIMGVN).
IOEZ00057I zFS kernel program IOEFSCM is ending

DCEIMGVM (z/OS V1R13) issues:

IOEZ00676E DCEIMGVN will terminate... it does not support the following
           feature(s) used by this system(DCEIMGVM):
           enhanced connect

DCEIMGVQ (z/OS V1R13) issues:

IOEZ00676E DCEIMGVN will terminate... it does not support the following
           feature(s) used by this system(DCEIMGVQ):
           enhanced connect

Example 3: DCEIMGVM (running z/OS V1R13) tries to enter the sysplex environment.

Results: DCEIMGVM (z/OS V1R13) issues:

IOEZ00721I Sysplex member DCEIMGVN is not running sysplex=filesys.
           zFS on this initializing member will terminate.
IOEZ00721I Sysplex member DCEIMGVQ is not running sysplex=filesys.
           zFS on this initializing member will terminate.
IOEZ00057I zFS kernel program IOEFSKN is ending.

DCEIMGVN and DCEIMGVQ (running z/OS V1R11 with the coexistance APAR installed) are not running sysplex=filesys.

Example 4: DCEIMGVN (running z/OS V1R11 without sysplex=filesys and with the coexistence APAR installed) tries to enter the sysplex environment. DCEIMGVM and DCEIMGVQ are running z/OS V1R13.

DCEIMGVN (z/OS V1R11 without sysplex=filesys) issues:

IOEZ00677E zFS will terminate... system DCEIMGVM uses feature(s)
           not supported by the initializing system (DCEIMGVN).
IOEZ00677E zFS will terminate... system DCEIMGVQ uses feature(s)
           not supported by the initializing system (DCEIMGVN).
IOEZ00057I zFS kernel program IOEFSCM is ending

DCEIMGVM (z/OS V1R13) issues:

IOEZ00720I Initializing system DCEIMGVN will not be allowed
           to join the sysplex.
           It is not running sysplex=filesys.

DCEIMGVQ (z/OS V1R13) issues:

IOEZ00720I Initializing system DCEIMGVN will not be allowed
           to join the sysplex.
           It is not running sysplex=filesys.

Reference information: Refer to the following documentation for more information about these migration steps.

For details about messages, see z/OS Distributed File Service Messages and Codes.
For more information about running zFS in a shared file system environment, see z/OS Distributed File Service zFS Administration.
For more information about IBM health checks, refer to IBM Health Checker for z/OS User's Guide.