® IBM eServer™ How to set up the z/OS® zSeries® File System and create and access a zFS file system business on demand software ^ © 2007 IBM Corporation This presentation will describe the z/OS zSeries File System and how to set it up so that you can create and access zFS file systems. It is assumed that you are familiar with z/OS UNIX and HFS file systems and that you are familiar with z/OS installation and service concepts. zOS_zFS_setup.ppt Page 1 of 18 Agenda What is the z/OS zSeries File System? What do you need to do to make zFS data available? What do you need to do to access zFS data? 2 Create and access a zFS file system © 2007 IBM Corporation This presentation will explain what the z/OS zSeries File System is, how to configure zFS and how to access z/OS zFS data. zOS_zFS_setup.ppt Page 2 of 18 What is the zSeries File System? The z/OS zSeries File System is Physical File System software that runs on z/OS and is part of the z/OS Distributed File Service base element zFS allows users to create zFS file systems and administrators to mount the zFS file systems into the z/OS UNIX file system hierarchy Users can then access files and directories in the zFS file systems 3 Create and access a zFS file system © 2007 IBM Corporation The zSeries File System (zFS) is a Physical File System that runs as a colony address space under control of z/OS UNIX. zFS is part of the z/OS Distributed File Service base element. Users can create zFS file systems which can be mounted by an administrator into the z/OS UNIX file system hierarchy. A zFS file system is really a VSAM* Linear Data Set that has been formatted as a zFS file system. After the zFS file system is mounted, users can access and create files and directories in the file system. * Virtual Storage Access Method zOS_zFS_setup.ppt Page 3 of 18 z/OS UNIX applications accessing zFS file systems z/OS UNIX appl z/OS UNIX zFS 4 Create and access a zFS file system © 2007 IBM Corporation z/OS UNIX applications access zFS files and directories by invoking z/OS UNIX which, in turn, invokes the zFS Physical File System (PFS). The zFS PFS accesses the zFS file system on DASD. zOS_zFS_setup.ppt Page 4 of 18 Agenda What is the z/OS zSeries File System? What do you need to do to make zFS data available? What do you need to do to access zFS data? 5 Create and access a zFS file system © 2007 IBM Corporation This section will describe what you need to do to make zFS data available. zOS_zFS_setup.ppt Page 5 of 18 What do you need to do to make zFS data available? Determine if you need to specify any zFS configuration options Define a VSAM Linear Data Set (VSAM LDS) and Format it as a zFS file system Mount the zFS file system 6 Create and access a zFS file system © 2007 IBM Corporation First, you need to determine if zFS is installed properly and if any zFS configuration options should be specified. Second, you need to define a VSAM Linear Data Set and format it as a zFS file system. Finally, you need to mount the zFS file system into the z/OS UNIX file system hierarchy. zOS_zFS_setup.ppt Page 6 of 18 Determine if you need to specify any zFS configuration options Ensure that zFS is installed properly Specify zFS configuration options 7 Create and access a zFS file system © 2007 IBM Corporation This section will discuss what you need for zFS installation. zOS_zFS_setup.ppt Page 7 of 18 Ensure that zFS is installed properly The hlq.SIOELMOD library (which contains the zFS executable modules) should be in the LNKLST concatenation. It is recommended that zFS be at the latest service level. In order to start the zFS physical file system, there must be a FILESYSTYPE statement for zFS in your BPXPRMxx. Here is an example: FILESYSTYPE TYPE(ZFS) ENTRYPOINT(IOEFSCM) ASNAME(ZFS,’SUB=MSTR’) If you are running z/OS V1R6 or later*, you can specify the zFS configuration options in a list of parmlib members with member names of the form IOEPRMxx. The member suffixes are specified in the PARM of the FILESYSTYPE statement. For example: FILESYSTYPE TYPE(ZFS) ENTRYPOINT(IOEFSCM) ASNAME(ZFS,’SUB=MSTR’) PARM(‘PRM=(01,02)’) 8 Create and access a zFS file system © 2007 IBM Corporation To ensure that zFS is properly installed, make sure the zFS load module library is in the LNKLST concatenation. Also, verify that you have a FILESYSTYPE statement for zFS in your BPXPRMxx. The slide has some examples of zFS FILESYSTYPE statements. zOS_zFS_setup.ppt Page 8 of 18 Ensure that zFS is installed properly … You can also use the &SYSCLONE system symbol to identify system specific parmlib member names in a FILESYSTYPE statement that is shared among sysplex systems. For example: FILESYSTYPE TYPE(ZFS) ENTRYPOINT(IOEFSCM) ASNAME(ZFS,’SUB=MSTR’) PARM(‘PRM=(01,&SYSCLONE.)’) There must also be a ZFS PROC that looks similar to this: //ZFS PROC REGSIZE=0M //GO EXEC PGM=BPXVCLNY,REGION=®SIZE,TIME=1440 //*IOEZPRM DD DSN=SUIMGVM.&SYSNAME..ZFSPARM(IOEFSPRM),DISP=SHR //* PEND 9 Create and access a zFS file system © 2007 IBM Corporation This slide mentions the &SYSCLONE system symbol and its usage in the zFS FILESYSTYPE statement to allow system specific parmlib members for zFS. Finally, you need to have a JCL PROC called ZFS that z/OS UNIX uses to start zFS. zOS_zFS_setup.ppt Page 9 of 18 Determine if you need to specify any zFS configuration options Ensure that zFS is installed properly Specify zFS configuration options 10 Create and access a zFS file system © 2007 IBM Corporation This section will discuss some zFS configuration options. zOS_zFS_setup.ppt Page 10 of 18 Specify zFS configuration options There are several zFS configuration options you may want to consider. aggrgrow=on trace_dsn=suimgvm.private.zfstrace The aggrgrow option is used to specify whether a zFS file system should be automatically extended when full. (The default is off.) The trace_dsn option is used for problem determination. * If you are running a release lower than z/OS V1R6, the zFS configuration options are specified in the data set member named in the IOEZPRM DD in the ZFS PROC. 11 Create and access a zFS file system © 2007 IBM Corporation The aggrgrow option specifies that a zFS file system will be extended automatically if it becomes full (assuming that the zFS file system data set has a secondary allocation size and direct access storage device space is available). The trace_dsn option specifies the data set name of a PDSE that is RECFM=VB, LRECL=133 with a primary allocation of at least 50 cylinders and a secondary allocation of 30 cylinders. This data set can be used during problem determination. zOS_zFS_setup.ppt Page 11 of 18 Define a VSAM Linear Data Set (VSAM LDS) and format it as a zFS file system The following is an example of a job to define a VSAM LDS and then format it as a zFS file system: //USERIDA JOB ,’Compatibility Mode’, // CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1) //DEFINE EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=H //SYSUDUMP DD SYSOUT=H //AMSDUMP DD SYSOUT=H //DASD0 DD DISP=OLD,UNIT=3390,VOL=SER=PRV000 //SYSIN DD * DEFINE CLUSTER (NAME(OMVS.PRV.COMPAT.AGGR001) VOLUMES(PRV000) LINEAR CYL(100 25) SHAREOPTIONS(3)) In order to run the DEFINE step of the example, you must have ALTER authority on the data set profile that covers the data set. /* //FORMAT EXEC PGM=IOEAGFMT,REGION=0M, // PARM=(’-aggregate OMVS.PRV.COMPAT.AGGR001 -compat’) //SYSPRINT DD SYSOUT=H //STDOUT DD SYSOUT=H //STDERR DD SYSOUT=H //SYSUDUMP DD SYSOUT=H //CEEDUMP DD SYSOUT=H //* To run the FORMAT step of the example, you must be uid 0 or have READ authority to the SUPERUSER.FILESYS.PFSCTL profile in the UNIXPRIV class. However, if you are running z/OS V1R9 or if you are running z/OS V1R8 or z/OS V1R7 with APAR OA18981 applied, you only need ALTER authority on the data set profile. Note: You must specify the -compat option in the PARM of the FORMAT step as shown. 12 Create and access a zFS file system © 2007 IBM Corporation Use the VSAM IDCAMS utility to define a VSAM Linear Data Set and use the zFS IOEAGFMT utility to format the VSAM LDS as a zFS file system. The slide shows an example of a two step job that defines and formats a zFS file system. zOS_zFS_setup.ppt Page 12 of 18 Mount the zFS file system In order to make the zFS file system available for user access, it must be mounted into the z/OS UNIX file system hierarchy. Here is an example of a TSO/E MOUNT command for a zFS file system: MOUNT FILESYSTEM(’OMVS.PRV.COMPAT.AGGR001’) MOUNTPOINT(’/etc/zfscompat1’) TYPE(ZFS) MODE(RDWR) PARM(’AGGRFULL(90,5)’) Here is the same mount command issued from the z/OS UNIX shell: /usr/sbin/mount -f OMVS.PRV.COMPAT.AGGR001 -t ZFS -o ’AGGRFULL(90,5)’ /etc/zfscompat1 13 Create and access a zFS file system © 2007 IBM Corporation An administrator must mount the zFS file system to make it available for user access. The mountpoint directory must exist. The PARM specified is optional. AGGRFULL(90,5) indicates that when the file system is 90 percent full, an operator message will be issued. Thereafter, every 5 percent that the file system becomes more full will cause another message. So, another message will be issued when it is 95 percent full and when it is 100 percent full. zOS_zFS_setup.ppt Page 13 of 18 Agenda What is the z/OS zSeries File System? What do you need to do to make zFS data available? What do you need to do to access zFS data? 14 Create and access a zFS file system © 2007 IBM Corporation This section will discuss what you need to do to access the zFS file system. zOS_zFS_setup.ppt Page 14 of 18 What do you need to do to access zFS data zFS data can be accessed in same way as any z/OS UNIX data is accessed z/OS UNIX applications z/OS UNIX shell commands 15 Create and access a zFS file system © 2007 IBM Corporation zFS data in a mounted file system can be accessed in the same way that any z/OS UNIX data is accessed. z/OS UNIX applications and z/OS UNIX shell commands can access zFS data in a mounted file system. z/OS UNIX permissions and ACLs* apply to zFS just as they do to HFS. zFS has the same sysplex shared file system support as HFS. * Access Control Lists zOS_zFS_setup.ppt Page 15 of 18 Final points Documentation for zFS is in: z/OS Distributed File Service zSeries File System Administration (SC24-5989) zFS Concepts and zfsadm command for zFS z/OS Distributed File Service Messages and Codes (SC24-5917) IOEZxxxt messages and X’EFxxrrrr’ reason codes for zFS z/OS Distributed File Service zSeries File System Implementation (Redbook SG24-6580) Redbook (updated February 2006 to include z/OS V1R7) 16 Create and access a zFS file system © 2007 IBM Corporation Finally, refer to documentation for zFS in the referenced documents. There are many topics that were not covered in this presentation that you can read about in these books. zOS_zFS_setup.ppt Page 16 of 18 Feedback Your feedback is valuable You can help improve the quality of IBM Education Assistant content to better meet your needs by providing feedback. Did you find this module useful? Did it help you solve a problem or answer a question? Do you have suggestions for improvements? Click to send e-mail feedback: mailto:[email protected]?subject= Feedback about zOS_zFS_setup.ppt 17 Create and access a zFS file system © 2007 IBM Corporation You can help improve the quality of IBM Education Assistant content by providing feedback. zOS_zFS_setup.ppt Page 17 of 18 Trademarks, copyrights, and disclaimers The following terms are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both: IBM z/OS zSeries UNIX is a registered trademark of The Open Group in the United States and other countries. Product data has been reviewed for accuracy as of the date of initial publication. Product data is subject to change without notice. This document could include technical inaccuracies or typographical errors. IBM may make improvements or changes in the products or programs described herein at any time without notice. Any statements regarding IBM's future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only. References in this document to IBM products, programs, or services does not imply that IBM intends to make such products, programs or services available in all countries in which IBM operates or does business. Any reference to an IBM Program Product in this document is not intended to state or imply that only that program product may be used. Any functionally equivalent program, that does not infringe IBM's intellectual property rights, may be used instead. Information is provided "AS IS" without warranty of any kind. THE INFORMATION PROVIDED IN THIS DOCUMENT IS DISTRIBUTED "AS IS" WITHOUT ANY WARRANTY, EITHER EXPRESS OR IMPLIED. IBM EXPRESSLY DISCLAIMS ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IBM shall have no responsibility to update this information. IBM products are warranted, if at all, according to the terms and conditions of the agreements (for example, IBM Customer Agreement, Statement of Limited Warranty, International Program License Agreement, etc.) under which they are provided. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products in connection with this publication and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. IBM makes no representations or warranties, express or implied, regarding non-IBM products and services. The provision of the information contained herein is not intended to, and does not, grant any right or license under any IBM patents or copyrights. Inquiries regarding patent or copyright licenses should be made, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may have achieved. The actual throughput or performance that any user will experience will vary depending upon considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve throughput or performance improvements equivalent to the ratios stated here. © Copyright International Business Machines Corporation 2007. All rights reserved. Note to U.S. Government Users - Documentation related to restricted rights-Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract and IBM Corp. Create and access a zFS file system zOS_zFS_setup.ppt © 2007 IBM Corporation Page 18 of 18
© Copyright 2024