Document 208978

®
IBM eServer™
How to set up the z/OS® System Message
Block server and access z/OS data from
Windows®
business on demand software
^
© 2007 IBM Corporation
This presentation will describe the z/OS System Message Block, or SMB, server and how
to set it up so that a PC user can access z/OS data.
zOS_V1R8_SMB_setup.ppt
Page 1 of 17
Agenda
What is the z/OS System Message Block (SMB)
server?
What do you need to do on the server to make
data available?
What do you need to do on the PC to access the
data on z/OS?
2
SMB access from Windows
© 2007 IBM Corporation
This presentation will explain what the z/OS SMB server is, how to configure the SMB
server and how to access z/OS data from a Windows PC.
zOS_V1R8_SMB_setup.ppt
Page 2 of 17
What is the SMB server?
The z/OS SMB (Server Message Block) server is
software that runs on z/OS and is part of the z/OS
Distributed File Service base element
The z/OS SMB server allows Windows PCs to
access z/OS data by using a remote drive letter on
the PC
The z/OS SMB server supports the SMB protocol
that Windows PCs send to a file server
3
SMB access from Windows
© 2007 IBM Corporation
SMB stands for Server Message Block. This is the name of the protocol that Windows
clients use to access remote files on a server. The z/OS SMB server runs on z/OS and is
part of the z/OS Distributed File Service base element. Windows PCs can connect to the
z/OS SMB server and assign a remote drive letter to a share name defined on the z/OS
SMB server. After connecting, the PC user can access data on the remote drive letter as
though it were local data.
zOS_V1R8_SMB_setup.ppt
Page 3 of 17
PCs communicating with the z/OS SMB server
PC
TCP/IP
TCP/IP
z/OS
z/OS
SMB
UNIX®
server
application
PC
z/OS UNIX
PC
4
HFS or zFS
SMB access from Windows
© 2007 IBM Corporation
Windows PCs communicate with the z/OS SMB server through TCP/IP. The file requests
are sent to the z/OS SMB server and those file requests are sent down to z/OS UNIX and
then to the Physical File System; for example, HFS or zFS. z/OS UNIX applications and
commands may be accessing the data at the same time.
zOS_V1R8_SMB_setup.ppt
Page 4 of 17
Agenda
What is the z/OS SMB server?
What do you need to do on the server to make
data available?
What do you need to do on the PC to access the
data on z/OS?
5
SMB access from Windows
© 2007 IBM Corporation
This section will describe what you need to do to make z/OS UNIX data available to
Windows PCs.
zOS_V1R8_SMB_setup.ppt
Page 5 of 17
What do you need to do on the server to make
data available?
Decide what data you want to make available
Determine whether the data needs EBCDIC to
ASCII translation
Decide how PC users will login to z/OS
Determine if you need to specify any SMB server
configuration options
6
SMB access from Windows
© 2007 IBM Corporation
First, you need to decide what data you want to make available to the Windows PCs.
That is, which directory in the z/OS UNIX hierarchy will be the entry point when a defined
share name is used.
Second, you need to decide whether you want data translated from EBCDIC to ASCII
characters when it is sent to the PC. That is, is the data that will be accessed character
data or binary data? Character data should be translated and binary data should not.
Third, you need to decide how PC users will login to z/OS. With all methods, the PC user
ID will be mapped to a local z/OS user ID.
Finally, you may need to specify some SMB server configuration options.
zOS_V1R8_SMB_setup.ppt
Page 6 of 17
Decide what data you want to make available
Ensure that the SMB server has been installed
You should have a started task PROC named DFS®
You should be able to access z/OS UNIX directories
/opt/dfslocal/var/dfs and /opt/dfslocal/home/dfskern
You can make individual file systems available or
you can make the entire z/OS UNIX hierarchy
available
You create a share name for the directory
7
SMB access from Windows
© 2007 IBM Corporation
Before you actually decide what data you want to make available, you should ensure that
the SMB server has been installed. There should be a started task PROC called DFS and
you should be able to access z/OS UNIX directories shown here. If these are not
available, go back and install the Distributed File Service SMB server.
The simplest way to make z/OS UNIX data available to Windows PC users is to make the
entire z/OS UNIX hierarchy available. This is illustrated on the next slide.
zOS_V1R8_SMB_setup.ppt
Page 7 of 17
Export the root file system
/opt/dfslocal/var/dfs/smbtab should contain this
line:
/dev/ufs1 share1 ufs “The z/OS UNIX root” r/w 100 /
/opt/dfslocal/var/dfs/dfstab should contain this line:
/dev/ufs1 hfs1 ufs 1 0,,1
/opt/dfslocal/var/dfs/devtab should contain these
lines:
define_ufs 1
<root file system name> text
8
SMB access from Windows
© 2007 IBM Corporation
To create a share, create the files with the values listed here.
The last line on this slide is the file system name of your root file system followed by the word text.
This is referred to as exporting the root file system and sharing the directory named /
(slash) in the root file system.
These files create a share named share1 that refers to the root of your entire z/OS UNIX
hierarchy.
zOS_V1R8_SMB_setup.ppt
Page 8 of 17
Determine whether the data needs EBCDIC to
ASCII translation
Most often you will be accessing character data
This requires you to tell the SMB server to
translate the data
The simplest way to do this is to specify
_IOE_HFS_TRANSLATION=ON in the
/opt/dfslocal/home/dfskern/envar file
9
SMB access from Windows
© 2007 IBM Corporation
Most often, the z/OS UNIX data that you will be accessing from Windows PCs will be
character data. This will be EBCDIC data stored in a z/OS UNIX file. When that data is
transferred to the Windows PC, you need it to be translated to ASCII so that it displays
properly on the Windows PC.
One way to tell the z/OS SMB server to translate the data going in both directions is to
specify a dfskern environment variable, or configuration option, that tells the server to
translate data. Turn character translation on using the setting in the file shown here.
This tells the SMB server to translate data unless a more discrete specification is made.
For example, on a particular file system as was done on the previous slide in the devtab
entry by specifying text – which also says to translate the data.
zOS_V1R8_SMB_setup.ppt
Page 9 of 17
Decide how PC users will login to z/OS
Your PC users need to identify themselves in
terms of a z/OS user ID
The PC user ID is mapped to a z/OS user ID using
the smbidmap file
The location of the smbidmap file is specified in the dfskern environment variable _IOE_SMB_IDMAP.
The dfskern environment variable file is located at /opt/dfslocal/home/dfskern/envar
Normally, you would specify _IOE_SMB_IDMAP=/opt/dfslocal/home/dfskern/smbidmap
Another thing you need to specify is whether PC
users will use
Clear passwords
Encrypted passwords
Domain passwords (Passthrough Authentication)
10
SMB access from Windows
© 2007 IBM Corporation
When Windows PC users connect to the z/OS SMB server, they need to identify
themselves. If they do not specify a PC user ID on the connect, the PC user ID specified
when the PC user logged on to Windows is used. If they do specify a PC user ID (for
example, on the net use command), then that PC user ID is used.
The PC user ID is mapped to a local z/OS user ID, using the specification in the
smbidmap file. More details are included at the end of this presentation.
zOS_V1R8_SMB_setup.ppt
Page 10 of 17
Determine if you need to specify any SMB
server configuration options
Specify the following in the
/opt/dfslocal/home/dfskern/envar file:
_IOE_PROTOCOL_RPC=OFF
_IOE_PROTOCOL_SMB=ON
To access subdirectories without needing to explicitly
export each file system, in the same file, specify:
_IOE_DYNAMIC_EXPORT=ON
You must specify that you want to use the SMB protocol but
not the DCE DFS protocol
(since the default is the opposite)
11
SMB access from Windows
© 2007 IBM Corporation
There are several SMB server configuration options that you will need to set.
In most cases, you will want to allow PC users to visit all the subdirectories under the
shared directory.
After these specifications are made, you should start (or restart) the SMB server by using
the operator command start dfs (or stop dfs and then start dfs). At this point, the SMB
server is ready to accept connections from Windows PCs.
zOS_V1R8_SMB_setup.ppt
Page 11 of 17
Agenda
What is the z/OS SMB server?
What do you need to do on the server to make
data available?
What do you need to do on the PC to access the
data on z/OS?
12
SMB access from Windows
© 2007 IBM Corporation
This section covers what you need to do on your Windows PC in order to access the
share that was created on the z/OS system.
zOS_V1R8_SMB_setup.ppt
Page 12 of 17
What do you need to do on the PC to access
the data on z/OS
Using the host name of the z/OS system and the
share name of the directory, issue a net use
command
For example:
net use z: \\yourhost.com\share1 password /user:pcuserid
Then, access z/OS UNIX data using:
MS-DOS® commands in a command prompt window
or Windows Explorer
13
SMB access from Windows
© 2007 IBM Corporation
Assuming that the host name of your z/OS system is yourhost.com, you can connect to
the share that was created on slide 9 (share1) using the MS-DOS net use command.
You can learn about the net use command by searching Windows help for command-line
reference A-Z and scrolling to net services commands and then net use. An example is
shown here.
The password specified depends on the type of password encryption specified in the
dfskern envar file (see slide 11). You only need to specify a pcuserid if you want to use a
PC user ID that is different that the one you used to logon to Windows. Remember that
the pcuserid must be mapped to a z/OS user ID in the smbidmap file.)
After this command is successfully run, you can access the z/OS data by using the drive
letter z:. So, for example, you could enter dir z: in a command prompt window or you
could open Windows Explorer and click on the z: drive letter. Files that contain a filename
extension that is known to Windows, like .txt, are easiest to work with.
zOS_V1R8_SMB_setup.ppt
Page 13 of 17
Documentation
Documentation for the SMB server is in:
z/OS Distributed File Service SMB Administration
(SC24-5918)
z/OS SMB server Concepts and Administration
z/OS Distributed File Service Messages and Codes
(SC24-5917)
IOEyxxxt messages
z/OS S/390® File and Print Serving
(Redbook SG24-5330)
Redbook (at OS/390® V1R9 level)
14
SMB access from Windows
© 2007 IBM Corporation
Finally, refer to documentation for the SMB server in the referenced documents. There
are many topics that were not covered in this presentation that you can read about in
these books.
zOS_V1R8_SMB_setup.ppt
Page 14 of 17
Format of the smbidmap file
In the smbidmap file, you specify the mapping of each
Windows PC user’s user ID to their corresponding z/OS
user ID. The format is:
pcuserid1
zosuserid1
<blank line>
pcuserid2
zosuserid2
<blank line>
and so on, for as many mappings as needed.
So, for example, you might specify:
smithj
g123456
jonesm
g111111
15
SMB access from Windows
© 2007 IBM Corporation
This slide explains the format of the smbidmap file. PC user IDs are followed by z/OS user
IDs and the pairs are delimited by a blank line.
zOS_V1R8_SMB_setup.ppt
Page 15 of 17
PC user authentication options
For clear passwords, specify the dfskern envar: _IOE_SMB_CLEAR_PW=REQUIRED
In this case, when they connect, your PC users will need to specify the z/OS (RACF)
password of the z/OS user ID they are mapped to.
To use clear passwords, the PC users may need to set this registry key value to 1:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Lanmanworkstation\EnablePlainTextPassword
For encrypted passwords, specify the dfskern envar: _IOE_SMB_CLEAR_PW=NOTALLOWED
In this case, to connect, PC users will need to specify the password they set in their
DCE segment on z/OS using the OMVS smbpw command.
For pass-through authentication, specify these dfskern envars:
_IOE_SMB_AUTH_DOMAIN_NAME=<domain name of domain controller>
_IOE_SMB_AUTH_SERVER=n.n.n.n
_IOE_SMB_AUTH_SERVER_COMPUTER_NAME=<computer name of domain controller>
_IOE_SMB_BACKUP_AUTH_SERVER=n.n.n.n
_IOE_SMB_BACKUP_AUTH_SERVER_COMPUTER_NAME=<computer name of backup domain controller>
These refer to the IP address and computer name of your Windows domain controller
(with an optional backup domain controller). In this case, when they connect, your PC
users will need to specify their domain password.
16
SMB access from Windows
© 2007 IBM Corporation
There are three options for how to handle passwords; clear, encrypted, and pass-through.
This slide illustrates the dfskern settings for each. Note that for clear-text passwords, an
additional setting on each client PC is needed.
zOS_V1R8_SMB_setup.ppt
Page 16 of 17
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:
DFS
IBM
OS/390
S/390
z/OS
MS-DOS, Windows, and the Windows logo are registered trademarks of Microsoft Corporation in the United States, other countries, or both.
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 in Internal Throughput Rate (ITR) ratio based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput 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 improvements equivalent to the performance ratios stated here.
All customer examples cited or described in this presentation are presented as illustrations of the manner in which some customers have used IBM products and the results they may
have achieved. Actual environmental costs and performance characteristics will vary depending on individual customer configurations and conditions.
This publication was produced in the United States. IBM may not offer the products, services or features discussed in this document in other countries, and the information may be subject
to change without notice. Consult your local IBM business contact for information on the product or services available in your area.
All statements regarding IBM's future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only.
Information about non-IBM products is obtained from the manufacturers of those products or their published announcements. IBM has not tested those products and cannot confirm the
performance, compatibility, or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
© 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.
17
zOS_V1R8_SMB_setup.ppt
SMB access from Windows
© 2007 IBM Corporation
Page 17 of 17