z/OS Version 2 Release 3 Distributed File Service SMB Administration IBM SC23-6886-30 Note Before using this information and the product it supports, read the information in “Notices” on page 195. This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-02-15 © Copyright International Business Machines Corporation 1999, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents List of Figures....................................................................................................... ix List of Tables........................................................................................................ xi About this document...........................................................................................xiii Who should use this document.................................................................................................................xiii How this document is organized............................................................................................................... xiii Conventions used in this document..........................................................................................................xiii z/OS information........................................................................................................................................xiv DFS information......................................................................................................................................... xiv How to send your comments to IBM......................................................................xv If you have a technical problem.................................................................................................................xv Summary of changes...........................................................................................xvi Summary of changes for SMB for z/OS Version 2 Release 3 (V2R3)....................................................... xvi Summary of changes for SMB for z/OS Version 2 Release 2 (V2R2)....................................................... xvi z/OS Version 2 Release 1 summary of changes.......................................................................................xvii Part 1. SMB support administration guide.............................................................. 1 Chapter 1. An overview of SMB support......................................................................................................3 Supported SMB clients........................................................................................................................... 3 SMB support features.............................................................................................................................4 SMB processes....................................................................................................................................... 4 Shared directories.................................................................................................................................. 4 Shared printers....................................................................................................................................... 4 Command structure and help................................................................................................................ 5 Command shortcuts..........................................................................................................................5 Receiving help................................................................................................................................... 6 Chapter 2. Considerations for a new SMB release......................................................................................7 New release considerations...................................................................................................................7 SMB configuration file considerations................................................................................................... 9 DCE migration considerations..............................................................................................................10 Chapter 3. SMB postinstallation processing............................................................................................. 11 Verifying the installation...................................................................................................................... 11 General configuration guidelines......................................................................................................... 11 Installing and configuring the SMB file and print server .................................................................... 12 Defining SMB administrators............................................................................................................... 15 Creating the default DFS configuration files........................................................................................16 Steps for using dfs_cpfiles program...............................................................................................16 RACF definitions for SMB..................................................................................................................... 18 Setting up a new SMB installation to run under a UID(0) TSO user.............................................. 18 Setting up new SMB installation to run under a unique nonzero UID TSO/E user........................19 Modifying an existing SMB installation to run with a unique nonzero UID................................... 20 Chapter 4. Managing SMB processes........................................................................................................23 Who can start and stop DFS server daemons?....................................................................................24 Starting DFS server daemons.............................................................................................................. 25 MODIFY DFS operator command................................................................................................... 25 Using MODIFY DFS to start DFS server daemons..........................................................................26 iii Order of starting DFS server daemons...........................................................................................26 Stopping DFS........................................................................................................................................ 26 Using the STOP command to stop DFS server daemons...............................................................27 Using MODIFY DFS to stop DFS server daemons.......................................................................... 27 Viewing the status of DFS server daemons......................................................................................... 27 Starting DFS server daemons during IPL.............................................................................................28 The daemon configuration file............................................................................................................. 28 How dfscntl starts the DFS server daemons....................................................................................... 29 Using the -nodfs option to start dfscntl......................................................................................... 30 Changing environment variables......................................................................................................... 30 Changing mappings..............................................................................................................................30 Changing shared directories or shared printers ................................................................................. 30 Changing the hfsattr or the rfstab........................................................................................................30 Changing the Infoprint Server DLL.......................................................................................................31 Renaming the DFSKERN started task.................................................................................................. 31 Chapter 5. Networking considerations......................................................................................................33 Chapter 6. Mapping SMB user IDs to z/OS user IDs................................................................................. 35 Creating an smbidmap file................................................................................................................... 35 Setting the _IOE_SMB_IDMAP environment variable.........................................................................36 Modifying and deleting identity mapping entries ............................................................................... 36 Determining the z/OS user ID from the SMB user ID..........................................................................37 How the SMB user ID is determined....................................................................................................37 Chapter 7. Sharing files..............................................................................................................................39