As074lsg1. RPG IV Programming
Intermediate Workshop for
System i
(Course Code AS07)
Lab Set Up Guide
ERC 4.0
IBM Certified Course Material
V3.1.0.1
cover
Front cover
2. Lab Set Up Guide
June 2006 Edition
The information contained in this document has not been submitted to any formal IBM test and is distributed on an “as is” basis without
any warranty either express or implied. The use of this information or the implementation of any of these techniques is a customer
responsibility and depends on the customer’s ability to evaluate and integrate them into the customer’s operational environment. While
each item may have been reviewed by IBM for accuracy in a specific situation, there is no guarantee that the same or similar results will
result elsewhere. Customers attempting to adapt these techniques to their own environments do so at their own risk.
© Copyright International Business Machines Corporation 2002, 2006. All rights reserved.
This document may not be reproduced in whole or in part without the prior written permission of IBM.
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 with IBM Corp.
Trademarks
IBM® is a registered trademark of International Business Machines Corporation.
The following are trademarks of International Business Machines Corporation in the United
States, or other countries, or both:
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the
United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are 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.
Other company, product, or service names may be trademarks or service marks of others.
AS/400 DB2 i5/OS
Integrated Language
Environment
iSeries Language Environment
OS/400 Redbooks RPG/400
System/36 VisualAge WebSphere
3. Lab Set Up Guide
V3.1.0.1
TOC
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2002, 2006 Contents iii
Contents
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Set Up Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
4. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
iv RPG IV Programming Intermediate © Copyright IBM Corp. 2002, 2006
5. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2002, 2006 Trademarks v
V3.1.0.1
TMK Trademarks
The reader should recognize that the following terms, which appear in the content of this
training document, are official trademarks of IBM or other companies:
IBM® is a registered trademark of International Business Machines Corporation.
The following are trademarks of International Business Machines Corporation in the United
States, or other countries, or both:
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the
United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are 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.
Other company, product, or service names may be trademarks or service marks of others.
AS/400® DB2® i5/OS™
Integrated Language
Environment®
iSeries™ Language Environment®
OS/400® Redbooks™ RPG/400®
System/36™ VisualAge® WebSphere®
6. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
vi RPG IV Programming Intermediate © Copyright IBM Corp. 2002, 2006
7. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2002, 2006 Purpose vii
V3.1.0.1
LSGp Purpose
This Lab Set Up Guide provides directions for installing, preparing, and verifying the lab
hardware and software in preparation for conducting a class of course AS07.
The Requirements sections of this document may also be used to determine the specific
hardware and software needed to conduct a class.
8. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
viii RPG IV Programming Intermediate © Copyright IBM Corp. 2002, 2006
9. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2002, 2006 Requirements 1
V3.1.0.1
AP Requirements
The following tables list the hardware, software, and other materials needed to set up a lab
to conduct a class of course AS07/S6198.
Hardware Requirements
The following table lists the hardware needed to prepare one student lab set. When
preparing for a class, multiply the items below by the number of lab sets needed for the
class.
The recommended student workstation hardware is a Pentium 4 processor with 1GB of
memory, and a SVGA 1024 x 768 monitor. A complete install of WDSC V6.0 uses about
3GB of disk space.
The overhead projector should be 800x600 pixels to match the resolution for the PDF
presentation.
Software Requirements
The table below lists the software needed for the systems used in the course. When
preparing for a class, be sure you have the required licenses for any non-IBM software.
Table 1: Hardware for lab platforms
Platform
Use
Machine
Type
Model Minimum
Memory
Minimum
Free DASD
Features
Student Pentium 4®
PC
PC 512MB
(1GB rec.)
10GB • Token Ring or
E'net Adapter
• SVGA
• CD-ROM
Instructor Pentium 4®
PC
PC 512MB
(1 GB rec.)
10GB • Token Ring or
E'net Adapter
• SVGA
• CD-ROM
i5(iSeries) i5(iSeries) RISC 1GB 20GB • Token Ring or
E'net Adapter
• SVGA
• CD-ROM
• Classroom
Printer
10. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
2 RPG IV Programming Intermediate © Copyright IBM Corp. 2002, 2006
Note: WDSC CD/DVD pack includes optional install for CODE and VisualAge RPG
products. These MUST be installed. After completing the WDSC install, check for on-line
fixes using the IBM Rational Updater facility.
WARNING: WDSC install will take a significant amount of time and occupies more than
3GB disk space. The Fixes require a fast Internet connection to download and install,
(approx 1GB). Allow several hours for this. Alternatively, it may be more convenient to
Platform
Use
Operating
System
OS
Versio
n
Applications Application
Version
Licensing
Requirement
Student Windows XP or
2000
iSeries Access
Mozilla Firefox
Internet
Explorer
Adobe Reader
IBM
InfoCenter
(CD link)
WDSC
PComm (opt)
V5R3
1.0.7+
6.0+
7.0+
V5R3
V6.0+(note)
5.8
One per PC
Platform
Instructor Windows XP or
2000
iSeries Access
Mozilla Firefox
Internet
Explorer
Adobe Reader
IBM
InfoCentre
(CD link)
WDSC
PComm (opt)
V5R3
1.0.7+
6.0+
7.0+
V5R3
V6.0+(note)
5.8
One per PC
Platform
i5(iSeries) i5/OS
(OS/400)
V5R3or
V5R2
See Below
11. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2002, 2006 Requirements 3
V3.1.0.1
AP download the Fixes in .ZIP or .EXE form, (if available) and install separately. Consult the
IBM Support literature for further details.
IBM PComm is an optional install. If it IS used, ensure it is installed BEFORE iSeries
Access. (PComm allows more flexibility than the iSeries Access 5250 emulation facilities.)
The recommended release of i5/OS (OS/400) for this class is V5R3. However, the labs
will still run on V5R2. V5R3 is preferred so that the instructor can show some of the new
V5R3 features. The list of i5(iSeries) software required for the class follows:
5722-SS1 OS/400 - Library QGPL
5722-SS1 OS/400 - Library QUSRSYS
5722-SS1 *BASE Operating System/400
5722-SS1 Option 12 OS/400 - Host Servers
5722-QU1 *BASE Query
5722-ST1 *BASE DB2 Query Mgr and SQL DevKit
5722-TC1 *BASE TCP/IP Connectivity Utilities
5722-XW1 *BASE iSeries Access
5722-XW1 Option 1 iSeries Access Enablement Support
5722-XE1 *BASE iSeries Access for Windows
5722WDS *BASE WebSphere Development ToolSet
5722WDS 21 Tools - Application Development
5722WDS 31 Compiler - ILE RPG IV
5722WDS 35 Compiler - ILE RPG IV *PRV
5722WDS 60 Workstation Tools - Base
Special Materials Requirements
The following table lists any special materials or supplies such as configuration diskettes,
project tapes, or bugged logic cards needed to conduct the class. Quantities are specified
as one for each class, each lab set, or each student.
Special Materials needed for class
Item Description Each Student
SK3T-4091 iSeries Information
Center CD
1
SK2T-2849 IBM Redbooks iSeries
400 Collection CDs
1
12. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
4 RPG IV Programming Intermediate © Copyright IBM Corp. 2002, 2006
Skills Required to Set up the Lab
Should know how to install i5(iSeries) software as well as how to install Windows OS on
PCs and PC applications. Must know how to setup TCP/IP and how to configure i5(iSeries)
hosts in i5(iSeries) Access.
13. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2002, 2006 Set Up Instructions 5
V3.1.0.1
AP Set Up Instructions
Setup of Instructor and Student PCs
Each workstation should be loaded with Windows XP/2000. Each student, as well as the
instructor, must be able to start a 5250 emulation session. You will need to install iSeries
Access (or IBM PComm) in order to get 5250 emulation.
14. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
6 RPG IV Programming Intermediate © Copyright IBM Corp. 2002, 2006
Installing PC Software
Install each of the following software packages on each classroom PC or create an install
image and replicate that image across all PCs. Please review the manufacturer's
documentation for detailed installation instructions
1. Install Windows
Be sure that you configure TCP/IP as necessary in your location. If you are using an
image it will be necessary to assign a unique address to each PC.
2. (Optional) Install IBM Personal Communications. This provides a more flexible 5250
(and 3270) emulation facility than that provided within iSeries Access. If you do install
IBM PComm, you must do so before installing iSeries Access
3. Install iSeries Access
You must specify that you want iSeries Navigator (full support) and 5250 emulation
when prompted. (If using IBM PComm for 5250 emulation, ensure this is installed
FIRST, before installing iSeries Access.)
4. Install Adobe Acrobat Reader
5. Install Mozilla Firefox and/or Internet Explorer
6. Install the Information Center CD Link
When prompted, specify Client: Single Workstation and, on the following panel that you
want the files to Remain in the current location.
7. Install WDSC and apply PTFs.
a. Insert the first DVD/CD and follow the instructions. You will be prompted to reboot
your PC.
b. Use the IBM Rational Updater function to find/install Fixes:
i. Click Start>Programs>IBM Rational>Rational Product Updater
ii. Select Find Updates and follow on-screen instructions.
c. Alternatively, go to the WDSC website and download any new PTFs for this version,
(currently V6.0):
http://www-3.ibm.com/software/awdtools/wdt400/support/
d. Check PTFs on the i5(iSeries) to make sure that your level of WDSC will support the
client PCs:
i. Click Start>Programs>IBM Rational>IBM WebSphere Development Studio
Client for iSeries V6.0 to start the WDSC Workbench.
ii. Use the New Connection node in the Remote Systems view to establish a
connection with the i5(iSeries). Follow the instructions.
iii. Expand the new Connection and right-click the iSeries Objects subsystem. A
context menu will appear. Select the option to Verify Connection.
15. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2002, 2006 Set Up Instructions 7
V3.1.0.1
AP iv. You will be prompted for your userid and password.
v. You will see a window that tells you if your server is OK for the client. If it is not,
check the list and you will see which PTFs need to be applied.
iSeries Setup
Install the base iSeries software listed above.
The AS07V4LIB SAVF contains an i5(iSeries) Save File (*SAVF). This file must be
uploaded to any i5(iSeries) library.
Then restore the AS07V4LIB library (AS07 Class master library) from the AS07V4LIB Save
File on the i5(iSeries). The AS07V4LIB library contains everything needed for all lab
exercises.
Be sure that the lab exercise software is loaded on the lab system, and that the setup
process has been run.
The labs were created on Version 5 Release 3 of i5/OS (OS/400) and have been tested on
V5R2 and V5R3 systems only!
All objects are owned by User Profile AS07INST. It will simplify the restore of object
authorities if this Profile is created FIRST with USRCLS(*ALLOBJ), before the course
library is restored. The AS07INST Profile can then be used to test the setup/drop
procedures which follow.
Course Setup Procedure
• Restore library AS07V4LIB to the lab exercise system.
• CHGCURLIB AS07V4LIB
• GO COURSE
• Select the menu option to display course code, name, edition, and version information.
Be sure your copy of AS07V4LIB matches the edition number in the front matter of your
instructor materials.
• Select the menu option to create profiles for a class.
The profile created for each student is:
USRPRF(AS07nnn)
PASSWRD(AS07)
expire at first logon
All AS07* profiles are granted additional authorities to:
• STRDBG command (AS07GROUP0 *USE)
• RSTOBJ command (AS07GROUP0 *USE)
• CHGJRN (*USE)
16. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
8 RPG IV Programming Intermediate © Copyright IBM Corp. 2002, 2006
All collection AS07XXX (Master Student Collection) objects have *PUBLIC authority *ALL,
because they are already owned by AS07INST, and restored at setup time to a collection to
which only the students and instructor have private authority. This is already established in
the AS07XXX save file.
AS07V4LIB objects that must be used by the student require *PUBLIC *USE authority.
Setup and drop code require *PUBLIC *EXCLUDE authority.
In the classroom, assign each student or team a number (nnn) that will be used for student
user profiles and libraries. The profile ending with 000 is reserved for the exclusive use of
the instructor.
Each iteration (class) of the course consists of a group profile, AS07GROUP0. The group
profile is created with PASSWORD(*NONE) and exists only to simplify and shorten the
setup authority process. The user profiles for the class are AS07000 through AS07999,
depending on the number of students for whom profiles are required. The instructor profile
ends with 000, and has authority to all student objects. The student profiles (AS07001 -
AS07999) have authority to their own objects but do not have authority to other students'
libraries.
All AS07nnn user passwords are set to expire at the first signon. The initial password is
AS07.
When you assign the team number to each student, remind them to pick a unique
password that they can remember.
Course Clean Up Procedure
On the i5(iSeries), invoke the course setup menu, GO COURSE. Option 4 will clean up the
class.
17. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
© Copyright IBM Corp. 2002, 2006 Set Up Instructions 9
V3.1.0.1
AP Verifying the Installation
This completes the installation of the operating system for this class.
__ 1. Boot the Windows operating system and a desktop screen should appear with a
taskbar.
__ 2. If the i5(iSeries) has all the required software installed, you can test the connection
using i5(iSeries) Access:
a. Open the iSeries Access folder and then open iSeries Navigator.
b. From the file menu, select Add Connection.
c. Follow the menus and add the IP address and name of the i5(iSeries) when
prompted. Add the system to the My Connections.
d. Return to the main iSeries Navigator window
e. You should see the system name you just added.
f. Right click on the system name. Select Verify Connection. If it is successful, close
the verification window.
If you cannot verify the connection to the i5(iSeries), most likely you need to update
the hosts or lmhosts file in your WINDOWS directory. You can open this file with
NOTEPAD and add an entry to the table. The table should look similar to this:
127.0.0.1 localhost
x.xx.xxx.xxx DALLASB
x.xx.xxx.xxx ATLANTAB
x.xx.xxx.xxx DIRTCITY
x.xx.xxx.xxx ROCKCITY
g. If it was necessary to update the HOSTS file, attempt to verify the connection once
again.
__ 3. To validate the CODE installation:
a. Click Start>IBM CODE and VisualAge RPG 6.0>Check PTF.
b. Enter the i5(iSeries) server name or its IP address, plus your userid and password.
Click OK. If you installed properly, you should see a message that says “You have
required LPP and PTFs”.
If you see anything else, the wizard will tell you what you need to do.
18. Lab Set Up Guide
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
10 RPG IV Programming Intermediate © Copyright IBM Corp. 2002, 2006