Craig Pelkie Bits & Bytes Programming, Inc.

Craig Pelkie Bits & Bytes Programming, Inc. craig@web400.com Configure iseries NetServer and work with Folders in the IFS

Edition NETSERVER_20020219 Published by Bits & Bytes Programming, Inc. Valley Center, CA 92082 craig@web400.com Copyright 2002, Craig Pelkie. All Rights Reserved You are allowed to print copies of this document for your own personal use and for the use of others in your company or organization. Otherwise, no part of this document or any accompanying computer source code may be reproduced or distributed in any form or by any means, or stored in a database or data retrieval system, without the prior written permission of Craig Pelkie, who is the author of the document and the computer source code. All computer source code distributed with this document, either on diskettes, CD-ROM, or available for downloading from sources such as the Internet is Copyright 2002 Craig Pelkie, All Rights Reserved. The source code is for use in computer programs that you develop for internal use within your company, or for use within programs that you develop for the use of your clients. No part of the computer source code distributed with this document shall be reproduced in source code format, either printed or in electronic format, by you or by others who you allow to have access to the source code. You shall not cause the source code to be stored on any information retrieval system, such as the Internet. You shall not develop any written articles, books, seminar materials, or other presentations that include the source code provided on the diskettes accompanying this document or within the document itself. For any questions regarding your rights and responsibilities using the computer source code distributed with this document, contact Craig Pelkie, Bits & Bytes Programming, Inc., who is the owner of the source code. LIMITATION OF LIABILITY AND DISCLAIMER OF WARRANTY No representation is made that any of the techniques, programs, computer source code, commands, or configurations described and depicted in this document and on the computer source code accompanying this document are error-free and suitable for any application that you may develop. Craig Pelkie makes no warranty of any kind, expressed or implied, including the warranties of merchantability or fitness for a particular purpose, with regard to the information, examples, and computer source code presented in this document and on the accompanying media. Everything provided in this document and the accompanying computer source code, if any, is provided as is. Craig Pelkie shall not be liable in any event for incidental or consequential damages or any other claims, pursuant to your use of any of the techniques presented in this document, or your use of the computer source code, even if Craig Pelkie has been advised of the possibility of such damages. You are responsible for testing any and all programs, configurations, commands, and procedures described in this document prior to using the programs, configurations, commands, and procedures with important user data. You must ensure that adequate and sufficient backup of important user data is available, in the event that recovery of the important user data is required.

Configure iseries NetServer and work with folders in the IFS This lab describes how to work with the iseries (AS/400) TCP/IP server NetServer. Using NetServer, you can share folders (directories) in your iseries Integrated File System (IFS) in a Windows network. NetServer lets you easily work with iseries folders on your Windows PC. The lab assumes that you have a recent version of AS/400 Operations Navigator installed and operational on your PC. It also assumes that you have sufficient authorization to your iseries server to perform the required system configuration. The lab shows you how to perform the following tasks: Use AS/400 Operations Navigator to determine if NetServer is active and review options for working with NetServer. Determine which folders in the IFS are being shared by NetServer. Map a network drive from your PC to a file share. Create a folder in the IFS and assign permissions to it. Share a folder in the IFS and stop sharing a folder in the IFS. Work with iseries NetServer using AS/400 Operations Navigator The primary tool for working with iseries NetServer is the AS/400 Operations Navigator. If you don t have AS/400 Operations Navigator installed on your PC, locate your Client Access Express install media and install the AS/400 Operations Navigator now. Note: you need the Network component of AS/400 Operations Navigator installed. If that component was not installed on your PC as part of the AS/400 Operations Navigator, use the selective install procedure to add the Network component. Follow these steps to work with iseries NetServer using AS/400 Operations Navigator: Start AS/400 Operations Navigator from the icon on your Windows desktop or from the option in the IBM AS/400 Client Access menu. The AS/400 Operations Navigator window should appear, as shown in Figure 1. (The version shown in the figure is for Client Access Express V5R1.) Note: the name of the iseries system in your AS/400 Operations Navigator will be different from those shown in the figure. Figure 1: The AS/400 Operations Navigator window when initially opened. B0100 1

Use either of these techniques to expand the options for the server shown in Figure 1: Single-click the plus sign inside the square next to the system name (M270 in the figure). Double-click the system name itself or the icon next to the system name. When you attempt to open an iseries system, you are prompted to sign on to the server if you have not already done so (Figure 2). Enter your iseries user ID and password if required and click the OK button to continue. Figure 2: Enter your iseries user ID and password if prompted. The display expands to show the list of AS/400 Operations Navigator functions installed on your PC (Figure 3). Note: do not continue with the following steps until you can reliably open the list of functions. You must be able to manipulate the AS/400 Operations Navigator display to work with it effectively. B0105 Figure 3: Expand the system name to show the list of AS/400 Operations Navigator functions. B0110 2

Expand the Network item. The list of functions under Network is shown in Figure 4. Figure 4: Expand the Network option to show its list of supported functions. Expand the Servers item then click the TCP/IP item. The list of TCP/IP servers is displayed in the right pane, as shown in Figure 5. B0115 Figure 5: Click the TCP/IP item to show the list of TCP/IP servers. B0120 3

Locate the AS/400 NetServer entry under the Server Name column in the right pane of Figure 5 and right-click it. If AS/400 NetServer is not currently running, click the Start option on the pop-up menu, then right-click the AS/400 NetServer entry again and select the Open option. If AS/400 NetServer is running, click the Open option on the pop-up menu (Figure 6). Figure 6: Right-click the AS/400 NetServer entry, then select Open from the pop-up menu. The AS/400 NetServer window is displayed, as shown in Figure 7. Expand the Shared Objects item to view the current list of folders in the IFS that are shared. Note: folders that appear in the shared objects list can be accessed on your PC using the Windows Explorer and other programs. If an IFS folder is not listed as a shared object, it is not accessible from your PC. B0125 4

Figure 7: The AS/400 NetServer window, showing the current list of shared objects. You can also see the list of shared objects by returning to the AS/400 Operations Navigator. Expand the File Systems item, then click the File Shares item. The list of shares is displayed in the right pane of the AS/400 Operations Navigator, as shown in Figure 8. B0130 Figure 8: You can also view the list of file shares under the File Systems entry in the AS/400 Operations Navigator. B0135 5

Map a network drive to a folder in the IFS using AS/400 Operations Navigator You can use the AS/400 Operations Navigator to access files in the iseries IFS and copy and paste files to and from your PC. However, you will probably find it more convenient to map a network drive on your PC to the folder you need to use in the IFS. When you map a drive, you assign a PC drive letter to a shared folder in the IFS. After mapping a drive, you can directly refer to the IFS folder by its drive letter, the same as you use drive C: on your PC. You can map a network drive using the AS/400 Operations Navigator or directly from the Windows Explorer. This section describes how to use AS/400 Operations Navigator. It is important that you become comfortable working with PC network drives mapped to the IFS. This is especially true for Java and web development, since you will do virtually all of your development on the PC using VisualAge for Java, HTML editors and other PC-based tools, then export your code to folders in the iseries IFS. Follow these steps to map a PC network drive to the QIBM folder in the iseries IFS: Refer to the technique depicted in Figure 8, and verify that folder QIBM is listed as a current shared folder on your iseries. If the folder is not currently shared, go to the section Share a folder in the IFS on page 16 and share the QIBM folder. Although there are several locations within the AS/400 Operations Navigator where you can map a network drive, follow these instructions for now. Locate the File Systems entry in the AS/400 Operations Navigator, expand it, then select the File Shares item. The list of available file shares appears in the right-pane of the AS/400 Operations Navigator, as shown in Figure 8. Right-click the QIBM folder name. Select the Map Network Drive item from the pop-up menu, as shown in Figure 9. Figure 9: Select the Map Network Drive menu item for the QIBM folder. Depending upon your version of Windows, you will be presented with different connection options. Use the following instructions based on your version of Windows. B0140 6

Windows 98, Windows ME The Map Network Drive prompt for Windows 98 and Windows ME is shown in Figure 10. The Connect as user ID is your Windows logon user ID. As you can see in the figure, it cannot be changed. If your Windows user ID is not the same as your iseries user ID, you will not be able to use the map network drive dialog, since you cannot change the Connect as option to a valid iseries user ID. If your Windows user ID is the same as your iseries user ID, enter your iseries password to complete the map network drive dialog. Figure 10: The Map Network Drive dialog for Windows 98 and Windows ME does not let you change the connect as user ID. You can select one of your PC's available drive letters to assign to the share name. If you will be working with the IFS folder in the future, you can check the Reconnect at logon option. When you restart Windows, it will attempt to connect to the iseries folder using the local drive letter that you selected. Windows NT 4.0, Windows 2000 The Map Network Drive prompt for Windows NT 4.0 (all versions) and Windows 2000 (all versions) is shown in Figure 11. Your Windows user ID is used as the default Connect as user ID. If your Windows user ID is not the same as your iseries user ID, you can change the Connect as value to your iseries user ID, then enter your password to complete the connection to the network drive. B0141 Figure 11: The Windows NT and Windows 2000 Map Network Drive prompt. B0145 7

Map a network drive to a folder in the IFS using Windows Explorer In addition to mapping a network drive in the AS/400 Operations Navigator, you can map a network drive in the Windows Explorer. Use the following steps for your Windows operating system to map a network drive to an iseries folder using the Windows Explorer. Windows NT 4.0, Windows NT Server 4.0 Start the Windows Explorer program if it is not already started (Note: start the Windows Explorer, not Internet Explorer). Select the Tools, Map Network Drive menu option as shown in Figure 12. Figure 12: Use the Windows Explorer Tools, Map Network Drive menu item. Windows displays the Map Network Drive dialog, shown in Figure 13. Select the drive letter to use. If you know the network path, you can type it in the Path field. To browse for the network path, expand the domain or workgroup names shown in the Shared Directories list in the lower part of the dialog, then expand the server name that contains the folder you want to map to. When you select an iseries server, you are prompted to enter your iseries user ID and password as shown in Figure 14. After entering your iseries user ID and password, you can select the shared folder from the list of folders, as shown in Figure 15. You can select the Reconnect at logon option if you will be using the network drive in the future. Click the OK button when done. The iseries folder in the IFS is now accessible through your PC drive letter. B0155 8

Figure 13: The Windows Map Network Drive dialog, as shown in Windows NT 4.0 and Windows NT Server 4.0. B0156 Figure 14: Enter your iseries user ID and password when prompted. B0157 Figure 15: After entering your iseries user ID and password, you can select a shared folder in the IFS. B0158 9

Windows 98, Windows 98 SE, Windows ME Note: for these PC operating systems, you can only map a network drive from the Windows Explorer if your Windows user ID is the same as your iseries user ID. Start the Windows Explorer program if it is not already started (Note: start the Windows Explorer, not Internet Explorer). Select the Tools, Map Network Drive menu option as shown in Figure 16. Figure 16: Use the Windows Explorer Tools, Map Network Drive menu item. Windows displays the Map Network Drive dialog shown in Figure 17. You can select an available drive letter on your PC. You must manually enter the Path value using the Universal Naming Convention (UNC) network name: \\server_name\folder_name B0165 B0166 Figure 17: The Windows Map Network Drive dialog, as shown in Windows 98 and Windows ME. Note that you cannot browse the network. Click the OK button to assign the drive letter. If you have not previously connected to the iseries server using your Windows user name, Windows displays the Enter Network Password dialog shown in Figure 18. Note: by default, the Save this password option is checked. To help secure your iseries server, you should remove the checkmark from that option. By removing the checkmark, you will be prompted for your iseries password the next time you connect to the folder. If you don't remove the checkmark, anyone who uses your Windows PC when logged on with your iseries user ID will have access to the folder. Figure 18: Enter you iseries password to complete the connection to the iseries folder. B0167 10

Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server Start the Windows Explorer program if it is not already started (Note: start the Windows Explorer, not Internet Explorer). Select the Tools, Map Network Drive menu option as shown in Figure 19. Figure 19: Use the Windows Explorer Tools, Map Network Drive menu item. Windows displays the Map Network Drive dialog, shown in Figure 20. Select the drive letter to use. Enter the network path name and folder name as shown in the figure. You can also click the Browse button to browse your Windows network to locate the server and the folder name as shown in Figure 21. If you have not previously signed on to the iseries server, Windows displays the user ID and password dialog shown in Figure 22. You can select the Reconnect at logon option if you will be using the network drive in the future. Click the Finish button. B0150 Figure 20: The Windows Map Network Drive dialog, as shown in Windows 2000. B0151 11

Figure 21: Use the Browse for Folder dialog to locate the iseries server and its shared folders. B0153 Figure 22: Enter the iseries user ID and password to connect to the iseries folder. B0152 12

Create a new root level folder in the IFS Another skill that you should be familiar with is creating a folder in the IFS and assigning permissions to it. You can use a folder in the IFS as a backup of your work on your PC. You will also be able to export Java and HTML code and other files to your folder in the IFS from your PC development tools. Note: you can create a new subfolder (folder within a folder) in the IFS using Windows Explorer. To create a new root level folder (that is, a folder that is not contained within any other folder), you need to use the AS/400 Operations Navigator as shown in this section. Follow these steps to create a root level folder in the IFS: In the AS/400 Operations Navigator, expand the File Systems option, then expand the Integrated File System option, then expand the Root option. Note: you should only create new folders in the IFS in the Root file system. Do not create folders in other file systems unless you understand how those file systems work. In particular, do not create folders in the QDLS file system. Right-click the Root entry. Be sure you right-click Root, and not one of the folders listed under Root. Select the New Folder option from the pop-up menu (Figure 23). Figure 23: Select the New Folder option in the Root file system. In the New Folder prompt (Figure 24), enter the folder name. Be sure the name is not already in use in the Root file system. Click the OK button after entering the name. B0170 13

Figure 24: Enter the name to assign to the new folder in the Root file system. After you click OK, the view of the Root file system should be refreshed in the AS/400 Operations Navigator. Locate your new folder in the Root file system. Right-click your folder name and select the Permissions option from the pop-up menu (Figure 25). B0175 Figure 25: Right-click your folder name and select the Permissions option on the pop-up menu. Review the permissions on the Permissions dialog (Figure 26). You can change permissions and add or remove iseries user profiles to alter the permissions for the folder. By default, each folder created in the Root directory has the following authorizations: (Public) has all authorizations to the folder. Your iseries user profile that you are signed on as has all permissions to the folder. You usually do not want (Public) to have all authorizations. You can click the Exclude option to remove authorizations to (Public). When you create a subfolder under this folder, or when you move files into the folder, the subfolder or new files inherit the permissions of the containing folder. B0180 14

Figure 26: Use the Permissions dialog to set permissions for folders in the IFS. B0185 15

Share a folder in the IFS You also need to know how to share a folder to work effectively with the iseries IFS. If you do not share a folder, you cannot access it through Windows Explorer or other PC programs. Follow these steps to share a folder in the iseries IFS: In the AS/400 Operations Navigator, expand the File Systems, Integrated File System, Root branch. Locate the folder you want to share, as shown in Figure 27. Right-click the folder name and select the Sharing, New Share menu item from the pop-up menu. Figure 27: Right-click the folder to share and select the Sharing, New Share menu item. On the AS/400 NetServer File Share dialog (Figure 28), you can assign the share name, a description, and the access to the folder: The share name is the name that appears in Windows Explorer and other PC programs. If you use a different name for the share name, the name is an alias for the actual folder name. You can use an alias if you do not want to expose the actual folder name in the IFS. For now, leave the share name set to the default. The description is displayed in the AS/400 Operations Navigator. It is optional. The access option is set to Read only by default. Change this to Read/Write so that you can save files from your PC to the folder in the IFS. After changing the Access option, click the OK button. The folder is now shared by the iseries server, and can be accessed through Windows programs. B0200 16

Figure 28: Assign the share name and access option in the AS/400 NetServer File Share dialog. B0205 Stop sharing a folder in the IFS Finally, you should know how to stop sharing a folder in the IFS. Follow these steps to stop sharing the folder that you enabled for sharing: Right-click the folder that you started sharing in the previous section. Select the Sharing, Stop Sharing menu item from the pop-up menu, as shown in Figure 29. Figure 29: Select the Sharing, Stop Sharing option for the folder. B0220 17

On the Stop Sharing dialog (Figure 30), be sure the folder name is selected and click the OK button. NetServer stops sharing for the folder. Figure 30: Click OK to stop sharing the selected folder. You can verify that the folder is no longer shared by locating it in the list of folders in the Operations Navigator. The hand icon is no longer holding the folder icon when sharing is inactive (Figure 31). B0225 Figure 31: Verify that the folder is no longer shared (the "hand" icon is no longer holding the folder icon). B0230 18