You are on page 1of 186



iSeries
Getting started with iSeries


iSeries
Getting started with iSeries
© Copyright International Business Machines Corporation 1998, 2001. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Chapter 1. Getting started with iSeries 400 . . . . . . . . . . . . . . . . . . . . . . 1
Completing EZ-Setup: do these tasks first . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 2. Configuring your LAN console . . . . . . . . . . . . . . . . . . . . . . . 3

Chapter 3. Backing up your system . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 4. Microsoft’s Data Access Components (MDAC) . . . . . . . . . . . . . . . . . 7


How MDAC works on your system . . . . . . . . . . . . . . . . . . . . . . . . . . 7
How to get MDAC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Saving changes after installing software . . . . . . . . . . . . . . . . . . . . . . . . 7
Adding electronic customer support to your system . . . . . . . . . . . . . . . . . . . . 7

Chapter 5. Making your system operational . . . . . . . . . . . . . . . . . . . . . . 9


Before you start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Turning on the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Powering on the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Performing an Initial Program Load (IPL) . . . . . . . . . . . . . . . . . . . . . . . 10
Configuring your LAN console . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
System interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Operations Navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Command line interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Installing Management Central . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Backing up your system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Initializing the tape for a system backup . . . . . . . . . . . . . . . . . . . . . . . 12
Performing a system backup . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installing software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Saving changes after installing software . . . . . . . . . . . . . . . . . . . . . . . . 15
Adding electronic customer support to your system . . . . . . . . . . . . . . . . . . . . 15
Configuring Universal Connection . . . . . . . . . . . . . . . . . . . . . . . . . 16
Configure service provider information . . . . . . . . . . . . . . . . . . . . . . . . 18
Testing your connection to electronic customer support . . . . . . . . . . . . . . . . . 18
Configuring SNA connection to electronic customer support . . . . . . . . . . . . . . . . 18

Chapter 6. System configuration concepts . . . . . . . . . . . . . . . . . . . . . . 21

Chapter 7. System operations concepts . . . . . . . . . . . . . . . . . . . . . . . 23


Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Logs and journals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Journals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
System authorities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Files and file systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Control language commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Command syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Entering commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
User profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Printing on iSeries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Installed and permanently installed fixes . . . . . . . . . . . . . . . . . . . . . . . 29
Available and delayed fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

© Copyright IBM Corp. 1998, 2001 iii


Chapter 8. Managing system operations . . . . . . . . . . . . . . . . . . . . . . . 31
Controlling jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
To get information about a job on your system: . . . . . . . . . . . . . . . . . . . . 31
Handling messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
To send a message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
To delete a message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
To get more information about a message . . . . . . . . . . . . . . . . . . . . . . 32
To reply to a message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Your system status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
User profile tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Perform common user profile tasks . . . . . . . . . . . . . . . . . . . . . . . . . 34
Managing user profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Adding and removing users from groups . . . . . . . . . . . . . . . . . . . . . . . 36
Entering personal information into a user profile . . . . . . . . . . . . . . . . . . . . 37
Setting security parameters for users . . . . . . . . . . . . . . . . . . . . . . . . 37
Job-related information for users . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Setting system security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
System security classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Setting security policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Setting up auditing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Defining authorization lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Using the security wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Starting and stopping the iSeries . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Setting up an automatic power on and off schedule . . . . . . . . . . . . . . . . . . . 43
Starting the System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Starting the iSeries: signing on . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Starting a remote system . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Changing your system IPL from the system control panel . . . . . . . . . . . . . . . . . 47
System Values That Control IPL . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Changing the system during IPL (attended IPL) . . . . . . . . . . . . . . . . . . . . 50
Tips for Improving IPL Performance . . . . . . . . . . . . . . . . . . . . . . . . . 53
Cleaning up your system to improve performance . . . . . . . . . . . . . . . . . . . 57
Changing the system password . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Working with subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Stopping the system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Powering off the system immediately . . . . . . . . . . . . . . . . . . . . . . . . 64
Using the power pushbutton . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
System reference codes and primary partitions . . . . . . . . . . . . . . . . . . . . 65
System reference codes and secondary partitions . . . . . . . . . . . . . . . . . . . 67
What causes an abnormal IPL? . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Managing fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Common fix management tasks . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Advanced fix management tasks . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Ordering individual fixes and cover letters . . . . . . . . . . . . . . . . . . . . . . 70
Sample cover letter and description of fields . . . . . . . . . . . . . . . . . . . . . 73
Ordering fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Using the SNDPTFORD command to order fixes . . . . . . . . . . . . . . . . . . . . 78
Preparing to install fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Choosing a storage area before applying a fix . . . . . . . . . . . . . . . . . . . . . 79
Installing a cumulative fix pack . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Installing licensed internal code fixes . . . . . . . . . . . . . . . . . . . . . . . . 82
Installing licensed program (LP) fixes . . . . . . . . . . . . . . . . . . . . . . . . 83
Verifying the fix installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Displaying fix status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Displaying fix information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Distributing fixes to remote systems. . . . . . . . . . . . . . . . . . . . . . . . . 86

iv iSeries: Getting started with iSeries


Removing fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Loading fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Applying fixes: advanced procedure. . . . . . . . . . . . . . . . . . . . . . . . . 95
Working with devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
System requirements for device configurations. . . . . . . . . . . . . . . . . . . . . 98
Working with printer output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
ASCII LAN printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
IPDS LAN printing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Twinax printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Using Line Printer Requester/Line Printer Daemon (LPR/LPD) printing . . . . . . . . . . . . 100
Setting up a remote printer . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Setting up a remote printer from the command line . . . . . . . . . . . . . . . . . . 101
Preparing to print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Starting printer output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Changing a format to ASCII before printing . . . . . . . . . . . . . . . . . . . . . 104
How spooled files are named . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Ownership of spooled files. . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Deleting printers that are no longer needed on the system . . . . . . . . . . . . . . . . 106
Setting up Telnet printer pass-through . . . . . . . . . . . . . . . . . . . . . . . 106
Setting the number of virtual devices . . . . . . . . . . . . . . . . . . . . . . . . 107
Virtual controllers and devices created by the system . . . . . . . . . . . . . . . . . . 108
Activating the QSYSWRK subsystem. . . . . . . . . . . . . . . . . . . . . . . . 108
Printer security considerations . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Using removeable media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Using tapes and tape units . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
General Tape Usage Information . . . . . . . . . . . . . . . . . . . . . . . . . 111
Storage Device Ready Conditions . . . . . . . . . . . . . . . . . . . . . . . . . 114
Using CD-ROM Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Using Optical Media Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Tape Drive Environment and Use . . . . . . . . . . . . . . . . . . . . . . . . . 118
Using 1/2-Inch and Magstar MP Tape Cartridges . . . . . . . . . . . . . . . . . . . 119
Using 1/4-Inch Cartridges . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Using 8-Millimeter Tape Cartridges. . . . . . . . . . . . . . . . . . . . . . . . . 133
Using 1/2-Inch tape reels . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Chapter 9. Handling system problems and getting help through electronic customer support 141
Troubleshooting printer problems . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Solving problems with sending jobs . . . . . . . . . . . . . . . . . . . . . . . . . 141
LPR command considerations . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Common error messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Materials required for reporting LPR problems . . . . . . . . . . . . . . . . . . . . 142
Solving problems with receiving jobs . . . . . . . . . . . . . . . . . . . . . . . . . 142
Materials Required for Reporting LPD Problems. . . . . . . . . . . . . . . . . . . . 143
Finding a job that did not print . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
On the server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
On the client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Resolving problems with the Universal Connection wizard . . . . . . . . . . . . . . . . . 144
AT&T customers: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Contacting electronic customer support . . . . . . . . . . . . . . . . . . . . . . . . 146
Wait! Before You Access the Internet... . . . . . . . . . . . . . . . . . . . . . . . 146
Viewing system configuration lists . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Troubleshooting your system . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Before you call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
How to use this flowchart . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

Contents v
Begin troubleshooting now. . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Troubleshooting your system: Step 2 . . . . . . . . . . . . . . . . . . . . . . . . 148
Troubleshooting your system: Step 3 . . . . . . . . . . . . . . . . . . . . . . . . 148
Troubleshooting your system: Step 4 . . . . . . . . . . . . . . . . . . . . . . . . 148
Troubleshooting your system: Step 5 . . . . . . . . . . . . . . . . . . . . . . . . 148
Troubleshooting your system: Step 6 . . . . . . . . . . . . . . . . . . . . . . . . 148
Troubleshooting your system: Step 7 . . . . . . . . . . . . . . . . . . . . . . . . 149
Troubleshooting your system: Step 8 . . . . . . . . . . . . . . . . . . . . . . . . 149
Troubleshooting your system: Step 9 . . . . . . . . . . . . . . . . . . . . . . . . 149
Troubleshooting your system: Step 10 . . . . . . . . . . . . . . . . . . . . . . . 149
Troubleshooting your system: Step 11 . . . . . . . . . . . . . . . . . . . . . . . 149
Troubleshooting your system: Step 12 . . . . . . . . . . . . . . . . . . . . . . . 149
Troubleshooting your system: Step 13 . . . . . . . . . . . . . . . . . . . . . . . 149
Troubleshooting your system: Step 14 . . . . . . . . . . . . . . . . . . . . . . . 150
Troubleshooting your system: Step 15 . . . . . . . . . . . . . . . . . . . . . . . 150
Troubleshooting your system: Step 16 . . . . . . . . . . . . . . . . . . . . . . . 150
Troubleshooting your system: Step 17 . . . . . . . . . . . . . . . . . . . . . . . 150
Troubleshooting your system: Step 18 . . . . . . . . . . . . . . . . . . . . . . . 151
Troubleshooting your system: Step 19 . . . . . . . . . . . . . . . . . . . . . . . 151
Analyzing problems with a symptom . . . . . . . . . . . . . . . . . . . . . . . . . 152
Procedure 1: Recovering from system power problem . . . . . . . . . . . . . . . . . 153
Procedure 2: Recovering when attention light is on or the System Reference Code (SRC) is
displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Procedure 2A: Recovering when Operations Console Remote Control Panel feature is not working
properly. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Procedure 3: Recovering when control panel pushbuttons or lights are not working properly . . . 156
Procedure 4: Recovering from IPL or system failure . . . . . . . . . . . . . . . . . . 156
Procedure 5: Recovering from workstation failure . . . . . . . . . . . . . . . . . . . 157
Procedure 6: Recovering from tape or optical device problem . . . . . . . . . . . . . . . 158
Procedure 7: Recovering from disk or diskette drive problem . . . . . . . . . . . . . . . 158
Procedure 8: Recovering from communication problem . . . . . . . . . . . . . . . . . 158
Procedure 9: Recovering from system hang or loop condition . . . . . . . . . . . . . . . 158
Procedure 10: Recovering from intermittent problem . . . . . . . . . . . . . . . . . . 159
Procedure 11: Recovering when system console did not vary on . . . . . . . . . . . . . 159
Problem summary forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Problem summary form for systems with a single partition (except Model 270 and 8xx) . . . . . 160
Problem summary form for systems with multiple partitions (except Model 8xx) . . . . . . . . 161
Problem summary form for Model 270 and 8xx systems with a single partition . . . . . . . . 162
Problem summary form for Model 8xx systems with multiple partitions . . . . . . . . . . . 163
Accessing panel functions on a secondary partition . . . . . . . . . . . . . . . . . . 164
Analyzing a new problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Reporting hardware and software problems . . . . . . . . . . . . . . . . . . . . . 165
Replacing Battery Power Unit on Models 5xx, and Tower FC507x and FC508X . . . . . . . . 170
Performing a main storage dump . . . . . . . . . . . . . . . . . . . . . . . . . 171
Determining the primary or alternate consoles . . . . . . . . . . . . . . . . . . . . 174
Getting help with system operation problems . . . . . . . . . . . . . . . . . . . . . 175

vi iSeries: Getting started with iSeries


Chapter 1. Getting started with iSeries 400
Whether you are new to the iSeries or an experienced professional, this topic is a useful starting point for
all kinds of information for handling simple and complex tasks on your system.

Use this information to get to know your system—how it works, how the pieces interact, and how you can
customize it to better meet your needs. Learn the terminology, and see how this platform is different from
others you may have worked on. Explore system concepts and learn to manage the day-to-day business
of your system. Identify some of your common administrative tasks, and how you can accomplish them. If
you run into problems, use the troubleshooting guide to get back on track.

Making your system operational Complete these tasks when you are ready to start your system for the first time.
System configuration concepts Your system configuration includes the hardware (system and any devices) and
the software (operating system). Discover what is under the ″hood″ of your new
system.
System operations concepts Focus on some of the most important concepts you need to know to operate your
system. See how your new system compares to the competition.
Managing system operations Perform a system performance check or set up user profiles. Understand the
security features incorporated into your system and how you can take full
advantage of them.
Handling system problems and If you’ve lost a print job, or want to know what those cryptic error messages
getting help mean, and why your system is acting weird, you need troubleshooting. When a
problem arises, you can either solve it yourself or get assistance, depending on
the nature of the problem.

Print this topic for future reference.

Completing EZ-Setup: do these tasks first


Now that you have successfully completed EZ-Setup, you need to complete the following tasks to bring
your system online for the first time. Once completed, your system will be configured, backed up, and
connected to IBM support services.

1. Configure your LAN console


If you did not configure your local area network when prompted in EZ-Setup, do so now.
2. Back up your system
Perform an immediate system backup to save your new configuration and create a regular backup
schedule.
3. Install MDAC
Add this component to enhance your database functionality.
4. Save changes to your system
Save the changes you have just made to your system.
5. Add electronic customer support
Run the wizard to set up a support connection to IBM.

Additional information on this topic can be found in these sources:

Getting started with iSeries 400: Introductory reference material for users new to the iSeries.

© Copyright IBM Corp. 1998, 2001 1


2 iSeries: Getting started with iSeries
Chapter 2. Configuring your LAN console
Operations Console allows you to use your PC as the system console, perform control panel functions, or
both. With Operations Console, you can administer iSeries servers that are on your local area network
(LAN). You can also remotely administer several iSeries servers at different locations, including other
LANs.

Follow the instructions in Client Access Express -> Operations Console.

© Copyright IBM Corp. 1998, 2001 3


4 iSeries: Getting started with iSeries
Chapter 3. Backing up your system
When you create a system backup, you create a snapshot of your system information at a particular point
in time. The system backup preserves all of the system configuration information that you have made so
far. You can expect to spend between 30 minutes and several hours performing this backup, but it is time
well spent.

Backing up a system is not a difficult process, but it is one that can easily be forgotten as you attend to
more pressing tasks. Scheduling backups can not only ease your system maintenance workload by
automating a commonly performed function, but help you address problems with data corruption, power
outages, and other unforseen situations that may damage your system data. The backup schedule you
create plays an important part of that strategy.

Backup, Recovery and Media Services (BRMS) will help you structure your backup tasks, and manage
your backup media. You can use BRMS to restore data, recover an entire system, and perform
maintenance tasks. BRMS is not intended to replace your backup and recovery strategy, but it can be a
useful tool for implementing that strategy.

Backing up your system initially involves these steps:


1. Initializing the tape
2. Performing the backup

Additional information on this topic can be found in these sources:

Backing up your system


Planning a backup and recovery strategy
Backup, Recovery, and Media Services

© Copyright IBM Corp. 1998, 2001 5


6 iSeries: Getting started with iSeries
Chapter 4. Microsoft’s Data Access Components (MDAC)
One of your system’s key roles is as a database server. The DB2 database that is integrated into your
system plays a vital role in managing client information, key business data, and historical archives.

How MDAC works on your system


MDAC adds important functionality to clients on your system. MDAC enables the universal data access
required in client/server environments, and includes a number of Microsoft data components.

Some database components, such as OLE DB which provides a connection between relational and
non-relational information sources, including traditional databases, require MDAC to be installed on clients
on the system. The minimum level required for this release is MDAC version 2.5.

How to get MDAC


Download and install the most recent version of MDAC on your clients to ensure that all database
components function effectively. You can obtain the most current version of MDAC at no additional charge

from the Microsoft site .

Additional information on this topic can be found in these sources:

DB2 Database information

Saving changes after installing software

After finishing the Checklist for completing installation in the Software Installation manual , you must
save the changes you have made to your system to make them permanent. Follow these steps:
1. On the command line, type: PWRDWNSYS *IMMED.
2. Once the machine is powered off and 01 BN is on the remote control display on the system, press the
white button on the front of the system to power on the machine. The system takes approximately 5 to
10 minutes to power on and completely restart.
3. Once the Function/Data display reads A900 2000 or 01 BN, the system has completed the restart and
you are finished installing additional software.
4. Back up your system to save the installed programs.

Adding electronic customer support to your system


From time to time, your system may experience problems that need attention from IBM’s support services.
Electronic customer support is available to help you keep your system operating efficiently. If there is a
system hardware or software problem,
IBM Customer Engineers can access your system directly to rapidly diagnose and solve the problem.á

Electronic customer support lets you:


v Order and install fixes
v Access the question-and-answer (Q & A) database

v Access local service and IBM product information

v Access technology forums

© Copyright IBM Corp. 1998, 2001 7


v Access problem analysis reporting and management

You can access electronic customer support in one of these ways:


1. Using Universal Connection.
Universal Connection is TCP/IP-based, and is configured using a graphical interface that allows you to
choose how you connect to IBM: direct dial-up via the AT&T Global Network Service, through an
existing Internet service provider (ISP), or via a virtual private network (VPN). This flexibility lets you
choose the most convenient solution for your organization, while still providing a secure connection.
For the majority of users, this option is the fastest, most convenient method of accessing electronic
customer support.
2. Using the traditional connection.
This route is available to users who use Systems Network Architecture (SNA) and a Synchronous Data
Link Control (SDLC) capable modem.

Additional information on this topic can be found in these sources:

Installing Fixes
Extreme Support

8 iSeries: Getting started with iSeries


Chapter 5. Making your system operational
Your system is ready to go—or is it? You’re ready to bring your system online. Once you have completed
these tasks, your system will be configured, backed up, and connected to IBM support services.

Depending on the state of your system (is it powered on, are you upgrading from a previous release), you
may need to complete some or all or of the tasks below to make your system operational.

Before you start


Do you want to start and configure the system yourself? If you prefer to use a wizard, obtain Client Access
Express. Client Access Express’s EZ-Setup simplifies the process of setting up a new server.

Working from Operations Console? Get information on setting it up now.

Turn on the system Your system is more complicated to start and stop than a PC. Get the information
you need to power it on safely.
Configure your local area network to allow a PC to act as a console.
Configure your LAN console
Install the interfaces You need a way to communicate with your system. IBM gives you two.
Install Management Central Plan now to simplify future administrative tasks.
Back up your system Perform an immediate system backup to save your new configuration and create
a regular backup schedule.
Install software Add new licensed programs to your new system.
Add electronic customer Run the wizard to set up a support connection to IBM
support

Turning on the system


If you have just completed the cabling process, you are ready to turn the system on for the first time.
These are the primary tasks to complete: turning the power on and performing an Initial Program Load.

Powering on the system


These are the steps you need to complete to power on your system for the first time.
1. Locate andáidentify some of the primary components on your control panel. The key components are:
v Power on light:áindicates when power has become available to the unit.
v Character display: displays the SPCN address, power status, or an SPCN reference code.
v Power switch:ácontrols the power for everything installed in the unit.
v Mode button: allows you to scroll through different operating modes.
2. Turn on the power of any display stations, tape devices, and controllers you will need to operate.
3. Set the mode to Normal.
4. Turn the unit on using the Power Switch.áConfirm that the unit has power by noting theáblinking of
the Power on light. If the unit is functioning properly, the Character display will display its normal
running message: *rru where rr is the rack address (an integer from 01 to 63) and u indicates the
SPCN port the unit is connected, and ranges from 1 to A (1 through 10).
If the Power on light does not blink to indicate that power is being received by the unit, and there is
no data displayed in the Character display, verify that your system power cables are properly
connected to electrical outlet and that all cables are properly connected to the system before trying
again.

© Copyright IBM Corp. 1998, 2001 9


If the Character display contains a message that does not conform to the standard, go to the Getting
Help section immediately. Do not attempt to rebootáthe systemáuntil you have determined the cause
of the problem!

Now that the iSeries is powered on correctly, you are ready to begin your Initial Program Load

Performing an Initial Program Load (IPL)


Once your iSeries has powered on successfully, you are ready to perform an Initial Program Load (IPL).
During an IPL, the system programs load from the system auxiliary storage and the system hardware is
checked. If you have not correctly cabled your system, it will not recognize some of the installed hardware,
and you will need to re-IPL in order for that hardware to be recognized on the system.

Your system is now ready to perform a normal, unattended IPL. In other words, the system will complete
this IPL automatically because you set the mode to Normal. Once it is complete, a signon display will
appear on your station.
1. Enter your user ID and press Enter.
You should now be taken to the main menu display.
2. Install the interfaces necessary to interact with the system.

Additional information on this topic can be found in these sources:

Starting and stopping the system


Changing operating modes and IPL types

Configuring your LAN console


Operations Console allows you to use your PC as the system console, perform control panel functions, or
both. With Operations Console, you can administer iSeries servers that are on your local area network
(LAN). You can also remotely administer several iSeries servers at different locations, including other
LANs.

Follow the instructions in Client Access Express -> Operations Console.

System interfaces
You have a system made up of hardware and software. But how do you interact with that system? How do
you get things to work? How do you monitor what is happening across the system? How do you check job
performance?

The answer is simple: you need an interface. Even better, have two interfaces.

Operations Navigator
Operations Navigator is a graphical user interface that provides a connection to your system that looks
and feels familiar to those experienced with Microsoft Windows platforms. You get point and click
functionality without sacrificing speed and power. If you are comfortable in Windows, you will feel right at
home with Operations Navigator.

10 iSeries: Getting started with iSeries


This example demonstrates the ease with which you can visualize and manage files, jobs, and security,
among other components. Operations Navigator will soon become a familiar part of your PC desktop.

Command line interface


The command line interface (also known as a character-based display or emulation), offers another
connection to your system. This interface takes longer to fully master, but may be preferred by those who
are more comfortable typing commands rather than pointing and clicking.
+--------------------------------------------------------------------------------+
| Sign On |
| System . . . . . : SYSTEM01 |
| Subsystem . . . . : QBASE |
| Display . . . . . : DSP01 |
| |
| User . . . . . . . . . . . . . . __________ |
| Password . . . . . . . . . . . . |
| Program/procedure . . . . . . . . __________ |
| Menu . . . . . . . . . . . . . . __________ |
| Current library . . . . . . . . . __________ |
| |
| |
| |
+--------------------------------------------------------------------------------+

Like Operations Navigator, the command line interface emulation is installed as a part of Client Access
Express.

Chapter 5. Making your system operational 11


Both Operations Navigator and the command line interface can operate together on the same desktop, the
same way that Windows and the DOS command prompt do. For many functions, Operations Navigator is
all you need to accomplish tasks; for some others, the command line interface will be required. Experience
will help you decide which to use in every situation.

Additional information on this topic can be found in these sources:

Operations Navigator home page


Operations Console

Installing Management Central


Some functions of Management Central are optionally installable components of Operations Navigator, the
graphical user interface (GUI) for iSeries 400. When you install Operations Navigator, be sure to choose to
install Operations Navigator Base Support (which includes most of the Management Central functions),
plus Commands, Packages and Products, and Monitors.

Follow the instructions in Operations Navigator -> Management Central.

Backing up your system


When you create a system backup, you create a snapshot of your system information at a particular point
in time. The system backup preserves all of the system configuration information that you have made so
far. You can expect to spend between 30 minutes and several hours performing this backup, but it is time
well spent.

Backing up a system is not a difficult process, but it is one that can easily be forgotten as you attend to
more pressing tasks. Scheduling backups can not only ease your system maintenance workload by
automating a commonly performed function, but help you address problems with data corruption, power
outages, and other unforseen situations that may damage your system data. The backup schedule you
create plays an important part of that strategy.

Backup, Recovery and Media Services (BRMS) will help you structure your backup tasks, and manage
your backup media. You can use BRMS to restore data, recover an entire system, and perform
maintenance tasks. BRMS is not intended to replace your backup and recovery strategy, but it can be a
useful tool for implementing that strategy.

Backing up your system initially involves these steps:


1. Initializing the tape
2. Performing the backup

Additional information on this topic can be found in these sources:

Backing up your system


Planning a backup and recovery strategy
Backup, Recovery, and Media Services

Initializing the tape for a system backup


Before beginning the backup, have your backup media ready. You will need blank tape cartridges to
perform the backup. You may need several tapes, depending on the type of tape device you have and the
size of your system.

12 iSeries: Getting started with iSeries


Prepare the tape for backup
1. Label the blank tape cartridges that you use for saving the system information (for example: SAVT01,
SAVT02).
2. Insert the tape into the iSeries and closeáthe tape unit door.

The tape unit may wind and rewind the tape to set the tension. This takes approximately three minutes.
You do not need to wait for the tape unit to stop to proceed to the next step.

Locate the initialize tape display


1. Open the command line interface.
2. On the command line Main Menu, type 3.
Press Enter. The General System Tasks display appears.
3. On the command line, type 8.
Press Enter. The Device Operations display appears.
4. On the command line, type 4.
Press Enter. The Tape display appears.
5. On the command line, type 2.
Press Enter. The Initialize Tape display appears.

Set the tape initialization parameters


1. Type the recommended value for the following parameters:
v Tape device: TAP01 (the name of the device you are using)
v New volume identifier: savt01 (the same as the label on the tape)
v Check for active files: *no
2. Leave all other values as they appear in the display.

Complete the tape initialization


1. Press Enter. The tape unit rewinds the tape which takes approximately one minute. The light on the
tape unit goes off.
2. The Tape menu appears with the following message: Volume SAVT01 prepared for operation with
owner ID *BLANK
3. Repeat these steps to initialize additional tapes, then perform the backup.

Performing a system backup


Periodically, and always after installing software, you should back up your system to preserve important
data and configuration information. Consider the impact to your business operations if you lose all of the
information contained on your system through fire, flood, or vandalism. A backup of vital information might
save your business from ruin with only relatively minor disruption in service. Backups should play a key
role in any business’s disaster recovery plan.

Beginning the backup


1. From the main command line, type GO TAPE.
2. At the Tape display, type 4.
3. Press Enter.
4. At the Save display, type 2.
5. Press Enter.
The Save the Entire System display explains what happens during the save process. Read it carefully
before proceeding.
6. Press Enter

Chapter 5. Making your system operational 13


Configuring the backup
From the Specify Command Defaults display, complete the following tasks:
1. Type the recommended value for the following parameters:

Parameter Recommended Value


Tape devices TAP01
Prompt for commands N
Check for active files N
Message queue delivery *BREAK
Start time *CURRENT

2. Press Enter two times. If any display appears, follow the instruction on that display.
The Save display appears with the following message: Save or restore option completed
successfully
3. Remove the tape when the light on the tape unit goes off.
4. Press F3 to return to the Main Menu.

You have now created a system backup. Ensure that all of your tapes are marked and stored in a safe,
accessible place. Create a duplicate set of tapes and store them at a secure location off-site. To
streamline the backup procedure, establish a backup schedule. This schedule should be part of a larger
backup and recovery strategy.

Consider your backup and recovery strategy


What would happen to your business if a security breach allowed a malicious user to corrupt client files?
Would you be able to recover that information or would your business collapse in chaos? What would
happen if a power failure or flood damaged your system? How would you respond?

An effective backup and recovery strategy takes all kinds of scenarios into account, and plans a response
to each. This strategy should be tailored to your business’s needs and particular circumstances. A good
strategy can’t be thrown together in a few minutes. It might require input from a variety of people at all
levels of your organization, and be a time-consuming venture. However, the alternative is even more
time-consuming: responding to a major catastrophe without any planning or strategy to guide you!

Create your own backup and recovery strategy now.

Additional information can be found in these sources:

Planning a backup and recovery strategy

Backup and Recovery Guide


Backing up your system

Installing software
From time to time, you may choose to install a licensed program that did not come pre-loaded onto your
system. Software installation takes careful planning to minimize downtime and maximize efficiency.á

The steps required for planning and installing software are the same for your first installation as they are
for your hundredth.
1. Preparing for the installation
Careful planning ensures that your software installation process is successful.

14 iSeries: Getting started with iSeries


2. Performing the installation
Once you have completely planned the installation, you are ready to actually install the software.
3. Saving changes after the installation
Save the changes you have just made to your system.

Additional information on this topic can be found in these sources:

Managing software and licensed programs

Saving changes after installing software

After finishing the Checklist for completing installation in the Software Installation manual , you must
save the changes you have made to your system to make them permanent. Follow these steps:
1. On the command line, type: PWRDWNSYS *IMMED.
2. Once the machine is powered off and 01 BN is on the remote control display on the system, press the
white button on the front of the system to power on the machine. The system takes approximately 5 to
10 minutes to power on and completely restart.
3. Once the Function/Data display reads A900 2000 or 01 BN, the system has completed the restart and
you are finished installing additional software.
4. Back up your system to save the installed programs.

Adding electronic customer support to your system


From time to time, your system may experience problems that need attention from IBM’s support services.
Electronic customer support is available to help you keep your system operating efficiently. If there is a
system hardware or software problem,
IBM Customer Engineers can access your system directly to rapidly diagnose and solve the problem.á

Electronic customer support lets you:


v Order and install fixes
v Access the question-and-answer (Q & A) database

v Access local service and IBM product information

v Access technology forums


v Access problem analysis reporting and management

You can access electronic customer support in one of these ways:


1. Using Universal Connection.
Universal Connection is TCP/IP-based, and is configured using a graphical interface that allows you to
choose how you connect to IBM: direct dial-up via the AT&T Global Network Service, through an
existing Internet service provider (ISP), or via a virtual private network (VPN). This flexibility lets you
choose the most convenient solution for your organization, while still providing a secure connection.
For the majority of users, this option is the fastest, most convenient method of accessing electronic
customer support.
2. Using the traditional connection.
This route is available to users who use Systems Network Architecture (SNA) and a Synchronous Data
Link Control (SDLC) capable modem.

Additional information on this topic can be found in these sources:

Chapter 5. Making your system operational 15


Installing Fixes
Extreme Support

Configuring Universal Connection


Unlike the traditional method, Universal Connectionáallows you to control how your business will connect
to IBM’s support services. Once connected, you can access a variety of customer support options as you
need them.

You can also run the Extreme Support wizard to configure Universal Connection. Extreme support also
allows you to use the Electronic Service Agent, and it will collect and send data to IBM when problems are
encountered.

Before you start


There are some decisions you need to make prior to running the Universal Connection wizard. During the
configuration process, you will be asked to choose the type of connection you want to use for electronic
customer support. That decision will depend upon your network and accessibility to the Internet from your
iSeries.
v If your iSeries currently has direct (broadband with a fixed IP address or LAN with a globally routable IP
address) access to the Internet (without an intervening firewall), you may want to select the Direct
connection to the Internet option. This option will allow for the fastest secure access to IBM services
and support.
v If you already have an Internet Service Provider (ISP) which your iSeries dials into, you may want to
select the Dial up connection using an Internet Service Provider option. This option will support a
secure connection to IBM services and support at the same time and over the same dial-up connection
currently used by your iSeries to access the Internet.
v If your iSeries is not on a network, or is only on a private network, you may want to select the Dial-up
connection using the AT&T Global Network Services option. This option will provide you with a
secure dial-up connection to IBM services and support only, with no access to the Internet.

Note: In order to run the wizard, you must have installed both
Client Access Express and the optional Network
component. You must also have *ALLOBJ and
*IOSYSCFG authorities to run the wizard.

If you would like to configure your service provider information, do so now.

Prepare to configure Universal Connection


The tasks below will prepare you to begin configuring your connection.
1. From Operations Navigator, select the system you want to work with.
2. Expand Network.
3. Click Remote Access Services.
4. Right-click Originator Connection Profiles.
5. Select Universal Connection Wizard and begin the configuration process.

Note: If you encounter any problems while running the wizard,


go to the problem resolution section for advice, and then
re-run the wizard.

Start the configuration process


The tasks below will configure your connection to Electronic Customer Support.
1. At the welcome window, click Next to start configuring.
2. Enter your service contact information in the spaces provided and click Next to continue.
3. Enter your company’s address information in the spaces provided and click Next to continue.

16 iSeries: Getting started with iSeries


4. Identify the country where your system is located and click Next to continue.
5. Select the Electronic Customer Support connection and click Next to continue.

Note: If you want to configure a connection for Service Agent,


the steps below remain the same.

6. Select the type of connection that you want to use for Electronic Customer Support.
v If you have chosen to use a dial-up connection to AT&T Global Network Services, select it now
and click Next to continue.
a. Select your hardware resource and click Next to continue.
b. Identify the line description to use (this may take you through several wizard panels). After
completing every panel, click Next to continue.
– If multiple PPP lines already exist for that resource, you will be asked to select an existing
one or to create a new one.
– If only one already exists, it will be used.
c. Select the appropriate AT&T location to dial. Modify the telephone number as appropriate
(remember to add any required prefixes to the phone number once it has been selected) and
click Next to continue.
d. Choose a backup phone number from the available list and click Next to continue.
e. (optional) Select the modem you would like to use from the available list. If you selected an
internal modem as your hardware resource, the wizard will not display this screen. Click Next to
continue.
v If you have chosen to use a Dial up connection using an Internet Service Provider, select that
option now and click Next to continue.
a. Select new or existing dialup connection and click Next to continue.
– If you select an existing connection, the wizard will take you to the steps described below in
″Complete the configuration″.
– If you select a new connection, the wizard takes you to step b.
b. Enter a name for the new Profile and click Next to continue.
c. Select your hardware resource and click Next to continue.
d. Identify the line description to use (this may take you through several wizard panels). After
completing each panel, click Next to continue.
– If multiple PPP lines already exist for that resource, you will be asked to select an existing
one or to create a new one.
– If only one already exists, it will be used.
e. Enter the telephone number used to connect to your ISP (remember to add any required
prefixes to the phone number) and click Next to continue.
f. Enter the account information provided by your ISP and click Next to continue.
g. (optional) Select the modem you would like to use from the available list. If you selected an
internal modem as your hardware resource, the wizard will not display this screen. Click Next to
continue.
v If you have chosen to use a Direct connection to the Internet, select that option now and click
Next to continue.
a. Select the TCP/IP interface (address) that you will use.
b. Click Next to continue.

Complete the configuration


The tasks below allow you to confirm the choices you have made during the configuration process, and
then test the resulting connection.

Chapter 5. Making your system operational 17


1. The next dialog summarizes the choices you have made during the configuration process. Verify that
the information is correct. If it is not, click Back to make the necessary corrections.
2. Click Finish when you are satisfied that the information is accurate.
3. Test your connection now to verify that the configuration has been successfully completed.
4. Test your electronic customer support connection.

Configure service provider information


Occasionally, you may need to contact a service provider directly, over the telephone, for assistance.
Complete the steps below to configure voice contacts for service and support:
1. On the command line of the main menu, type: WRKCNTINF and press Enter. The Work with Support
Contact Information display appears.
2. On the command line, type 6 (Work with service providers), and press Enter.
3. Select option 2 to change the *IBMSRV Control Point Entry, and press Enter.
4. The Change Service Provider display appears.
If you are installing this system in the United States, type the following on the Change Service Provider
display:
Hardware service: 1-800-426-7378
Software service: 1-800-237-5511
If you are not installing this system in the United States, call your service representative for the service
telephone numbers.
5. Press Enter.
6. Press F3 (Exit) to return to the Work with Support Contact Information display.

Testing your connection to electronic customer support


To ensure your connection to Electronic Customer Support is functioning properly, complete the test
described below. Upon receiving your request, an IBM service representative will telephone you.

Connection/Registration Test
1. The Send Test Request display should be before you.
If this screen does not appear, or you have previously set up Electronic Customer Support, follow this
procedure:
a. Go to the main menu.
b. On the command line, type SNDSVRQS *TEST.
c. Press Enter.
2. Press Enter to submit the test.
3. Test request complete appears at the bottom of the screen. If your test does not work, then note the
error message and contact your service representative.

Congratulations! You have added and tested your electronic customer support connection.

Configuring SNA connection to electronic customer support


If you intend to access electronic customer support using SNA and a synchronous (SDLC) capable
modem, then complete these tasks to establish your connection to IBM’s support services.

Warning: Temporary Level 5 Header


Gather configuration information:

18 iSeries: Getting started with iSeries


1. Obtain primary and alternate numbers and connection information. If you do not know your service

numbers and are not in the United States, contact IBM’s Service and Support Center for more
information.
2. Power on the modem that is connected to the electronic customer support cable.
3. (optional) You may choose to configure your service provider information now.

Get ready to begin configuration:


1. On your PC desktop, open Client Access.
2. Expand Operations Console.

Note: If you have not worked with Operations Console, you


need to configure a new connection to your system. A
wizard takes you through the configuration process. If no
wizard appears, select Connection on the tool bar and
select New Connection. If you do not have Client Access
Express installed, you can use telnet or a 5250 emulation
session.

3. In Operations Console window, select your system.


4. From the file menu, select Connection.
5. If prompted for the DST user ID and password, type in QSECOFR for both values.
6. Select Console. The system signon screen appears.
7. Enter your QSECOFR user ID and password.
8. On the command line of the main menu, type: Call QESPHONE and press Enter.á

Configure primary telephone information: If you are installing this system in the United States, the
Change Data Area (CHGDTAARA) display may have one of these IBM service support numbers in the
New Value field. If you are not in the United States, call your IBM service support telephone number.
v East of the Mississippi River: SST:18002378804
v West of the Mississippi River: SST:18005252834
The ’SST’ value is a modem command. If you receive an error after entering these values, delete ’SST’,
or add the required prefix (for example, ’SST9’), and try again.
1. Type in the primary telephone number in the New Value field.
2. Fill in the telephone/connection information outlined below and press Enter.
v Ensure that the telephone number you enter follows this format:
'1234567890 '

Do not add or delete any spaces after the last digit of the telephone number. Adding or deleting
characters or spaces will cause an error.

Configure alternate telephone information: The Change Data Area (CHGDTAARA) display appears
again to allow you to enter the alternate support number (if it is available in your area). To determine
whether you are on the display for the primary support number or the alternate support number (if it is
available in your area), check the value of the substring starting position. For the primary support number,
the value is 001. For the alternate support number, the value is 051.
1. Type the alternate support telephone number (the support number you did not use as primary) in the
New Value field and press Enter.
2. Press F3 (Exit) to return to the main menu.

Configure contact information:


1. On the command line of the main menu, type: WRKCNTINF and press Enter.

Chapter 5. Making your system operational 19


2. Type 2 (Work with local service information) and press Enter.
3. The Work with Local Service Information display appears.
Type 2 (Change service contact information), and press Enter.
4. The Change Service Contact Information display appears.
Type the customer information.
5. Page down to the next display.
6. Enter the correct information in the National language version and Media for mailing fixes fields.
Press F4 for a list of national language versions. Press the Help key for more information about the
Media for mailing fixes field.
7. Press Enter.
8. The Work with Local Service Information display appears with the following message:
Data area QSSF created in library QUSRSYS.
If the contact information has been created and you change it, the following message appears:
Support contact information updated.
9. Press F3 (Exit).

Test your electronic customer support connection.

Additional information on this topic can be found in these sources:

Universal Connection

20 iSeries: Getting started with iSeries


Chapter 6. System configuration concepts
Your system is up and running, but what is in the box? What kind of software was pre-installed on the
system? These are the questions that new users often have about their system configuration. If someone
else purchased the system, you might not even know what they ordered, or how to tell if you received
everything.

You need to know more about your system’s hardware and software—fast!

Hardware Software
The hardware side of your system can be as Your system is shipped with the operating system pre-installed.
straightforward as a single iSeries and workstation Additionally, it may contain optional programs that were selected
in a single room, or as complex as an iSeries in one prior to purchasing. You also have the choice of installing
location linked together with others across cities, programs contained within the media distribution set.
countries, and continents, spanning numerous
workstations and connected to local area networks You may also have additional software packages, such as
and wide area networks that support a variety of Facsimile Support for iSeries 400, iSeries 400 Toolbox for Java,
platforms. NetFinity, HTTP Server for iSeries 400 MQ Series, or any of a

Your system, regardless of its size, is comprised of list of programs that can be found on the IBM site .
many components that work seamlessly together to
meet the needs of your business. You can view your To determine which programs are currently installed on your
hardware configuration“Hardware” on page 147 system, follow these instructions“Software” on page 147.
here.

Additional information on this topic can be found in these sources:

Software Installation book

IBM’s product listing (ShopIBM)

© Copyright IBM Corp. 1998, 2001 21


22 iSeries: Getting started with iSeries
Chapter 7. System operations concepts
IFS? CL? APAR? Ever feel like you are learning an entirely new language in addition to a new operating
system? Relax. The terminology used by the iSeries 400 will soon become second nature, and you will be
using acronyms with the best of them!

The iSeries uses some of the same operating system concepts and terminology as other platforms. Others
are unique. These topics introduce you to some of the most commonly used terminology:

Go here ... For information like this ...


Messages Users communicate with each other, and your system
communicates with you, using messages.
Jobs Every unit of work performed by your system is called a
job.
Objects If it takes up memory and can be used to perform a task,
it is an object.
Logs and journals A log is a viewable history of backup, archive, recovery,
and media management operations. A journal is an object
that contains a record of system activity.
Authorities (security) You control access to objects, and what users can do with
them.
Files and file systems Files can be easily organized and managed with
Operations Navigator.
OS/400 commands Familiarize yourself with the ways commands can be
entered, and in what form.
User profiles Manage user activity with profiles.
Printing See how printing works on your system.
Fixes Discover fixes and the role they play on your system.

Additional reference information can be found in the IBM glossary.

Messages
Messages are communications that are sent from one person or program to another. Your system sends
informational messages that allow you to track system activity, jobs, users, and errors, and inquiry
messages that require you to respond to system activity.

Messages that are immediate or impromptu are sent between users, and are not permanently stored on
the system. Predefined messages, on the other hand, are created by the system and are stored.
Predefined messages have these components:
v a message ID, which serves as a storage identifier
v the text of the message
v a message key, which contains a queue identifier indicating the queue to which it belongs

You can use these componentsáto track messages.

Additional information on this topic can be found in these sources:

Handling messages
Working with messages
Create a message monitor

© Copyright IBM Corp. 1998, 2001 23


Jobs
A job is a unit of work on your system, and may be either interactive or batch. Users who enter commands
are creating interactive jobs, while batch jobs run in the background without user interaction.

The system initially places a new job in a job queue. The queue defines how many jobs that it contains
may be active and running at the same time. Subsystems manage the queues and determine the queue
that each job is assigned to. The subsystem also decides when each job runs. Once the job begins to run,
the subsystem selectsáthe area of memory (pool) that the job will use. The overall performance of the job
depends on the amount of resources available in that pool.

Jobs may be filtered in Operations Navigator by name, user, type, and so on, at the user’s convenience.
Users may also choose the information that is displayed about a job. For instance, a user may choose to
view the job name, type, queue, priority, and subsystem.á Or, the user may only want to view job name
and status.á This flexibility enables users to view the information that is important to them as they perform
jobs on the system.

Additional information on this topic can be found in these sources:

Create a job monitor

Objects
The OS/400 is an object-based operating system. An object is anything that has a name and takes up
space on the system. An object can be a data file, a directory, a user, or a printer. Each has an identifying
name and holds space on your system.

Objects are not limited to individual entities on your system. They can also be categorized by type. An
object’s type defines its purpose and how it is used on the system. Some examples of object types:

*USRPRF User Profile


*LIB Library

Objects on this system are encapsulated. Encapsulation means that they are protected by an interface that
defines the operations that can be done to that specific object.

Additional information on this topic can be found in these sources:

Commands operating on OS/400 objects


Management Central and commands
OS/400 objects

Logs and journals


Record keeping is an important management function. Accurate records can provide clues in the case of
system failure or attempted security breach. Two key types of records on your system are logs and
journals.

Logs
A log is a database file that contains the history of backup, archive, recovery, and media management
operations that may be displayed online or printed for future reference.á Logs are usedáin backup and
recovery situations.á Logs can also contain information about jobs and problems

24 iSeries: Getting started with iSeries


Journals
A journal is a system object that contains information about changes made to another system object, such
as a database or a security-related object.á The journal can be used to recover a database.á Regular
journaling speeds up database management tasks such as saves.

Additional information on this topic can be found in these sources:

Logs Journals
Job logs Database journals
History logs Backup, Recovery, and Availability
Problem logs á
Event logs á

System authorities
Protecting confidential information is the most important function of security on any system. Your system
integrates security features into every component, from the hardware to the interface that users see. The
authorities that you grant to users on the system determine what they can and cannot access, change,
and delete. The system does not recognize an absence of authority. Instead, users must be specifically
excluded from accessing objects.

Example: Granting Miranda the special authority All Object gives


her access to the entire system. Miranda can now access
to every object on the system, and you have no way to
deny her access to specific objects, such as payroll.
Similarly, granting Job Control to Dennis gives him the
ability the control, change, or cancel any job on the
system—his and everyone else’s.

You need to carefully consider who is given these kinds of global special authorities to minimize who has
superuser access to your system. Generally speaking, users only need to be granted the privileges
necessary to perform their tasks.

Authority can be granted at the object level (the container that holds objects) or at the object data level
(the actual data within a container). Object level authority gives a specific user specific access to specific
objects.

Example: Ophelia needs authorization to delete data in a database,


but does not need to delete tables or the database itself.
She would be granted object level authority, rather than
object data level authority.

Users can be granted public authority, granting them default access to objects. Users can also be added
to an authorization list which gives them access to objects defined within that list. They can also receive
adopted authority when the object they have access to calls another object to complete its tasks.

Users with similar kinds of access needs can be assigned individual profiles; these profiles can then be
grouped to simplify security management. See creating and managing user profiles for more details.

Additional information on this topic can be found in Setting system security.

Chapter 7. System operations concepts 25


Files and file systems
A fileáis another kind of object on your system. Each file has a description that describes its
characteristics and how the data associated with the file is organized into records, and, in many cases, the
fields in the records. Whenever a file is processed, the operating system uses this description.

Operations Navigator provides access to the integrated file system. In the integrated file system, files are
sorted in a familiar, Microsoft Windows-like hierarchical structure. Viewed with Operations Navigator, files
are instantly accessible, whether they are stored locally or remotely. This transparency eases management
of files across a large network, because users can view the file system, select files or folders to work with,
and send them instantly to multiple systems if they choose. Files can be renamed or relocated with only a
few clicks of the mouse.

The integrated file system combines a Windows-like hierarchical structure with a Unix-like ability to handle
file pointers, effectively merging the strengths of these two operating systems. The integrated file system
has real security advantages, too. In a Unix environment, a directory is the smallest object that can be
owned by a user. In the integrated file system, however, users have object-level ownership, which allows
for a more granular level of security. Users can have access rights to individual files, rather than to entire
directories, which eliminates some security risks, while at the same time, increasing flexibility for the
administrator.

Additional information on this topic can be found in these sources:

File systems and management


Integrated file system tasks
Integrated file system concepts

Control language commands


By now, you have probably run across the first signs of iSeries Command language, also known as CL.
Those unfamiliar with typing commands may be a bit intimidated by the seemingly-incomprehensible string
of characters that you need to know in order to complete tasks on the system.

Relax—working with CL syntax“Command syntax” is not as difficult as it appears at first glance. Once you
learn the trick to decoding CL, you may find yourself using it as shorthand in other situations.

Commands may be entered into source files and compiled into programs. They can be entered from the
command line“Entering commands” on page 27 or run from Management Central.

Command syntax
Control language syntax follows this structure:á <command name> <parameter> <parameter> ....

CL is used to interact with and get work done on your system. Commands usually take the form of
verb/noun combinations (that is, what the action is followed by what is being acted on). Examples of
commands include:

Command Verb Noun


DSPMSG Display Message
CPYF Copy File
SBMJOB Submit Job

Some commands require a modifier. Examples of this kind of command include:

Command Verb Modifier Noun


WRKMSGQ Work Message Queue

26 iSeries: Getting started with iSeries


Command Verb Modifier Noun
CRTCLPGM Create CL Program
EDTLIBL Edit Library List

Entering commands
As you can imagine, the possible permutations that you might need to know to be fully fluent on your
system is mind-boggling! Fortunately, you do not need to memorize commands that you seldom use to
complete daily tasks. The system is designed to help you find just the information you are looking for.

To enter a command, use one of these methods:


v Command prompt from Operations Navigator
1. Select Run command.
2. Enter a command and click Prompt.
– Press F10 to show additional parameters.
– Press F9 to show all parameters.
– Press F1 on a parameter to get specific information.
– Drag the ? into the field to see possible values.
You may also be prompted to enter commands in Operations Navigator. Create and save common
commands as definitions that can be used over again without retyping.
v Command prompt from a command line
1. Enter a command and press F4. A short description is given for each parameter.
2. Press F10 to show additional parameters.
3. Press F9 to show all parameters.
4. Press F1 on a parameter to get specific information.
5. Drag the ? into the field to see possible values.
v Keyword notation
– Each parameter has a name. This is a keyword.
– From the command prompt screen, press F24 (more keys), then F11 (show keywords).
– You can enter a command from the command line using keyword notation. For example,
<command> <keyword>(value)<keyword>(value) ...
– The order of <keyword>(value) combinations does not matter.
v Positional Notation
– Syntax:á <command> value value ...
– The order of values is important.á They must be entered in the order they are listed on the command
prompt screen.
– Each command has a limit as to how many positional parameters it can accept. For example,
CRTLIB payroll *PROD ’Production Library’ produces an error.á DSPCMD <command name>
displays (among other information) how many parameters it can accept.

You do not need to use all of the parameters available for a command. The system has many predefined
default values, and not all of them need to be entered for every command.

Additional information on this topic can be found in these sources:

Commands operating on OS/400 objects


How commands are named
Running commands with Management Central

Chapter 7. System operations concepts 27


User profiles
When someone asks you to prove your identity, you have the tools to do that. You can show them a birth
certificate, a driving license, and other forms of identification that verify that you are indeed the person you
claim to be.

Similarly, you need proper identification on your system to prove that you have access to the confidential
information you need to do your job. One way this is handled is through a system of user profiles.

A user profile defines a user to your system. It includes:


v A system user profile name
v The user’s privileges and limitations
v A list of objects the user owns or is authorized to use
v A message queue
v An output queue
v Information about which groups the user is a member of (up to 16)
v Information on the user’s last signon
v Job attributes, such as description and priority, the initial program to call, and the initial library list
v National language settings
v UNIX-like attributes, such as the userid (UID), group ID (GID), and home directory, similar to those
found in UNIX systems

User profiles may be linked to group profiles. In this way, all group members share common attributes,
common access to specific objects, and common ownership of objects. Group profiles simplify user
administration tasks.

Administrators can also use Operations Navigator’s Management Central functions to create large users
and groups that allow them to create, edit, and delete both users and groups across systems.

Additional information on this topic can be found in these sources:

User profile tasks

Printing on iSeries
If you are used to printing in a Microsoft Windows environment, you will notice differences when you print
on your iSeries. Rather than just initiating a print job and picking up the output, printing on your system
takes an extra step and gives you increased flexibility.

The two-step printing process means that files you want to print are first spooled . During the spooling
process, formatting occurs,áchanging what appears on your screen by adding line and page breaks, fonts,
and so on, to create a more visually appealing end product. The spooled file then waits in an output
queue until you have decided to move it to a printer. This allows you to manage printing jobs and
resources more effectively. Spooled files may be printed locally or remotely, immediately or at a later time,
putting control over print jobs entirely in your hands.áThat control is enhanced by Operations Navigator’s
print functioning.áYou can easilyáview spooled information, sortáthe output queue, as well as work with
those spooled files (open, hold, release, print, and send).á

Once your spooled file has been moved from the output queue to a printer, printing begins. Your
formatted data is collected and printed on the printer you have specified.

28 iSeries: Getting started with iSeries


Operations Navigator also streamlines the printing process by combining print writers, printer devices, and
output queues intoáa logical printer.á This is equivalent toáthe WRKWTR (Work with all printers)
command.á Through either interface, printers can be started, held, taken offline, and brought online.

For more information on printing, see Working with printers.

Additional information on this topic can be found in these sources:

IBM AS/400 Printing V

IBM AS/400 Printing IV

IBM AS/400 Printing III


Physical security for printers and printer output

Fixes
Periodically, bugs are discovered in iSeries programs. IBM issues a fix (formerly called a PTF, or program
temporary fix) once corrections are made and the affected programs are recompiled. Multiple fixes are
bundled together to form a cumulative pack, which contains certain recommended fixes. Cumulative fix
packs should be installed quarterly in dynamic environments, and less frequently in stable ones.
Cumulative fix packs should also be considered prior to making major hardware or software changes to
your environment.

Fixes play an important part in your system’s maintenance strategy . They give you a chance to
fine-tune your system’s operation, add additional functionality, or improve performance.

Management Central wizards simplify fix management: they allow you to make a fix available on the
system immediately—or delay the installation if you choose. You can also use the compare and update
wizard to compare a model system to multiple target systems to find missing or extra fixes throughout the
system.

Installed and permanently installed fixes


When a fix is installed to a system, both the original and new objects are kept on the system. Logically,
two copies of the code are in residence on the machine. This allows you to restart the system using either
the original objects or the new objects. Installing a fix to your system gives you a secure backup while you
test the new code. If the system functions incorrectly using the new code, you simply restart your system
using the original code and remove the defective code.

When a fix is permanently installed on your system, only the new objects exist on the system. A fix can
be permanently installed when it has been in use for a period of time and you feel confident that the
chances of it being defective are small.

Available and delayed fixes


Once a fix is loaded on your system, you can choose to apply it right away or wait for a period of time
before applying it. A fix can be made available if the system cannot run the old and new code at the same
time. Alternatively, you can choose to delay applying a fix. The fix is then applied the next time the system
is restarted.

Additional information on this topic can be found in these sources:

Chapter 7. System operations concepts 29


Manage fixes with Management Central

Fix maintenance strategy


Fixes and logical partitions
Managing fixes

30 iSeries: Getting started with iSeries


Chapter 8. Managing system operations
Okay, your system is up and running. But how do you make stuff happen? How do you transform the box
from a paperweight to an effective, useful aspect of your business?

There are a number of system operations that you need to perform on a daily basis. The topics below are
a great starting point to get your system working the way it needs to work.

If you want to ... Go here ...


Monitor your system Control jobs to enhance system performance, send, track
and handle messages, and monitor your system’s
performance.
Manage users on the system Create and manage user profiles, and set security and
authorities.
Perform system tasks Discover how to start and stop your system safely. Order,
install and manage fixes to keep your system running at
peak levels.
Manage hardware-related activities Work with devices, set up and manage printing tasks, and
use removeable media (tapes, CDs, reels, and cartridges)
effectively.

Controlling jobs
Controlling how jobs are handled is one of the most common tasks you perform on your system. You can
control a job’s attributes, change its priority, determine its status, and view its output using Operations
Navigator’s work management functions.

Why would you need to control a job on the system? Good question. If one of your users has just initiated
an enormous job (printing War and Peace, for instance) that is really slowing down the system, you need
to be able to change that job’s priority, or cancel it altogether. Otherwise, every other user needing to print
business-related material on that printer would have to wait.

To get information about a job on your system:


1. Select the system you want to work with.
2. Expand Work Management.
3. Expand Job Queues.
4. Expand Active Job Queues.
When the information appears in the right window, you can view the job queue, library, status, jobs on
queue, subsystem, and description.á
5. Right-click a job queue and select Properties.á Use the information displayed on the tabs to determine
the number of jobs waiting in a job queue.á Select Advanced on the Activity tab to view the priority of
jobs contained within a queue.

Operations Navigator’s Management Central allows you to manipulate jobs on your system in numerous
ways. Create a monitor, manage job queues—Management Central gives you the flexibility you need to
work with jobs

Additional information on this topic can be found in these sources:

Jobs and job queues


Managing jobs
Create a job monitor

© Copyright IBM Corp. 1998, 2001 31


Handling messages
Over the course of an average work day, you might receive dozens of messages. Your co-workers will
send you messages about going for coffee or lunch, about problems they are having with the system, or
about system function in general. In addition, your iSeries will send you messages keeping you informed
about the state of the system, or about messages you have sent or received. Handling these messages,
by responding or getting rid of them entirely, keeps you in touch with what is going on around you.

Management Central offers you an effective way to monitor messages. Message monitors allow you to
keep a queue clear of unwanted messages, to be notified if a message or set of messages appear, and to
delete or get more information about a message.

Use Operations Navigator to do the following tasks:


v Send a message“To send a message”
v Delete a message“To delete a message”
v Get more information about a message“To get more information about a message”
v Reply to a message“To reply to a message”

To send a message
1. Select the system you want to work with.
2. Expand Basic Operations.
3. Right-click Messages and select Send message.
In the Send Message dialog, choose the users or workstations that you want to send a message to.
You can choose to have the message interrupt the recipients. You can also choose to request a reply
from the users.
4. Type the text of the message and click Send.

To delete a message
1. Select the system you want to work with.
2. Expand Basic Operations.
3. Right-click the message and select Delete.
4. In the Confirm Delete dialog, select Delete.

To get more information about a message


1. Select the system you want to work with.
2. Expand Basic Operations.
3. Right-click the message you want more information about and select Details.
This dialog provides you with the date and time the message was sent, as well as its text and help.
4. Right-click the message and select Properties.
This dialog provides more complete information about the message, including the message’s type, its
queue, job number, and severity.
Alternately, you can also select the message and then click on Properties in the task bar.

To reply to a message
1. Select the system you want to work with.
2. Expand Basic Operations.
3. Right-click the message you want to reply to and select Reply.

Additional information on this topic can be found in these sources:

32 iSeries: Getting started with iSeries


Monitor messages
Message queues

Your system status


Quick—is your system operating at peak efficiency, or is it slowing down because of high demand? How
can you tell?

Operations Navigator allows you to monitor your system’s performance, and gather data about your
system over a period of time. Use this data to track peak periods of demand on your system, and to plan
how to resolve that demand.

Management Central performance monitors allow you to capture real-time data about your system 24
hours a day, and turn that data into useful information. You can even monitor system status using an
internet phone, personal digital assistant (PDA), or browser by using Management Central - Pervasive.

Additional information on this topic can be found in these sources:

Collecting performance data

Performance Tools for iSeries

User profile tasks


Managing large numbers of users is simplified by organizing them into groups. These groups can then be
assigned shared attributes, access to selected objects, and ownership of objects.

If you have a single iSeries, Operations Navigator lets you easily manage user profiles and groups. When
you click one of the user or group icons, the operating system performs a security check. Users must have
at least read access to view a group or user profile.

Imagine being able to change authority on six different profiles across 20 systems at once! If you have a
large system and need to administer authority this way, use Management Central’s user administration
functions to create and edit multiple profiles. Management Central also allows you to delete profiles, scan
for owned objects, send profiles between systems, and create user definitions. You can also search across
systems for users that match a variety of criteria, and export user and group information to a PC file. If this
sounds like something you need for your system, check out Management Central’s user administration
function now.

You can perform the following user and group administration tasks:

Perform common user profile tasks v Create a profile“Creating a user profile” on


page 34
v Change a profile“Changing a user profile” on
page 34
v Copy a profile“Copying a profile” on page 34
v Delete a profile“Deleting a profile” on page 35
Manage user profiles v Create a new group profile“To create a new
group profile” on page 35
v Add users to a group“To add users to a group”
on page 35
v Remove users from a group“To remove users
from a group” on page 35

Chapter 8. Managing system operations 33


Additional information on this topic can be found in these sources:

Management Central’s user administration function


Planning user groups

Perform common user profile tasks


Operations Navigator simplifies the performance of the following common user profile tasks:
v Creating a profile“Creating a user profile”
v Changing a profile“Changing a user profile”
v Copying a profile“Copying a profile”
v Deleting a profile“To delete a message” on page 32

Check out Management Central’s user administration function if you need to administer profiles across
multiple systems.

Creating a user profile


Create user profiles as often as you acquire new users who need access to your system.
1. Right-click the Users and Groups icon.
2. Select New User from the context menu.
3. Assign a password by typing one in, or change the password field to no password (logon not allowed).
4. Enter an eight-character user name and description. The password field defaults to use user name.
5. The user must change password at next logon option is now active.á By default, new users are
prompted for a new password the first time they attempt to logon to the system.
6. Change other system values, which are grouped into dialog buttons:
v Groups: Add or remove users from groups.
v Personal: Identify users by their real name, location, and mail address. The operating system
creates a directory for a user once you enter personal information.
v Capabilities:á Set security parameters for the user.
v Jobs:á Enter the user’s job-related information.
v Networks:á Add or remove the user from remote server sessions.
Groups, personal, capabilities, jobs, and network parameters have default values that you can use;
accept the defaults if you do not need to change any of these settings.
7. Click Add to accept the new user profile.

Changing a user profile


1. Right-click the user profile that you want to change.
2. This brings up a window identical to the New User window that you saw when you added a new user
profile, with the single exception that you cannot change the user name.
3. When you are done making changes, click OK.

Copying a profile
To copy a profile:
1. Expand Users and Groups icon.
2. Expand All Users.
3. Select a user whose profile you want to copy.
4. Right-click the selected user to get a context menu.
5. Select New Based On from the context menu.
6. Change all [user profile information].
7. Click Add when finished.

34 iSeries: Getting started with iSeries


Deleting a profile
To delete a user profile:
1. Highlight the user profile that you want to delete.
2. Click Delete, or select Delete from the Context menu.

On the Delete User dialog, select the appropriate options:


v Do not delete if the user owns object
v Delete objects that the user owns
v Transfer objects to another user

Additional information on this topic can be found in these sources:

Management Central’s user administration function


Planning user groups

Managing user profiles


You can combine profiles into groups to further streamline the administration process. The tasks below
describe how to create a new“Creating a user profile” on page 34 group profile and how to add“To add
users to a group”, and how to delete“To delete a message” on page 32 users from group profiles.

Remember, if you are managing user profiles across multiple systems, Management Central has features
that can make the task much easier. Check out Management Central’s user administration function for
more details.

To create a new group profile


1. In Operations Navigator, select the system you want to work with.
2. Expand User and Groups.
3. Select the Groups icon.
4. Right-click Groups.
5. Select the context menu item New Group.
6. Select the group name, write an optional description, and add users to the new group profile.
The All Users box displays all the user profiles to which you have at least *USE authority.
7. Click Add and create the group profile.

To add users to a group


1. In Operations Navigator, select the system you want to work with.
2. Expand User and Groups.
3. Expand the All Users icon.
4. Select an existing user.
5. Expand the user to get the Properties window.
6. Click Groups.
7. Select the group and click Add after or Add before.
8. Click OK to accept the information in the Groups window.
9. Click OK to close the Properties window.
Users can be a member of as many as 16 group profiles. Be sure to assign users to groups in order of
most frequent use.

To remove users from a group


1. In Operations Navigator, select the system you want to work with.
2. Expand User and Groups.

Chapter 8. Managing system operations 35


3. Expand Groups.
4. In the Group Properties window, highlight the users in the Selected Users list.
5. Click Remove.
6. Click OK to close the window.

Additional information on this topic can be found in these sources:

Management Central’s user administration function


Planning user groups

Adding and removing users from groups


Complete these tasks when adding or removing users from groups:
1. In Operations Navigator, select your system.
2. Expand Users and Groups.
3. Expand All Users.
4. Expand a user to display Properties dialog.
5. Click the Groups button to open the Groups window. A list of the groups on your system is shown in
the left pane of the Groups window under the All groups heading.

To add a user to a group or groups when that group exists on all of your systems, follow this procedure:
1. Expand the system group you want to add the user to.
2. Expand Users and Groups.
3. Select Edit Groups.
4. Type in the name of the group.
5. Select the user to add to that group.

The group or groups will automatically be updated on all systems at the same time to reflect this addition.

To add a user profile to a group


1. Select a group from the list and click Add before or Add after.
2. Drag and drop to reorder the groups in the Selected Groups list.

To remove a user from selected groups


1. Highlight one or more groups in the Selected Groups list.
2. Click Remove.

To remove a user from all groups


1. Close the Properties dialog and go back to the main Operations Navigator window.
2. Select a user.
3. Drag and drop the selected user onto the Users not in a Group icon.

Other considerations
Define the default authority that is given to a user’s first group of objects by selecting a value from the
Access Rights to Objects Created by User list.

Define whether the first group has private or primary group authority to objects created by a particular user
by enabling the Source of Access Rights options.

Additional information on this topic can be found in these sources:

Planning user groups

36 iSeries: Getting started with iSeries


Entering personal information into a user profile
The system creates a directory for this user once you enter personal information.
1. Expand the user.
2. In the user’s Properties dialog, click the Personal button.
3. Enter in the user’s name, location, and mail address.

Remember, if you are managing user profiles across multiple systems, Management Central has features
that can make the task much easier. Check out Management Central’s user administration function for
more details.

Additional information on this topic can be found in these sources:

Management Central’s user administration function

Setting security parameters for users


From the Capabilities dialog you can change:
v User privileges“Setting user privileges”: Set the privilege class and system privileges.
v Applications: Set the user’s access for specific applications.
v User passwords“Setting user passwords”: Set the user’s password expiration parameters.
v Auditing“Control user profile auditing”: Set the user’s action and object auditing parameters.
v Certificates: Get information about certificates and use the Digital Certificate Manager.
v Other settings“Other user settings” on page 38: Set the user’s UID number for system reference.

Setting user privileges


Define the privilege class privileges screen using the following values:
v User
v Programmer
v System operator
v System administrator
v Security officer

Default system privileges are automatically selected based on a user’s privilege class and the security
level. Additional system privileges can be granted or taken away by simply checking the appropriate box.

Use Management Central’s Edit Users to change the privileges for many users all at once.

Setting user passwords


Specify when a user’s password expires from the Password dialog in the User Security window.

Set the password to expire by clicking one of these options:


1. As specified by system value
2. A certain number of days after last change (you need to type the number of days in the right-hand
field). The number cannot exceed 366 days if you select this option.
3. Never

Control user profile auditing


User profile object auditing is a combination of settings for the object itself and for those users who have
access to that object. On the auditing settings page, you can define which actions to log. Selecting the
appropriate options lets you define none, change, or all.

Your selection under Audit these actions specifies the level of activity that is audited for a user profile.

Chapter 8. Managing system operations 37


The audit policy function lets you define a system-wide audit.

Other user settings


The user ID (UID number) is displayed in the other window. Because every user on the system must have
an unique UID number, use the default setting of system generated value for a new user. This virtually
eliminates the possibility of duplicating a UID number.

Additional information on this topic can be found in these sources:

Management Central

Job-related information for users


This information includes the current library, job description, initial program and menu, and attention
program.

From the jobs window you can further define:


v General settings: Set the library, maximum storage, schedule priority, accounting codes, job
descriptions, and home directory for the jobs.
v Session startup:á Set initial programs and menus and their libraries, display sign-on information, and
limit device sessions.
v Display session settings:á Set attention programs, limit program/menu capabilities, set the assistance
level, enable a keyboard buffer, and set user preferences (options) for display.
v Output settings:á Designate the printer device, printer output queue, and message queue for the jobs.
v International settings:á Change the sort sequence, language, country, coded character set ID, and
locale to make your system fit the way you do business.

Additional information on this topic can be found in these sources:

What can I do with Management Central

Setting system security


Nearly every day, the newspapers contain headlines about companies who have had their information
invaded by malicious hackers. Only occasionally do they report the even more common occurrence of
companies whose information security is breached internally.

To help safeguard privileged information from curious eyes, you need to establish security protocols to
control access to your data. You can organize user authorities to accomplish your goals.

As you plan your system’s security, keep in minds the variety of security levels available to you. The level
you choose will depend upon the nature of your business and any security plans already in place.

Then, complete these tasks to establish the security of your system:


1. Set system security values
v Set security policies: Set the security-related system values.
v Set up auditing: Control auditing of actions and new objects.
v Set up authorization lists: Create, maintain, delete, and display authorization lists.
2. Run security wizard

Additional information on this topic can be found in these sources:

Tips and Tools

38 iSeries: Getting started with iSeries


System security classes
Security on your system is arranged in a series of levels or classes, each offering a greater degree of
security and protection of your data than the previous. Select the level that best meets the needs of your
organization.

You can use Operations Navigator to change these settings on a single system, and Management Central
to alter them across multiple systems.
v Level 20:
This level is referred to as password security. That is, users must have a password and userid that is
recognized by your system in order to gain access to the system. Both the userid and initial password
are created for users by the System Administrator.
This level of security offers all users on the system total authority to do anything they want. That
means they can access all data, files, objects, and so on, on your system. This may be appropriate for
small businesses where internal security is a low priority, but would likely be inappropriate for larger
businesses who do not want every employee to be able to access confidential payroll files, for example.
v Level 30:
This level is referred to as resource security. That is, users must have a valid user ID and password
defined for them by the system administrator, and no longer have automatic access to everything on the
system. User access is limited by the security policies of the business.
v Level 40:
This level is referred to as system integrity security. That is, at this level, the system itself is protected
against users. User-written programs cannot directly access the internal control blocks through pointer
manipulation.
Level 40 is the default security level for every new installation.
v Level 50:
This level is referred to as enhanced system integrity security. Level 50 is the recommended level of
security for most businesses, because it offers the highest level of security currently possible. Not only
is the system protected against user-written programs, but it ensures that users only ever have access
to data on the system, rather than information about the system itself. This offers greater security
against anyone attempting to learn about your system.

Additional information on this topic can be found in these sources:

Tips and Tools

Security Reference
Management Central’s user administration function

Setting security policies


An important safety precaution you need to take is to set limitations and restrictions to make it more
difficult for unauthorized users to get access to your system through workstations.

Keep in mind that you must balance security with usability. If you allow users only one attempt to
successfully sign onto the system, will you have users calling you for help every day because they
incorrectly entered their passwords? At the other extreme, have you set the limit of signons so high that a
malicious user has enough time to crack a password?

Now, in addition to setting security on one iSeries, Management Central allows you to compare system
values to a model system, and then update values across multiple systems. For instance, you could set
the security level on the model system to 50, then compare and update system values to set that level
across 25 other systems. This allows you to easily standardize your security levels without having to set
each system individually—a real time-savings.

Chapter 8. Managing system operations 39


To set security for your system, complete these tasks:
1. In Operations Navigator, expand your system.
2. Expand Security.
3. Expand Policies.
4. Expand Security Policy.á The Security Policies Properties dialog appears.
5. Refer to the table below to select the appropriate tabs.
6. After you have filled in the desired information, click OK.

If you want to... Then click this tab...


Set and change time-out intervals for jobs or job message The Time-Out tab
queues
Allow security officers to sign on to any display station The Remote Sign-On tab
Control remote sign-on The Remote Sign-On tab
Limit device sessions The System Sign-On tab

Go to the heading Allow Auto-configuration of or enable


Limit each user to one device session
Set action to take for failed sign-on attempts The System Sign-On tab

Go to the heading Action when sign-on attempts reached


Set maximum sign-on attempts allowed for users The System Sign-On tab

Go to the heading Incorrect sign-on attempts


Set password parameters, maximum and minimum The Password tab
length, different passwords required
Set password expiration parameters The Password Expiration tab
Set security levels The Security Controls tab
Allow restore of:á remote service of the system, programs The Security Controls tab
that adopt their owner, server security information to be
retained
Allow objects that are not auditable to go into specific The Objects Not Auditable tab
libraries
Specify what action needs to happen when a device error The Device Error Action tab
occurs at the workstation

Additional information on this topic can be found in these sources:

Security Reference
Security system values

Setting up auditing
Auditing is a vital tool in tracking what happened on your system at what time. Audit records can help you
reconstruct system failure or intrusion.

To activate active system auditing, the journal QAUDJRN must exist in library QSYS. Each time an event
is selected, the system writes a journal entry in the current receiver for this journal. The journal receiver
can grow significantly in size so do not activate system auditing if you do not need it.

If you have all object auditing special authority, you can control:

40 iSeries: Getting started with iSeries


v Action Auditing“Set action auditing”
v New Object Auditing“Creating a user profile” on page 34

Set action auditing


To open the Action Auditing dialog:
1. In Operations Navigator, select the system you want to work with.
2. Expand Security Policies.
3. Expand Security.
4. Expand Audit Policy.

Start auditing new objects


This tab can only be accessed object auditing is activated. You can select the default auditing value for
new objects to be none, user settings, change to objects, or all access of objects.
1. In Operations Navigator, select the system you want to work with.
2. Expand Security.
3. Expand Policies.
4. Expand Audit Policy.
5. Click the New Objects tab in the Properties dialog.

Additional information on this topic can be found in these sources:

Security Reference

Defining authorization lists


Running out of time to set up and monitor authority for every individual user on the system? Simplify
management of authorities by creating authorization lists.

Once you have determined the kind of authorization lists you need, use Operations Navigator to perform
the following tasks:
v Create a new authorization list“Creating a user profile” on page 34
v Add users and groups“To add users to a group” on page 35
v Change user permissions“Changing a user profile” on page 34
v Display secured objects“To display secured objects” on page 42

To create a new authorization list


1. Select the system you want to work with.
2. Expand Security.
3. Right-click Authorization Lists.
4. Select New Authorization List from the Context menu.
This opens a dialog where you enter a name, description, and select a public authority level.

To add users and groups


1. Select the system you want to work with.
2. Expand Security.
3. Click Add and expand the list of users or groups.
4. Select one or more users and groups.
5. Click OK.

Chapter 8. Managing system operations 41


To change user permissions
1. Select the system you want to work with.
2. Expand Security.
3. Expand the authorization list that you want to change.
This opens the basic authorization list dialog where you can change permissions for the displayed
users or groups by checking the use, change, all, and exclude radio buttons.
4. Click Details to grant and revoke individual permissions.
5. Click Customize to assign customized permissions.
This opens a dialog that contains a list of the individual rights that a user can have.

To display secured objects


1. Select the system you want to work with.
2. Expand Security.
3. Expand an authorization list. This opens the basic authorization list dialog.
4. Click Secured Objects. A window opens that displays all the objects that the authorization list secures.

Additional information on this topic can be found in these sources:

What can I do with Management Central?

Using the security wizard


The security wizard can advise you on security planning. You also need to run the security wizard when
you move to new versions and releases of the iSeries.á As new functionality is added to your system, you
need to make sure that your security policy remains in force, and that users have consistent access to
new components on the system.

The security wizard asks you questions and assess your security needs based on your answers.á It then
offers up a selection of recommended security settings.á Youáchoose which recommendations to
implement. The security wizard only makes suggestions:á no changes are made on your system until you
have approved of them.

The security wizard also creates detailed reports based on your answers which explain in detail the
recommendations it makes.á Once you have selected the settings you want to implement on your system,
the security wizard applies them to the system, and saves them for future reference.

Note: You must have a user ID with *ALLOBJ, *SECADMN, *AUDIT, and *IOSYSCFG authority to use the
wizard. If you do not have the correct authority, you will not be able to access the wizard.

To run the security wizard in Operations Navigator:


1. Right click Security.
2. Select Configure.

Additional information on this topic can be found in these sources:

Tips and Tools for Securing your iSeries

Starting and stopping the iSeries


To start the system, turn the system power on and do an initial program load (IPL). During an IPL, system
programs load from the system auxiliary storage and the system hardware is checked. When the IPL is
finished, the Sign On display is shown on the console.

42 iSeries: Getting started with iSeries


You can stop the system (turn the power off) using the Power On and Off Tasks (POWER) menu. To get to
the Power On and Off Tasks (POWER) menu, type go power on any command line and press Enter. You
can also stop the system by using the Power pushbutton. However, using the Power pushbutton may
cause errors with your data files and other objects on the system.

You can set up a schedule that automatically powers your system on and off. You can determine the time
of day you want the system powered on and off. You can also specify special circumstances that change
that normal daily schedule, such as a holiday or special closing.

Refer to the following table when starting or stopping your system:

Starting your system Stopping your system

v Starting the system (Unattended IPL) v Stopping the system


v Signing on to the system v Powering off the system immediately
v Starting a remote system v Using the power pushbutton
v Changing your system IPL from your system control panel
v Changing your system during IPL (Attended IPL)
v Changing your system password
v Working with subsystems

Additional information on this topic can be found in these sources:

System reference codes and primary partitions


System reference codes and secondary partitions
What causes an abnormal IPL?
Controlled shutdown concepts

Setting up an automatic power on and off schedule


You can plan when you want to power on and off the system by setting the power on and off schedule. To
work with the power on and off schedule, go to the Power On and Off Tasks (POWER) menu.

Tip: You can also display this menu from the Customize your system, users, and devices (SETUP) menu
by selecting option 3 (Power on and off tasks).

Displaying the power on and off schedule


The power on and off schedule ensures that the system is powered on and off at specific times during the
day or night. To view this schedule:
1. On any command line, type go power and press Enter.
2. Select option 1 (Display power on and off schedule) on the Power On and Off Tasks menu.

The power on and off schedule shows the date, day, and time (using the 24-hour clock) that the system
will be powered on and off. The Description column includes comments about those days that have been
changed from the system’s regular schedule. Any user can display this schedule.

Changing power on and off schedule defaults


To set up your own power on and off schedule, select option 2 (Change power on and off schedule) on the
Power On and Off Tasks (POWER) menu. On the Change Power On/Off Schedule display, press F10
(Change power on/off defaults).

On this display, you can change the first day of the week by typing a number in the First day of week field.
Also, the system automatically sends users a message telling them when the system will be powered off.
You can indicate how many minutes before power off you want the system to send this message in the
Minutes before power off to send field.

Chapter 8. Managing system operations 43


When the system sends the power off message, you can delay the scheduled time for powering off from
30 minutes to 3 hours when you reply to the message. Then the system will wait the time specified before
powering off. You do not have another chance to delay the time.

For example, if you want the system powered on Mondays at 5:30 a.m. and off on Fridays at 11:00 p.m,
and on Saturdays and Sundays you want the system powered on at 7:30 a.m. and off at 8:00 p.m., type
the new times in the Default Power On and Default Power Off columns next to Saturday and Sunday.
When you press Enter, your changes are shown on the Display Power On/Off Schedule and the Change
Power On/Off Schedule displays.

Changing a Day in the Power On and Off Schedule


The Change Power On/Off Schedule display allows you to change the power on and off schedule for a
single day.

For example, to change the power on and off time for the plant’s company picnic on Wednesday, May 3:
1. Type 14:30 in the Power Off column to power the system off at 2:30 p.m. so the employees can attend
the picnic.
2. Type the reason for the change, Closing - Company picnic, in the Description column across from the
date and time and press Enter.
3. Type the start time 5:30 in the Power On column to power the system back on Thursday, May 4.

To display the schedule starting on a different date, type the date you want to start with in the Start list at
field and press Enter. The information that is displayed begins with the date you specify.

Solving Problems with the Automatic Power Schedule:


If the power schedule is not working:
v Make sure that the Start Cleanup (STRCLNUP) command is part of your startup program.
v The automatic power scheduler uses a job called QSYSSCD to process the requests for schedule
changes. The Start Cleanup (STRCLNUP) command must be run to start the QSYSSCD job. The
IBM-supplied startup program includes the Start Cleanup (STRCLNUP) command. If you have your own
startup program from a previous release, it may not contain the Start Cleanup (STRCLNUP) command.
v Make sure that you specify Yes on the Change Cleanup (CHGCLNUP) command to allow automatic
cleanup. The QSYSSCD job will not start if you do not allow automatic cleanup.
v Make sure that the Start Cleanup (STRCLNUP) command submits the QSYSSCD job to the job queue
specified in the Change Cleanup (CHGCLNUP) command.
v Check to see if the QSYSSCD job is running; it could be on a held job queue.
v Make sure that the job queue that the Start Cleanup (STRCLNUP) command is submitted to has the
maximum jobs parameter set to *NOMAX or a number greater than 1. Because the QSYSSCD job
always runs, the other jobs that perform automatic cleanup and power off functions are not able to start
if the maximum jobs parameter is set to 1. To change the maximum jobs parameter, use the Change
Subsystem Description (CHGSBSD) command.
v Make sure the mode is set to Normal or Auto.

Starting the System


When you start your system by turning the power on, an IPL (initial program load) is done for the system
to reset storage and recognize changes to certain system characteristics. If you are working on a system
that has logical partitions, please refer to the documentation on starting and stopping logically partitioned
systems.

44 iSeries: Getting started with iSeries


Note: A license authorization code (also referred to as a licensed key) must be installed for OS/400 and certain
licensed programs. Each locked program has a unique license authorization code that must be installed within 70
days of installing the program. Starting with Version 4 Release 2, OS/400 will not IPL after the 70 day grace period
without a valid key. Without a valid key, a message is sent to you (and possibly other users depending on how your
system is set up) every four hours during the 70 day grace period. Messages stop when you enter a valid key.

After the 70 day grace period, a message is sent every hour to you and to the QSYSMSG message queue. All high
priority messages in the system are sent to the QSYSMSG message queue. Messages stop when you enter a valid
key.

A valid key must be entered, or the system will not complete the IPL process after the end of the 70 day grace
period.

You can enter the key by using the Add License Key Information (ADDLICKEY) command from any OS/400
command line before the grace period expires. If the grace period has expired or if you need a new OS/400 software
license key, contact your IBM marketing representative or IBM business partner.

When to perform an IPL


There are four different situations that typically require an initial program load: starting normal operations,
starting a remote system, changing configuration options, and recovering after a power failure. When your
system is sent to you, it is set to do a normal or unattended IPL. An unattended IPL is done automatically
by the system after the power is turned on; then the Sign On display is shown on all available display
stations. An attended IPL shows displays on the display station you are using for a console. This allows
you to change the configuration options such as how the system does an IPL and how the system runs.

IPL Summary
System State Unattended IPL Attended IPL
Running 1. Set the mode to Normal. 1. Set the mode to Manual.
2. Type ENDSYS or ENDSBS *ALL 2. Type ENDSYS or ENDSBS *ALL
on any command line and press on any command line and press
Enter. Enter.
3. Type PWRDWNSYS *IMMED 3. Type PWRDWNSYS *IMMED
RESTART(*YES) on any RESTART(*YES) on any
command line and press Enter. command line and press Enter.
4. Follow the displays on the
console to complete the IPL.
5. Set the mode to Normal.
Not Running 1. Set the mode to Normal. 1. Set the mode to Manual.
2. Power on all devices. 2. Power on all devices.
3. Press the Power pushbutton to 3. Press the Power pushbutton to
Power On. Power On.
4. Follow the displays on the
console to complete the IPL.
5. Set the mode to Normal.
Note: While not required, setting the mode to Normal after the IPL is finished is a good practice.

Normal operations (unattended IPL)


Before you start
v The mode must be set to Normal (unattended IPL).
v The QIPLTYPE system value must be set to 0 (unattended IPL). See system values that control IPL for
information on how to set this system value. If this is the first time you are doing an IPL, the QIPLTYPE
system value is already set to 0.

Chapter 8. Managing system operations 45


Note: The system must be powered on, and the IPL complete before you can display or change the
QIPLTYPE system value.

To do an unattended IPL:
1. Turn on the power of any display stations, printers, tape devices, and controllers you or others may
want to use.
2. Make sure that the mode is set to Normal. Use the Power pushbutton to turn on the system.
3. When the unattended IPL is done, the Sign On display appears on the display station.

Starting the iSeries: signing on


To sign on the system:
1. Type your user ID, your password (if security is active), and fill in any of the optional entry fields you
want to use. Use the Tab key to move the cursor from field to field on the display.
Note:
v The Password field is displayed only if password security is active on the system.
v In the top right corner of the Sign On display, the name of the system you are using, the subsystem
the system is using, and the display station identifier (ID) are shown.
2. Press Enter.
If this is an unattended IPL (initial program load), one or more of the following occurs, depending on
what options you select on this display or what is defined in your user profile:
v The Main Menu is displayed.
v Another menu is displayed.
v A program or procedure is run.
v A current library is inserted into your library list.

If you specify a program or procedure to run and a menu to be displayed, the program or procedure is
run first and then the menu is shown.

Now that your system is up and running be aware that:


v The Operational Assistant displays are now the default.
v The system cleanup functions are automatically started with default values.
v The Attention key program defaults to display the Operational Assistant (ASSIST) menu.

Starting a remote system


To start the remote system automatically using a telephone and modem, you need to set system value
QRMTIPL to 1.

Before you start:


1. Set the mode on the control panel to Normal or Auto and turn the system off.
2. After the system is turned off and is made ready for remote initial program load (IPL), do not turn the
modem on or off. Otherwise, the system may start unexpectedly, although it will turn itself off in a few
minutes.

To start the remote system:


1. Dial the telephone number that is assigned to the electronic customer support modem and line of the
remote system.
Note: If you hang up before the silence, the IPL may not complete.
2. Wait about 20 to 40 seconds while the telephone rings. You will hear a modem tone and then silence.
At this time, the communication is being established from the modem to the control panel to start the
IPL sequence.

46 iSeries: Getting started with iSeries


3. Hang up the telephone. The system does an IPL and the Sign On display is shown.
4. Sign on to the system.

Changing your system IPL from the system control panel


The Increment/Decrement buttons are used to change the initial program load (IPL) type and mode on
systems without a mode button. Use Function 02 to select the IPL type (A, B, or D) and Mode (Normal,
Manual). To select IPLátype and mode, do the following:
1. Use the Increment/Decrement buttons to select Function 02, and press the Enter pushbutton.
2. Use the Increment/Decrement buttons to select the IPL type and mode you want, and then press the
Enter pushbutton to save.
3. You can also specify a fast or slow IPL that can only be set one time at the console panel when the
system is powered off. Select Function 02 and press Enter twice. Then, use the Increment/Decrement
buttons to select F(Fast), S(Slow), or V(Value from IPL attributes).

The IPL attribute determines subsequent IPLs. *MIN is the recommended setting, however, if you
anticipate any hardware problems, specify *ALL on the Hardware diagnostics parameter. Use the Change
IPL Attributes (CHGIPLA) command to change the IPL attribute.

System Values That Control IPL


The system values listed below let you control the type of IPL (initial program load) and the way the
system does an IPL. Change these system values using option 2 (Change) on the Work with System
Values (WRKSYSVAL) display.

QIPLDATTIM
The IPL date and time system value lets you specify the IPL date and time for starting the system
automatically. The default value *NONE indicates that no timed automatic IPL is desired.

You can set this system value independently in each partition. If the primary partition is powered down at
the time an automatic IPL should occur in a secondary partition, the IPL will not occur. When the primary
partition does IPL, the secondary partition is IPLed if its IPL date and time is past due. The secondary
partition will not IPL if it is configured with an IPL action of hold.

The date format used by your system for date and time is defined in the system value QDATFMT. You
need to know your system date format for step 1. Use option 5 (Display) to determine the format.

To specify the IPL date and time:


1. Type the new date over the current date as follows:
v MM/DD/YY where MM is the month, DD is the day, and YY is the year.
For example, to start the system on June 26, 1997, type 06/26/97.
v YY/MM/DD where YY is the year, MM is the month, and DD is the day.
For example, to start the system on June 26, 1997, type 97/06/26.
v DD/MM/YY where DD is the day, MM is the month, and YY is the year.
For example, to start the system on June 26, 1997, type 26/06/97.
v YY/DDD where YY is the year and DDD is the Julian date.
For example, to start the system on June 26, 1997, type 97/178. June 26 is the 178th day of the
year.
Note: The format is set with the system value QDATFMT. The separator is set with the system value
QDATSEP. The separator is optional.
2. Type the time in the format HH:MM:SS where HH is the hour, MM is the minute, and SS is the second.
Use the 24-hour clock.
For example, if you want to start the system at 8:16 a.m., type 08:16:00, or if you want to start the
system at 8:16 p.m., type 20:16:00.

Chapter 8. Managing system operations 47


Note:
1. The time separator format is set with the system value QTIMSEP. The separator is optional.
2. If you are using the automatic power schedule, you can force the power schedule to update the
QIPLDATTIM system value by entering the following command on any command line.
CHGPWRSCDE DAY(*TODAY) PWRONTIME(*SAME) PWROFFTIME(*SAME)

QIPLSTS

The IPL status system value displays the way the system did the last IPL. You cannot change this system
value. Use option 5 (Display) on the Work with System Values display to display it.

0 An IPL from the control panel of the system unit or from


dedicated service tool (DST) for a secondary partition.
1 An unattended IPL automatically after a power failure
(QPWRRSTIPL set to 1).
2 An unattended IPL after using the Power Down System
(PWRDWNSYS) command with the Restart after power
down (RESTART) parameter set to *YES.
3 A unattended scheduled IPL (QIPLDATTIM set to the
date and time for the IPL to occur).
4 An unattended remote IPL from another location
(QRMTIPL set to 1).

QIPLTYPE

The IPL type system value defines the type of IPL the system does from the control panel.

0 An unattended IPL. Start the system without an operator


(see Normal Operations (Unattended IPL)). If the mode is
set to Manual, an attended IPL is performed instead.
1 An attended IPL with Dedicated Service Tools (DST) Start
the system with an operator (see Changing Your System
During IPL (Attended IPL).) An unattended IPL is done if
it is done remotely, by date and time, or after power
failure.
2 An attended IPL in debug mode. Start the system with an
operator. The console description, QCONSOLE, is left
varied on. You should only use this for problem analysis
because it prevents other devices on the work station
controller from being used.

QPWRRSTIPL

The automatic IPL system value allows the system to start automatically when power is restored after a
power failure. On a partitioned system, change this system value from the primary partition only. The
QPWRRSTIPL system value controls only the primary partition.

The IPL action configuration value for the secondary partition determines whether a secondary partition will
IPL at the same time as the primary partition. For details on configuring logical partitions on your AS/400

48 iSeries: Getting started with iSeries


system, go to Planning and Setting Up under the Logical Partitions topic in the iSeries Information Center.

0 Does not do an automatic IPL after a power failure.


1 Does an automatic IPL after a power failure.

QRMTIPL

The remote IPL system value allows you to start the remote system by using your telephone and a
modem or the SPCN signal.

0 Does not allow a remote IPL.


1 Allows a remote IPL.

Note:If you are using a modem eliminator, your system will power up every time PWRDWNSYS
RESTART(*NO) is issued.

QUPSDLYTIM

The uninterruptible power supply delay time system value controls the length of time the system will wait,
before saving main storage and power down the system. If utility power is restored before the time ends,
the system ends the timer. If the timer ends first, the system begins to save main storage or goes into
CPM.

On a partitioned system, change this system value from the primary partition only.

There are three choices for the QUPSDLYTIM value.

*BASIC or *CALC The default value for QUPSDLYTIM is *CALC. Leaving


QUPSDLYTIM set to *CALC may defeat the purpose of
having a UPS. *BASIC or *CALC provide the same
function in systems using PowerPC(R) technology. After a
fixed interval delay (typically 45 seconds), high end
systems enter CPM, while entry systems equipped with a
UPS perform a controlled shutdown. Users with a UPS
who prefer a shorter IPL may wish to use a numeric
value.
*NOMAX *NOMAX is used when a user supplied program is
controlling the power down of the system or a generator
is providing unlimited UPS power.
0 Automatic system power down when the system utility
power fails.
1 — 99999 Specifies delay time in seconds before the system
powers down.

See the Uninterruptible power supply delay time system value (QUPSDLYTIM) for more detailed
information about QUPSDLYTIM.

Chapter 8. Managing system operations 49


QUPSMSGQ

The uninterruptible power supply message queue system value allows you to specify where you want your
messages sent when the power to the system is interrupted.

Note: The SCPF job clears the message queue specified for the system value QUPSMSGQ.

QSYS/QSYSOPR

Sends the messages to the system operator’s message queue when power to the system is interrupted.

message queue Specifies another message queue (in addition to the


system operator’s message queue) where messages are
sent when power to the system is interrupted.
library Specifies the library where the other message queue is
located.

Changing the system during IPL (attended IPL)


If you want to change initial program load (IPL) options, install the operating system, use dedicated service
tools, work with logical partitions, or recover from a system failure, you need to perform an attended IPL.

Before you start:


v Set the mode to Manual, or
v Set the QIPLTYPE system value to 1. For information on how to set this system value, see System
Values That Control IPL.
Note: The system must be on and the IPL complete before you can display or change the QIPLTYPE
system value.

Perform the attended IPL


v Performing an attended IPL when the power is off:
1. Make sure that the power for the display station you are using as the console is turned on. The
power should be turned on for display stations, printers, tape devices, and controllers you or others
may want to use.
2. Use the control panel to do the following:
a. Make sure that Manual mode is selected on the control panel.
b. Use the Power pushbutton to turn on the power.
When you have completed the attended IPL, you may want to set the mode to Normal.
v Performing an attended IPL when the power is on:
– If the system is running and you are able to enter commands:
1. Set the mode to Manual.
2. On any command line, type PWRDWNSYS OPTION(*IMMED) RESTART(*YES)
3. Press Enter.
– If you cannot enter commands, start the IPL from the operator panel, as follows:
1. Use the Power pushbutton to turn off the system.
2. Press the Power pushbutton to start an IPL.
During the attended IPL, the IPL or Install the System display is shown on the console.

50 iSeries: Getting started with iSeries


3. On the IPL or Install the System display, select option 1 (Perform an IPL) and press Enter.
The IPL Sign On display is shown. You may have to wait 30 or more minutes for this display to
appear.
4. Sign on to the system using the Sign On display. The Select Products to Work with PTFs display
is shown.
- On the Select Products to Work with PTFs display, select the product for which you want to
apply the fix and continue with the attended IPL.
- If you do not want to apply a fix, press F3 (Exit) on the Select Products to Work with PTFs
display and continue with the IPL.
5. The IPL Options display is shown next. See Changing IPL Options below to select options to
change system attributes.

Change IPL options


To change IPL options, you need to do an attended IPL.
v Use one of the procedures described above to begin the IPL.
When you select option 1 (Perform an IPL) on the IPL or Install the System display, the IPL Options
display is shown.
v To change an IPL option, type the new option over the existing information, and press Enter.
v Depending on what you selected, one of the following displays is shown next:
– If you typed Y (Yes) in the Set major system options field, the Set Major System Options display is
shown.
Note: If you also typed Y (Yes) in the Define or change system at IPL field, the Define or Change the
System at IPL menu is shown after the Set Major Options display.
– If you typed Y (Yes) in the Define or change system at IPL field and N (No) in the Set major system
options field, the Define or Change System at IPL menu is shown.
– If you typed N (No) for both the Set major system options field and the Define or change system at
IPL field, the menu, program, or procedure you defined on the Sign On display or in your user profile
is shown.

Set Major System Options


The Set Major System Options display allows you to select automatic configuration, the type of device
configuration naming, and the special environment in which you want to run.
1. Using the following information, type the new values over the existing values in the following fields:
v Enable automatic configuration
– Y (Yes) automatically configures local devices.
– N (No) indicates no automatic configuration.
v Device configuration naming
– *NORMAL uses a naming convention unique to the iSeries, for example, DSP01 and PRT01 for
displays and printers, TAP01 and DKT01 for tape and diskette devices.
– *S36 uses a naming convention similar to System/36(TM), for example, W1 for workstations, P1
for printers, and T1 and I1 for tape and diskette devices.
– *DEVADR uses a naming convention which is obtained from the device resource name, for
example, DSP010203 for a display station, PRT010203 for a printer, TAP01 and DKT01 for tape
and diskette devices.
v Default special environment
– *NONE indicates there is no special environment.
– *S36 sets up the System/36 environment.
2. Press Enter.

Depending on what you selected on the IPL Options display, the following is shown next:

Chapter 8. Managing system operations 51


v If you typed an N (No) in the Define or change the system at IPL field, the menu, program, or procedure
you defined on the Sign On display is shown next.
v If you typed a Y (Yes) in the Define or change system at IPL field, the Define or Change System at IPL
menu is displayed.

Define or change the system at IPL


On the Define or Change the System at IPL display, you can change the system configuration, system
values, network attributes, user profiles, and object or file attributes. This display is shown when you type
Y (Yes) in the Define or change the system at IPL field on the IPL Options display.
1. Do one of the following:
v To change the way the system starts, select option 3 (System value commands) and go to Changing
System Values During IPL.
v If you selected option 1, 2, 4, 5, 6, or 7, continue to select options and use the displays until you are
finished.
2. When you are finished using the options on this display, press F3 (Exit and continue IPL) to continue
the IPL.

Change system values during IPL


System values control information that affects the operation of certain parts of the system. Some system
values that you change do not take effect until the next IPL; other system values take effect immediately.

On the System Value Commands display, you can change system values that affect IPL or other areas of
the system. This display is shown when you type a Y (Yes) in the Define or change the system at IPL field
on the IPL Options display (see step 6).

To change system values during an IPL:


1. Select option 3 (System value commands) on the Define or Change System at IPL display (see
Defining or Changing the System at IPL).
2. Select option 3 (Work with system values).
3. Select option 2 (Change) on the Work with System Values display.
4. Type the new system value over the current value and press Enter.
5. Press F3 (Exit) to return to the System Value Commands display.
6. Press F3 (Exit) to return to the Define or Change the System at IPL display, and press F3 again to
continue the IPL.

Security considerations:To change system values, you must be signed on as QPGMR, QSYSOPR, or
QSRV, or have all object (*ALLOBJ) authority. Certain system values can be changed only by a security
officer (someone with all object (*ALLOBJ) and security administrator (*SECADM) special authorities). For
information about system values that control the way the system does an IPL, see System Values That
Control IPL.

Edit access paths during attended IPL


Access paths define the order that records in a database file are organized for processing by a program. If
there are access paths to rebuild, the Edit Rebuild of Access Paths display is shown after the IPL Options
display.

Tip: use the online help information on this display to get more about each column and field.

A message notifies you that a journal should perform an access path recovery. A journal is a system
object. It is used to record entries in a journal receiver when a change is made to the database files
associated with the journal. Any access path that is recoverable because it was recorded is not shown on
this display. The IPL threshold indicates that access paths with a sequence less than or equal to the

52 iSeries: Getting started with iSeries


number specified will be rebuilt at IPL time. It is a value from 1 through 99 that you can set (default is 50).
If the IPL threshold changes, all access paths with a status of IPL and AFTIPL will change to reflect the
new status of the IPL threshold.
v To change the sequence of access paths that will be rebuilt:
– Make any changes to the Seq column.
– Press Enter.
v If you do not want to change the sequence, press Enter and the Display Access Path Status display is
shown if there are access paths left to be rebuilt.

Tip: Press Enter to continue with the IPL from the Edit Rebuild of Access Paths display.

If no access paths need to be rebuilt, the IPL continues.

If you press F3 (Exit and continue IPL) the access paths will be rebuilt while the IPL continues. If you
press F12 (Cancel), you return to the Edit Rebuild of Access Paths display.

Every 5 seconds, the display is updated with the current run time. After all the access paths have been
rebuilt (access paths with a sequence less than or equal to the IPL threshold), the IPL continues.

Edit check pending constraints during attended IPL:


During an attended IPL, the Edit Check Pending Constraints display is shown if there are constraints to be
verified. A constraint is an attribute that places restriction or limitation on a physical file.

Tip: use the online help information on this display to get more about each column and field.

On the Edit Check Pending Constraints display, you can change the sequence (1 through 99) of the
constraints to be verified. If the constraint has a sequence less than or equal to the IPL threshold, it is
verified during the IPL. If a constraint has a sequence greater than the IPL threshold, it is verified after
IPL. The sequence *HLD indicates that the constraint is not verified until it is changed to a number from 1
through 99. When the IPL threshold changes, all constraints with a status of IPL or AFTIPL are changed to
reflect the new status of the IPL threshold.
v To change the sequence of check pending constraints:
1. Make any changes to the Seq column
2. Press Enter.
v If you do not want to change the sequence, press Enter. The Display Constraint Status display is
shown if there are constraints left to be verified.

If you press F3 (Exit and continue IPL) the constraints are verified while the IPL continues. Every five
seconds, the display is updated with the current run time. After all constraints with IPL status have been
verified, the IPL continues. If you press F12 (Cancel), you return to the Edit Check Pending Constraints
display.

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Tips for Improving IPL Performance


The topics that follow describe actions that you can take to reduce the amount of time that it takes your
system to perform an IPL (initial program load).

Note: A normal IPL means that your previous system shutdown was under normal conditions rather than
being an abrupt shutdown caused, for example, by a power failure.

Chapter 8. Managing system operations 53


Cleanup Activities That Affect IPL Performance
Cleaning Up Your System suggests many tasks that you can perform to reduce the clutter on your system
and improve overall system performance. Following are specific cleanup activities that can have the most
impact on the time that it takes your system to perform an IPL.

Reducing the Number of Jobs on the System: In simple terms, a new iSeries job starts whenever a
user signs on the system or submits a batch job. When a job starts, the system creates an internal entry in
a job table. It uses this table to keep track of all the jobs on the system and to organize information about
those jobs.

From a user perspective, an interactive job ends when the user signs off. A batch job ends when all the
programs have run to completion. However, from a system perspective, a job ends when all the objects
that are associated with that job have been removed from the system. Often, jobs create spooled files that
remain on the system for days or weeks. As long as those spooled files remain, the entry for the job
remains in the job table.

When you perform an IPL, the system processes all the entries in the job table. A very large job entry
table can significantly increase your IPL time. The best way to clean up jobs is to remove unnecessary
spooled files. Setting Up Automatic Cleanup“Setting Up Automatic Cleanup” on page 57 describes how you
can set up your system to automatically remove old spooled files. Cleaning Up Obsolete Objects“Cleaning
Up Obsolete Objects” on page 58 describes steps you can take to encourage users to remove spooled
files that they no longer need.

You can use the Display Job Tables (DSPJOBTBL) command to monitor the size of the job table on your
system. Use this as a signal for when you need to encourage your users to perform housekeeping. The
image below illustrates this concept.
+--------------------------------------------------------------------------------+
| Display Job Tables SYSTEMX |
| 02/20/97 14:05:32 |
| Permanent job structures: Temporary job structures: |
| Initial . . . . : 30 Initial . . . . : 20 |
| Additional . . . : 10 Additional . . . : 10 |
| Available . . . : 3 |
| |
| |
| ---------------------Entries---------------------- |
| Table Size Total Available In-use Other |
| 1 164608 160 8 152 0 |
| |
| |
+--------------------------------------------------------------------------------+

Reducing the Number of Device Descriptions: Whenever you perform an IPL, the system processes
every device description on the system several times (to make performance calculations and to prepare for
varying on the device). You can reduce this processing time by removing obsolete device descriptions from
your system. Cleaning Up Your Hardware Configuration describes a method for finding and removing
unnecessary device descriptions.

System Settings That Affect IPL Performance


You can use the Change IPL Attributes (CHGIPLA) command to control some of the processing that the
system does during an IPL. The example below shows the prompt display for the command. The topics
that follow describe several of the parameters and how they affect IPL performance. For a complete
description of the parameters, refer to online information or the Programming topic in the iSeries
Information Center.
+--------------------------------------------------------------------------------+
| Change IPL Attributes (CHGIPLA) |
| |
| Type choices, press Enter. |
| |

54 iSeries: Getting started with iSeries


| Restart type . . . . . . . . . . *SYS *SAME, *SYS, *FULL |
| Keylock position . . . . . . . . *SAME *SAME, *NORMAL, *AUTO... |
| Hardware diagnostics . . . . . . *MIN *SAME, *MIN, *ALL |
| Compress job tables . . . . . . *NONE *SAME, *NONE, *NORMAL... |
| Check job tables . . . . . . . . *ABNORMAL *SAME, *ABNORMAL, *ALL |
| Rebuild product directory . . . *NONE *SAME, *NONE, *NORMAL... |
| Mail server framework recovery . *NONE *SAME, *NONE, *ABNORMAL |
| Display status . . . . . . . . . *ALL *SAME, *SYS, *NONE... |
| Clear job queues . . . . . . . . *NO *SAME, *YES, *NO |
| Clear output queues . . . . . . *NO *SAME, *YES, *NO |
| Clear incomplete joblogs . . . . *NO *SAME, *YES, *NO |
| Start print writers . . . . . . *YES *SAME, *YES, *NO |
| Start to restricted state . . . *NO *SAME, *YES, *NO |
| |
+--------------------------------------------------------------------------------+

Specifying IPL Restart Type: When you specify RESTART(*SYS), the system restarts the System
Licensed Internal Code and the operating system. However, the system does not completely stop and then
restart all the hardware functions. Usually, the IPL time for RESTART(*SYS) is less than the IPL time for
RESTART(*FULL).

Note: You can also specify the restart type on the Power Down System (PWRDWNSYS) command.

Controlling the Level of Hardware Diagnostics: When you specify HDWDIAG(*MIN), the system
performs only a minimum, critical set of hardware diagnostics. The system runs a quick processor
diagnostic check that covers approximately 90% of the hardware in approximately 10% of the time that is
required for full diagnostics. The system does not perform extended main storage diagnostic or
chip-to-chip circuitry tests.

When you specify HDWDIAG(*ALL), the system performs complete hardware diagnostics. If you are not
experiencing any hardware problems, you can reduce your IPL time by specifying HDWDIAG(*MIN).
However, you should periodically perform an IPL with HDWDIAG(*ALL) to ensure that the system checks the
status of all components. You should always specify HDWDIAG(*ALL) for the first IPL after any of the
following:
v Installation of new processor cards or modules, because of either hardware service or a system
upgrade.
v Replacement of the main processor card.
v Replacement or addition of main storage.

You can override the HDWDIAG parameter from the control panel on the system unit by doing the following:
1. Select function 02 (Select IPL type/mode).
2. Press Enter. The system panel displays the current setting for the IPL type and mode.
3. Press Enter again to display the IPL speed. (The Enter button toggles between IPL type and IPL
speed.) Following are the values for the IPL speed:

F Fast (*MIN) IPL (overrides IPL attribute setting)


S Slow (*ALL) IPL (overrides IPL attribute setting)
V Cancel override of current IPL attribute setting

4. Use the increment and decrement function to scroll through and select your desired IPL speed.
5. Press Enter to store the selected value.
6. Continue the IPL.

Compressing the Job Tables: When a job ends on your system, the system deletes its entry from the
job table and makes that entry space available for another job. If the number of jobs on your system
continues to grow, the system must expand the size of the job tables to accommodate new jobs. After you

Chapter 8. Managing system operations 55


perform cleanup activities on your system, you might find that you have a large number of available job
entries. (See the Available column in the Display Jobs Table example above.)

If you have a large number of available job table entries, you should set the Compress job tables
parameter to *YES for your next IPL. Although the next IPL will be longer because of the compression,
subsequent IPLs will be shorter because the system will have a smaller job table to process.

Note: Remember to set the Compress job tables parameter to *NO after the next IPL.

Checking the Job Tables: When you specify *ABNORMAL for the Check job tables parameter, the
system checks for damage to internal job tables and their associated objects only when your last system
shutdown was abnormal. For most installations, this level of checking is sufficient and will reduce your
overall IPL time.

Rebuilding the Product Directory: The system maintains an internal product directory of all installed
licensed programs. The system rebuilds this product directory automatically when you install the operating
system. For most systems, this directory should be stable when you upgrade to a new release or install
new licensed programs. You can reduce your IPL time by instructing the system never to rebuild the
product directory (RBDPRDDIR(*NONE)).

Displaying Status: The display status attribute specifies whether the console displays status of OS/400
IPL steps during IPL. The status is not displayed during install IPLs or when the console is not powered
on.

Automatic Performance Tuning: The performance adjustment (QPFRADJ) system value controls when
the system does automatic performance tuning. You can set up your system to dynamically tune
performance, to calculate performance values during an IPL, or both. When you set up your system to
tune performance during an IPL, it calculates performance settings based on information that includes the
number of devices and network interfaces and the total amount of main storage. If your system
configuration is stable, you can reduce your IPL time by eliminating these calculations (because they will
have the same result each time). For a stable configuration, set the QPFRADJ system value to 3
(automatic adjustment) or 0 (no adjustment).

How Access Paths and Journaling Affect IPL Performance


Access paths and journaling can affect your IPL performance in the following ways:
v When you restart your system after it ends abnormally, the system must rebuild any access paths that
were open when the system stopped. This rebuild time can be lengthy. You can reduce this time by
journaling access paths, either explicitly by using the Start Journal Access Path (STRJRNAP) command
or implicitly by using the System-Managed Access-Path Protection support. The Backup and Recovery

v Whenbook you perform


describesa manual IPL, you
both methods forsee the Editaccess
protecting Rebuild of Access
paths Paths
from long display.times.
recovery You can use this
display to specify which access paths the system rebuilds during the IPL versus after the IPL. Except
for critical files, you probably want to delay rebuilding access paths until after your system has
completed the IPL.
Note: The system rebuilds an access path if the access path was open for update when the system
stopped or if the file description specifies MAINT(*DLY)
v Management of journal receivers can also affect IPL performance. You can set up a journal so that the
system manages when to detach the current receiver and attach a new one. This simplifies your job of
monitoring the size of your journal receivers. However, for each journal that specifies MNGRCV(*SYSTEM),
the system performs processing during the IPL. If IPL performance is critical to you, you should
consider switching to MNGRCV(*USER) for most of your journals.
v Similarly, you can set up the system to automatically delete journal receivers that it no longer needs for
recovery by specifying DLTRCV(*YES) for the journal. This avoids excessive disk usage for journal

56 iSeries: Getting started with iSeries


receivers but it also increases your IPL time. Again, if IPL performance is critical, consider switching to
DLTRCV(*NO). However, you will need to monitor your system and remove the journal receivers
manually to avoid disk usage problems.

Cleaning up your system to improve performance


Think of your system like a house or office. It can fill up with clutter and unnecessary objects. This clutter
can fill up the disk storage on your system and affect your system performance. The topics that follow
provide suggestions for cleaning up your system on a regular basis.

Setting Up Automatic Cleanup


You can set up your system to run some cleanup functions regularly. Do the following to set up automatic
cleanup:
1. Type GO CLEANUP to display the CLEANUP menu.
2. Select option 1 (Change cleanup options). You see the Change Cleanup Options display:
+--------------------------------------------------------------------------------+
| Change Cleanup Options XXXXXX |
| |
|Type choices below, then press Enter. |
| |
|Allow automatic cleanup . . . . . . . . . . . . . Y Y=Yes, N=No |
| |
|Time cleanup starts each day . . . . . . . . . . 22:00:00 00:00:00-23:59:59, |
| *SCDPWROFF, |
| *NONE |
| |
|Number of days to keep: |
| User messages . . . . . . . . . . . . . . . . . 7 1-366, *KEEP |
| System and workstation messages . . . . . . . . 4 1-366, *KEEP |
| Job logs and other system output . . . . . . . 7 1-366, *KEEP |
| System journals and system logs . . . . . . . . 30 1-366, *KEEP |
| OfficeVision/400 calendar items . . . . . . . . 30 1-366, *KEEP |
+--------------------------------------------------------------------------------+
3. Type Y for the Allow automatic cleanup field.
4. Type values in the fields on the bottom half of the display (Number of days to keep). The online help
information provides more information about what these options do.
5. Set up your system to run automatic cleanup regularly by typing a value in the Time cleanup starts
each day field. Then press Enter.
Notes:
a. If you want to run the automatic cleanup function immediately, you can select option 3 (Start
cleanup immediately) from the CLEANUP menu. If you receive the message Cleanup has already
been started, select option 4 (End cleanup). This ends either the scheduled cleanup job or the
cleanup job that is already started. Then select option 3 again to run cleanup immediately.
b. You can use the Work with Active Jobs (WRKACTJOB) command to determine when the cleanup
jobs have finished. Their names begin with QCLN. Or you can check the QSYSOPR message queue
for the message CPC1E1D (Cleanup has completed).

Cleaning Up Obsolete User Profiles


Obsolete user profiles take space on your system. In addition, obsolete user profiles probably own objects
that you no longer need. To identify obsolete user profiles, do the following:
1. Type GO SECTOOLS and press Enter. You see the Security Tools menu.
2. Select option 4 (Analyze profile activity). You see the Analyze Profile Activity (ANZPRFACT) display.
3. For the Number of inactive days, type the number of days that a user can go without signing on before
you consider the user profile to be inactive.

Chapter 8. Managing system operations 57


4. Press Enter. The system schedules a job to run once a month (at 1 a.m. on the day after you selected
this menu option). The job sets the status to *DISABLED for any user profile that has been inactive
longer than the number of days that you specified. You receive a listing of the user profiles that the
system set to *DISABLED.
Notes:
a. You can use option 3 (Change active profile list) from the Security Tools menu to make a user
profile exempt from ANZPRFACT processing.

b. The Tips and Tools for Securing Your iSeries book provides more information about using
security tools.

When you receive the report of user profiles that the system disabled, do the following:
1. Type WRKUSRPRF *ALL and press Enter. You see the Work with User Enrollment display.
Note: If you see the Work with User Profile display, use F21 to change to basic assistance level.
2. On the display, type 4 (Remove) in the option column for the user profile that you want to remove.
You see the Remove User display.
3. Select 2 (Delete or change owner of specific objects owned by this user) and press Enter. You see a
list of objects owned by the user.
4. For every object that you no longer need on the system, type 4 (Delete) in the option column in front
of the object.
Notes:
a. You can select more than one object for deletion at a time.
b. To see the type of object, press F11.
5. Press Enter. You see the Confirm Delete of Objects display.
6. If your selections are correct, press Enter. Otherwise, press F12 (Cancel) to return to the selection
display.
7. For objects that you want to keep, you need to assign them to a new owner. Type the name of the
user profile for the new owner at the top of the display.
8. Type 2 (Change to new owner) in the option column next to the objects and press Enter key. You see
the Confirm Change of Owner display.
9. If your selections are correct, press Enter. Otherwise, press F12 (Cancel) to return to the selection
display.
10. When you have handled all the objects that the user profile owned, you see the message (User does
not own any objects, press Enter to remove)
11. Press Enter to remove the user profile from the system. You see several messages while the system
removes the user’s records. Then you see the Work with User Enrollment display again with a
confirmation message at the bottom of the display.
12. To remove any spooled files that the user created, do the following:
a. Press F9 to display a command line.
b. Type WRKSPLF SELECT(user-profile-name)and press Enter.
c. On the Work with Spooled Files display, use option 4 (Delete) to delete any spooled files that you
no longer need.
d. When you have deleted all the spooled files that are no longer necessary, press F12 (Cancel).
Note: Spooled files can remain on the system even when the user profile that created them is no
longer on the system.
13. If you have additional user profiles to remove, return to step 2.

Cleaning Up Obsolete Objects


As part of your cleanup effort, you need to encourage users to clean up objects that they no longer need.
The example below shows a sample set of instructions that you can distribute to users. Notice that the

58 iSeries: Getting started with iSeries


example refers to an archives library. You might want to create a library for users to store things that they
seldom use. Your operators can periodically save the library to tape and delete it from your system.

Cleanup Instructions - Sample

To delete objects that you no longer need, do the following:


1. At a command line, type the following and press Enter:
WRKOBJOWN

You see the Work with Objects by Owner display. It lists all of the objects that you own.
2. If you are not sure about whether to delete an object, you can use the MOVOBJ (Move Object) command to
move the object to the following archives library: á áááá . System operators will save this library to an archives
tape before deleting the library from the system.
3. If you are sure that you no longer need an object, use option 4 (Delete) on the Work with Objects by Owner
display to remove the object from the system. (You can delete more than one object at a time.) You will see a
confirmation display with the objects that you selected to be deleted.
4. Verify that the correct objects are listed. Then press Enter.
5. To see a list of spooled files that you created, type the following and press Enter:
WRKSPLF

You see the Work Spooled Files display or the Work with Printer Output display, depending on your assistance
level.
6. From the display, use option 4 to delete spooled files that you no longer need.

Cleaning Up Licensed Programs


Your system might have licensed programs that you no longer need. (Perhaps you installed them as a test
and decided not to use them.) To remove licensed programs that you do not plan to use, do the following:
1. To create a list of all the software resources on your system, type the following and press Enter:
DSPSFWRSC OUTPUT(*PRINT)
2. Retrieve the printout from the printing and mark any licensed programs that you want to delete. Be
sure that you do not need a licensed program before you delete it.
3. Type GO LICPGM and press Enter. You see the Work with Licensed Programs menu.
4. To save a licensed program before you delete it, type 1 (Save) in the option column in front of the
licensed program. Follow the instructions on the prompt displays.
Note: If a licensed program does not appear in the list, use the Save Licensed Program (SAVLICPGM)
command to save it.
5. Press F12 (Cancel) to return to the Work with Licensed Program menu.
6. After you have saved the licensed programs, select option 12 (Delete licensed programs) from the
menu. You see the Delete Licensed Programs display.
7. Type 4 (Delete) in the option column in front of each licensed program that you want to delete.
Note:If a licensed program does not appear in the list, use the Delete Licensed Program
(DLTLICPGM) command to delete it.
8. Follow the instructions on any prompt displays that you see.

Cleaning Up Your Hardware Configuration


Your system might have configuration descriptions for devices that no longer exist on your system. You
should remove these unnecessary descriptions to save space and improve your IPL performance.

Note: On most systems with Logical Partitions, it is common to have one or more system bus resources
that are reported as missing or non-reporting under Hardware Service Manager. For more information
about managing logical partitions, see the Logical partitions topic in the iSeries Information Center.

Chapter 8. Managing system operations 59


The following list contains actions you should take when cleaning up your hardware configuration:
1. Use the GO SAVE command, menu option 21, to make a complete backup of your system. If you have
logical partitions, make a full backup of each partition.
2. Print a list of your hardware devices“Hardware” on page 147.
3. Type DSPHDWRSC TYPE(*CMN) and press Enter. You see the Display Communications Resources
display. Press F6 to print this information. You may wish to make a hard copy printout of the list.
4. Make a note of any resource that has a status of Not detected. Check to see if the hardware is
physically on the system. You might need to check with your hardware service representative to
determine this.
5. Repeat steps 3 through 4 for the following resource types:
v *LWS. You see the Display Local Work Station Resources display.
v *CSA. You see the Display Coupled Resources display.
v *STG. You see the Display Storage Resources display.
v *PRC. For resource type *PRC, do not delete the resource CEC01, even if its status is Not
detected.
6. Use the Work with Configuration Status (WRKCFGSTS) command to display and delete resources that
you do not need.
7. Use the Start System Service Tools (STRSST) command to start a service tool. Select the Hardware
Service Manager option to remove unwanted descriptions.

Additional Cleanup Tasks


Following are suggested tasks that you can perform regularly (such as monthly) to clean up the disk usage
on your system. You may perform these tasks in any sequence. Some of them might require information
from your system users.
1. To identify and delete obsolete libraries, do the following:
a. Type DSPBCKUPL OUTPUT(*PRINT) and press Enter.
b. Retrieve the printout from the printer. The printout shows all the libraries on your system. Mark any
libraries that you no longer need.
c. Before you delete a library, use the Save Library (SAVLIB) command to save it to tape.
d. To delete the library, use the Delete Library (DLTLIB) command.
Note: If a library contains objects that have dependent objects in another library (such as physical
and logical files), you will need to resolve the dependency problems before you can delete the
library. On option might be to change the sequence in which you delete unneeded libraries. (Delete
the library with the logical files first.)
2. To free up unused space in document library objects (DLOs), use the Reorganize Document Library
Objects (RGZDLO) command. This command compresses documents and removes unused space
caused by editing changes. If your users frequently edit documents on the system, this command
might free up a significant amount of space.
3. If you have save files that contain information that you no longer need (for example, because you have
saved it to tape), you can clear the save files and free up most of the space that they use. Use the
Clear Save File (CLRSAVF) command.
4. If you have database files with large numbers of deleted records, you can use the Reorganize Physical
File Member (RGZPFM) command to free up space that is used for deleted records.
Notes:
a. You can use the Display File Description (DSPFD) command to determine how many deleted
records are in a file.
b. If you reorganize a file that is journaled, you must save the file immediately after you reorganize it.
5. To free up space that is used by deleted spooled files, use the Reclaim Spool Storage (RCLSPLSTG)
command. (Your system might do this automatically if you have set the QRCLSPLSTG system value.)

60 iSeries: Getting started with iSeries


6. If you have message queues that sometimes have many messages, you can reset the message
queues to their original sizes. Use the Clear Message Queue (CLRMSGQ) command to remove all the
messages from the message queue. This resets the size.
7. Save and delete any journal receivers that you no longer need for recovery. Use the Save Object
(SAVOBJ) command and the Delete Journal Receiver (DLTJRNRCV) command. The Journal
management for backup and recoveryfor more information about managing journal receivers.
8. If disk usage on your system is high, consider permanently applying fixes to clean up temporary
objects and the fix index. Use the Apply PTF (APYPTF) command.
Note: You should permanently apply fixes only after you have validated the affect of the fixes on your
system.

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Changing the system password


When you install the OS/400 licensed program, the licensed program runs a check to detect system model
changes, certain service conditions, and ownership changes. If the licensed program detects these
changes or conditions, you are prompted to enter the system password before the IPL (initial program
load) can continue. If no changes or conditions are recognized, the IPL continues without a request for the
system password.

You must enter the correct system password to complete the IPL on the primary partition. If the system
password is not available, you or your service representative may temporarily bypass entering the system
password for a limited time. When the bypass period starts, immediately contact your marketing
representative, who will have IBM send you the correct system password. To order the system password,
ask your marketing representative to order nonstandard RPQ S40345 if you are in the United States, Asia
Pacific, Canada, Latin America, or Japan. If you are in Europe, Middle East, or Asia, request nonstandard
RPQ S40346.

Changing the system password


v If you have just installed new hardware, you may need to change the system password during the first
IPL. To do this:
1. Select option 1 (Change the system password) on the Verification of System Password Failed
display.
2. The following system information on the Change the System Password display is shown:
– System serial number
– System type number
– System model number
– System password version
– Processor card serial number

If you do not know the system password, use F12 (Cancel) and select option 2 (Bypass the system
password) on the Verification of System Password Failed display.
3. Type the password in the blank field and press Enter.
v To change the system password when your system is operational:
1. Perform an attended IPL.
2. Select option 1 (Change the system password) on the Verification of System Password Failed
display.
3. Type the password in the blank field and press Enter.

Chapter 8. Managing system operations 61


Bypassing the system password
Use the Verification of System Password Failed display to bypass the system password when:
v You do not know or cannot find the system password.
v You guess the system password and get a message telling you the password you entered is incorrect.
Note: If you type the password incorrectly five times, you must do the IPL again.

To bypass the system password during the first IPL:


1. Select option 2 (Bypass the system password) on the Verification of System Password Failed display.
2. Read the information on the Bypass the System Password display. Remember to contact your
marketing representative immediately to obtain the system password before the bypass period runs
out.
3. Press F9 (Bypass) to continue the IPL.

When the IPL has finished, you will receive hourly messages that tell how much time is left in the bypass
period.

When you receive the password, you can enter it by:


v Doing an attended IPL and selecting option 1 (Change the system password) on the Verification of
System Password Failed display.
v Doing an attended IPL and selecting option 1 (Change the system password) on the Bypass Period has
Ended display.

Working with subsystems


A subsystem is an operating environment where the system coordinates processing of jobs and resources
for the jobs. If you use one of the default subsystem configurations supplied by IBM, all of your
subsystems are automatically started when you do an IPL (initial program load).

Once your system is successfully powered on, you may need to start additional subsystems to make your
system ready to use if:
v You created a subsystem which is not automatically started, such as a subsystem which runs only at
night.
v You ended all but the controlling subsystem to bring your system to a restricted state to back it up.

To start or end subsystems or display subsystem descriptions, use the Work with Subsystem Descriptions
(WRKSBSD) command.

Starting Subsystems: To start a subsystem on the Work with Subsystem Descriptions display, use option
9 (Start subsystem). A message is displayed telling you the subsystem has started.

Ending Subsystems: To end a subsystem, on the Work with Subsystem Descriptions display, use option
10 (End subsystem). On the End Subsystem (ENDSBS) display, in the How to end field, type one of the
following:
v *CNTRLD
Jobs are ended in a controlled manner. This allows programs that are running to perform cleanup and
finish completely, which may take 600 seconds or more.
v *IMMED
Jobs are ended immediately. This can cause problems if data has been partially updated. Use this
option only if you have attempted a controlled end unsuccessfully.

Press Enter. A message is displayed indicating that the system has started to end the subsystem. Another
message is sent when the subsystem has ended.

62 iSeries: Getting started with iSeries


Displaying Subsystem Descriptions: To display a subsystem description, on the Work with Subsystem
Descriptions display, use option 5 (Display). The Display Subsystem Description menu is shown on which
you can select options that give you more information about that subsystem.

Stopping the system


Turning off your system takes careful attention. If you turn off the system without completing the tasks
below, you may cause damage to data or cause the system to behave in unpredictable ways. Before you
stop the system:

Make sure all batch jobs are finished and users are signed off the system
1. Send a message that interrupts all users signed on the system telling them to sign off.
a. Type go managesys and press Enter.
b. Select option 12 (Work with signed-on users) on the Manage Your System, Users, and Devices
(MANAGESYS) menu.
Note: if the Work with User Jobs display is shown, you need to switch to basic assistance level
using F21.
c. Press F10 (Send message to all) on the Work with Signed-On Users display.
d. Type the message in the Message text field on the Send a Message display and press F10 (Send).
2. Wait for the users to sign off.
3. Check to make sure all users have signed off by pressing F5 (Refresh) on the Work with Signed-On
Users display. When everyone is signed off the system, the display will show only your job. To sign
someone off the system, use option 4 (Sign off).
Note: if you have separate interactive subsystems, other than the controlling subsystem, you may want
to stop the interactive subsystems once the users have signed off. This prevents them from signing on
again before you have stopped the system. See Working with Subsystems for information on how to
end a subsystem.

Check the status of any batch jobs that might be affected if the system is powered
down
1. On any command line, type go managesys and press Enter.
2. Select option 11 (Work with jobs) on the Manage Your System, Users, and Devices (MANAGESYS)
menu.
Note: if the Work with User Jobs display is shown, you need to switch to basic assistance level using
F21.
3. Press F14 (Select other jobs) on the Work with Jobs display.
4. Type *all in the User field.
5. Type an N in every field except the Message waiting, Running, and Running job held fields. The Work
with Jobs display is shown again with the batch jobs listed.
6. If any job queues have jobs waiting to run, press F22 (Work with job queues) to see the Work with Job
Queues display.
7. Hold any job queues that have jobs waiting to run on the Work with Job Queues display.
Don’t forget to release these job queues when you start the system again.
8. Press F12 (Cancel) to return to the Work with Jobs display.
9. Press F5 (Refresh) every few minutes until all batch jobs have completed processing.

Check for removeable media


1. Check to see if there are any tapes in any of the tape units or diskettes in any of the diskette units.
2. Remove any tapes or diskettes currently in the unit.

Chapter 8. Managing system operations 63


Powering off the system immediately
You can stop the system by using the Power Down System (PWRDWNSYS) command on any command
line when the system is in any mode. Type PWRDWNSYS and press F4 to view the power down options.
You must have QSYSOPR authority to use the Power Down System (PWRDWNSYS) command. If this
command does not work on your system, use the following methods.

To power off the system immediately:


1. Type go power on any command line to display the Power on and Off Tasks (POWER) menu.
2. Select option 3 (Power off the system immediately) if you want to keep the power off until the next time
the system is scheduled to power on.
3. Press F16 (Confirm) to confirm your choice to power off the system immediately. An immediate power
down occurs that causes the subsystems to end all active jobs.

To power off the system and restart immediately:


1. Select option 4 (Power off the system immediately and then power on) on the Power On and Off Tasks
(POWER) menu.
2. Press F16 (Confirm) to confirm your choice. The system stops running and then starts again
automatically.

Note: Don’t turn the modem on or off when the system is turned off and is made ready for remote IPL
(initial program load). Otherwise, the system may start unexpectedly, although it turns itself off in a few
minutes.

Important: If you stop the system using the automatic power schedule or one of the options on the Power
On and Off Tasks (POWER) menu, the IPL date and time system value (QIPLDATTIM) is checked and, if
necessary, reset to the next scheduled power-on time. This checking does not occur if you power off in
another way, so the system may not power on automatically. To force the power schedule to update the
QIPLDATTIM system value, enter the following command on any command line: CHGPWRSCDE
DAY(*TODAY) PWRONTIME(*SAME) PWROFFTIME(*SAME)

Using the power pushbutton


If you cannot use option 3 (Power off the system immediately) or option 4 (Power off the system
immediately and then power on) on the Power On and Off Tasks (POWER) menu to stop the system, you
can turn the power off using the Power pushbutton to turn off the system when the mode is set to Manual.

Attention: Using the power pushbutton to turn off the system may cause results that cannot be predicted in
your data files, and the next IPL (initial program load) will take longer to complete. Using the Power
pushbutton to turn off the system will power down all partitions.

Make sure that there are no tapes in the tape units or diskettes in the diskette units, and that the mode is
set to Manual.

Do not turn the modem on or off when the system is turned off and is made ready for remote IPL.
Otherwise, the system may start unexpectedly, although it turns itself off in a few minutes.

To turn the power off using the Power Pushbutton, do the following:
1. Press the Power pushbutton. The Function/Data display blinks with 0? (the international power off
symbol).
2. Press the Power pushbutton again. The Power On light blinks as the system is being powered off.
When power off is complete, the light goes off.

64 iSeries: Getting started with iSeries


If the system does not turn the power off within 30 minutes, wait for the System Attention light to come on.
When the System Attention light comes on, go to Handling system problems and getting help and follow
the steps necessary to solve the problem.

System reference codes and primary partitions


The figure below shows the system reference codes that are displayed on the control panel, and
approximately how long they remain displayed while the IPL (initial program load) is progressing on the
primary partition. If you notice a code displayed longer than it should or a code not listed, see handling
system problems and getting help.

Note: in the diagram, X can be any number 0 through 9 or letter A through F.

Chapter 8. Managing system operations 65


After the Sign-on display or command entry display apears, the IPL may still be completing some
processing in the background. The IPL is considered complete, but the system may be performing
asynchronous clean up. Some functions, such as accessing folders and document library objects (DLOs)
may not be available until this clean up is complete.

66 iSeries: Getting started with iSeries


You should allow sufficient time for an IPL to complete before attempting such functions. The time of
completion for an IPL depends on such factors as your system model and configuration.

System reference codes and secondary partitions


The figure below shows the system reference codes that are displayed on the Work with Partition Satus
display while the IPL (initial program load) is progressing on secondary partitions. The figure also shows
approximately how long the codes remain displayed. If you notice a code displayied longer than it should
or a code not listed see handling system problems and getting help.

Note: in the diagram, X can be any number 0 through 9 or letter A through F.

Chapter 8. Managing system operations 67


After the Sign-on display or command entry display apears, the IPL may still be completing some
processing in the background. The IPL is considered complete, but the system may be performing
asynchronous clean up. Some functions, such as accessing folders and document library objects (DLOs)
may not be available until this clean up is complete.

68 iSeries: Getting started with iSeries


You should allow sufficient time for an IPL to complete before attempting such functions. The time of
completion for an IPL depends on such factors as your system model and configuration.

What causes an abnormal IPL?


An abnormal IPL (initial program load) can be caused by any of the following:
v Using the End Job Abnormal (ENDJOBABN) command. To see if this command has been used, look for
message CPC1124 in the job log.
v Using option 7 (Start a service tool), then option 7 (Operator panel function) on the Dedicated Service
Tool (DST) menu.
v Using the Power pushbutton instead of the PWRDWNSYS command.
v A power failure occurring before all data is written from main storage to disk.
v Any B900 xxxx system reference code (where xxxx is any number or letter) during the start of the
operating system phase of the IPL.
v A Power Down System (PWRDWNSYS) command that did not complete, ending with a system
reference code of B900 3F10.
v Any function check in the controlling subsystem causing the system to end.
v For all active secondary partitions, any failure of the primary partition.
v Issuing a PWRDWNSYS command in the primary partition without first powering down secondary
partitions.
v The system going down when database recovery has not completed during the IPL.

Note: if the End Job Abnormal (ENDJOBABN) command was issued, message CPI0990 will be in QHST.
For all other reasons, message CPI091D will be in QHST stating why the IPL was abnormal.

Managing fixes
As a system administrator, one of your responsibilities is maintaining your iSeries. Part of the maintenance
procedure involves getting, installing, and managing fixes. The topics described below will assist you with
these tasks.

Note: Before applying fixes to the primary partition on a system with logical partitions, be sure to power
down secondary partitions. If you have a logically partitioned iSeries, go to Installing program temporary
fixes on a system with logical partitions for more information.

Common fix management tasks


1. Ordering fixes
Plan to regularly visit IBM’s fix page in order to find the fixes are available to you, those which affect
most users, those which you need before installing new hardware or licensed programs, and those that
come bundled together. Then, get the status of the fixes you’ve ordered. To order fixes electronically,
configure electronic customer support.
v Cover letters
v Authorized program analysis reports (APARs)“Authorized program analysis reports (APARs)” on
page 76
v Cumulative fix packs“Cumulative fix packs” on page 76
v Cross-referenced summary lists“Cross-referenced summary lists” on page 77
v Preventative service packs (PSPs)“Preventative service packs (PSPs)” on page 77
v Fix summary lists“Fix summary lists” on page 78
v Status of fix orders“Status of fix orders” on page 78
Refer the SNDPTFORD command reference table when ordering fixes.

Chapter 8. Managing system operations 69


2. Installing fixes
Once you have selected and ordered the fixes that your system needs, prepare to install them on your
system. Be sure to select the appropriate storage area before beginning the installation. Then, once
the fixes are installed, verify that the installation was successful, and view information about the fix.
a. Prepare to install fixes
b. Choose the appropriate storage area
c. Choose the appropriate type of fix
v Cumulative fix packs
v Licensed internal code fixes
v Licensed program (LP) fixes
d. Verify installation
e. Display fix status“Displaying fix status” on page 85
You can also use Management Central to display the status of all fixes on your system.
f. Display fix information“Displaying fix information” on page 85
3. Managing installed fixes
After fixes have been installed on the system, distribute them across multiple systems using
Management Central. You can also remove fixes that are no longer needed on the system.
v Distributing fixes across multiple systems
You can also use Management Central to distribute fixes across multiple systems.
v Removing fixes

Advanced fix management tasks


Fix installation is generally a two-step process: load and apply. The easiest way to install fixes is to follow
the steps above. If you follow these instructions, the fixes are loaded and applied for you automatically.

Occasionally, you may need to install fixes by loading them first and applying them later. The following
procedures give you information on how to load and apply fixes under special circumstances. If you do not
need to use the load and apply steps separately, follow the steps above to install your fixes.

Note: The methods described in this section are not recommended ways to install fixes. Using these
methods may cause the following error conditions:
v Fix is not applied during an IPL (initial program load) due to missing prerequisites.
v Required distribution requirements are missing after the fix apply.
Therefore, it is recommended that you use the steps above to install all your fixes.

Advanced fix management tasks include:


v Loading fixes
v Applying fixes

Additional information on this topic can be found in these sources:

IBM technical support


Administering Client Access Express service packs

Ordering individual fixes and cover letters


Cover letters are used to explain the contents of a fix, what problem the fix resolves, what special
instructions are associated with the fix, and what prerequisites or corequisites must also be installed on
your system in order for the fix to function properly. See a sample of a cover letter, and learn more about
the information it contains.

70 iSeries: Getting started with iSeries


This topic explains how to order“Ordering cover letters”, copy“Copying a profile” on page 34, display and
print“Displaying and printing fix cover letters” on page 72 cover letters.

Ordering cover letters


You can order up to 20 fixes at a time. To order individual fixes and cover letters electronically, complete
the following steps:
1. On any command line, type SNDPTFORD nnnnnnn where nnnnnnn is the number of the individual fix
you want to order.
2. Press Enter.

When you receive fixes electronically on your service support communications line, they are placed in a
save file in library QGPL. In most cases, the save file name is the fix identifier prefixed with a Q. For
example, the save file for fix identifier SFnnnnn is QSFnnnnn.

Keep the following points in mind:


v If the fix files are too large to be delivered electronically, they are delivered on CD-ROM or tape.
v When you order a fix that has been replaced (superseded) with another fix, you receive the ordered fix,
not the replacement fix. To identify fixes that have been replaced (superseded), consult the fix summary
list.
v When you order a fix for a product that is installed on your system, you will receive a fix package that
contains the ordered fix and its requisites.
v If you order a fix for a product that is not installed on your system, you will receive only the fix that you
ordered. If you use the Display Program Temprorary fix (DSPPTF) command on the fix you just ordered,
you will receive the following message: PTF 5769xxx-SFxxxxx is not found. This message means that
the fix is for a release of the product that is not installed on your system. Contact your service provider
for the correct fix number.

Ordering a fix cover letter only: To order a fix cover letter without ordering the fix, complete these steps:
1. On any command line, type: SNDPTFORD nnnnnnn PTFPART(*CVRLTR)
2. Press Enter.

Specifying media for shipping a fix: You can specify the media for shipping fixes by doing the following:
1. On any command line, type WRKCNTINF.
2. Press Enter. The Work with Support Contact Information display appears.
3. Select Option 2.
4. Press Enter. The Work with Local Service Information display appears.
5. Select Option 2.
6. Press Enter. The Change service contact information display appears.
7. Page down to the next display.
8. Specify the fix medium type by entering the corresponding number.
9. Press Enter.

Copying fix cover letters from CD-ROM or Tape


Fixes on CD-ROM or tape are sent by mail. A shipping information letter is included with the CD-ROM or
tape. Each fix on the CD-ROM or tape may also have a cover letter.

Copy the cover letter into file QAPZCOVER in library QGPL. Make sure that the product that you are
copying the cover letter for is installed.

Copying cover letters from CD-ROM: To copy a cover letter from CD-ROM, do the following:
1. On any command line, type
LODPTF LICPGM(XXXXXXX) SELECT(zzzzzzz) DEV(YYYYY) COVER(*ONLY) PATHID(*FIRST)

Chapter 8. Managing system operations 71


where XXXXXXX is the licensed program number found in the shipping information letter, YYYYY is
the CD-ROM unit ID (typically named OPT01 or OPT02), and zzzzzzz is the fix ID for the cover letter
you want.
2. Repeat step 1 for each licensed program fix cover letter on the CD-ROM.

If you are using this function to simultaneously load fixes and copy fix cover letters, change
COVER(*ONLY) to COVER(*YES). This loads the fix and copies the cover letter onto the system.

Copying cover letters from tape


v If the tape contains multiple fixes, perform these steps:
1. On any command line, type
LODPTF LICPGM(XXXXXXX) DEV(YYYYY) COVER(*ONLY) ENDOPT(*LEAVE)
where XXXXXXX is the licensed program number found in the shipping information letter, and
YYYYY is the tape unit ID (typically named TAP01 or TAP02).
2. Repeat step 1 for each licensed program fix cover letter on the tape except the last licensed
program fix cover letter.
3. For the last fix cover letter on the tape, change ENDOPT(*LEAVE) to ENDOPT(*REWIND).

If you are using this function to simulatneously load fixes and copy fix cover letters, change
COVER(*ONLY) to COVER(*YES). This loads the fix and copies the cover letter onto the system. If
there are multiple fix files on the tape and the *LEAVE option is not specified, you must then specify the
fix sequence number for the Sequence number (SEQNBR) parameter. Your fix sequence number is in
the cover letter that comes with your tape. For each fix package, you need to specify the correct
sequence number.
v If the tape contains only one fix:
On any command line, type LODPTF LICPGM(XXXXXXX) DEV(TAPYY) COVER(*ONLY), where
XXXXXXX is the licensed program number, and YY is the tape device ID.

Displaying and printing fix cover letters


There are two ways to display or print fix cover letters. You should use the first method in most cases. If
you are unable to display or print a cover letter using the first method, use the second method. This may
be necessary, for example, when you want to print or display a cover letter for a product that has not been
installed or supported on your system.

Method 1
1. Enter the Display Program Temporary Fix (DSPPTF) command and press F4 (Prompt). This command
only works for products that are installed or supported.
2. Specify the product, fix identifier, and release for the appropriate parameters on the Display Program
Temporary Fix (DSPPTF) display.
3. Specify *YES for the Cover letter only (COVERONLY) parameter and press Enter to display the cover
letter.

You can also print a fix cover letter using the following command: DSPPTF LICPGM(xxxxxxx)
SELECT(yyyyyyy) COVERONLY(*YES) OUTPUT(*PRINT), where xxxxxxx is the licensed program
number, and yyyyyyy is the fix identification number.

For example, if you wanted to print the Fix Summary List, type the following command on any command
line: DSPPTF LICPGM(5769SS1) SELECT(SF97072) COVERONLY(*YES) OUTPUT(*PRINT). Your output
will be placed in the output queue that is associated with your job. The output is stored under the file
name QSYSPRT.

Method 2

Printing the cover letter:

72 iSeries: Getting started with iSeries


1. On any command line, type cpyf fromfile(QGPL/QAPZCOVER) tofile(QGPL/QPRINT)
frommbr(Qnnnnnnnxx), where Qnnnnnnnxx is the name of the file member in which the fix cover
letter is stored.
Remember, the member containing the cover letter is usually named Qnnnnnnnxx. The Q begins the
member name. The nnnnnnn is either the associated fix number or a time stamp. The xx, if present, is
the last two digits of the language code for the cover letter. For cover letters in English, the last two
digits of the language code do not appear and the member name is the same as the corresponding fix
number preceded by a Q. For example, if the related fix is SF12345 for English, the member name is
QSF12345 (there is no xx. If the related fix is SF12345 for Dutch, the member name is QSF1234523
(the Dutch language code is 2923, so xx is 23 in this case). This is also the case when you are
displaying a cover letter.
2. Press Enter. The file member is copied to the QPRINT print file.
3. On the Operational Assistant menu, select option 1 (Work with printer output). The Work with Printer
Output display is shown.
4. Look in the Printer/Output column for the file name QPRINT. This is the file that contains the cover
letter.
5. If the file is held, you can print the cover letter by selecting option 6 (Release).

Displaying the cover letter:


1. On any command line, type dsppfm (the Display Physical File Member command).
2. Press F4 (Prompt). The Display Physical File Member display is shown.
3. Specify the member name in file QAPZCOVER in library QGPL.
Remember, the member containing the cover letter is usually named Qnnnnnnnxx. The Q begins the
member name. The nnnnnnn is either the associated fix number or a time stamp. The xx, if present, is
the last two digits of the language code for the cover letter. For cover letters in English, the last two
digits of the language code do not appear and the member name is the same as the corresponding fix
number preceded by a Q. For example, if the related fix is SF12345 for English, the member name is
QSF12345 (there is no xx. If the related fix is SF12345 for Dutch, the member name is QSF1234523
(the Dutch language code is 2923, so xx is 23 in this case). This is also the case when you are
displaying a cover letter.
4. Press Enter to see the cover letter.

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Sample cover letter and description of fields


The figure below shows the contents of a typical fix cover letter. A description (See 75) of each field
follows.

5769SS1 5050 0000 SI04400 2924 R02M00


XPF-DSPOBJD-CPF9999-DSPOBJD FUNCTION CHECKS WITH LIN(*) PARM
PTF/FIX # SIxxxxx - OS/400 - BASE SYSTEM
LICENSED PROGRAM: 5769SS1

——————————————————————————————————————————————

SYSTEM LEVEL RELEASE RECOMPILE LIBRARY MRI APAR


MIN/MAX FEATURE FIXED
AS/400 NONE VxRxMx N QSYS 2937 SExxxxx

——————————————————————————————————————————————-

Chapter 8. Managing system operations 73


PRE/COREQUISITE PTF/FIX LIST
——————————————-

REQ LICENSED PTF/FIX LEVEL


TYPE PROGRAM REL NUMBER MIN/MAX OPTION
____ ________ ___ _______ _______ _______
PRE 5769SS1 xxx SIxxxxx NONE 0000
PRE 5769999 xxx MFxxxxx NONE 0000
CO 5769SS1 xxx SIxxxxx NONE 0000
DIST 5769SS1 xxx SIxxxxx NONE 0000
DIST 5769SS1 xxx SExxxxx NONE 0000 (SEE MRI
PTF/FIX LIST
BELOW)

MRI PTF/FIX LIST


————————

APAR SExxxxx AFFECTS THESE LANGUAGES. IF YOU HAVE ANY OF THESE LANGUAGES
INSTALLED, INSTALL THE CO-REQUISITE MRI PTF THAT CORRESPONDS TO THE LANGUAGE(S)
INSTALLED ON YOUR SYSTEM.
—————————————————————————————-

FEATURE LICENSED PTF/FIX


CODE LANGUAGE PROGRAM NUMBER
———- ————————————- ———— ———-
2924 ENGLISH UPPER/LOWER CASE 5769SS1 SIxxxxx
2938 ENGLISH UPPERCASE (DBCS) 5769SS1 SIxxxxx
2950 ENGLISH UPPERCASE 5769SS1 SIxxxxx
2984 ENGLISH U/L (DBCS) 5769SS1 SIxxxxx

DESCRIPTION OF PROBLEM FIXED FOR APAR SExxxxx:


———————————————————————
USERS CANNOT RECEIVE PTFS FOR PRODUCTS NOT INSTALLED
ON THEIR SYSTEMS.

CORRECTION FOR APAR SExxxxx:


——————————————
ELECTRONIC CUSTOMER SUPPORT PROGRAM CODE WILL BE CHANGED SO THAT PTFS WILL
BE REQUESTED EVEN IF THE CORRESPONDING PRODUCTS ARE NOT INSTALLED ON THE
REQUESTING SYSTEM.

CIRCUMVENTION FOR APAR SExxxxx:


———————————————-
NONE.

ACTIVATION INSTRUCTIONS:
———————————————————
NONE.

SPECIAL INSTRUCTIONS:
———————————————————
NONE.

74 iSeries: Getting started with iSeries


DEFAULT INSTRUCTIONS:
———————————
THIS PTF MUST BE APPLIED AT IPL TIME.

SUPERSEDES
PTF/FIX NO(S).áá APAR TITLE LINE
———————áá—————————————————————————————
SIxxxxxááááááááá OSP-RSTS36F-MSGCPA2C6C RESTORING ALL FILES FROM SYSTEM/34

Description of fields:

Field name Description


PTF/Fix # The alphanumeric identifier for the fix or Licensed Internal
Code fix.
Licensed Program The alphanumeric identifier for the licensed program.
System The IBM system for which this fix is valid.
Level Min/Max The lowest and highest level of the product that this fix
can be installed on.
Release The version, release, and modification number of the
system for which this fix is valid. The format for version,
release, and modification number is VxRxMx where x is a
number between 0 and 9.
Recompile Y (Yes) means a recompile of affected objects is
necessary after this fix is applied.
N (No) means a recompile is not necessary after this fix is
applied.
Library The library the fix is intended for.
MRI Feature The numeric identifier for the language feature of the
language sensitive object affected by the fix. None means
language sensitive object is not affected.
APAR Fixed The number of the authorized program analysis report
(APAR) for which this fix was created.
Prerequisite PTF/Fix List The information about the fixes that must be applied on
the system before this fix can be applied.
Corequisite PTF/Fix List The information about other fixes that must be installed
along with this fix. The system will check to ensure all
corequisite fixes are applied together.
Distribution Requisite PTF/Fix List The information about other fixes that must be installed at
the same time as this fix. The system will not verify
distribution requisites are applied together.
MRI Requisite PTF/Fix List The information about other fixes that must be installed at
the same time as this fixes. Select the fixes that
correspond to the languages that you have installed on
your system.
Description of Problem Fixed A brief description of the problem this fix fixes.
Correction A brief description of what has been done to correct the
problem.
Circumvention A description, if applicable, of how to work around the
problem and continue your operation without applying the
fix.
Activation Instructions Actions you must perform in order to activate fixes without
an IPL (initial program load) of the system. Activation
instructions are limited to actions that would normally be
accomplished by an IPL of the system, such as stopping
and restarting a subsystem, varying devices offline and
back online, etc.
Special Instructions Any special information pertaining to this fix.

Chapter 8. Managing system operations 75


Field name Description
Default Instructions Tells when the fix can be applied; either at the next IPL
(delayed) or immediately.
Supersedes PTF/Fix No(s) The numbers of the fixes that this fix replaces or
supersedes.
APAR Title Line The title of the authorized program analysis report (APAR)
for the superseded fix.

Ordering fixes
There are many different kinds of fixes that can be ordered:
v Authorized program analysis reports (APARs)“Authorized program analysis reports (APARs)”
v Cumulative fix packs“Cumulative fix packs”
v Cross-referenced summary lists“Cross-referenced summary lists” on page 77
v Preventative service packs (PSPs)“Preventative service packs (PSPs)” on page 77
v Fix summary lists“Fix summary lists” on page 78
v Status of fix orders“Status of fix orders” on page 78

Authorized program analysis reports (APARs)


Information APARs are created when there is a need to provide worldwide access to information. Typically,
information APARs are created to describe pervasive user errors, provide recovery actions for non-defect
situations, or explain system operation.

To print an Information APAR, do the following:


1. On any command line type DSPPTF LICPGM(INFOAS4) SELECT(xxxxxxx) OUTPUT(*PRINT), where
xxxxxx is the name of the information APAR you are printing.
2. Press Enter. Your printer output will be placed in the output queue that is associated with your job.
3. On the Operational Assistant menu, select option 1 (Work with Printer Output). The Work with Printer
Output display is shown.
4. Look in the Printer/Output column for the name of your spooled file or printer output. This file contains
the information APAR.
5. If the file is held, you can print the information APAR by selecting option 6 (Release).

Cumulative fix packs


To order a cumulative fix package electronically:
1. Identify your licensed program release level:
a.On any command line, type GO LICPGM.
b.Press Enter.
c.Select option 10 (Display installed licensed programs) on the Work with Licensed Programs display.
d.Press F11. The current version, release, and modification level is shown in the Installed Release
column where V is the version, R is the release, and M is the modification level.
2. Type SNDPTFORD SF99VRM, where VRM is the version, release, and modification level you found in
step 1.
For example, for Version 5 Release 1 Modification 0, type SNDPTFORD SF99510.
3. Verify the shipping information on the Verify Contact Information display. If any of the information is
incorrect, change it and press Enter.
4. Select option 1 (Send service request now) on the Select Reporting Option display. This places the fix
order.

76 iSeries: Getting started with iSeries


Cross-referenced summary lists
The fix cross-reference summary list itemizes fixes from an earlier release that are included in the current
release. Use this list to make sure you order any fixes for the new release that you had at the previous
release, but are not included in the list. These fixes will not have the same number, but they correct the
same problem.

To order this list electronically, select the version and release you are moving from and use the
corresponding command. See SNDPTFORD command table for the fix cross-reference summary.

Preventative service packs (PSPs)


Preventive service planning (PSP) information is a collection of information that is used when installing a
licensed program, cumulative fix package, or hardware. PSP information should be reviewed before
installing a licensed program, a cumulative fix package, or hardware. You should order preventive service
planning information and review the recommended High Impact Pervasive (HIPER) fixes periodically.

HIPER fixes fix severe problems such as: your system may crash or hang and requires an IPL (initial
program load) to recover, your system may be stuck in a looping condition, your system’s data integrity
may be threatened, your system may experience a severe performance degradation, or the problem
involves usability of a product’s major function. If any of the fixes are needed for your system, you should
order and install them.

To order PSP information, use the following commands:


v For Licensed programs: SNDPTFORD SF98vrm
v For Licensed Internal Code: SNDPTFORD MF98vrm
where vrm is version, release, and modification level. For Version 5 Release 1 Modification 0, use 510.

To print preventive service planning (PSP) information, use the instructions for printing and displaying fix
cover letters“Displaying and printing fix cover letters” on page 72. The PSP information is placed in
QAPZCOVER when it is sent to you.

Preventive service planning information is available for:


v Licensed programs installation
v Licensed Internal Code
v System equipment
v Cumulative fix packages
v PTFs (fixes) in error (PE)
v High impact or pervasive (HIPER) problems

These PSPs can be ordered through your software service provider or by using electronic customer
support.

Preventive service planning information includes the following:


v Installation information: Information concerning upgrade and new installation, including information
about cumulative fix package installation.
v General information: Hints or tips for working with fix packages or products.
v Fixes in error:Information about all fixes found to have a problem, the users that will be affected by the
problem, and recommendations on how to avoid the problem.
v Service recommendations: Detailed information about critical fixes you need to install.

You should get this information before you install or upgrade system equipment and licensed programs.
This ensures that you have all the latest information that is applicable for the new program or cumulative
package.

Chapter 8. Managing system operations 77


Carefully review the following sections of the PSP before installing the cumulative package:

Service Recommendations: This section lists those High Impact PERvasive (HIPER) problems that have
been discovered in the base code since shipment and not included in this cumulative package. As before,
these recommendations should be reviewed based on your system’s setup and configuration.

PTFs (fixes) in Error (PE): This section contains a list of fixes that are included on this cumulative
package that, since shipment, have been found to be defective. You have two options: install the
cumulative package without applying the fixes in error, or you can install the corrective fixes for the fixes in
error, if available. This section lists the defective fix, the users affected, the reason the fix is defective, and
the recommended action to take.

The PSP information also contains a list of fix identifiers to order PSP information for Licensed Internal
Code and system equipment, licensed programs installation, and PSPs for older cumulative packages.

Fix summary lists


A fix summary list is a cover letter that contains a list of fixes that affect most system users. Use the fix
summary list to identify fixes you may want to order. The fix summary list also identifies the current fix
package and what package each fix was included in.

To order the fix summary list, use the following command: SNDPTFORD SF97vrm , where vrm is version,
release, and modification level. For Version 5 Release 1 Modification 0, use 510.

Status of fix orders


To find the status of fix orders:
1. On any command line, type WRKPRB. Press Enter.
2. All fixes that you requested and have been sent (either electronically or through the mail) are identified
in the Problem Description column as Fix Request on the Work with Problems display.
3. Use option 5 (Display details) for the problem with the problem description Fix Request.
4. Press F9 (Display PTFs) on the Display Problem Details display.
All fixes related to the problem you selected are shown on the Display PTF information display. This
includes the fixes you ordered, in addition to any others requested that are not already on your system.

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Using the SNDPTFORD command to order fixes


The table below shows how to use the Send Fix Order (SNDPTFORD) command to order fixes and fix
information. You may want to print and use this table as a reference when you order fixes.

To process your PTF order in batch, use the Submit Job (SBMJOB) command.

Getting fixes and fix information

Fix Information Command


Specific fixes and cover letters SNDPTFORD nnnnnnn(1)
Fix cover letter only SNDPTFORD nnnnnnn(1)
PTFPART(*CVRLTR)

78 iSeries: Getting started with iSeries


Fix cross-reference summary list SNDPTFORD SF97025
VRM320 to VRM450 SNDPTFORD SF97097
VRM420 to VRM450 SNDPTFORD SF97066
VRM430 to VRM450 SNDPTFORD SF97035
VRM440 to VRM450
Cumulative fix packages SNDPTFORD SF99vrm(2)
PSP information for licensed programs SF98vrm(2)
PSP information for Licensed Internal Code MF98vrm(2)
PTF summary list SF97vrm(2)
Notes:
(1) nnnnnnn is the fix identifier. You can order up to 20 fixes at a time.
(2) v is the version, r is the release, and m is the modification level of the system. For Version 5 Release 1
Modification 0, type 510.

Preparing to install fixes


Before you begin to install fixes, complete these tasks:
v Have a current backup of your user data, operating system and licensed programs. If you have backed
up the operating system and licensed programs since the last time you applied fixes, that backup is
acceptable.
v Have all users sign off the system. If you fail to have all users sign off the system and someone else is
doing a fix operation, the cumulative fix package will not load.
v Before applying a fix to the primary partition of a system with logical partitions, power down the
secondary partitions.
v Be sure you have security officer (*SECOFR) user class. You need it to do the following steps.

Note: get more information before you install fixes on a logically partitioned iSeries.

Choosing a storage area before applying a fix


The system maintains two copies of all Licensed Internal Code on the system. One copy is considered the
permanent copy and is stored on system storage area A. The other copy is considered the temporary
copy and is stored on system storage area B. When the system is running, it uses the copy that was
selected before the last IPL (initial program load).

System storage areas A and B


A B in the Data display on the front panel of the system unit indicates that the next system IPL will be
made from the B or temporary storage area. The B storage area contains any Licensed Internal Code
fixes that have been temporarily or permanently applied. Temporarily applied Licensed Internal Code fixes
can be applied permanently (copied to the A storage area) or be permanently removed.

For the system to use the latest Licensed Internal Code fixes that are temporarily applied, you must be
using the B storage area. The B storage area is what you normally use. Select the A storage area if the
IPL to the B storage area fails because of a temporarily applied Licensed Internal Code fix.

Selecting the A or B storage area: You can change the storage area on the command line or the control
panel:
v On the command line, type PWRDWNSYS *IMMED RESTART(*YES) IPLSRC(X), where X is the
storage area you want to select.
v On the control panel:
1. For systems with a mode button, set the system to the Manual mode. For systems without a mode
button, start at step 2.

Chapter 8. Managing system operations 79


2. Press the Increment/Decrement buttons until 02 is displayed in the Function/Data display on the
control panel.
3. Press the Enter pushbutton on the control panel.
4. For systems with a mode button, press the Increment/Decrement buttons until the character that
represents the storage area you want to use for your IPL source (A or B) appears in the
Function/Data display. For systems without a mode button, press the Increment/Decrement buttons
until you see Normal (N) and the character (A or B) for the IPL storage area you want to appear in
the Function/Data display.
5. Press the Enter pushbutton on the control panel to save the IPL settings.
6. For systems with a mode button, set the mode to Normal.
7. Power off the system using option 4 (Power off the system and immediately power on) on the Power
On and Off Tasks (POWER) menu.
Wait for the system to power down and automatically start an IPL. You see the Sign On display
when the IPL is complete. The storage area is now changed.

Installing a cumulative fix pack


If your system changes to a new release, order and install the current cumulative fix package to keep your
system at the most current fix level.

To install cumulative fix packages:


1. Read the fix shipping information letter thoroughly and follow the instructions contained in it. You
should be running on the B storage area (B side) when installing the cumulative fix packages.
2. Select the storage area if you have not already done so.

Displaying or printing the cumulative fix package summary

To print or display the summary of fixes contained in a cumulative fix package on CD-ROM:
1. Load the cumulative fix package CD-ROM in the CD-ROM drive.
2. On any command line, type LODPTF LICPGM(5769999) DEV(OPTYY) SELECT(*ALL)
PATHID(*FIRST) COVER(*ONLY), where YY is the unit ID for the CD-ROM drive in which you loaded
the fix CD-ROM.
For information about printing the cumulative fix package summary, see Displaying and printing fix
cover letters“Displaying and printing fix cover letters” on page 72. A copy of the fix summary is put into
file QAPZCOVER in Library QGPL.

To print or display the summary of fixes contained in a cumulative fix package on tape:
1. Load the cumulative fix package tape in the tape unit.
2. On any command line, type CPYFRMTAP FROMFILE(QTAPE) TOFILE(QPRINT) FROMSEQNBR(3)
FROMDEV(TAPYY) FROMREELS(*SL), where YY is the tape unit ID (for example, TAP01) in which
you loaded the fix tape.
A copy of the fix summary is put into a system output queue from which you can print or display the fix
summary information.

Installing High-Impact Pervasive (HIPER) fixes from a cumulative fix package:

To install both high-impact pervasive (HIPER) fixes and HIPER Licensed Internal Code fixes, follow the fix
installation instructions in the shipping information letter. When you are on the Install Options for Program
Temporary Fix display, specify 2 for the PTF type field. To install only HIPER Licensed Internal Code fixes,
specify 3 for the PTF type field.

Verifying installation of the cumulative fix package:

80 iSeries: Getting started with iSeries


After completing the last IPL (initial program load) in the installation instructions, to verify that the fix
package was properly installed:
1. On any command line, type go licpgm.
2. Press Enter.
3. Select option 50 (Display log for messages) on the Work with Licensed Programs display.
4. Fill in the start date and start time on the Display Install History display.
5. Press Enter.
6. On the Display History Log Contents display, if the cumulative fix package was installed successfully,
you see messages like the following:

Licensed program or PTF installation process started.


Loading of PTFs completed successfully.
Marking of PTFs for delayed application started.
Marking of PTFs for delayed application completed successfully.
Apply PTF started.
Applying of PTFs for product 5769xxx completed successfully.
Applying of PTFs for product 5769xxx completed successfully.
Applying of PTFs for product 5769xxx completed successfully.
.
.
.
Applying of PTFs completed.

If the cumulative fix package was not installed successfully, you see error messages like the following:

Licensed program or PTF installation process started.


Loading of PTFs failed.
Marking of PTFs for delayed application started.
Marking of PTFs for delayed application failed.
Apply PTF started.
.
.
.
Applying of PTFs failed for product 5769xxx.
.
.
.
Applying PTFs failed.

Displaying the cumulative fix package level of your system: The cumulative fix package level of your
system refers to the latest cumulative fix package installed on your system. To determine the cumulative
fix package level of your system:
1. On any command line, type DSPPTF LICPGM(5769SS1)
2. The PTF ID column on the Display PTF Status display lists the identifiers for all of the cumulative fix
packages installed on your system. Cumulative fix package identifiers start with the letter T.
If you are using Version 4 Release 3 Modification 0, and you have PTF TC94178 installed on your
system, your cumulative fix package level is C4178430 (430 is added to the end of the package ID to
indicate Version 4 Release 3 Modification Level 0). The last four digits of the cumulative package ID
indicate the release date of the package, using the Julian calendar. The latest cumulative fix package
is the one where the last four digits are the highest.
Note: Fix IDs that start with the letters TC indicate that the entire CD-ROM or tape has been applied.
Fix IDs that start with the letters TA indicate that the HIPER fixes and HIPER Licensed Internal Code

Chapter 8. Managing system operations 81


fixes have been applied. Fix IDs that start with the letters TL indicate that the HIPER Licensed Internal
Code fixes have been applied. To find the level of Licensed Internal Code fixes on your system, enter
DSPPTF 5769999.

Omitting individual fixes from a cumulative package: The omit function allows you to specify
individual fixes that you do not want to install from the cumulative package. To use the omit
function, do the following:
1. On the Install Options for Program Temporary Fixes display, specify Y for the Other options field, and
press Enter. The Other Install Options display is shown.
2. Specify Y for the Omit PTFs field, and a value for the Apply Type field, and then press Enter. The
Omit Program Temporary Fixes display is shown.
3. In the Opt Column, type a 1 next to each product and release for which you want to omit specific fixes
from being installed, and press Enter. The PTFs to Omit display is shown for each product that was
selected on the previous display. This display shows the list of fixes that are to be omitted from being
loaded for the specified product and release.
4. To add fixes to the list on the PTFs to Omit display, type a 1 on the first line of the Opt column and
specify the fix ID in the PTF ID column. Press Enter.
5. Repeat step 4 until you have specified all of the fixes you want to omit from being installed for the
product and release. Press Enter again and repeat the procedure for the next product and release you
selected on the Omit Program Temporary Fixes display. When you are done with the last product and
release you have selected, the Omit Program Temporary Fixes display is shown again. The > symbol
next to the product and release indicates that you have specified fixes to be omitted. Press Enter. The
Confirm to Omit PTFs panel is shown.
6. The Confirm to Omit PTFs panel lists each of the fixes that have been specified to be omitted from
being installed. If the list is correct, press Enter. Normal fix installation process continues from this
point.

Remember, you can install fixes using the power on and power off schedules.

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Installing licensed internal code fixes


There are two types of Licensed Internal Code fixes: Delayed and immediate.

Delayed Licensed Internal Code fixes can only be applied immediately while running on the A side, or can
be applied delayed while running on the B side.

Immediate Licensed Internal Code fixes can be applied immediately while running on the A or B storage
area. No IPL (initial program load) is required for applying immediate fixes.

You must be running on the B storage area to use any temporarily applied Licensed Internal Code fixes.
Temporarily applied Licensed Internal Code fixes can be applied permanently (copied to the A storage
area). To permanently apply delayed or immediate Licensed Internal Code fixes, you must be running from
the B storage area. These fixes can be permanently applied without an IPL.

Licensed Internal Code fixes to be applied on the next IPL while running on the A side must be applied
immediately. More information can be found in Applying fixes (in advanced fix management tasks).

82 iSeries: Getting started with iSeries


Installing Licensed Internal Code Fixes: For immediate Licensed Internal Code fixes that will be applied
immediately without an IPL, see the instructions in Applying Licensed Internal Code fixes without an
IPL“Temporarily or permanently installing immediate licensed program or OS/400 fixes without an IPL” on
page 97.

For delayed Licensed Internal Code fixes and immediate Licensed Internal Code fixes that will be applied
during an IPL, use the following instructions:
1. Print and read each cover letter“Displaying and printing fix cover letters” on page 72.
2. If there are any pre-installation special instructions in any of the cover letters, follow those instructions
first.
NOTE: Do not cancel any of the following steps once they are started. Allow each step to complete
normally.
If shipping information letters are included with the fix CD-ROM or tape you received, follow the
instructions in the letters to install the fixs. If the shipping information letters are not included with the
CD-ROM or tape, continue with the following instructions.
3. Determine the storage area you are currently using:
a. On any command line, type dspptf 5769999 and press Enter.
b. On the Display PTF Status display, the storage area is identified in the IPL source field.
##MACH#A is the A storage area and ##MACH#B is the B storage area.
c. If you are not running on the B storage area, type the following command on any command line
and press Enter: PWRDWNSYS *IMMED RESTART(*YES) IPLSRC(B)
4. On any command line, type go ptf and press Enter.
5. Select option 8 (Install program temporary fix package) on the Program Temporary Fix (PTF) display.
The Install Options for Program Temporary Fixes display is shown.
6. Enter the appropriate value in the Device field from the list below:
v If the fix was delivered electronically, type *service.
v If the PTF was delivered on a tape, type tapyy, where yy is the name of the tape unit (for example,
tap01) where you loaded the fix tape.
v If the fix was delivered on CD-ROM, type optyy, where yy is the name of the CD-ROM drive unit
(for example, opt01) where you loaded the fix CD-ROM.
v If you do not want to install certain fixes, you can omit those fixess by using the procedure called
Omitting individual fixes from a cumulative package (See 82).
v If you have additional fixes to install at this time, type an N (No) in the Automatic IPL field and install
the additional fixes. If you do not have additional fixes to install at this time, type a Y (Yes) in the
Automatic IPL field.
Although it will take longer than previous releases to set Licensed Internal Code fixes for apply on the
next IPL, the next IPL will take much less time.
7. Press Enter.
After the IPL has finished, verify that the fixes are installed. If there are any post-installation special
instructions in the cover letter, follow those instructions at this time.

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Installing licensed program (LP) fixes


For immediate OS/400 fixes that will be applied immediately without an IPL (initial program load), see the
instructions in Applying Immediate Licensed Program or OS/400 PTFs Temporarily or Permanently Without
an IPL.

Chapter 8. Managing system operations 83


For licensed program fixes, delayed OS/400 fixes, or Immediate OS/400 fixes that will be applied during
an IPL, use the following instructions:
1. Print and read each cover letter“Displaying and printing fix cover letters” on page 72.
2. If there are any pre-installation special instructions in any of the cover letters, follow those instructions
first.
Note: Do not cancel any of the following steps once they are started. Allow each step to complete
normally.
3. On any command line, type go ptf and press Enter.
v If you do not want to install certain fixes, you can omit them by using the procedure called Omitting
individual fixes from a cumulative package (See 82).
v If you have additional fixes to install at this time, type an N (No) in the Automatic IPL field and install
the additional fixes. If you do not have additional fixes to install at this time, type a Y (Yes) in the
Automatic IPL field.
4. Select option 8 (Install program temporary fix package) on the Program Temporary Fix (PTF) display.
5. If the fix was delivered electronically, type *service in the Device field. If the fix was delivered on a
tape, type tapyy, where yy is the name of the tape unit (for example, tap01) where you loaded the fix
tape. If the fix was delivered on CD-ROM, type optyy, where yy is the name of the CD-ROM drive unit
(for example, opt01) where you loaded the fix CD-ROM.
Note: Fixes may not be applied successfully during an IPL if the IPL is abnormal.
6. Press Enter.

After the IPL has finished, verify that the fixes are installed. If there are any post-installation special
instructions in the cover letter, follow those instructions at this time.

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Verifying the fix installation


To verify that your Licensed Internal Code and licensed program PTFs have been installed correctly, do
the following:
1. On any command line, type GO LICPGM and press Enter. The Work with Licensed Programs display
appears.
2. Select Option 50 (Display log for messages). The Display Install History display appears.
3. Fill in the start date and start time on the Display Install History display and press Enter. The
messages about fix installation are shown.

When fixes do not install


To determine the cause of the failure, do the following:
1. Place the cursor on the previous message and press F10 (Display all). If F10 (Display all) is not
available, switch to intermediate assistance level using F21 (Select assistance level) and try again.
2. A new message is shown that helps you find out what errors occurred. Use the Help key to display
additional message information.

You can also look at the SCPF job log for errors. To check this job log, do the following:
1. On any command line, type WRKSPLF SELECT(QSYS *ALL *ALL SCPF) ASTLVL(*INTERMED)
2. The Work with All Spooled file display appears. Find the last spooled file named QPJOBLOG. Use
Option 5 (Display) to see if any errors are listed.

OS/400 fix and licensed program activity does not occur during an unattended IPL (initial program load)
that immediately follows an abnormal system end.

84 iSeries: Getting started with iSeries


If an abnormal IPL occurs, and Licensed Internal Code fixes were ready to be applied, the Licensed
Internal Code fixes will now be applied. To apply the fixes after an abnormal IPL to storage area B, type:
PWRDWNSYS *IMMED RESTART(*YES) IPLSRC(B).

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Displaying fix status


To determine the status of the fixes for products that are installed and supported on your system:
1. Enter the Display PTF (DSPPTF) command and press F4 (Prompt).
2. Specify the licensed program number and fix identifier for the product (LICPGM) parameter and for the
fix numbers to select (SELECT) parameter. If you want to see the status for all the products on the
system, specify *ALL for both parameters and press Enter until all the licensed programs are
displayed.
3. The Display Program Temporary Fix display shows the action that will be taken for a fix at the next
unattended IPL (initial program load).

The status of a fix can be:

Status Description
On order Ordered but not received by the system. They may reside
on a tape, CD-ROM, be sent electronically, or copied from
a tape.
Cover letter only A cover letter exists for the fix.
Save file only PTF exists in a save file in library QGPL.
Not applied Loaded but not applied.
Temporarily applied Applied temporarily
Temporarily applied - PND Applied temporarily - Pending
Temporarily applied - ACN Applied temporarily - Action
Permanently applied Applied permanently
Permanently applied - PND Applied permanently - Pending
Permanently applied - ACN Applied permanently - Action
Temporarily removed Removed temporarily
Temporarily removed - PND Removed temporarily - Pending
Temporarily removed - ACN Removed temporarily - Action
Permanently removed - PND Removed permanently - Pending
Permanently removed - ACN Removed permanently - Action
Superseded PTF is replaced by another.
Damaged A PTF object cannot be found (perhaps accidentally
removed). The PTF must be loaded again before you can
apply it or remove it.

The pending and action status indicate that additional actions need to be taken to make the PTF active or
inactive. PND means the PTF status will be updated after the actions are taken. ACN means the PTF status
will not be updated until the next IPL as no exit program was provided to verify that the actions were
actually performed. Temporarily applied - ACN does not mean that the fix is not in effect. It means that
the system cannot verify that it is in effect.

Displaying fix information


You can find out general information about a fix by doing the following:
1. On any command line, type DSPPTF. The display PTF Status display appears.

Chapter 8. Managing system operations 85


2. Select the specific fix that you want to display, and then Option 5 (Display PTF details). The Display
PTF menu appears.
3. Select Option 1 (General information). The General information display appears.

The following describes each parameter on the General information display:

Parameter Description
On order Specifies whether the fix is on order. Yes indicates that the
fix is on order, but may or may not be on the system. No
indicates that the fix is not ordered.
PTF save file Specifies whether a save file exists for the fix.
PTF status Specifies the current status of the fix. The fix status field
on the Display information display may differ from the
Status field on the Display PTF status panel for several
reasons:
v If there has been a change in status since the Display
PTF Status display is shown, the General information
display shows the updated status.
v The Status field on the Display PTF Status display is a
combination of the fix status field, and the Action
pending and Action required fields on the General
information display.
v If the system encountered an error while building the fix
information file, the fix status is updated when the
General information display is shown.
Type Specifies whether the fix is immediate or delayed
Unattended IPL action Specifies the action that will occur on the next unattended
IPL (initial program load).
Option part Specifies the option that this fix is for.
PTF library Specifies the library this fix is installed into.
Cover letter Specifies whether there is a cover letter for this fix.
Mandatory instructions Specifies whether there are instructions that need to be
performed before this fix is applied.
Action pending Specifies whether there is an action that needs to be
performed. If YES is specified for this field, an action
needs to be taken to make the fix active or inactive. If NO
is specified, it means the fix is active.
Action required Specifies whether an action is required to make this fix
active after it has been applied.
Target OS/400 Release Specifies the release of the operating system this fix can
be copied to or loaded on.
Minimum-maximum level Specifies the lowest and highest level of the product that
this fix can be installed on. fixes are able to span multiple
levels of a system.

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Distributing fixes to remote systems


You can distribute some or all the fixes you receive to a remote system. Fixes that are in a save file can
be sent to remote systems electronically. You can also use Management Central to distribute fixes across
multiple systems.

86 iSeries: Getting started with iSeries


Note: When preparing a fix package to send to a remote system, make sure that the model of the remote
system unit is compatible with the model of system unit required for the fixes (shown on the cover letter as
Models).
v Combine some or all the fixes you received electronically into a single fix save file so you can send it
electronically to a remote system.
Note:You cannot combine fixes from different languages, releases, or superseded fixes into one save
file.
v Copy one or more fix files from CD-ROM or tape to a fix save file so you can send it electronically to a
remote system.

If the fixes are already in a save file, use object distribution to send the save files electronically to the

remote system. See the SNA Distribution Services book for more information about using object
distribution.

If you ordered and received a fix electronically for another system that has a newer release than the one
on your system, you cannot load, copy, or display that fix on your system, but you can send that fix to the
remote system using object distribution.

Loading, Applying, and Removing PTFs Automatically at Remote Systems


To load fixes on remote systems follow the instructions in Installing Licensed Program or OS/400 fixes.

To load fixes received through the distribution services network:


1. On any command line, type LODPTF LICPGM(xxxxxxx) DEV(*SAVF) SELECT(nnnnnnn), where
xxxxxxx is the licensed program number and nnnnnnn is the fix identifier.
2. Type APYPTF (the Apply Fix command) to apply the fixes.

To load PTFs from device *SERVICE, do the following:


Note: Loading fixes from device *SERVICE is only valid if one fix exists in the savefile.
1. Use the QPZGENNM application program interface (API) to generate a name for the fix save file.
2. Store the fix save file in the library returned from the API.
3. Once the fix exists in the save file, use the QPZLOGFX API to store the information about the fix in the
fix database.
4. On any command line, type: LODPTF LICPGM(xxxxxxx) SELECT(nnnnnnn) FROMDEV(*SERVICE)
, where xxxxxxx is the licensed program number and nnnnnnn is the PTF identifier.

For more detailed information about the QPZGENNM and QPZLOGFX APIs, see the Programming topic in
the Information Center.

To have fixes applied automatically at the next unattended IPL (initial program load) on a remote system,
specify the delayed parameter value as *YES. If the next IPL at the remote system is attended, the Select
Products to Work with PTFs (fixes) display is shown and the operator can choose to apply or not to apply
the fixes. If the operator chooses not to apply the fixes, they are applied automatically during the next
unattended IPL.

To remove delayed fixes from remote systems (see Removing fixes), specify *YES for the Delayed PTFs
field to remove fixes during the next unattended IPL. If the next IPL on the remote system is attended, the
Work with PTFs display is shown and the operator can choose to remove or not to remove the fixes. If the
operator chooses not to remove the fixes, they are removed automatically during the next unattended IPL.

Building a tailored fix package


The following example shows you how to build your own fix package that can be used the same way as a
fix package supplied by IBM service support. This example combines a fix package with individual fixes
into a tailored fix package for distribution to other iSeries systems in your network.

Chapter 8. Managing system operations 87


You can also use Management Central to complete these tasks.

The order of a cumulative PTF package is:


1. High-impact pervasive (HIPER) Licensed Internal Code Fixes (5769999)
2. HIPER OS/400 fixes (5769SS1)
3. HIPER licensed program fixes
4. A delimiter which divides the HIPER fixes from the non-HIPER fixes (5769111)
5. Non-HIPER Licensed Internal Code fixes
6. Non-HIPER OS/400 fixes
7. OS/400 online information fixes (if any)
8. Non-HIPER licensed program fixes

For this example, assume that you want a tape that contains all but one (SF00600) of the fixes from the
most recent fix package on CD-ROM or tape received from IBM service support, including the high-impact
pervasive (HIPER) fixes. In addition, you want to include four individual fixes received electronically from
service support. These four fixes are MF00050, SF00480, SF00500, and SF00800.

Because the four individual fixes were received from IBM service support, they already exist in save files
in library QGPL. They exist in the library as object type *file, as shown below:
File Name Object Type
QMF00050 *FILE
QSF00480 *FILE
QSF00500 *FILE
QSF00800 *FILE

The following shows the procedures for building a tailored fix package from CD-ROM or tape.

Tailoring a PTF Package From Tape:


1. Find out the sequence number of the fix file you want to copy from the fix cumulative package by using
the Display tape (DSPTAP) command:
DSPTAP DEV(TAP01) DATA(*LABELS) OUTPUT(*PRINT)

The Display Spooled File display is shown. The product identifier is listed in the Data File Label
column, and the fix file sequence number is listed in the File Seq column. For example, to copy fix for
product RPG/400(R), first find the data file label that identifies the product with an extension of A00,
then find the corresponding sequence number. According to the figure below, the product identifier is
P5769RG1.A00 and the file sequence number is 7.

Display Spooled File display


+--------------------------------------------------------------------------------+
| Display Spooled File |
|File . . . . . : QPTAPDSP Page/Line 1/1 |
|Control . . . . . á Columns 1 - 78 |
|Find . . . . . . á |
|5769SS1 V4R1M0 TAPE VOLUME INFORMATION C4123410 |
|Device . . . . . : TAP01 Volume . . . . . : C4123410 |
|Owner ID . . . . : Density . . . . : *QIC120 |
|Type . . . . . . : *SL Code . . . . . . : *EBCDIC |
| Record |
| File Block Recg Record Block File Mvol Mvol |
|Data File Label Seq Format Tech Length Length Length Ind Seq |
|P5769999.A00 0001 *U 00000 32760 000002 0001 |
|P5769999.A01 0002 *U 00000 32760 000016 0001 |
|P5769999.A02 0003 *U 00080 32760 000066 0001 |
|P5769SS1.A00 0004 *U 00000 32760 000002 0001 |
|P5769SS1.A01 0005 *U 00000 32760 000013 0001 |
|P5769SS1.A02 0006 *U 00080 32760 000066 0001 |

88 iSeries: Getting started with iSeries


|P5769RG1.A00 0007 *U 00000 32760 000002 0001 |
|P5769RG1.A01 0008 *U 00000 32760 000013 0001 |
|P5769RG1.A02 0009 *U 00080 32760 000066 0001 |
| More... |
|F3=Exit F12=Cancel F19=Left F20=Right F24=More keys |
| |
+--------------------------------------------------------------------------------+

Display Spooled File display - screen 2


+--------------------------------------------------------------------------------+
| Display Spooled File |
|File . . . . . : QPTAPDSP Page/Line 1/23 |
|Control . . . . . á Columns 1 - 78 |
|Find . . . . . . á |
|P5769111.A00 0010 *U 00000 32760 000002 0001 |
|P5769111.A01 0011 *U 00000 32760 000016 0001 |
|P5769111.A02 0012 *U 00080 32760 000066 0001 |
|P5769999.A00 0013 *U 00000 32760 000002 0001 |
|P5769999.A01 0014 *U 00000 32760 000013 0001 |
|P5769999.A02 0015 *U 00080 32760 000066 0001 |
|P5769SS1.A00 0016 *U 00000 32760 000002 0001 |
|P5769SS1.A01 0017 *U 00000 32760 000016 0001 |
|P5769SS1.A02 0018 *U 00080 32760 000066 0001 |
| |
| |
| |
| |
| |
| |
| |
| Bottom |
|F3=Exit F12=Cancel F19=Left F20=Right F24=More keys |
| |
+--------------------------------------------------------------------------------+
2. Use the Copy Program Temporary Fix (CPYPTF) command to bring the HIPER fixes from the
cumulative fix package into library QGPL. Two licensed programs are being used in this example (MF
and SF PTFs).
CPYPTF LICPGM(5769999)
FROMDEV(TAP01)
TODEV(*SAVF)
FROMSEQNBR(1)
FROMENDOPT(*LEAVE)
TOSAVF(QGPL/PCUMH999)

CPYPTF LICPGM(5769SS1)
FROMDEV(TAP01)
TODEV(*SAVF)
FROMSEQNBR(4)
FROMENDOPT(*LEAVE)
TOSAVF(QGPL/PCUMHSS1)
3. Copy the product delimiter into a save file.
CPYPTF LICPGM(5769111)
FROMDEV(TAP01)
TODEV(*SAVF)
SELECT(*ALL)
FROMSEQNBR(10)
FROMENDOPT(*LEAVE)
TOSAVF(QGPL/PCUMH111)
4. Copy the non-HIPER fixes from the cumulative package into a save file omitting the unwanted fixes.
CPYPTF LICPGM(5769999)
FROMDEV(TAP01)
TODEV(*SAVF)
FROMSEQNBR(13)

Chapter 8. Managing system operations 89


FROMENDOPT(*LEAVE)
TOSAVF(QGPL/PCUMP999)

CPYPTF LICPGM(5769SS1)
FROMDEV(TAP01)
TODEV(*SAVF)
OMIT(SF00600)
FROMSEQNBR(16)
FROMENDOPT(*LEAVE)
TOSAVF(QGPL/PCUMPSS1)

Tailoring a fix Package From CD-ROM:


1. Find out the path identifier for the fix file you want to copy from the fix cumulative package:
Note: A path identifier is a 1 to 6-digit number that identifies each fix file on the CD-ROM. Each release
of a licensed product on the CD-ROM has its own unique set of identifiers. Each set of path identifiers
for the product begins with the number 1 indicating the first fix file for the product and release. This
first fix file may or may not contain HIPER fixes for the product.
To get the path identifier for each fix file you want to copy from the cumulative fix package for your
product, use the Copy Program Temporary Fix (CPYPTF) command, and specify PATHID(*SELECT).
The Select PTF CD-ROM File display is shown.
Select PTF CD-ROM File display
+--------------------------------------------------------------------------------+
| Select PTF CD-ROM File |
| System: SYSNAMXX |
|Product . . . . . . . . : 5769SS1 |
| |
|Type option, press Enter. |
|1=Select |
| |
| National |
| Feature Language Path Hiper |
|Opt Release Type Version Identifier PTFs |
|á V4R4M0 *CODE 1 Yes |
|á V4R4M0 *CODE 2 No |
|á V4R4M0 *LNG 2924 2 No |
+--------------------------------------------------------------------------------+
2. Use the Copy Program Temporary Fix (CPYPTF) command to bring the HIPER fixes from the
cumulative fix package into library QGPL. Two licensed programs are being used in this example (MF
and SF PTFs). You can identify the HIPER fix files on the Select PTF CD-ROM File panel by a Yes in
the Hiper PTFs column.
CPYPTF LICPGM(5769999)
FROMDEV(OPT01)
TODEV(*SAVF)
FROMPATHID(1)
TOSAVF(QGPL/PCUMH999)

CPYPTF LICPGM(5769SS1)
FROMDEV(OPT01)
TODEV(*SAVF)
FROMPATHID(1)
TOSAVF(QGPL/PCUMHSS1)
3. Copy the product delimiter into a save file.
CPYPTF LICPGM(5769111)
FROMDEV(OPT01)
TODEV(*SAVF)
SELECT(*ALL)
FROMPATHID(1)
TOSAVF(QGPL/PCUMH111)
4. Copy the non-HIPER fixes from the cumulative package into a save file omitting the unwanted fixes.

90 iSeries: Getting started with iSeries


CPYPTF LICPGM(5769999)
FROMDEV(OPT01)
TODEV(*SAVF)
FROMPATHID(2)
TOSAVF(QGPL/PCUMP999)

CPYPTF LICPGM(5769SS1)
FROMDEV(OPT01)
TODEV(*SAVF)
OMIT(SF00600)
FROMPATHID(2)
TOSAVF(QGPL/PCUMPSS1)

Creating the tailored fix cumulative tape: Repeat the command for each licensed program with
non-HIPER fixes. The OMIT parameter was used to identify the fix not included in the tailored package.
The TOSAVF name must be 8 characters in length and must start with the letter P. You can choose the
remaining seven characters. The library on the TOSAVF parameter must be QGPL.

Library QGPL now contains:


File Name Object Type
QMF00050 *FILE
QSF00480 *FILE
QSF00500 *FILE
QSF00800 *FILE
PCUMH999 *FILE
PCUMHSS1 *FILE (plus more for HIPERs of licensed programs)
PCUMH111 *FILE
PCUMH999 *FILE
PCUMPSS1 *FILE (plus more for non-HIPERs of licensed programs)

1. Initialize the tape for the tailored cumulative package.


INZTAP DEV(TAP01)
NEWVOL(CUMPKG)
2. Copy the Licensed Internal Code HIPER fixes into one file and place it first on the tape.
CPYPTF LICPGM(5769999)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMH999)
TOENDOPT(*LEAVE)

The TOENDOPT(*LEAVE) parameter is used to maintain tape position.


3. Copy the OS/400 HIPER fixes onto the tape.
CPYPTF LICPGM(5769SS1)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMHSS1)
TOENDOPT(*LEAVE)

Repeat for each licensed program with HIPER fixes.


4. Copy the delimiter to the tape.
CPYPTF LICPGM(5769111)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMH111)
TOENDOPT(*LEAVE)
5. Copy the non-HIPER Licensed Internal Code fixes into one file and place on the tape.

Chapter 8. Managing system operations 91


CPYPTF LICPGM(5769999)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMP999 MF00050)
TOENDOPT(*LEAVE)
6. Copy the non-HIPER OS/400 fixes into one file and place on the tape.
CPYPTF LICPGM(5769SS1)
FROMDEV(*SERVICE)
TODEV(TAP01)
SELECT(CUMPSS1 SF00480 SF00500 SF00800)
TOENDOPT(*LEAVE)

Repeat for each licensed program with non-HIPER fixes.

The tape now contains the tailored fix package. It can be used in the same way that your service support
fix packages are used.

Fixes can now be loaded on, applied to, or removed from a system.

Removing fixes
You can remove fixes that are temporarily installed. Delayed fixes temporarily installed can be removed
temporarily when you do an IPL (initial program load) and then removed permanently without doing an
IPL. Immediate fixes temporarily installed can be removed either temporarily or permanently without doing
an IPL. You can also remove immediate fixes that have been loaded but not applied. Fixes permanently
installed cannot be removed.

When fixes are removed temporarily, the original objects that were replaced by the fix are restored to the
program library. The system again verifies that the fix being removed is not required for any other currently
applied fix. If the fix being removed is found to be required, the other fix (that it is required for) must be
removed first or at the same time.

Note:
v Before you remove a fix, be sure that the object affected by the immediate fix is not in use.
v Licensed Internal Code fixes can only be removed permanently.

Removing licensed program fixes


To remove one or more licensed program fixes:
1. Enter the Remove Program Temporary Fix (RMVPTF) command and press F4 (Prompt).
2. On the Remove Program Temporary Fix (RMVPTF) display, type the character value of the licensed
program (shown on the cover letter) for the Product (LICPGM) parameter.
3. Select the fixes you want removed by doing one of the following:
v Specify the numbers of the fixes you want to remove for the PTF numbers to select (SELECT)
parameter or *ALL to remove all of them.
Note: Specify RMVDEP(*YES) when specific fix numbers are entered on the SELECT parameter to
ensure that dependents in the same product are also removed.
v Specify *ALL for the PTF numbers to select (SELECT) field and the numbers of specific fixes you do
not want to remove for the PTF numbers to omit (OMIT) parameter.
4. Specify *TEMP for the Extent of change (APY) parameter to remove the fixes temporarily or *PERM to
remove the fixes permanently.
5. If you are removing immediate fixes, specify *NO for the Delayed PTFs (DELAYED) parameter.
6. If you are identifying delayed or immediate fixes that are to be automatically removed during the next
unattended IPL, specify *YES for the Delayed PTFs (DELAYED) parameter and *YES for the Remove
on unattended IPL (IPLRMV) parameter.
7. Press Enter.

92 iSeries: Getting started with iSeries


Removing OS/400 fixes
v To remove an immediate OS/400 fix temporarily:
Type RMVPTF LICPGM(5769SS1) SELECT(SFxxxxx) RMV(*TEMP) RMVDEP(*YES), where xxxxx is
the fix identifier.
Note: if the fix is only temporarily removed, it will be applied again with the next cumulative fix package.
v To remove an immediate OS/400 fix permanently:
Type RMVPTF LICPGM(5769SS1) SELECT(SFxxxxx) RMV(*PERM) RMVDEP(*YES), where xxxxx is
the fix identifier.
v To remove a delayed OS/400 fix temporarily:
1. Type RMVPTF LICPGM(5769SS1) SELECT(SFxxxxx) RMV(*TEMP) DELAYED(*YES)
RMVDEP(*YES), where xxxxx is the fix identifier.
2. Type the following command and press Enter to do an IPL to the B side: PWRDWNSYS
OPTION(*IMMED) RESTART(*YES) IPLSRC(B)
v To remove a delayed OS/400 fix permanently:
1. Temporarily remove the delayed fix first.
2. Type RMVPTF LICPGM(5769SS1) SELECT(SFxxxxx) RMV(*PERM) RMVDEP(*YES), where xxxxx
is the fix identifier.

Removing licensed internal code fixes


v To remove an immediate fix for the Licensed Internal Code temporarily, use the following command:
RMVPTF LICPGM(5769SS1) SELECT(SFxxxxx) RMV(*PERM) RMVDEP(*YES), where xxxxx is the fix
identifier.
v To remove a delayed licensed internal code fix temporarily, do the following:
1. Type the following command and press Enter: RMVPTF LICPGM(5769999) SELECT(MFxxxxx)
RMV(*PERM) DELAYED(*YES) RMVDEP(*YES), where xxxxx is the Licensed Internal Code
identifier.
2. Type the following command and press Enter to do an IPL to the B side: PWRDWNSYS
OPTION(*IMMED) RESTART(*YES) IPLSRC(B)

Removing individual fixes in a cumulative package before the next IPL


To remove a fix from a fix cumulative package after you have already selected option 8 (Install program
temporary fix package) on the Program Temporary Fix (PTF) menu, but before the IPL has been done,
enter the following command: APYPTF LICPGM(XXXXXXX) SELECT(YYYYYYY) DELAYED(*YES)
APY(*TEMP) IPLAPY(*NO), where XXXXXXX is the licensed program and YYYYYYY is the number of the
fix you want to omit.

This resets the IPL apply indicator to IPL Action NONE. If you receive an error message, check the job
log. If you receive message CPF3608, this fix has fixes that depend on it. You must omit these dependent
fixes before omitting the original fix. The status of the omitted fixes will remain Not applied during
subsequent IPLs. When you are finished omitting fixes, enter the following command to complete the
cumulative package installation: PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(B)

Deleting fix save files and cover letters


After you have permanently installed a fix, you may want to delete the fix save file and cover letter if you
do not need to distribute it to another system. Once a fix has been permanently installed and the save file
is deleted, all information about the fix except the status information is also deleted. By deleting the save
file, you can make more room on your system for other files.

To delete a fix save file, use the Delete Program Temporary Fix (DLTPTF) command. Do not use the
Delete File (DLTF) command to delete fix save files.

Note: fix save files and cover letters for a previous release are removed during automatic cleanup if
system logs are specified.

Chapter 8. Managing system operations 93


Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Loading fixes
The fix packages on CD-ROM, tape, or in a save file can contain many fixes. You can load one, some, or
all of them using the Load Program Temporary Fix (LODPTF) command. As fixes are loaded, the system
verifies that the release of the product is correct. Fix status is not applied after the fix has been loaded on
the system. Use the Apply Program Temporary Fix (APYPTF) command to apply the fix. For some of the
applied fixes, the status is Temporarily applied - ACN. There are also some temporarily applied fixes that
show a status of Temporarily applied - PND. For these fixes, you need additional actions to make them
active.

Loading individual fixes from a cumulative fix package


To load one fix from a cumulative package
1. Enter the Load PTF (LODPTF) command and press F4 (Prompt).
2. Specify the parameter values according to the fix you are loading.
3. Specify the fix identifier you want to load in the fix numbers to select (SELECT) parameter and press
Enter.
4. Repeat the Load PTF (LODPTF) command for each fix you want loaded from the cumulative CD-ROM
or tape.

For fixes on a CD-ROM, the system will automatically find the fix file in the cumulative package that
contains the selected individual fixes when you specify PATHID(*FIRST). All fixes to be loaded must exist
in the same path identifier. Otherwise, you need to load the fixes separately.

For fixes on a tape, you can also use the Load PTF (LODPTF) command to specify the fixes by the
sequence number found in the cover letter that comes with the tape. In the fix numbers to select
(SELECT) parameter, specify the fix you want. Specify the sequence number for the sequence number
(SEQNBR) parameter. You need to specify the correct sequence number for each fix in the cumulative
package. When loading individual fixes from the package on tape, you can also specify ENDOPT(*LEAVE)
on the Load Program Temporary Fix (LODPTF) command and repeat the command until the desired fix is
found.

Loading fixes that supersede other fixes


If the fix being loaded replaces (supersedes) existing fixes (identified in the fix cover letter) the following
considerations apply:
v If the fix to be replaced is not applied to the system, the new fix can be loaded successfully. A record is
kept indicating that the replaced fix has been superseded.
v If the fix to be replaced is permanently applied, it is considered to be a part of the operating system or
licensed program to which it was applied. The new fix can be loaded successfully.
v If the fix to be replaced is temporarily applied, the load operation will automatically permanently apply
any replaced (superseded) fixes. If you do not want the fix function to permanently apply any replaced
(superseded) temporarily applied fixes automatically, specify *NOAPY for the Superseded PTFs
(SPRPTF) parameter on the Load Program Temporary Fix (LODPTF) command. The fixes to be
replaced must either be permanently applied or permanently removed before fixes that are replacing
them can be loaded.

Note: When you order a fix, IBM service does not search through the fixes to determine which one is the
latest level. For example, if you order a fix that is superseded by another fix, IBM service will only send
you the fix ordered by you instead of the superseding fix. You need to use the summary list to identify a fix
you need to order. Scan the summary list for fixes that replace the fix in question and then order the fix.

94 iSeries: Getting started with iSeries


Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Applying fixes: advanced procedure


Some fixes cannot be applied immediately because the operating system or licensed programs they affect
are active. These fixes are called delayed fixes and can be applied at the next system initial program load
(IPL). Immediate fixes can be applied without doing an IPL if the licensed program they affect is not in use,
or may be applied like delayed fixes when you do the next IPL.

Fixes can be applied (made active) on either a temporary or permanent basis. If the fix is applied
temporarily (also known as installed), a copy of the object being changed is saved. If the fix is applied
permanently (also known as permanently installed), the old object is removed. Permanently applied fixes
cannot be removed.

Fixes generally should be installed when received. Installing fixes allows you to test them in your
operational environment. You should ensure that the new fixes operate properly on your system before
permanently installing them. As long as the fixes are installed temporarily, they can be removed. Once
they have been installed permanently, they cannot be removed.

When you are sure that the Licensed Internal Code fixes work properly, it is recommended that you install
them permanently to reduce the time required to install the next cumulative fix package, and to make
available the storage for future fixes. If this storage is not made available, you will need to permanently
install some of your Licensed Internal Code fixes before you can temporarily install any additional fixes.
Temporarily installed Licensed Internal Code fixes are only in effect when you use the B storage area to
perform an IPL.

Notes:
1. You cannot apply or remove fixes with mandatory special instructions when *ALL is specified on the
PTF numbers to select (SELECT) parameter of Apply Program Temporary Fix (APYPTF) or Remove
Program Temporary Fix (RMVPTF)commands. These PTFs are only applied or removed when they are
specified by a number on the SELECT parameter. This protects against applying or removing fixes
without reading the mandatory special instructions.
2. The term fix, in this context, refers to Licensed Internal Code fixes and licensed program fixes,
including OS/400 program fixes.

Temporarily or permanently installing licensed program or OS/400 fixes during an


unattended IPL
You can install both delayed and immediate fixes temporarily or permanently.

To install delayed fixes temporarily:


1. On any command line, type: APYPTF LICPGM(*ALL) SELECT(*ALL) APY(*TEMP) DELAYED(*YES)
IPLAPY(*YES)
2. Press Enter.

To permanently install all fixes that are temporarily installed (status of Temporarily applied) during the next
unattended IPL, or to permanently install all immediate fixes that have a status of Not applied during the
next IPL
1. On any command line, type: APYPTF LICPGM(*ALL) SELECT(*ALL) APY(*PERM) DELAYED(*YES)
IPLAPY(*YES)
2. Press Enter.

To perform an IPL on the system:

Chapter 8. Managing system operations 95


1. On any command line, type: PWRDWNSYS *IMMED RESTART(*YES) IPLSRC(B)
2. Press Enter.

Remember: You must specify LICPGM(*ALL) and SELECT(*ALL) to ensure that fix dependency checking
takes place for prerequisite Licensed Internal Code fixes.

Attention: If your system has logical paripartitionsing the Power pushbutton, DST option 7, or the Power
Down System (PWRDWNSYS) command can affect multiple partitions. For details on using logical
partitions on your iSeries server, go to Managing logical partitions.

Checking requisite fixes


When installing fixes, other fixes can be specified as requisites for the fix. These different types include
prerequisites and corequisites. Each type has a different relationship with the fix you are trying to apply.
Some of the relationships have additional considerations.

Prerequisite fixes: You must specify LICPGM(*ALL) and SELECT(*ALL) on the Apply Program
Temporary Fix (APYPTF) command to ensure that fix dependency checking takes place for prerequisite
Licensed Internal Code fixes. The fix with prerequisites knows about its prerequisites, but a prerequisite fix
does not have any information about the fix that is dependent on it. Therefore, prerequisite checking must
be done when the fix with the prerequisites is set for apply. When you use the GO PTF command and
Option 8 to apply a fix with prerequisites, any Licensed Internal Code fixes that are called out as
prerequisites are set for permanent apply. This is very important to remember. It is the action of setting the
dependent for apply that sets the Licensed Internal Code fixes prerequisite for permanent apply.

Corequisite fixes: The system will not apply corequisite fixes unless it is also applying the other. The
corequisite relationship is two-way, meaning each fix must specify the other as a corequisite. Corequisites
must be within the same product, option, version and release. The system will check that the corequisite
fixes are applied at the same time, but it cannot ensure that one will not end up active without the other.

The system now recognizes under certain conditions, whether a fix specified as a prerequisite or
corequisite is really needed. This decision is based on whether the function it will fix is actually installed on
your system. These prerequisites and corequisites are displayed as conditional requisites.

Temporarily or permanently installing licensed program or OS/400 fixes during an


attended IPL
You can temporarily or permanently install both delayed and immediate fixes that have a status of Not
applied during an attended IPL.

To temporarily install a delayed fix, you only need to do one IPL. To permanently install a delayed fix after
it has been applied temporarily and tested, you need to do another IPL.

Before you start: Send a message to users notifying them to sign off the system.

To temporarily or permanently install a fix during an attended IPL:


1. Switch the system unit to the Manual mode.
If you are temporarily installing delayed Licensed Internal Code fixes, select storage area A. Immediate
Licensed Internal Code fixes can be installed when IPL’d to storage area B. If you are permanently
installing Licensed Internal Code fixes, select storage area B.
2. Type PWRDWNSYS *IMMED RESTART(*YES) IPLSRC(x), where x is your storage area, on any
command line and press Enter.
3. Select option 1 (Perform an IPL) on the IPL or Install the System display.
4. Type your user ID and password on the Sign On display.
5. On the Select Products to Work with PTFs display, select the licensed program for which you want to
install the fix

96 iSeries: Getting started with iSeries


v If fixes are not applied or are temporarily applied, the Work with PTFs display is shown. This display
is used to install and remove fixes and shows the current status of each fix that you can work with.
v If you want to keep the same status for any of the fixes displayed, leave the Opt column empty.
v Fixes that are not installed can be either temporarily installed using option 1 or permanently
removed using option 4.
v Fixes that are temporarily installed can be either permanently installed using option 2 or temporarily
removed using option 3.
Note: For an explanation of ″permanently removed″ and ″temporarily removed″ PTFs, see Removing
fixes.
6. After typing the option number you want for each of the fixes displayed, press Enter.
7. Repeat step 5 and step 6 for each licensed program for which you want to apply fixes.
8. Press F3 (Exit) to continue with system operations.

Temporarily or permanently installing immediate licensed program or OS/400 fixes


without an IPL
To temporarily or permanently install immediate fixes without doing an IPL:
1. Make sure the licensed programs to which the fixes are being applied are not in use.
Note: If you are applying fixes to the Licensed Internal Code or to the OS/400, be sure to follow any
special instructions, including activation instructions, in the cover letter to ensure that the system is in
the correct state.
2. Enter the Apply Program Temporary Fix (APYPTF) command and press F4 (Prompt). Press F9 (All
parameters) to display all of the fields on the Apply Program Temporary Fix (APYPTF) display.
3. Specify the number that corresponds to the licensed program you are applying fixes for the Product
(LICPGM) parameter.
4. Specify the release level for the Release (RLS) parameter.
Note: The release parameter is only required if more than one release of the product is installed.
5. Select the fixes you want applied by doing one of the following:
v Specify the identifiers of the fix you want to apply in the PTF numbers to select (SELECT)
parameter. To apply all fixes, specify *ALL in the PTF numbers to select (SELECT) parameter.
v Specify *ALL for the fix numbers to select (SELECT) parameter, and the numbers of specific fixes
you do not want to apply for the fix numbers to omit (OMIT) parameter.
Note: Specify APYREQ(*YES) to ensure all requisites within the same product are also applied if
individual fix identifiers are specified in the SELECT parameter.
6. To temporarily install the fixes, specify *TEMP for the Extent of change (APY) parameter. To
permanently install the fixes, specify *PERM.
Note: fixes temporarily installed can be removed; fixes permanently installed cannot be removed (see
Removing fixes).
7. Specify *NO for the Delayed PTFs (DELAYED) parameter.
Note: To apply all immediate fixes right now and all delayed fixes on the next IPL, specify *ALL for the
Product (LICPGM) parameter, *ALL for the Select (SELECT) parameter, and *IMMDLY for the Apply
Type (APPLY) parameter.
8. Press Enter. The system applies the fixes to the specific licensed program.
9. Repeat steps 2 through 8 until the fixes are applied for all the selected licensed programs.

Applying licensed internal code fixes at the next unattended IPL


To apply Licensed Internal Code currently operating on the A storage area, the Licensed Internal Code
fixes can be applied immediately.
1. Make sure the system is in the Normal mode.
2. If you are not running on the correct storage area, type the following on any command line and press
Enter: PWRDWNSYS *IMMED RESTART(*YES) IPLSRC(B)

Chapter 8. Managing system operations 97


3. Type the following commands on any command line and press Enter after each one:
APYPTF LICPGM(5769999) APY(*TEMP) DELAYED(*YES)
PWRDWNSYS *IMMED RESTART(*YES) IPLSRC(B)

Note: While applying Licensed Internal Code fixes, it may be necessary for the system to reorganize a
portion of the Licensed Internal Code storage. This reorganization can take up to 1 hour. While this
reorganization is taking place, system reference codes (SRCs) C600 434B and C600 435B are displayed.

Applying licensed internal code fixes without an IPL


You may be operating from either storage area to temporarily install an immediate Licensed Internal Code
fix without doing an IPL. You must be operating from the B storage area to permanently install a
temporarily installed Licensed Internal Code fix without doing an IPL.

To determine the storage area you are currently operating from:


1. On any command line, type DSPPTF 5769999.
2. Press Enter.

On the Display PTF Status display, the storage area is identified in the IPL source field. ##MACH#A is the
A storage area and ##MACH#B is the B storage area.

If you are not running on the correct storage area:


1. On any command line, type PWRDWNSYS *IMMED RESTART(*YES) IPLSRC(X), where IPLSRC(X)
is A if you want to apply them temporarily or B if you want to apply them permanently.
2. Press Enter.

To apply Licensed Internal Code fixes immediately:


1. On any command line, type APYPTF 5769999 APY(xxxxx) DELAY(*NO), where where xxxxx is
*TEMP or *PERM.
2. Press Enter.

Resetting IPL action: If you decide not to apply the fix on the next IPL, you can reset IPL action by using
the following command: APYPTF LICPGM(5769999) APY(*TEMP) DELAYED(*YES) IPLAPY(*NO) .

Additional information on this topic can be found in these sources:

Manage fixes with Management Central


Fixes and logical partitions

Working with devices


A device is a piece of equipment that is connected to, but does not directly interact with, your system.
Instead, a device (such as a workstation, printer, diskette or tape unit, or remote system) is controlled by a
controller. Depending on your organization, you may frequently attach and configure new devices, or these
activities may happen rarely once your system is operational.

System requirements for device configurations


Your system automatically configures any new devices that you attach. However, if you changed the
automatic configuration set parameter when you initially set up your system, you will not be able to change
it until you perform an attended IPL, as the Set Major System Options display is only available at that time.

If you have automatic configuration set to Yes (Y), your system automatically configures any local
controllers or devices, including local workstation and tape controllers, display stations, printers, tape,
diskette or optical units, and media library devices.

98 iSeries: Getting started with iSeries


Your system must be powered off to physically attach new local controllers. However, it does not have to
powered off, and you do not have to perform an IPL for automatic configuration to take place when you
add new external devices.

Additional information on this topic can be found in these sources:

Creating a device inventory

Working with printer output


One of the most basic system functions is printing. Depending on the type of printing you choose, you can
print to a local or remote printer, across a LAN (local area network) or to a directly-attached printer.

The iSeries supports many different kinds of printing. The three most commonly used methods are:
v ASCII LAN printing
v Intelligent Printer Data Stream (IPDS) LAN printing
v Twinax printing

Choosing the printing method that is right for you depends on the particular circumstances of your
business. For instance, if you have a very complex printing environment and you want to share your
printer between systems, you might want to consider IPDS LAN printing. If your print needs are less
complex, or your printer will only be used on one system, the traditional Twinax printing method might be
the best fit for your needs. Keep these considerations in mind as you choose a printing protocol from one
of the ones listed below.

ASCII LAN printing


Printing across your local area network (LAN) can take many forms. Some of the most common are
described below:
v Simple Network Management Protocol (SNMP)
There are various methods of ASCII LAN printing. One method of ASCII LAN printing is through the use
of the SNMP printer driver support. To use the SNMP printing support, your printer and network printer
server must support the Host Resource MIB (Management Information Base) or the Printer MIB. Your
network printer server is the network interface used to connect the printer to the LAN. Sometimes it is
an internal card in the printer itself, and sometimes it is an external box.
This configuration method tracks printer status on a TCP/IP port separate from the TCP/IP port used to
send the print data. This provides better error handling than other ASCII LAN attachment methods. This
method also provides better sharing of the printer with other systems.

Get the latest SNMP configuration and troubleshooting information from the IBM Knowledge Base ,

or check out the Printer Device Programming manual .


v Print Job Language (PJL)
A second method of ASCII LAN printing is through the use of the HP PJL printer driver support. To use
the HP PJL printer support, your printer must support PCL5e and the network printer server must
support bi-directional PJL on some TCP/IP port.
This configuration method provides some error handling through the same TCP/IP port used to send the
print data. Unlike the LPR/LPD method, the PJL printer driver waits until the printer has finished printing
the current spooled file before printing the next one.

Get the latest PJL configuration and troubleshooting information from the IBM Knowledge Base , or

check out the Printer Device Programming manual .

Chapter 8. Managing system operations 99


v Line Printer Requester/Line Printer Daemon (LPR/LPD)
A third method of ASCII LAN printing is through the use of the LPR/LPD (Remote Writer) support. To
use the LPR/LPD support, your network printer server must support LPD.
This configuration method provides very minimal error handling. Once the file has been sent to the
printer, it is no longer monitored. This method does not provide page range or job accounting support.
v Telnet
A fourth method of ASCII LAN printing is through the use of the telnet printer pass-through support. Get
information on setting up and managing Telnet printing now.

IPDS LAN printing


PSF/400 (Print Services Facility/400) is required to print to LAN attached IPDS printers. PSF/400 requires
the network printer server to support IPDS.

This configuration method provides the best level of printer error handling and printer data stream support.
It also has performs better in complex printing environments.

Get the latest IPDS configuration and troubleshooting information from the IBM Knowledge Base . For

more information on when to use PSF/400, check out the Printer Device Programming manual .

Twinax printing
You can also print to printers attached to workstation controllers, InfoWindow displays, or PCs through the
use of the twinax printing support.

One advantage of twinax printing support is the automatic configuration of printers. See the Local Device

Configuration guide or the Printer Device Programming manual manual for more information.

Additional information on the printing topic can be found in these sources:

IBM AS/400 Printing V


Troubleshooting printers
Printing and device programming
Printers and devices

Using Line Printer Requester/Line Printer Daemon (LPR/LPD) printing


v Setting up a remote printer
Setting up printers on your system can be accomplished quickly. The topics below describe the steps
you need to follow to set up LPR/LPD printing on your system.
v Preparing to print
Printing files using LPR/LPD is accomplished by sending spooled files. Determine if you have
the authorization necessary to send and receive spooled files, and to start an LPR print job.
v Starting printer output
The printers are set up, and you have all the authorization you need. Time to start printing.
v Managing printer output
Spooled files are sent from the system to the printer queue or to another system. The topics below
assist you as you manage the smooth flow of information from user to printer.
– Changing format to ASCII
– Naming printer output
– Determining ownership of printer output

100 iSeries: Getting started with iSeries


v Deleting printers
As a part of regular system maintenance, delete printers that you no longer want on your system. This
eliminates the problem of users attempting to send spooled files to printers that no longer exist on the
system.

Setting up a remote printer


Not every printer attached to your system has to be in close physical proximity to your system. You have
the option of printing to a printer at another site. Follow the tasks below to set up a remote printer.

To set up an LPD from Operations Navigator:


1. Expand the system that you want to configure.
2. Expand the Network icon.
3. Expand the Servers icon.
4. Expand the TCP/IP icon.
5. Right-click the LPD server and select Properties.

You can now select the number of listener jobs to be started and whether the LPD server starts whenever
TCP/IP is started on the system. You can also specify that one or more LPD servers can be started
automatically by using the Change LPD Attributes (CHGLPDA) command. Other properties can be
configured from the command line.

To set up an LPR from the command line (to a printer on the network), following the instructions in the IBM

Knowledge Base, under Configuring a Remote Output Queue (RMTOUTQ) .

Additional information on this topic can be found in these sources:

Starting printer output


Printing and device programming

IBM Knowledge Base

Setting up a remote printer from the command line


Occasionally, you need to customize the remote printer configuration more than is possible through
Operations Navigator. The steps below outline how to complete this task:
1. From the command line, enter the CRTOUTQ command to create an output queue to hold your
spooled files.
2. When the command is displayed, press F4 to display optional parameters in stages.
3. Specify the following values:
v Output queue: Enter the name of the output queue (up to 10 characters). The library the output
queue is created in may also be specified.
v Remote system: Enter the name assigned to that IP address.
v Remote printer queue: PASS
The supported values for this parameter are determined by the remote system. This may be the
name of the queue on a print server or have a specified value, such as PASS, for some printers.
This value may be case sensitive; to preserve lower case characters, enclose the parameter in
single quotes. Consult your printer or server manual for problem resolution.
v Connection type: *IP
v Destination type: *OTHER
If destination is a network station printer, enter *OS400 for V4R4 and later systems.
v Host print transform: *YES

Chapter 8. Managing system operations 101


v Manufacturer type and model: Press F4 on this field to see the list of printer types and models and
enter the value that corresponds to your printer.
v Image configuration: *NONE
v Internet address: Enter the printer’s IP address.
Only an IP address is anticipated here (for example, address.address.address.address). No
validation is done to confirm that an appropriate value has been entered. Do not use a host table
entry in place of the address in this field.
v Text ’description’: Enter the printer’s description.
v Destination options: XAIX. Use this setting for printers but not for servers to ensure maximum
compatibility. This option is needed for printers to print more than one copy of a spooled file that
has more than one copy in its spooled file attributes. XAIX is not a default value because it may
cause problems with some print servers.
4. Enter WRKOUTQ [character string] on the command line. Use a portion of the name you gave the
output queue in the character string. Entering the command without the character string returns a list
of all output queues, which may be very long. You will receive a message that the output queue was
created in the library.
5. Confirm that the output queue was created. Look in the resulting list for the output queue name that
you created.
6. Enter STRRMTWTR on a command line.
7. Enter the name of the output queue you created. You will receive a message that the writer was
submitted to the job queue.
8. Enter WRKWTR [output queue name] on any command line to verify that the writer was started.
9. Test the printer by placing a small spooled file on the output queue.
10. Test the multiple copy function by changing the spooled file copies attribute with the CHGSPLFA
command before placing it in the output queue. This confirms that a printer is directly attached to the
network, rather than attached through a print server.

The printer is now ready to use.

Additional information on this topic can be found in these sources:

Printing and device programming

Preparing to print
Printing files using TCP/IP is accomplished by sending spooled files. Do the following tasks to determine if
you have the authorization necessary to send and receive spooled files, and to start a LAN-attached
printer session, see the following topics:
v Authorizations for sending jobs“Authorizations for sending jobs”
v Authorizations for receiving jobs“How the system uses authorizations for receiving jobs” on page 103
v Starting an LPD server job“Commands to start an LPD server job” on page 103

Authorizations for sending jobs


To send a spooled file, users need to have one of the following authorities to the file or to the output
queue in which the file resides:
v Be the owner of the spooled file.
v Have spool control authority (*SPLCTL).
v Have job control (*JOBCTL) special authority on an operator-controlled (OPRCTRL(*YES)) output
queue.
v Be the owner of the output queue.
v Have add, delete, and read authority to an output queue created with AUTCHK(*DTAAUT).
v Have read authority to output queues created with DSPDTA(*YES).

102 iSeries: Getting started with iSeries


This information is common to all printers.

How the system uses authorizations for receiving jobs


This information is applicable to LAN-attached print jobs only.

The destination system administrator restricts output queue access for users without user IDs on the
destination system. This is done by restricting the access authorities of the QTMPLPD user ID, which is
the default profile used by any user ID that is not found. However, this restriction does not affect user IDs
that are found on the destination system.

If you set the *PUBLIC authority of the user profile QTMPLPD to *EXCLUDE, only users with user IDs that
are the same on both the sending and receiving systems receive spooled files on the destination system.
The QTMPLPD user profile ships with an authority of *OBJOPR.

If you do not have a user ID on the destination system, you are still able to send spooled files to the
destination system under the QTMPLPD user profile.

Having a user ID defined on the receiving system can be advantageous. If you have the same user ID on
both systems, you are the owner of the spooled file on the receiving system, making it easier to find the
spooled file with the Work with Spooled Files (WRKSPLF) command.

If you do not have a user ID on the receiving system, then QTMPLPD owns the file. Because you do not
own the spooled file, you might have limited access to the spooled file. Your authority to the output queue
on which the spooled file is located determines your access to the spooled file.

If you are using a security level of 50, the system value QALWUSRDMN must contain the library name
QTEMP to enable LPR service. For LPD service, the required library is QTCP.

Commands to start an LPD server job


LPR and LPD do not support the ability to print page ranges. To do that you must configure your printers
as *LAN type printers by creating a printer device type.

To receive spooled files from other LPR clients, you must start the server job for the LPD application in the
QSYSWRK subsystem. You must also ensure that the QALWUSRDMN system value is set to *ALL or has
the library QTCP included in it. This is required for the LPD service to function.

The Start TCP/IP Server (STRTCPSVR *LPD) command starts the LPD server that is shipped with the
TCP/IP Utilities licensed program.

You can also start the LPD server job with the AUTOSTART parameter of the Change LPD Attributes
(CHGLPDA) command. However, the STRTCPSVR command overrides or ignores the AUTOSTART
parameter on the CHGLPDA command. The Start TCP/IP (STRTCP) command starts all of the servers
that have been started automatically. If your LPD server did not start, check the LPD Autostart attributes
by typing CHGLPDA and pressing F4.

The STRTCPSVR command starts the number of servers configured in the CHGLPDA command. After
you start the minimum number of LPD servers, the STRTCPSVR command starts only one additional
server at a time.

LPD works most efficiently when two or more servers are running. Each server processes one job; LPD
cannot receive any jobs while a current job is running. Have an additional LPD server available to prevent
delays for other LPR clients.

You can use the Configure TCP/IP LPD (CFGTCPLPD) command or the CHGLPDA command to work
with the LPD attributes.

Chapter 8. Managing system operations 103


Additional information on this topic can be found in these sources:

Starting printer output


Printing and device programming

Starting printer output


LPR/LPD Printing is accomplished by sending spooled files to a predefined printer. You can send a print
job to a printer by following these steps:
1. Expand the system you are configuring.
2. Expand Basic Operations.
3. Right-click the printer you wish to print to and select Start.
4. When the start dialog is displayed, confirm the values in the fields and click OK to start the printer.

Additional information on this topic can be found in these sources:

Printing and device programming

Changing a format to ASCII before printing


If a spooled file has the printer device type of Systems Network Architecture (SNA) character string (*SCS)
or Advanced Function Printing Data Stream (AFPDS), the file format needs to be changed on an iSeries
server prior to sending it to a system printer.

Files with the printer device type of Intelligent Printer Data Stream (IPDS) cannot be transformed. If you
attempt to change the format, no conversion will occur, the file will not be sent, and an error message will
be issued.

If you know that the destination system supports the printer device type of the spooled file, send the file
without transforming it. When sending files, you must consider any external resources of that file. These
resources, such as fonts and overlays, must also reside on the destination system in order for the file to
print correctly.

ASCII printers cannot print spooled files that have a printer device type of Systems Network Architecture
character string (*SCS) or Advanced Function Printing Data Stream (AFPDS). The data stream needs to
be converted to ASCII before the file can be printed. The Host Print Transform (HPT) function provides a
means to transform spooled files prior to sending them to the printer. Using the system to transform the
spooled files takes less time than having the printer transform the file.

Newer releases of the operating system provide support to transform PostScript files to ASCII format by
using the Image Print Transform function.

If you need to change the format of a spooled file, specify *YES on the Transform parameter of the
SNDTCPSPLF or LPR command to have the data stream transformed when you send spooled files.

Using LPD to print ASCII files converted to EBCDIC


LPD can also receive printer files from ASCII hosts running LPR and print them in EBCDIC. There are
some limitations on character conversion, however. In particular, line feed and form feed printer control
characters may not function properly. The ASCII hosts must be able to convert the printer data stream to
EBCDIC prior to sending it using LPR. In addition, variable length records are not handled well. Pad each
record with blanks to a fixed width, and specify the width option or flag on the LPR command.

To do this, you need to customize the LPD printer file on the iSeries.

Do not change the original printer file in QTCP. Instead, make a copy of it, change the copy, and include it
higher up in the user library list portion of the *LIBL for the user profile receiving the file.

104 iSeries: Getting started with iSeries


You have two options for changing the LPD printer file:
1. Change the QUSRSYS/QPTMPLPD working copy from *USERASCII to *SCS. This affects all LPR
clients because it resides in the *SYSLIBL path and is found first by all user profiles. This means that
all LPR clients must send EBCDIC data streams (or at least only send EBCDIC streams until the
QUSRSYS/QPTMPLPD printer file is restored to *USERASCII type).
2. Change the QUSRSYS/QPTMPLPD working copy of the *USERASCII to *SCS, and move it to another
library that is your *CURLIB or somewhere in your *USERLIBL path. Ensure that your target library is
found ahead of library QTCP, which has the installation copy of the printer file. You must also ensure
that the target library is unique to your user profile, *LIBL, in order to avoid affecting other users.

Your *LIBL is considered to be one that exists when your user profile is signed on. You cannot run any
programs when you sign on to set the library list. Any change to your current interactive session has no
effect upon the *LIBL used. This is because the user profile *LIBL is checking events occuring in an LPD
server batch job and not your interactive job.

To receive EBCDIC files, the LPR client must be any user with an iSeries user profile that has the *SCS
working copy in its *LIBL path. For example, if someone moves the printer file to library JOHNDOE, any
user profile with JOHNDOE as its *CURLIB or in its *USRLIBL uses the *SCS printer file.

Removing the working copy from library QUSRSYS forces every user profile that does not have library
JOHNDOE in its *LIBL to find the installation copy of QTCP. If library QTCP is not already in the *LIBL,
then the system adds it as the last library in *LIBL for all user profiles. This insures that the system finds a
printer file. Do not change the installation copy in QTCP. This insures that other user profiles, including the
default profile QTMPLPD, still receive ASCII data streams as usual.

Additional information on this topic can be found in these sources:

Printing and device programming

How spooled files are named


Spooled files that LPD receives have file names in the form LPDxxxx. The ″x″ represents any valid
hexadecimal character (from A-F and 0-9). These hex characters are the result of cyclic redundancy
checking that is performed on client information to identify the LPR client for LPRM support. áSpooled files
that are named in this manner are unique to each client.áThe system uses the name as a signature. All
files from a single client have the same signature. A client must generate a matching signature to use
LPRM to delete any LPR spooled file.

Clients can use LPQ (line printer queue) and LPRM (line printer removal) commands to query and remove
LPR spooled files, as LPD supports both functions. However, the system that acts as a client cannot issue
these commands.

If the LPR client is another iSeries 400 using DESTTYP(*AS400) and TRANSFORM(*NO) parameters, the
spooled file has exactly the same attributes on the receiving queue as it had on the sending queue. The
spooled file name is not converted to LPDxxxx form and is left unchanged.

The LPQ command sent to an iSeries 400 system requires a job list parameter, or more specifically, a
user profile under which the query is performed.á

Additional information on this topic can be found in these sources:

Printing and device programming

Chapter 8. Managing system operations 105


Ownership of spooled files
If the user ID on the sending system exists on the destination system, the spooled file is created under
that user profile.áHowever, if the user profile does not exist on the destination system, then the spooled
file is created under the QTMPLPD user profile.

When sending from a non-iSeries 400 system to an iSeries 400 system, the file is always created using
the QTMPLPD user profile.áThis is also true when sending fromáone iSeries to another with the
TRANSFORM(*YES) parameter.áIn these cases, spooled files received by the LPD server are placed
under special jobs.

For example, if user ID JOHN exists, the file is placed under job 999999/JOHN/QPRTJOB.á If user ID
JOHN does not exist, the file is placed under 999999/QTMPLPD/QPRTJOB.

Additional information on this topic can be found in these sources:

Printing and device programming

Deleting printers that are no longer needed on the system


As a part of regular system maintenance, delete printers that you no longer want on your system. This
eliminates the problem of users attempting to send spooled files to printers that no longer exist on the
system.

Deleting LAN-attached printers


Perform the following steps to remove a LAN attached printer from the system:
1. Enter the WRKCFGSTS *DEV command on any command line.
2. Enter Option 2=Vary off next to the printer you are removing.
3. Enter the WRKOUTQ command on any command line.
4. Enter Option 3=Hold next to the printer you are removing.
5. Enter the WEKDEVD command on any command line.
6. Enter option 4=Delete next to the printer that you are removing.

Deleting printer writers


To remove an ASCII printer from the system, perform the following steps:
1. Enter the WRKWTR *ALL command on any command line.
2. Enter Option 4=End next to the printer that you are removing.
3. Enter the WRKOUTQ command on any command line.
4. Enter Option 4=Delete next to the printer that you are removing.

Additional information on this topic can be found in these sources:

Printing and device programming


CLROUTQ command

Setting up Telnet printer pass-through


The Telnet printer pass-through mode allows system users with a Telnet client that supports client
emulation to attach printer devices on the system over the network. This support is accomplished by
negotiating the 3812 or 5553 device type support with the remote client Telnet application.

If you intend to use the TCP/IP Telnet printer pass-through, check with the client vendor or with third
parties that are known to provide 5250 clients for the availability of the printer pass-through function. Client
Access supports this function, as do many third-party clients.

106 iSeries: Getting started with iSeries


Telnet printer pass-through delivers the printer data stream between the two systems as either EBCDIC or
ASCII depending on the preferences of the requesting client. Telnet printer pass-through supports the
following generic EBCDIC printer devices:
v IBM-312-1 for single byte character set support (SBCS)
v IBM-5553-B01 for double byte character set devices (DBCS)

Client Access supports 3 additional transform mechanisms, called Host Print Transform (HPT), Printer
Definition Table (PDT), and Graphical Device Interface (GDI).

When using Telnet printer pass-through, the print data must be spooled to a print writer queue (direct
printing to the device is not supported). To ensure this, the print file used must specify *YES for the
SPOOL parameter. The name of the print writer output queue is the same as the name of the printer.

Use the Configure TCP/IP Telnet (CFGTCPTELN) command to set up your Telnet session.

Use the following steps to set up your Telnet printer pass-through mode session:
1. Start the Telnet server job
2. Set the number of virtual devices
3. Create virtual controllers and devices
4. Activate the QSYSWRK subsystem
5. Security considerations

Additional information on this topic can be found in these sources:

Starting printer output


Printing and device programming

Setting the number of virtual devices


Virtual devices are used by the server system to direct output to devices on your system. iSeries 400
Telnet server support automatically selects (and creates if necessary) these devices for you. You may also
choose to create your own virtual device under the QVIRDCnnnn virtual controller.

You can choose to allow the Telnet server support on the system to automatically configure virtual
controllers and devices. The QAUTOVRT system value specifies the maximum number of devices that are
automatically configured by the system. Use the Change System Value (CHGSYSVAL) command to
change the value of the QAUTOVRT system value. For example, entering the following command string
changes the number of virtual devices that can be allocated on a system to 50:
CHGSYSVAL SYSVAL(QAUTOVRT) VALUE(50)

QAUTOVRT supports numeric values of 0 through 32500, and a special value of *NOMAX.

Maximum number of users


To determine and set the maximum number of users you want signed on to the system at any one time:
1. Set the QAUTOVRT value to 32500, the maximum value allowed, or use the *NOMAX value.
2. Let your users use pass-through, Telnet, the virtual application program interface and Telnet printer
pass-through until you decide that the number of virtual devices created is sufficient for normal system
operation.
3. Change the QATUOVRT value from 32500 to the number you have determined is optimal for your
system.

Virtual device configuration


If you have never allowed automatic virtual device configuration on your system, the QAUTOVRT value is
0. A Telnet connection attempt with a dependence on automatic creation of the virtual device then fails

Chapter 8. Managing system operations 107


because the Telnet server does not create more than the specified QAUTOVRT devices (in this case, 0). If
you try to connect, you will receive a message (TCP2504) that indicates the Telnet client session has
ended and the connection is closed. Additionally, QTVTelnet and QTVDEVICE in the QSYSWRK
subsystem on the Telnet server will send a message (CPF8940) indicating that a virtual device cannot be
automatically selected.

If devices already exist on the system and are not currently in use, Telnet will reuse an existing, available
device that fits the device name criteria, even if it means it must delete and recreate that existing device to
match the device type.á Some users may still be able to connect for this reason.

If you change the QAUTOVRT value to 10, the next Telnet connection attempt causes the Telnet server to
create a virtual device.á This virtual device is created because the number of virtual devices on the
controller (0) is less than the number specified in the QAUTOVRT.á Even if you change the specified
number to 0 again, the next user attempting a Telnet connection succeeds.á When a Telnet connection
attempt fails, the CPF87D7 message is sent to the system operator message queue on the Telnet server
system.á The CPF87D7 message indicates that the server is not able to create a virtual device.

Additional information on this topic can be found in these sources:

Device system values


iSeries system values
Configuring the Telnet server

Virtual controllers and devices created by the system


When your system creates virtual devices, it follows these guidelines:
v The virtual controller is named QPACTLnn, where nn is an integer 01 or greater.
v The virtual device is named QPACDEVxxxx, where xxxx is an alphanumeric character from 0001 to
ZZZZ, with the exception of the letters a,e,i,o,u,y, allowing a maximum of 809,999 devices with unique
device names. User-selected names have no restrictions on them.
Note: If you want to use more than 32,500 devices, you can set the QAUTOVRT system value to
*NOMAX.
v The Telnet server attempts to use existing virtual devices by matching the device type and model. If no
match is found, then a virtual device is created. If necessary, the existing device is deleted and
recreated if it is not already in use. This applies to named devices (that is, when a specific device is
requested, rather than a default one assigned). This is true even if the named device requested is of
QPADEVxxx type. Telnet knows that a device name was specifically requested and applies these rules
to the QPADEVxxxx device just like any other named device.

If your Telnet client supports device naming, you can specify which device to use. Otherwise, you can
assign the device name to a Telnet session with the Telnet exit programs.

The exit program always overrides any negotiated device name. In this way, the system administrator
always has final control over the name assigned, simply by implementing the Telnet user exit program.
The administrator can therefore block or override TN5250E requests if necessary.

Activating the QSYSWRK subsystem


You can work with any subsystem by using Work Management in Operations Navigator.
1. Determine the status of the QSYSWRK subsystem
a. In Operations Navigator, select the system you want to work with.
b. Expand Work Management.
c. Expand Subsystems.
d. Locate the QSYSWRK subystem. It may be necessary to expand further to find this subsystem.

108 iSeries: Getting started with iSeries


e. The status of the subsystem is displayed in the right panel of the Operations Navigator window.
2. If the status is inactive, type STRSBS QSYSWRK on the command line to start the subsystem.
3. Start the Telnet server job.

The interactive subsystem needs to be active. The default interactive subsystem is QINTER. However, it
may not be the subsystem that you have created for interactive jobs. If you are not sure which subsystem
you use for interactive jobs, type WRKSBSD *ALL. The Work Station Type Entries shows which devices
are to be allocated to which subsystems. If you are using QINTER, start it by typing STRSBSQINTER.

Interactive jobs can be sent to any subsystem, based on the device name assigned to the job. To change
the entries for a subsystem, use ADDWSE or RMVWSE.

The spooling subsystem (QSPL) needs to be active to run printer pass-through sessions.

Additional information on this topic can be found in these sources:

Work management: managing subsystems

Printer security considerations


Profile and passwords are not required for printer sessions. However, they are required for a bypass of
signon displays. The passwords can be encrypted if the Telnet client supports the function.

The System Administrator can deny users printer sessions if necessary.

Additional information on this topic can be found in these sources:

Printing and device programming

Tips and Tools for securing your iSeries

Using removeable media


The iSeries uses the following media for saving or restoring data:
v Tape
v CD-ROM
v Optical library

To ensure a successful backup, it is important to handle and maintain the media properly.
v Using Tapes and Tape Units
v General Tape Usage Information
v Using CD-ROM“Using CD-ROM Storage” on page 116
v Using Optical Media Libraries“Using Optical Media Libraries” on page 118

Additional information on this topic can be found in these sources:

Tape drive environment and use


Using quarter-inch cartridges
Using 1/2-Inch and Magstar MP Tape Cartridges
Using 1/2-Inch and Magstar MP Tape Units“Using 1/2-Inch and Magstar MP Tape Units” on page 130
Using 8-Millimeter Tape Units“Using 8-Millimeter Tape Units” on page 128
Using 1/2-Inch tape reels

Chapter 8. Managing system operations 109


Using tapes and tape units
There are several types of tape cartridges and tape units that are commonly used on the iSeries system:
v 1/4-inch tape cartridge and tape unit
v 8-mm tape cartridge and tape unit
v 1/2-inch tape cartridge and tape unit
v Magstar® MP tape cartridge and tape unit

You can also use 1/2-inch tape reel and tape unit on the iSeries.

Term Description
Tape Cartridge A tape cartridge is a case containing a reel of magnetic tape that can be put into a tape
unit without stringing the tape between reels.
Tape Reel A tape reel is a round device on which magnetic tape is wound.
Tape Drive A tape drive is a device that is used to move the tape and read and write information
on magnetic tapes.
Tape Unit A tape unit is a physical enclosure that contains the tape drive.
Tape Library The complete collection of tapes available for use on the system (including all new,
scratch, used tape cartridges, or reels) is a tape library.

For all tapes, you need to establish a procedure for maintaining a tape library which includes:
v Assigning each tape a unique volume ID.
Each tape must have a unique volume ID to maintain the accuracy of tape volume statistics as shown
in monitoring tape volume statistics“Monitoring Tape Volume Statistics” on page 113. On barcoded
tapes, the volume ID must match the bar code.
v Establishing a temperature and humidity controlled tape media storage area.
v Maintaining records for each tape volume including:
– Date the tape was purchased
– Problems encountered
– Corrective action taken

Regardless of the type of tape you are using, follow these guidelines to avoid damage and loss of the data
on the tape.

Remember:
v Leave the reels or cartridges in their protective container until you use them.
v Place reels or cartridges in the computer room for 24 hours before using them.
v Remove the reel or cartridge from the tape unit when it is not in use.
v Store reels or cartridges in the protective container.
v Copy and then throw away reels and cartridges that have a high number of temporary errors. See
monitoring tape volume statistics“Monitoring Tape Volume Statistics” on page 113 for information on how
to obtain the number of errors.
v Operate tape units in a relatively clean, dust-free environment. Storing and operating tape media and
tape devices in a dirty environment may cause errors and early life failures.
v 8mm 160-meter tapes must have media recognition system (MRS), or the tapes will not load.

Apply an external label to the outside of each reel or cartridge and to the protective container when you
store data on a tape. These labels can be ordered separately. Record information such as:
v Name or number of the reel or cartridge
v Type of data stored on the reel or cartridge
v Date the data was stored on the tape

110 iSeries: Getting started with iSeries


v Tape volume ID

Do not:
v Carry cartridges loosely in a box or basket because the leader blocks can catch on other tapes and
become unlatched.
v Stack more than six cartridges on top of each other.
v Open a cartridge.
v Release the leader block and pull the tape from the cartridge.
v Touch any exposed tape.
v Expose the tape to direct sunlight, moisture, or high magnetic fields.
v Drop the tape reel or cartridge.
v Apply an external label to the outside top of the cartridge or reel. This could interfere with the drive or
media operation.

Tapes, tape units, and diskettes are used primarily for saving and restoring system data. A tape unit is the
physical enclosure that holds the tape drive.

Verifying that your tape unit works correctly


To verify that your tape unit is working correctly, do the following:
1. Remove the reel or cartridge from the tape unit.
2. Type WRKCFGSTS *DEV *TAP on any command line and make the tape unit unavailable to the
iSeries (vary off).
3. Clean the tape unit. Refer to the cleaning instructions for the tape unit you are using.
4. Type the Verify Tape (VFYTAP) command on any command line and press Enter.

Errors That Can Occur with Tape Units: If an error message appears during tape usage, you can put
the cursor under the message, and press F1 or HELP. Then follow the instruction in the online help
information to resolve the problem.

Using 1/4-Inch Tape Units: The iSeries system supports the following 1/4-inch tape units:
v Internal tape features
v 7207 Model 122

For more information about the 7207 Model 122, refer to the following publication: SA37-0400, 7207 Model
122 4GB External SLR5 Quarter-Inch Cartridge Tape Drive Setup, Operator, and Service Guide.

Note: The tape unit installed in the 7207 Model 122 is functionally the same as the internal feature
identified as QIC-4GB-DC.

General Tape Usage Information


Tape Volume, Initialization, and Volume ID
A volume is a tape reel, a tape cartridge, or a diskette. Each volume must be initialized before data files
can be recorded on the tape (or diskette) magnetic medium. A tape volume ID is a name or number
identification that is recorded in a standard volume label at the beginning of the tape when a tape is
initialized.

Initializing Tape: Use the Initialize Tape (INZTAP) command to initialize a tape. When you run this
command, a standard volume label is recorded at the beginning of the magnetic tape medium.
v When a tape is initialized, any information previously recorded on the tape medium is erased and
written over with new information. Information is also written over when new data files are appended to
the newly recorded volume label.

Chapter 8. Managing system operations 111


Note: Do not reuse an old tape volume if permanent read or write errors have been detected more than
two times. Also do not reuse an old tape volume if temporary read or write errors for that volume are
excessive. To determine if temporary errors are excessive, see Monitoring Tape Volume Statistics.

Commonly Used Parameters of the INZTAP Command: The most commonly used INZTAP parameters
are:
v New volume identifier (Volume ID)
v Check for active files
v Tape density

New Volume Identifier (Volume ID)

Use the new volume identifier parameter to provide a unique volume identification (ID) for a tape being
initialized for use as a standard labeled tape. This parameter is required for tape cartridges. This option is
not required by 1/2-inch tape reels.
v On the Initialize Tape display, type the volume identifier of your choice in the new volume identifier
parameter. The identifier can be no longer than six characters in length and should not start with a *.

Check for Active Files

An active file has an expiration date that is equal to or later than the current date.

Select one of three options to complete the parameter:


v Type *YES in the check for active files parameter if you want all data files on the tape to be checked
before the tape is initialized. If an active file is found, the tape volume is not initialized and you receive
an error message.
Important: Check for active files=*YES is the default option. The processing of tapes that have a
large file, or tapes that have many files, may take a long time. The processing of 8-millimeter tapes may
take up to 3.5 hours.
v Type *NO in the check for active files parameter if you want the tape to be initialized immediately
without checking for active files. Use *NO when:
– The tape or data cartridge is new.
– You are sure you want the volume initialized and you want the INZTAP processing to complete in the
minimum amount of time.
– You are sure you want the volume initialized and the INZTAP command failed when you entered
*YES or *FIRST in the parameter field.
IMPORTANT:If you type *NO in the Check for active files parameter, the system writes over all data
that is on your tape. Make sure the tape cartridge you are using is new. If the tape you are using is
not new, be certain that you want the tape volume initialized regardless of the data that is on the
tape.
v Type *FIRST in the check for active files parameter if you want to check only the first file on the tape. If
this file is active, the tape volume is not initialized. The processing time for this parameter option
depends on the size of the first file on the tape.

Tape Density

The tape density parameter determines the amount of data recorded per inch of tape. The choice of
density also changes the format of 1/4-inch and 8-mm tape cartridges.

If you are initializing two or more reels or cartridges for a multi-volume SAVE operation, the density and
format of all volumes must be the same.

Clear

112 iSeries: Getting started with iSeries


The clear parameter is used to erase all of the data on the tape medium that follows the standard volume
label record at the beginning of the tape. The Magstar MP, 1/2-inch, and all 1/4-inch tape drives except the
QIC-5010 tape drive have an erase head that erases all data tracks in one pass. The QIC-5010 1/4-inch
tape drive and the 8-mm tape drive erases at the normal write speed. This can take a very long time.

Note: Using the clear parameter to erase QIC-5010 1/4-inch tapes and 8-mm tapes is not recommended
because the process time for erasing 8-mm tapes can be up to 3.5 hours.

Copying Tapes
To copy a tape:
1. You must have two tape drives.
2. Make sure the tape units are turned on.
3. Load the tape to be copied into one tape unit.
4. Load the tape receiving the information in the other tape unit.
Note: If the tape that receives the information is new, you must initialize it before continuing. See Tape
Volume, Initialization, and Volume ID“Tape Volume, Initialization, and Volume ID” on page 111 for
information on how to initialize a tape.
5. Enter the Duplicate Tape (DUPTAP) command and press F4 (Prompt).
6. Specify the name of the tape unit from which the information is to be copied in the From device
(FROMDEV) parameter.
7. Specify the name of the tape unit to which the information is to be copied in the To device (TODEV)
parameter.
8. Press Enter. A message is displayed when it is time to insert a new tape.

Monitoring Tape Volume Statistics


To ensure that your tapes are in good condition, you should monitor the tape volume statistics on your
iSeries system.
1. Use the Start System Service Tools (STRSST) command.
2. Select option 1 (Start a service tool) on the System Service Tools menu.
3. Select option 1 (Product Activity Log) on the Start a Service Tool menu.
4. Select option 4 (Work with removable media lifetime statistics) on the Product Activity Log menu.
5. Select the type of removable media for which you want data on the Select Media Option display. The
Work with Lifetime Statistics display appears.
+--------------------------------------------------------------------------------+
| Work with Lifetime Statistics |
| |
|Removable media . . . . . . : 1/4 inch cartridge tape |
| |
|Type options, press Enter. |
|4=Delete entry 6=Print entry |
| |
| Volume --Temporary Errors--- --------K Bytes------- |
|Option ID Read Write Read Written |
| >>PHB021 23452450 23450 23457123 97689690 |
| THB021 2 0 14307 0 |
| AIPLT 0 3 214494 137546 |
| AD0000 0 0 3 0 |
| AIPL 0 0 2 27620 |
| IVIHE 0 0 1 0 |
| MM 0 0 361 0 |
| PHB031 0 0 2 0 |
| PTFFIX 0 0 3 432 |
| |
| |
|F3=Exit F5=Refresh F10=Delete all |
|F11=Print all F12=Cancel |

Chapter 8. Managing system operations 113


| |
|(C) COPYRIGHT IBM CORP. |
+--------------------------------------------------------------------------------+
6. If you see the following symbols preceding the volume ID on the Work with Lifetime Statistics display,
take the appropriate action:

Symbol Explanation Action to take


>> Media replacement recommended Copy the contents of the media to a new
tape and discard the old tape.
> Media approaching replacement criteria v Replace the tape if the tape format is:
– QIC-120
– 7208 2.3GB
– 6250 bpi density
v If the tape format does not fulfill the above
conditions, continue to monitor this tape to
ensure that media replacement is not
necessary.

Note: To ensure accurate statistics, each tape cartridge or reel must have a unique volume ID.

When to Clean
After 400 MB of data transfers have occurred for the volume ID, the Error Log Utility uses the following
guidelines to determine whether a particular tape should no longer be used.
v Discard tape reels and tape cartridges that have a permanent read or write error.
v If all tapes used in a single drive exceed the criteria that follows this list, the read/write head are
probably dirty and should be cleaned.
v If a specific tape exceeds the criteria that follows this list, copy the contents to a new tape and discard
the old tape.

Storage Device Ready Conditions


Use the table below if you are having trouble making a device ready. All the conditions listed for each
device must be correct for the device to be ready.

If you are not able to make a device ready, contact your service representative.

Storage Device Ready Conditions

Tape Unit Ready Description Reference Information


2440 v Power light is on IBM 2440 Magnetic Tape Subsystem
Operator’s Manual G571-0149.
v Tape is loaded
v Status display shows A 0
v Online light is on

114 iSeries: Getting started with iSeries


Tape Unit Ready Description Reference Information
1/4-inch v Tape cartridge is inserted.
– The tape cartridge must be changed or, to
reuse the same cartridge, the tape cartridge
must be reloaded under the following
conditions:
- The tape unit was made unavailable (varied
off).
- The tape application program ended with the
*UNLOAD option.

7208/6390 8mm v Power light is on See the appropriate operator’s guide


for your specific model.
v Tape cartridge is inserted
v Ready light is on

9347 v Power light is on 7208 20 GB External 8mm Tape Unit


Model 342 Setup and Operator’s
v Load/Rewind light is on
Guide, SA37-0319.
v Online light is on

9348 v Power light is on 9348 Customer Information,


SA21-9567.
v Tape is loaded
v Status display shows 00 A002
v Online light is on

3422/3430 v Power light is on IBM 3422 Magnetic Tape Subsystem


Operator’s Guide, GA32-0090.
v Enable/Disable switch is set to the Enable position
v Tape is loaded
v Ready light is on

3480/3490/3490E v Power light is on See the appropriate operator’s guide


for your specific model.
v DC Power light is on
v Control unit Online switch is set to the Online
position
v Control unit Normal/Test switch is set to the
Normal position
v Control unit channel Enable/Disable switch is set
to the Enable position
v Tape unit Online/Offline switch is set to the Online
position
v Tape is loaded
v Tape unit displays Ready U or Ready F

3570/3590 v Tape is loaded


v Tape unit displays Ready

Chapter 8. Managing system operations 115


Using CD-ROM Storage
The CD-ROM drive is a read-only drive. The feature code for the iSeries CD-ROM drive is 6320 or 6321.
The figure below shows the CD-ROM drives on the 9402/9404 Models 4xx and 9404/9406 Models 5xx.

Note: The CD-ROM drive on the iSeries system is not enabled for the digital audio disc.

Loading and unloading a CD


1. Remove the CD from the protective case.

RV3P172-0

2. Slide the CD into the CD tray with the label side showing. If your CD-ROM is vertically positioned,
make sure that the CD is secured by the two tabs at the bottom of the CD tray as shown on the left in
the following illustration.

116 iSeries: Getting started with iSeries


3. When you have properly positioned the CD in the CD tray, press the Eject button or push the tray into
the CD-ROM drive.

RV3P174-0

4. To remove the CD from the CD-ROM drive, press the Eject button.

RV3P175-0

Cleaning
No preventive maintenance is necessary for the CD-ROM drive. Always handle discs by the edges to
avoid finger prints. Discs can be wiped with a soft lint-free cloth or lens tissue. Always wipe in a straight
line from the inner hub to the outer rim.

Verify Optical Device


The Verify Optical(VFYOPT) command can be used to detect hardware errors, or verify whether a problem
has been resolved. This function can be used to verify a CD-ROM drive or a directly attached optical
media library device.

To use this function, do the following:


1. On any command line, type
VFYOPT DEV(xxxxxxxxxx)

where xxxxxxxxxx is the device name.

A display is shown with instructions on how to perform verification test.

Chapter 8. Managing system operations 117


2. Follow the instructions, and press the Enter key. The verification test is run.
If the test completes successfully , you will receive a message about the successful completion. If
hardware errors occur during the test, you will receive an error message.

Using Optical Media Libraries


The IBM 3995 Optical Library Dataserver is a storage device for the iSeries system that provides
removable and permanent storage of information on optical media. The 3995 Optical Library lets you
access data right at your work station. It is an alternative to retrieving data that is traditionally kept on
paper, stored on diskette, stored on microfilm, or stored on magnetic tape.

If you are using the 3995 Optical Media Library and would like more information, see the following
manuals:
v IBM 3995áAS/400 Optical Library Dataserver: Operator’s Guide Models 142 and 042, GA32-0140

v Optical Support

Tape Drive Environment and Use


IBM’s goal is to provide you with a product that you can configure and use reliably. Tape drives require
specific maintenance and environmental conditions to operate well over time. Using high quality, data
grade media, handling and storing this media properly, operating the tape drive in a clean environment and
keeping the tape drive properly cleaned can help you to avoid problems with your IBM tape drive.

Media Grades
IBM uses two different grades of media. We supply program temporary fixes (PTF) on a tape that is
designed to be written to only once and read from a few times. This tape is designed for limited use, not
as a backup medium. IBM also sells media that are designed for storage use.

IBM supports the tape that we sell. If analysis by IBM service personnel indicates a problem with non-IBM
media, it may be necessary for the customer to replace the media.

Tape Handling and Storage


Most tape arrives in a sealed cartridge so that the tape will remain in a clean environment. Opening the
cartridge allows dirt and airborne particles to enter and then become a source of contamination. Only the
tape drive should open the cartridge; not an operator. Inside the cartridge, the tape is under proper
tension. If the cartridge is dropped, this tension will be relaxed. Inserting a dropped cartridge into a tape
drive can cause incorrect loading and result in a jam. This will ruin the tape and can cause physical
damage if the cartridge is not removed properly.

To store the tapes properly, put them in their protective containers and store them on their ends. The
storage area must be clean, dry, normal room temperature and away from any magnetic fields.

Environmental Issues
Tape drives are designed to operate in a clean environment. Problem factors are dirt, dust, fibers, and
airborne particles. Airborne particles are the most difficult to address. When you install a tape in the tape
drive, the clearance between the heads and the tape is measured in microns. Particles can damage the
tape or the head if they come in contact with either. IBM offers a tape drive filter enclosure for some
systems to solve this problem. The enclosure draws air in through a filter and supplies the tape drive with
clean air. Customers are responsible to provide a clean operating environment for the tape drive and
system.

Tape Drive Cleaning


Dirt may build up on the heads of any tape drive, no matter how clean the environment. Every time tape
motion occurs, some of the media surface comes off on the heads. Over time, this builds up and causes
errors in reading and writing.

118 iSeries: Getting started with iSeries


We only recommend that you use IBM cleaning cartridges for IBM tape drives.

You can use cleaning cartridges a limited number of times. Once a cleaning cartridge has been used to its
maximum number of times, the usefulness of the cartridge expires. When cartridges expire, replace them.
Never reuse an expired cleaning cartridge. Doing so allows previously removed dirt to be reintroduced to
the tape drive. When you have cleaned the tape drive, mark the usage on the cartridge in order to best
determine when your IBM cleaning cartridge has expired.

Microcode Updates
IBM constantly works to provide the best possible tape drive products. To make certain that the drives
work their very best, IBM occasionally releases changed microcode for the tape drives. When a microcode
change is developed, IBM makes it available to you through the service organization or by electronic
delivery.

Microcode changes are also available by downloading and installing fixes using Electronic Customer
Support, or by ordering and installing cumulative fix packages from IBM Global Services.

Summary
Install your tape drive in the cleanest possible environment. IBM tape drives require high quality, data
grade tapes, and cleaning on a regular basis. Store and handle media properly. Improper use, storage, or
handling of tape drives or media may void your IBM warranty, or service agreement.

If a tape drive stops functioning due to a component failure during the tape drive warranty or maintenance
time, IBM will replace the tape drive unit. IBM will replace any defective tape drive under the terms and
conditions of the IBM warranty or service agreement. It is our objective to work with you to identify the
cause of any tape drive problems and provide a solution.

Using 1/2-Inch and Magstar MP Tape Cartridges


Before You Start:
Inspect the cartridge and do not use it if:
v The cartridge case is cracked or broken.
v The leader block or the latch is broken.
v The file-protect selector is damaged.
v The cartridge case contains any liquid.
v The cartridge case has any other obvious damage.
v The tape is wound completely out of the cartridge onto the machine reel and then reattached to the
cartridge reel by the service representative. This repair is temporary and permits the cartridge to be
loaded one time so that the data can be copied on a replacement cartridge.
Note: If you have a damaged cartridge, substitute a backup version of the data from another cartridge.
If the cartridge has a detached leader block but no other damage, you can repair the cartridge with the
IBM Leader Block Repair Kit.

If dirt appears on the external surface of a cartridge, lightly moisten a lint-free cloth (IBM part 2108930)
with IBM cleaning fluid (IBM part 8493001), or its equivalent, and wipe the outside surfaces.

Important: Do not allow anything wet, including the cleaning fluid, to contact the tape.

Make sure all cartridge surfaces are dry and the leader block is snapped into place before you load the
tape cartridge.

Protecting Data Stored on 1/2-Inch Tape Cartridge


To protect the data, roll the thumbwheel selector on the side of the cartridge left or right until it is in the
correct position.

Chapter 8. Managing system operations 119


The 3570 and 3590 data cartridges are preformatted with data servo tracks. These cartridges should not
be bulk erased. The 3570 and 3590 tape devices have control data at the beginning of each cartridge. The
device updates (writes) this region every time a cartridge is loaded. As a result, the device display will
state writing even if you have file protected the cartridge. This data is separate from the user data.

Note: For more detailed information about using 1/2-inch tape cartridges, see Care and Handling of the
IBM Magnetic Tape Cartridge GA32-0047

Protecting Data Stored on Magstar MP Tape Cartridge


To protect the data, slide the file protect selector on the end of the cartridge until it is in the correct
position.

Note: For more detailed information about using Magstar MP tape cartridges, see the IBM 3570 Magnetic
Tape Subsystem Operator’s Guide

Using 1/4-Inch Cartridges


The image below shows a 1/4-inch tape cartridge and the box used for storage.

Attention: Do not attach labels to the edges of the 1/4-inch tape cartridges; this may interfere with the
cartridge sensors and cause the tape to run off the end of the spools.

Tape Cartridge and 1/4-Inch Tape Unit Compatibility:


For full read/write capability, follow the guidelines in the table below to determine which tape cartridges to
use for each tape unit.

Compatibility Between Tape Cartridges and Tape Units

Capacity and Date Rate by Media Type/Format Read/Write Support by Tape Unit Feature Code Number1,2
Media iSeries Data Capacity 6380 6381 4482 4483 6385 4486
Type (IBM Format Compaction3 and Data 6480 6481 4582 4583 6485 4586
P/N) (density) Rate4 6382 6383 6386
6482 6483 6486

MLR3- MLR3 Yes 2.5GB No No No No No R/W


25GB 2.0MB/s
(59H4128)

120 iSeries: Getting started with iSeries


Capacity and Date Rate by Media Type/Format Read/Write Support by Tape Unit Feature Code Number1,2
MLR1- QIC5010 Yes 16GB No No No R/W R/W R/W
16GB 1.5MB/s
(59H4175)
DC5010 QIC5020 Yes 13GB No No No R/W R/W R/W
(16G8574) 1.5MB/s
SLR5-4GB QIC4DC Yes* 8GB No No R/W R No R
(59H3660) 760KB/s
SLR5-4GB QIC4GB No 4GB No No R/W R No R
(59H3660) 380KB/s
DC9250 QIC2DC Yes* 5GB No R/W R/W R No R
(16GB8436) 600KB/s
DC9200 QIC2DC Yes* 4GB No R/W R/W R No R
(16G88541) 600KB/s
DC9250 QIC2GB No 2.5GB R/W R/W R/W R R/W R
(16G8436) 300KB/s
DC9200 QIC2GB No 2GB R/W R/W R/W R R/W R
(16G8541) 300KB/s
DC9120 QIC1000 No 1.2GB R/W R/W R/W No R/W No
(21F8730) 300KB/s
DC9100 QIC1000 No 1GB R/W R/W R/W No R/W No
(16G8539) 300KB/s
DC6525 QIC525 No 525MB R/W R/W R/W No R/W No
(21F8597) 200KB/s
DC6320 QIC525 No 320MB R/W R/W R/W No R/W No
(21F8583) 200KB/s
DC6150 QIC120 No 120MB R/W R/W R/W No R/W No
(21F8578) 120KB/s
DC6150 QIC24 No 60MB R R No No No No
(21F8578) 92KB/s

1. Refer to Recommended cleaning cartridges to correlate the tape unit feature code number to the tape unit front
bezel label.
2. In the Tape Unit Feature Code # columns, ″R/W″ indicates both read and write support of the associated media
type and format. An ″R″ indicates read only. ″No″ indicates that the media type and format is not supported.
3. Data Compaction is a term used to describe a data recording option for compacting (or compressing) data prior
to writing to the tape media. Selecting the data compaction option will usually result in an increase in both
capacity and data transfer rate. The typical compaction ratio is 2:1, but is dependent upon the type of data. A
″Yes″ in the Data Compaction column means that the associated media type and format supports data
compaction. The OS/400 SAVE command parameter COMPACT is used to select the data compaction option,
except for those cases identified by a ″Yes*″. A ″Yes*″ indicates that the compaction option is controlled
entirely by the format (density) that is selected during the tape initialization operation. The OS/400 SAVE
command parameter COMPACT will have No effect in these cases.
v QIC2DC is a compaction format (density) for the DC9250 and DC9200 media type.
v QIC4DC is a compaction format (density) for the SLR5-4GB media type.
4. Cartridge capacities and data transfer rates shown are for non-compacted data, except for the QIC4DC and
QIC2DC cases. For the QIC4DC and QIC2DC formats (densities), the capacities and the data transfer rates
shown assume a typical 2:1 data compaction. See Note 2.

If the QIC format and the tape cartridge are not compatible, an error message displays. Errors that can
occur are:

Chapter 8. Managing system operations 121


v Selecting a QIC format that cannot be written on the tape. For example, inserting a DC6150 tape
cartridge and specifying a QIC1000 format.
v Attempting to process a high density tape cartridge in a low density tape unit. For example, you try to
process an SLR5-4GB cartridge in a 6381 tape unit.
v Attempting to add a file and selecting a QIC format different from the format previously recorded on the
tape. For example, inserting a tape cartridge recorded in QIC525 format and specifying a QIC120
format.

Note: When purchasing non-IBM tape cartridges, purchase a small quantity to verify the tape quality.
Quality tape reduces the possibility of tape cartridge problems.

Loading 1/4-Inch Tape Cartridges: To load a 1/4-inch tape cartridge in a QIC-4GB-DC, QIC-2GB(DC),
or QIC-2GB tape unit:
1. Push the pushbutton on the tape unit door to release the door.
2. Pull the tape unit door out, then push it down.
3. Insert the tape cartridge into the tape unit.
The cartridge should be inserted firmly until it cannot go any further into the tape unit. About 10-mm
(3/8 inch) of the cartridge remains outside the tape unit.
4. Lift up the tape unit door, then push it closed. The cartridge does not go all the way into the tape unit
until the tape unit door is closed. Use moderate force to close the door. Slamming the door shut may
damage the tape unit.
Push the door until the latch holds the door closed.

To load a 1/4-inch tape cartridge in an MLR3 or an MLR1 tape unit, insert a tape cartridge through the
cover door until the loading mechanism pulls the cartridge into the drive. This allows the door to close.

For older tape cartridge types, the 1/4-inch tape units run a retension operation whenever a tape cartridge
is loaded. The tape unit will also run a retension operation if a tape cartridge is in the tape unit when the
door is closed. Retension means that the tape unit moves the tape to the end-of-tape position and rewinds
it to the beginning-of-tape position. The retension operation is part of the load sequence. When using
MLR3-25GB, DC5010, and MLR1-16GB tape cartridges, the tape units run the retension operation only
when necessary (as determined by the tape unit) to maintain correct tape tension. The approximate
retension times are as follows:

Retension Times for 1/4-Inch Tape Cartridges

Tape Cartridge Approximate Retension Time


MLR3-25GB Less than 8 minutes
MLR1-16GB Less than 8 minutes
DC5010 Less than 6 minutes
SLR5-4GB Less than 8 minutes
DC9250 Less than 4 minutes
DC9120 Less than 4 minutes
DC6525 Less than 4 minutes
DC6320 Less than 3 minutes
DC6150 Less than 3 minutes

Unloading 1/4-Inch Cartridges: Important: For the QIC-4GB-DC, QIC-2GB(DC), or QIC-2GB tape unit,
do not remove a tape cartridge if the tape unit status light is green. For the MLR3 and MLR1 tape units,
do not remove a tape cartridge if the tape unit activity light is on. Only a cleaning cartridge can be
removed when the status light is green or the activity light is on.

If you remove a tape cartridge while the status light is green, or the activity light is on, you may have the
following problems:

122 iSeries: Getting started with iSeries


v A system message indicates that an error has occurred and the tape job must be repeated.
v You may not be able to retrieve data already on the cartridge because end-of-tape processing did not
complete.

To unload the MLR3 or MLR1 1/4-inch tape unit, wait until the activity light is off. Press the unload button.
The tape drive rewinds the tape, unloads and ejects the tape cartridge. If the tape cartridge cannot unload
and has to be removed manually from the tape drive, contact your service representative.

To unload 1/4-inch tape cartridges from the QIC-4GB-DC, QIC-2GB(DC), or QIC-2GB tapes units:
1. Push the pushbutton on the tape unit door to release the door.
2. Pull the tape cartridge unit door out, then push it down.
Moderate force is necessary to fully open the door with the tape cartridge in the tape unit. Excessive
force damages the tape unit.
3. Grasp the tape cartridge and pull the cartridge straight out of the slot. Turning the cartridge or pulling
too hard may damage the door mechanism.
4. Lift up the tape unit door, then push it closed.
Little force is required to close and latch the door when the tape unit is empty. Moderate force is
required when a tape cartridge is in the tape unit. Be sure to close the door on the first attempt. If the
door does not close completely and pops open, the tape drive may receive two retension commands.
This condition may cause an error which requires an initial program load (IPL) to recover.

If you remove the tape cartridge while the green light is on, turn the light off by:
v Inserting the cartridge again.
v Run the Check Tape (CHKTAP) command and specify *REWIND for the End of tape option (ENDOPT)
parameter.
Remember: Do not remove a tape cartridge from the tape unit unless the last command was run with
*REWIND or *UNLOAD specified for the End of tape option (ENDOPT) parameter.
If the last command ends with *LEAVE, the tape unit heads might be over a data area. To avoid this,
specify *REWIND or *UNLOAD for the End of tape option (ENDOPT) parameter of the last tape
command. You may also use the Check Tape (CHKTAP) command with *REWIND specified for the End
of tape option (ENDOPT) parameter.
Tape cartridges can be left in the drive for several hours or overnight if:
– The green light is off (*REWIND is specified for the End of tape option (ENDOPT) parameter).
– The room temperature does not vary by more than 9.5°C (15°F).
– Humidity levels are within the range that is shown in the table in Shipping, Storage, and Operating
Environments for 1/4-Inch Tape Cartridges“Shipping, Storage, and Operating Environments for
1/4-Inch Tape Cartridges” on page 127.

Status Lights for MLR3 or MLR1 Tape Units: The MLR3 and the MLR1 tape units have three indicator
lights: two green and one amber. These status lights are turned on and off in various combinations to
indicate the status of the tape unit.

Chapter 8. Managing system operations 123


The symbols that are located next to the status lights are the International Organization for Standardization
(ISO) symbols that define the general function of the status lights as follows:

(A) Ready. This light indicates the following conditions:


v Off - No cartridge installed or no fault condition
v Green - Cartridge installed, loading or unloading
v Green flashing - Power on self-test in progress.
(B) Activity. This light indicates the following conditions:
v Off - No cartridge installed. No activity or fault condition
v Green flashing - Cartridge activity
(C) Fault. This light indicates the following conditions:
v Off - No fault condition
v Amber - Cleaning required or worn tape media
v Amber flashing - Fault condition

The various on/off combinations of the status lights are shown in the following chart.

124 iSeries: Getting started with iSeries


Chapter 8. Managing system operations 125
Cleaning the 1/4-Inch Tape Unit: The 1/4-inch tape unit requires periodic head cleaning. Cleaning the
tape unit read/write head is important. This cleaning prevents a build up of debris that could cause
unrecoverable errors when writing or reading data. In general, the clean the head after every 8 hours of
tape movement when using IBM tape cartridges. Other tape media may require cleaning more frequently.
If using new tape cartridges it is advisable to clean the head after two (2) hours of tape movement, or
before loading each new tape cartridge.

Note: System messages are posted when the tape unit determines that cleaning is required. The MLR1,
MLR1-S, and MLR3 tape units also have a cleaning status light that indicates that cleaning is required. It
is very important to respond to these cleaning indicators and clean the head using a recommended
cleaning method.

Use the IBM Cleaning Cartridge Kits as recommended below.

Recommended IBM Cleaning Cartridges

Tape Unit Identification Recommended IBM Cleaning Cartridges


Front Bezel Label Feature Code P/N 59H4366 Note 1, P/N 46G2674 Note 1 P/N 16G8572
Numbers 2
MLR3 4486 Yes No No
4586
6386
6486
MLR1 QIC-5010-DC 6385 Yes Yes No
6485
MLR1-S 4483 Yes Yes No
QIC-5010-DC 4583
6383
6483
QIC-4GB-DC 4482 Yes Yes Yes
4582
6382
6482
QIC-2GB (DC) 6381 Yes Yes Yes
6481
QIC-2GB 6380 Yes Yes Yes
6480
Notes:
1. The cleaning cycle takes place automatically when the cleaning cartridge is loaded.
v For the MLR1, MLR1-S, and MLR3 tape units, the amber activity light flashes at a rate of 2 cycles per second
during the cleaning operation.
v For the QIC-4GB-DC, QIC-2GB (DC), and QIC-2GB tape units, the status light flashes at a rate of 1 cycle per
second during the cleaning operation. After the flashing stops, remove the cartridge.
2. The MLR3 tape unit uses an enhanced cleaning procedure. The duration of this procedure is approximately three
(3) minutes.

Protecting Data Stored on 1/4-Inch Tape Cartridges: To protect data from being overwritten:
v Set the pointer toward SAFE for older style tape cartridges, as shown in the first image below.
v Set the pointer toward the locked padlock icon for the newer style tape cartridges, as shown in the
second image below.

126 iSeries: Getting started with iSeries


To not protect the data:
v Set the pointer away from SAFE for the older style tape cartridges, as shown in the first image below.
v Set the pointer toward the unlocked padlock icon, for the newer style tape cartridges, as shown in the
second image below.

SAFE

Write-Protected

OR

SAFE

Not Write-Protected

RV2P749-0

Write-Protected

OR

Not Write-Protected

RV2P986-0

Shipping, Storage, and Operating Environments for 1/4-Inch Tape Cartridges


The recommended environment for operation, storage, and shipment of 1/4-inch tape cartridges is a
temperature of 15 to 25°C (59 to 77°F), and a relative humidity of 40 to 60%. The table below provides
maximum and minimum environmental conditions for safe shipment, storage, and use of the tape
cartridges for an iSeries tape unit. A hyphen (-) indicates that the dry bulb temperature is outside the
recommended range for safe operation, storage, or shipment.

Chapter 8. Managing system operations 127


Environment Ranges for 1/4-Inch Tape Cartridges

Dry Bulb Temperature Degrees Relative Humidity (Percent)


Celsius Fahrenheit Operating Storage Shipping
-40 -40.2 - - 20 to 80
10 50 20 to 80 20 to 80 20 to 80
20 68 20 to 80 20 to 80 20 to 80
30 86 20 to 55 20 to 73 20 to 73
40 104 - 20 to 32 20 to 32

Using 8-Millimeter Tape Units


The iSeries supports the following tape units:
v 7208 Models 002, 012, 222, 232, 234, and 342
v 9427 Models 210, 211
v Feature Code 6390

The 7208 Models 002, 012, 222, 232, 234, and 342 are external tape units for the iSeries System Units.

For the 7208 Model 002, refer to the following publication:


v IBM 7208 Model 002 2.3GB External 8mm Tape Operator Guide SA23-2675.

For the 7208 Model 012, refer to the following publication:


v IBM 7208 5.0GB External 8mm Tape Unit Model 012 Operator Guide, SA26-7036.

For the 7208 Model 222, refer to the following publication:


v IBM 7208 7.0GB External 8mm Tape Unit Model 222 Operator Guide, SA26-7117.

For the 7208 Model 232 and 234, refer to the following publication:
v IBM 7208 External 8mm Tape Subsystem Models 232 and 234 operator’s Guide, SA26-7104.

For the 7208 Model 342, refer to the following publication:


v IBM 7208 20GB External 8mm Tape Unit Model 342 Setup and Operator Guide, SA37-0380.

Note: The 7208-342 can read tapes written at the 2GB, 5GB, or
7GB formats. However, if a 20GB tape is inserted after the
drive has been using a lower density tape, the 20GB tape
is ejected and the drive will post a must clean message.
The drive must be cleaned using the correct cleaning
cartridge before it may be used again.

For the 9427 Models 210 and 211, refer to the following publication:
v IBM 7208 External 8mm Tape Subsystem Models 210 and 211 operator’s Guide, SA26-7108.

The feature code 6390 is an 8mm tape unit that is internal to the iSeries.

Status Lights for 8MM Tape Units: The 8mm tape units that support the 5.0GB, 7.0GB or 20GB format
have three indicator lights: two green and one amber. These status lights are turned on and off in various
combinations to indicate the status of the tape units.

128 iSeries: Getting started with iSeries


RV3P177-0

The symbols located next to the status lights are the International Organization for Standardization (ISO)
symbols that define the general function of the status lights as follows:

(A) Disturbance. The amber status light flashes whenever the tape unit encounters an irrecoverable
fault. It is on solid whenever the tape drive requires cleaning.
(B) Ready. The green status light is on solid whenever the tape unit is ready to receive the tape
backup commands.
(C) Read-Write. The green status light flashes whenever the tape unit is moving the tape.

The various on/off combinations of the status lights are shown in the following chart.

Chapter 8. Managing system operations 129


Status Lights State Status

On The Power-on Self Test (POST) is running or the


system has issued a reset to the drive.
On Note: The POST condition can occur either
when the power is first applied or after
On use of the diagnostic cartridge.

Off One of the following has occurred:


1. The power is off.
Off
2. The POST has completed successfully but no tape
Off cartridge was inserted.

Off A tape cartridge has been inserted and the tape drive
is performing a tape load/unload operation.
Off

Flashing

Off The tape load operation has completed and the tape
drive is ready to receive commands from the system.
On

Off

Off The tape is in motion and the tape drive is busy


running a device operation.
On

Flashing

Flashing The flash rate is fast (4 flashes per second) when


using the test cartridge. The flash rate is slow (1 flash
per second) when the tape drive has detected an
Off internal fault that requires corrective action. Refer to
your Service Guide or contact your service
Off representative.

On The tape path requires cleaning.

or Off or On

or Off or
Flashing
RV3P176-1

Using 1/2-Inch and Magstar MP Tape Units


The iSeries supports the following 1/2-inch tape units:
v 3480
v 3490
v 3490E
v 3494
v 3590

130 iSeries: Getting started with iSeries


The iSeries supports the following Magstar MP tape units:
v 3570

Tape Unit with Automatic Cartridge Loader: There are two ways that tape cartridges can be loaded
with the automatic cartridge loader:

Manual Mode: You insert tape cartridges one at a time by pressing the Start key.

Auto Mode: You can preload multiple tape cartridges. The tape
cartridges will automatically load when the previous
cartridge is unloaded.

Note: For the 3570, 3490Fxx, 3590, and 3494, the tape device supports a random mode of operation. In
random mode, the tape device operates as a tape library. Tape libraries require special considerations. For

more information, see the following book: Automated Tape Library Planning and Management .

Sharing Systems with a 3480, 3490, 3490E, or 3590 Tape Unit: The 3480, 3490, 3490E, or 3590 tape
units can be attached to:
v One or two input/output processors on the same iSeries system.
v Two iSeries systems.
v An iSeries system and a System/390*.

You can choose whether or not you want your 3480, 3490, 3490E, or 3590 tape unit assigned to an
iSeries system when the tape unit is varied on (made available for intended use). Assigning a tape unit
reserves the tape unit specifically for one system.

To assign a 3480, 3490, 3490E, 3570, or 3590 Tape Unit:


1. Use the Work with Device Description (WRKDEVD *TAP) command to work with a tape device
description. in the Assign device at vary on field and press Enter to assign the tape unit to the system.
Note: *YES is the default for Version 2 Release 3. For Version 2 Releases 1 and 2, the assign device
at vary on parameter was not optional. For releases prior to Version 2 Release 1, the assign function
did not exist.
2. Use the Vary Configuration (VRYCFG) command to vary off the tape unit.
Note: The Vary Configuration (VRYCFG) command can be run by using the VRYCFG command or by
using the Work with Configuration Status (WRKCFGSTS) command. To use the Work with
Configuration Status command, type WRKCFGSTS *DEV *TAP and press Enter.
3. Use the VRYCFG command to vary on the tape unit and assign it to the system.

If the tape unit is being used by the other system, a message is displayed that indicates the tape unit is
assigned elsewhere. The tape unit must be varied off (made unavailable) at the other system before it can
be varied on (made available) at a new system.

To leave a tape unit unassigned:


1. Use the Work with Device Description (WRKDEVD *TAP) command to work with a tape device
description. In the Assign device at vary on field and press Enter to leave the tape unit unassigned.
Remember: A tape unit that is unassigned may be varied on to both systems. The operator must
control the tape application programs so that the two systems do not interfere with each other. The
results of failing to control the tape application programs may be unpredictable.
2. Use the Vary Configuration (VRYCFG) command to vary off the tape unit.
3. Use the VRYCFG command to vary on the tape unit.

Chapter 8. Managing system operations 131


Remember:
v When a tape unit is being shared by two iSeries systems, the tape unit can only be in VARY ON
status on one system at a time. To use a drive, vary it on by typing the following on any command
line and pressing Enter:
VRYCFG CFGOBJ(TAPxx) CFGTYPE(*DEV) STATUS(*ON)
v If you do not want to vary on tape units during future IPLs, type the following on any command line
and press Enter:
CHGCTLTAP CTLD(TAPCTLxx) ONLINE(*NO)

After doing an IPL, to vary on only the controller, type the following on any command line and press
Enter:
VRYCFG CFGOBJ(TAPCTLxx) CFGTYPE(*CTL) STATUS(*ON) RANGE(*OBJ)

1/2-Inch and Magstar MP Tape Unit Addressing: For a 34xx or 35xx tape device attached to a type
6501 or 6534 IOP or a type 2729 IOA, the SCSI address must be set to 0 when the device is used for
IPL. The SCSI address can be set to any address except 7 when the device is not being used for initial
program load.

For a 34xx tape device attached to a type 2644 IOP, the controller address must be set to address 7. The
device address must be set to address 0 when the device is used for IPL. Address 8 can be used when
there is no device at address 0. The controller and device can be set to any value when the device is not
being used for IPL.

Backing Up and Restoring Data with the 1/2-Inch and Magstar MP Tape Unit: The 3480, 3490,
3490E, 3570, or 3590 attached tape unit is most often used to back up and restore data. You can use
multiple tape units to back up and restore data plus the automatic cartridge load function to do an
unattended backup. When using multiple tape units, the sequence of tape media used is across the tape
units: the first tape is on tape unit 1, and the second on tape unit 2.

For example, if you use the 3490 tape unit (model D32) with the automatic cartridge load function to back
up the data, 12 cartridges can be loaded using the automatic cartridge load function. When the job is
complete, tapes 1, 3, 5, 7, 9, and 11 are in tape unit 1. Tapes 2, 4, 6, 8, 10, and 12 will be in tape unit 2.
To restore the data, the odd-numbered tapes must be loaded into tape unit 1 and the even-numbered
tapes in tape unit 2.

Before backing up data, all tapes should be initialized on the model and type of tape unit that will be used
to do the backup. Tapes that are initialized on other tape units may not be recognized by the system.
Tapes that are initialized on a 3490 D3x tape unit cannot be used on 3490E D4x or Cxx tape units.

Cleaning the 3480, 3490, 3490E, and 3590 Tape Unit: On the average, clean the tape path on each
drive every seven days. If you use an unusually large amount of tape, clean the tape path more often. If
the drive displays a *CLEAN message, clean the tape unit path as soon as possible. You should also
clean the tape path after each initial program load (IPL), after a drive is reset, or whenever the power on
the tape drive has been interrupted.

To clean the tape path, insert the special cleaning cartridge as you would a normal tape cartridge. The part
number for the 3490 cleaning cartridge is 4780527. The part number for the 3590 cleaning cartridge is
05H4435. Keep track of the number of uses on the label provided with each cleaning cartridge and then
throw the cartridge away after 500 uses.

Tip:
1. Do not use a grease pencil on the label.
2. The cleaning cartridge should be undamaged and clean when it is inserted into a tape unit.

132 iSeries: Getting started with iSeries


If your tape unit has the automatic cartridge loader feature, put the cartridge into the feed position and
press the start pushbutton. The cleaning cartridge can also be put into the input stack, and the cleaning
procedure takes place whenever the cleaning cartridge is loaded into the drive. If you start cleaning during
a job, an inquiry message is displayed. After responding to the message, the drive threads the cleaning
tape, cleans the read/write head, and then rewinds and unloads the cleaning cartridge. When the cartridge
has been unloaded, remove it and mark the usage label.

Cleaning the 3490 Fxx, 3494, and 3570 Tape Units: These tape units provide random access to the
tape cartridges. When the device detects that cleaning is needed, the tape unit will perform the cleaning
operation automatically, if the cleaning cartridge is in the internal cell (known only to the Random Access
Cartridge Loader). The tape unit keeps track of the number of cleaning operations performed by the
cleaning cartridge and ejects the cleaning cartridge through the priority cell when the cleaning cycles
allowed for the cleaning cartridge have been used up. The part number for the 3590 Tape Cleaning
Cartridge is 05H4435. The part number for the 3570 Tape Cleaning Cartridge is 05H2463.

Using 8-Millimeter Tape Cartridges


The following are the cartridges you can use in the 8-mm tape unit:

Cartridge Name Description Notes


Test Cartridge #21F8577 Test Cartridge #21F8577 is used to This test cartridge may be used with
write test data onto a tape cartridge. the 2.3GB, 5.0GB, and 7.0GB 8-mm
The tape unit reads the recorded data tape units.
to check the write operation. Do not
use this cartridge to save programs or
data.
Test Cartridge #59H2677 Test Cartridge #59H2677 is used to This test cartridge can only be used
write test data onto a tape cartridge. with the 20GB 8mm tape unit.
The tape unit reads the recorded data
to check the write operation. Do not
use this cartridge to save programs or
data.
Diagnostic Cartridge #46G2660 Only use the Diagnostic Cartridge Diagnostic Cartridge #46G2660 may
when the system is not available and not be used with the 7208 Model 002
you are not able to use Test Cartridge or Model 342 tape units. Call your
#21F8577. This diagnostic cartridge service representative for additional
contains a program that tests only the copies of the Diagnostic Cartridge.
read capability of the tape drive.
8-mm (112-m) Tape Cartridge Use this cartridge to save your Tape cartridges 21F8595 and
#21F8595 programs or data. Each tape cartridge 87G1601 can be read in the 7208
provides up to 2.3GB of storage with Model 342 but cannot be written.
the 7208 Model 002 or 5.0GB of
storage on the 8-mm 5.0GB or 7.0GB
tape units.
8-mm (160-m) Tape Cartridge Use this cartridge to save your á
#87G1601 programs or data. Each tape cartridge
provides up to 7.0GB of storage with
the 7208 Models 222 and 234, 9427
Models 210 and 211, and Feature
Code 6390.
8-mm Tape Cartridge #59H2678 Use this cartridge to save your This cartridge cannot be used in the
programs and data with the 7208 7208 Models 002, 012, 222, 232, 234
Model 342. or in the 9427 Models 210, 211, or in
the feature code 6390.

Chapter 8. Managing system operations 133


Cleaning Cartridge #21F8593 and Use this cartridge for cleaning the á
#16G8467 2.3GB, 5.0GB, and 7.0GB 8-mm tape
unit heads. #16G8467 is a mildly
abrasive cleaning tape and should be
used whenever tape unit problems
are encountered.
Cleaning Cartridge #59H2898 Use this cartridge for cleaning the This cartridge cannot be used in the
7208 Model 342. 7208 Models 002, 012, 222, 232, 234
or in the 9427 Models 210, 211, or in
the feature code 6390.

Loading the 8-Millimeter Tape Cartridge


To load a tape cartridge, push the blue load/unload pushbutton on the tape drive.
v For the 7208 Model 002 tape unit, the tape drive opens, and a cartridge tray ejects. After a tape
cartridge is inserted, push the tape drive door until the mechanical latch holds the door closed. The tape
drive loads the tape from the tape cartridge.
v For all the other 8mm tape units, insert a tape cartridge through the cover door into the tape drive. The
tape drive loads the tape from the tape cartridge.
If you need more information, see Using 8-Millimeter Tape Units“Using 8-Millimeter Tape Units” on
page 128.

The tape takes about 25 seconds to load. When the green ready light comes on, the drive is ready for
data operations.

You can type commands on your display station while the tape is loading. Any commands to the tape unit
start running once the tape has finished loading. Commands that do not require the tape cartridge are run
immediately.

Unloading the 8-Millimeter Tape Cartridge


You can unload a tape cartridge by a system command or by pushing the load/unload pushbutton on the
tape drive. Depending on the position of the tape, the time for rewind and unload is between 18 seconds
and 3 minutes.

The drive rewinds the tape within the cartridge.


v The 7208 Model 002 tape unit ejects the tray containing the tape cartridge. After a cartridge is removed,
another cartridge may be inserted. To keep dust and other contaminants out of the tape drive, push the
drive door closed until the mechanical latch holds the door closed.
v The 7208 Models 012, 222, 232, 234, 342 or the 6390 tape unit ejects the tape cartridge, which can
then be removed.

If the tape cartridge cannot unload and has to be removed manually from the drive, contact your service
representative.

Protecting Data Stored on 8-Millimeter Tape Cartridges


The window on the tape cartridge that is shown here controls write protection. To prevent data from being
written on the tape cartridge, slide the tab so that the window is closed. To allow data to be written on the
tape cartridge, slide the tab so that the window is open.

134 iSeries: Getting started with iSeries


Erasing Data on the 8-Millimeter Tape Cartridge
To erase data on an 8-mm tape cartridge, use a tape erasing device that has a magnetic coercivity
strength of 1500 oersteds or more.

Note: You may also erase the tape by specifying *YES for the Clear parameter on the Initialize Tape
(INZTAP) command. However, this method takes up to 3.5 hours. For the 160-m tape unit, it may take up
to 5 hours.

Using 1/2-Inch tape reels


Use the following tape and reel recommendations for maximum performance and reliability:

Tapes
1.5 mil thick
A maximum of 733.7 meters (2400 feet)

Reels
15.24 cm (6.0 inches)
17.78 cm (7.0 inches)
21.58 cm (8.5 inches)
26.67 cm (10.5 inches)

Using tapes that are longer than 2400 feet is not recommended. Using these tapes will cause the tape unit
head to wear incorrectly. You could have an increase in read and write errors.

Chapter 8. Managing system operations 135


17.78 cm
(7.0 inches)
21.58 cm or
(8.5 inches)
26.67 cm
(10.5 inches)

Tape must be
1.5 mils thick

Tape no longer than 733.7 meters


(2400 feet) RV2P719-2

Follow these tips to ensure that your tape reels are used correctly:

Important:
v Secure the end of the tape with a tape end fastener when not in use.
v Keep the reel protected with a locking collar when not in use.
v Store tapes in a vertical position.

Do Not:
v Squeeze the outer flanges of the reels when handling and loading tape. Hold the tape evenly around
the outer edge by the palm of your hand.
v Allow tape ends to drag on the floor and get dirty.
v Touch the tape surface.

Preparing a Tape Leader


A tape leader that is square or damaged can cause the tape to load incorrectly in units that automatically
load tapes. When using this type of tape unit, ensure that the tape loads correctly by:
v Preparing the tape leader with the tape leader tool (IBM part 2512063).
v Pressing hard when cutting the tape. This prevents static problems on the tape leader.

The figure below shows how to correctly prepare a tape leader.

136 iSeries: Getting started with iSeries


Loading the 1/2-Inch Tape Reel
When loading 6-inch and 10-inch reels of tape on the 9348, carefully place the tape reel on the center of
the hub.

When loading a tape reel, ensure that the loose end of the tape is on the tape reel and not under the reel.

Protecting Data Stored on the 1/2-Inch Tape Reel


To prevent the drive from writing data, remove the write enable ring (shown below). To allow the drive to
write on the tape, install the write enable ring.

Chapter 8. Managing system operations 137


Cleaning the 1/2-Inch Tape Reel Unit
Use the table below as a guide to establish how often to clean your tape reel unit.

Cleaning the 1/2-Inch Tape Reel Unit

When: Clean the tape path:


Less than ten reels are used in eight hours. Every eight hours.
More than 10 reels are used in eight hours. Every one to two hours of running.
Particles appear on the tape path or you are using new After each reel.
or seldom used tapes.

Use the following cleaning supplies:


v Tape cleaning kit, IBM part 352465 or equivalent
v Cleaning fluid, IBM part 8493001, 13F5647, or equivalent
v Lint-free cloth, IBM part 2108930
v Rigid cleaning tool, IBM part 2200574 or equivalent

To clean the tape reel unit:


1. Set the power switch to the Off position.
2. Clean the following areas using a lint-free cloth or swab and cleaning fluid:
v Read/write head
v Tape cleaner block
v Tape guides
v General tape path

138 iSeries: Getting started with iSeries


Pay particular attention to the read/write head and tape cleaner block. Push hard against the read/write
head. Dry the areas with a lint-free cloth until the cloth comes away clean.

If the tape unit is cleaned thoroughly and a particular tape is causing errors, discard the tape.

Chapter 8. Managing system operations 139


140 iSeries: Getting started with iSeries
Chapter 9. Handling system problems and getting help
through electronic customer support
When something goes wrong, help is available to get your system up and running again. These articles
help you determine exactly what the problem is and how you can resolve it.

Start here to solve problems:

Go here ... If you want to ...


Troubleshoot printer problems Solve printing difficulties.
Resolve Universal Connection Wizard problems Solve problems before re-running the wizard.
Locate the service agent that you need.
Contact electronic customer support
Choose the fix you need from IBM’s support page.
Get fixes
View your system configuration list View your current configuration information.
Use the troubleshooting flowchart Determine what the problem is and how you can solve it.
Troubleshooting with Systems Management Get help with system and application problems.

Additional information on this topic can be found in these sources:

Getting help with system operation problems

Troubleshooting printer problems


Printing is a two-step process on your system, and problems can arise in either step: you cannot send
material to the printer, or your printer is not receiving the material you send. This topic describes steps to
take to solveáthese problems and other printing problems.
v Solving problems with sending jobs (LPR)
v Solving problems with receiving jobs (LPD)
v Finding an unprinted job

v Reasons Why a Printer Will Not Print

Additional information on this topic can be found in these sources:

Printing and device programming

Solving problems with sending jobs


The system handles the various parameters passed to the LPR command. Sometimes, they need to be
formatted in a particular way to work correctly. Examples are given for some of the most common error
conditions.

LPR command considerations


When the system passes alphabetic characters to a command processing program from a command, it
converts all of the characters to uppercase. Enclosing the parameter in apostrophes preserves the case of
the characters. This is required if you use filters for the DESTOPT parameter. It may be required for the
PRTQ parameter of the LPR command, depending on the case sensitivity of the destination system.

© Copyright IBM Corp. 1998, 2001 141


Common error messages
If a problem is detected when usingáyour system’s LPR client, most problem analysis can be done by
examining the job logs of the user and the message help text for the issued error message.

Send request failed for spooled file XYZ is the error message for both TCP3701 and TCP3719.
Examine the message help text, however. If the message is TCP3719, the error may be that the printer
queue name is incorrectly spelled or the case of the printer queue name does not match that of the printer
queue on the destination system.

If the message is TCP3701, look in the job log for the previous messages to determine the failure.á
Common failures are caused by the following:
v Destination system name is misspelled.
v Destination system name is not defined in the TCP/IP host table
v LPD server is not started on the destination system
v TCP/IP is not started on the destination system

Examine the message help text for any previous messages to determine error recovery procedures.

Materials required for reporting LPR problems


Include the following information when reporting any LPR problem to IBM:
v The QTCPIP and LPR client job logs.
v If file or data integrity is compromised, then any files that were being sent.
v If the file being sent is being transformed, a copy of the workstation customizing object being used.
v All options taken on the LPR command when trying to send a file.
v The type of remote host, operating system, and operating system version to which the LPR command
was attempted, for example, PS/2 to OS/2, PS/2 to DOS, or RS/6000 to AIX.
v Special authorities in the user profile of the sender; the owner of the file; and the output queue
parameters AUTCHK, OPRCTL, and the DSPOBJAUT to get all authorities of the user to the output
queue.
v A communications trace from the time of the failure (Format TCP/IP data only field), formatted for ASCII.
If you are not familiar with the procedure for collecting a communications trace, refer to Collecting a
communications trace and Formatting and saving the communications trace.

Additional information on this topic can be found in these sources:

Printing and device programming

Solving problems with receiving jobs


The most common problems, causes, and solutions for LPD are shown below:

Problem Cause Solution


All files on the receiving system are The QPTMPLPD printer file is set to a Change the printer file (CHGPRTF
of the same printer device type but type other than *USERASCII command) to printer device type
not *USERASCII *USERASCII1

142 iSeries: Getting started with iSeries


Problem Cause Solution
Spooled file is not on the print queue v Destination print queue name is v Display the messages sent by LPD
that you requested misspelled. to check where the spooled file
v User did not have authority to the was placed (you must be logged
requested print queue. on the system where the LPD
server is running to see the
v The requested print queue is not in
messages).
the user ID library list path.
v If you are logged on with the same
user ID as was used to issue the
LPR command, use the Display the
Message (DSPMSG) command. If
you are logged on to a different
user ID than was used to send the
LPR command, you must use the
DSPMSG userid command if the user
ID exists. If the user ID does not
exist, use DSPMSG QTCP/QTMPLPD.
Use QTMPLPD as the default user
profile if there are any problems
with the client profile.
v If the messages are not able to
help locate the file or the problem,
then check the print queue
QPRINT in library QGPL. If there
are any problems with the
requested print queue, QPRINT is
the default destination where all
files are spooled.
LPD receives only a portion of the The LPR job failed before sending all Send the spooled file again.
spooled file sent the data. LPD assumes that when the
connection is closed, all the data has
been sent.
Spooled files do not show up on the If the sending user ID does not match Change the authority for the
receiving system from a non-iSeries a user ID on the receiving system, QTMPLPD profile to *OBJOPR, or
400, even though LPR indicates it LPD uses QTMPLPD user profile to find a system with a matching user ID
was successfully sent spool the file. However, if the to accept the spooled files.
QTMPLPD user profile does not exist,
or the PUBLIC authority is set to
*EXCLUDE, the file is not spooled.2

1. Set the QPTMPLPD printer file to *USERASCII because LPD expects to receive ASCII data from non-iSeries 400
systems. The *USERASCII device type on the printer file does not mean that the data stream of the spooled file
is ASCII. If, for example, AFPDS data is sent from a non-iSeries 400 system, the data is sent as *USERASCII
and will not print correctly.
2. The sending system does not know that the file was not spooled because LPD does not search for a place to
store the file until after it has received all the data from the sending system.

Materials Required for Reporting LPD Problems


Include the following information when reporting any LPD problem to IBM:
v Any problems that cause LPD to fail unexpectedly will generate spooled files as part of the LPD error
handling. Three spooled files are created inside the failing job from these commands:
SYS/DSPJOBLOG JOB(*) OUTPUT(*PRINT)
QSYS/DSPJOB OUTPUT(*PRINT)
QSYS/DMPOBJ OBJ(QUSRSYS/QTMPLPD8MM)
OBJTYPE(*USRQ)

Chapter 9. Handling system problems and getting help through electronic customer support 143
These 3 files are owned by either the sending user profile, the default user profile QTMPLPD or the
QTCP user profile.
v The QTCPIP and LPD client job logs.
v If file or data integrity is compromised, then any files that are being sent.
v If the file being sent is being transformed, a copy of the workstation customizing object being used.
v If the file being received is an iSeries 400 spooled file sent with TRANSFORM=*YES, or is coming from
a non-iSeries 400 client, include the description of the QUSRSYS/QPTMPLPD printer file.
v The type of remote host, operating system, and operating system version from which the LPR command
was attempted, for example, PS/2 to OS/2, PS/2 to DOS, or RS/6000 to AIX.
v A communications trace from the time of the failure (format TCP/IP data only), formatted for both ASCII
and EBCDIC. If you are not familiar with the procedure for collecting a communications trace, refer to
iSeries Communication.

Additional information on this topic can be found in these sources:

Printing and device programming

Finding a job that did not print


Your users are frustrated because jobs that their print job has disappeared. You can look either on the
server, or on the client, to discover what went wrong with the print job, and then begin to solve that
problem.

On the server
One method of determining what went wrong with a print job on the server side is to use the QEZJOBLOG
log on the server that is running LPD for the print job. To get to the job log, follow these steps:
1. On any command line, enter the WRKOUTQ command.
2. Find the QEZJOBLOG and use option 5 to work with the job log.
3. Find the print job with the user of QTCP. Use option 5 to view the spooled file to determine what type
of errors were encountered.

On the client
Another method of determining what went wrong with a print job on the client side is to find the job log for
the print job. Follow these steps to get to the job log:
1. Enter the WRKOUTQ command on any command line.
2. Press F20 to work with print writers.
3. Find the writer with your job and use option 5 to work with the job log.
4. Press F17 to work with the writer.
5. Use option 10 to display the job log associated with the file.
6. Press F10 to display detailed messages. A message appears that describes the problem that occurred.

Additional information on this topic can be found in these sources:

Printing and device programming

Resolving problems with the Universal Connection wizard


If you have been unable to successfully run the Universal Connection wizard, answer the questions below
and then re-run the wizard.
1. Is the Universal Connection wizard unavailable to you?

144 iSeries: Getting started with iSeries


You must have installed both Client Access Express

and the optional Network component. You must also have *ALLOBJ and *IOSYSCFG authorities to
run the wizard.
2. If you are using an internatl modem, does your Modem Country ID Network Attribute correspond to the
location of your iSeries?
To verify that this attribute is correct:
a. On any command line, enter DSPNETA (Display Network Attribute command).
b. Press Enter.
c. If the value is correct, move to the next question.
d. If the value is incorrect, modify it by entering CHGNETA MDMCNTRYID(XX), where XX is the
appropriate Country Identifier.
3. Is the QRETSVRSEC system value correct?
In order for the authentication information required to connect to IBM to be retained on your system,
this system value must be set to 1 (Retain Data). To make this change:
a. On any command line, enter CHGSYSVAL SYSVAL(QRETSVRSEC) VALUE(’1’)
b. Press Enter.
4. Is TCP started?
TCP must be started in order for the Universal Connection wizard to run successfully. In addition, TCP
must be active whenever the Universal Connection is to be used. To start:
a. On any command line, enter STRTCP (Start TCP command).
b. Press Enter.
5. Is your Virtual Private Network (VPN) functioning correctly?
Refer to the VPN Troubleshooting documentation in the Information Center for assistance.
6. Does your modem selection exist or do you need to modify some of the default parameters?
To modify the modem list:
a. From Operations Navigator, select the system you want to work with.
b. Expand Network.
c. Click Remote Access Services.
d. Click on modems.
e. Add or modify modems as needed. Refer to your modem manual for the proper settings.
You can also modify the modem list this way:
a. On any command line, enter CFGTCPPTP.
b. Press Enter.
c. Select Option 11 (Work with modem information).
d. Select options to add or modify modems as needed. Refer to your modem manual for the proper
settings.
7. Is your modem configured with a framing type of asynchronous?
If not, you may have to change dip-switch and other hardware settings. Refer to your modem manual
for more information, or to Configuring your modem.
If you’re using an internal modem or an IBM 7852-400, no change is required.
8. Did problems occur when you attempted to test the connection?
Refer to Troubleshooting your PPP Connection.
9. Are you trying to use an existing SNA electronic customer support switched connection as a backup?
Ensure that the QESLINE line description specifies a valid resource name (DSPLIND QESLINE) and is
connected to a synchronous capable modem. The same IBM 7852-400 modem can be used for both
the Universal Connection and an SNA backup. It is also possible to use two separate modems.

Chapter 9. Handling system problems and getting help through electronic customer support 145
AT&T customers:
If you are using AT&T for your electronic customer support connection, please be aware of the following
information:

Every 30 days (or whenever you use the Universal Connection after that 30 day period), an updated AT&T
telephone list is downloaded by your system. This ensures that the telephone numbers available for the
Universal Connection remain current.

When this download occurs, a message is posted to the system operator’s message queue.

If the Universal Connection Profile being used contains a telephone number that is no longer in the current
AT&T telephone list, a diagnostic message will be issued. The purpose of this message is to notify you to
re-run the wizard to update the telephone numbers. When you re-run the wizard, updated telephone
numbers will be available for you to choose from. To view the very latest telephone numbers, visit the

AT&T website.

Contacting electronic customer support

Wait! Before You Access the Internet...


The iSeries 400 Service Web site delivers fixes to your PC console, which acts as a gateway between
IBM’s server and your system. Theáfix information flows through your PC console onto your system. The
iSeries 400 Service Web site guides you through this process.

However, before you access this information on the Internet, you need to be aware of some security
issues. Read this page before linking to the iSeries 400 Service web site.
1. End your console session to the iSeries.
Why?
Someone with malicious intent could gain access to your PC anytime you are connected to an external
network and do significant damage to your system. If your PC is compromised, either by direct control
or through a virus, your system could be accessed through the PC console connection. Ending your
PC console session before connecting to the Internet reduces the possibility that yourásystem might be
damaged.
2. Reduce the security risks to your system.
v Do not have any shared drives on your PC
v Stop FTP and Telnet on your PC
v Run virus scan on your PC after ending your Internet activity (before starting the console session to
your iSeries)

Note: Consider directly accessing the Internet with your PC console a short-term option only.

If you foresee continued Internet access or an Internet presence as part of your business goals,
architect a complete Internet security strategy and educate yourself on Internet security risks, secure
gateways, and Web serving.

3. Proceed to the fixes on the iSeries 400 Service Home page.

Viewing system configuration lists


Operations Navigator allows you to view your current system configuration and monitor performance. Use
this information to schedule maintenance or plan upgrades. Management Central also allows you to view
and export hardware and software inventories. Get more information on Management Central now.

146 iSeries: Getting started with iSeries


Hardware
1. Select the system you want to work with.
2. Expand Configuration and Service.
3. Expand Hardware.
4. Expand All Hardware.

You can view all of the hardware resources, organized by name, status, and description. Use this
information as a diagnostic tool if you suspect that a hardware resource is not operational.

Print a copy of your system’s configuration list periodically. This is a useful way to plan for changes to your
system’s hardware configuration. To print this list:
1. Select All Hardware.
2. From the File menu, select Print.

Software
1. Select the system you want to work with.
2. Expand Configuration and Service.
3. Expand Software.
4. Expand All Software.

You can view all of the software on your system. You can look at the general properties of the software
product you select, including the name of the product, a brief description, and other information.

Additional information on this topic can be found in these sources:

Management Central hardware inventory


Management Central software inventory
Printing system configuration for logical partitions

Troubleshooting your system


You can often solve problems that occur on your system with methodical analysis. However, on other
occasions, you will need the assistance of a service representative or technical support person. If you do
call on external help, you need to have as much information to offer that person as
possible.áDetailsáaboutáyour system’s problemáare required for accurate diagnosis of the situation and
rapid resolution.

Before you call


Before you call a support person, ask yourself these questions:
v Has there been an external power outage or momentary power loss?
v Has the hardware configuration changed?
v Hasásystem software been added?
v Have any new programs or program changes been recently installed?
To make sure that your licensed programs and products have been properly installed, use the Check
Product Option (CHKPRDOPT) command.
v Have any system values changed?
v Has any system tuning been done?

Keep these questions in mind while you are diagnosing the problem.

Chapter 9. Handling system problems and getting help through electronic customer support 147
If the system is logically partitioned, references in this document to the system, system console, displays,
system commands, and system values are relative to the partition having a problem. References to the
system control display refer to the Work with partition status display functions if the problem is in a
secondary partition. References to the system control display refer to the actual system control display if
the problem is in the primary partition.

How to use this flowchart


Work through these questions. As you answer each, follow the link to the next question that has relevance
to your problem. For instance, if you are told to go to Step 10, for instance, click the link and continue
answering questions.

Begin troubleshooting now


1. Can you power on your system?
Yes, go to Step 2.
No, go to Analyzing problems with a symptom.

Additional information on this topic can be found in these sources:

How the iSeries manages problems


Getting help with system operation problems

Troubleshooting your system: Step 2


1. Does the Function/Data display on the system control display start with Function 11-3, or is the System
Attention light on? Use the up and down arrow buttons to cycle through the functions to determine if a
11-3 exists.
Yes, go to Step 19.
No, go to Step 3.

Additional Information:
Press the Enter pushbutton to alternate between function and data.

Troubleshooting your system: Step 3


1. Is the system logically partitioned?
Yes, go to Step 4.
No, go to Step 5.

Troubleshooting your system: Step 4


1. Using system service tool (SST)/dedicated service tool (DST) from the primary partition console, select
Work with system partitions, then select Work with partition status. Is there a partition with the state of
Failed or Unit Attn?
Yes, go to Step 19.
No , go to Step 5.

Troubleshooting your system: Step 5


1. Does the console show a Main Storage Dump Manager display?
Yes, perform a Main Storage Dump.
No, go Step 6.

Troubleshooting your system: Step 6


1. Does the display station that was in use when the problem occurred (or any display station) appear to
be operational?

148 iSeries: Getting started with iSeries


Yes, go to Step 7.
No. If your console cannot vary on, go to Procedure 11. For all other workstations, go to Procedure 5.

Additional Information:
The display station is operational if there is a signon display or a menu with a command line. If another
display station is operational, use that display station to resolve the problem.

Troubleshooting your system: Step 7


1. Is a message related to this problem shown on the display station?
Yes, go to Step 8.
No, go to Step 12.

Troubleshooting your system: Step 8


1. Is this a system operator message?
Yes, go to Step 9.
No, go to Step 10.

Additional Information:
A message is a system operator message if the display indicates that the message is in the QSYSOPR
message queue. Critical messages can be found in the QSYSMSG message queue.

Troubleshooting your system: Step 9


1. Is the system operator message highlighted or does it have an asterisk (*) by it?
Yes, go to Step 18.
No, go to Step 14.

Troubleshooting your system: Step 10


1. Move the cursor to the message line and press the Help key, or use Option 5 Display details and
reply). Does the Additional Message Information display appear?
Yes, go to Step 11.
No, go to Step 12.

Troubleshooting your system: Step 11


1. Record the message information that is shown on the problem summary form. If possible, follow the
recovery instructions on the Additional Message Information display. Did this solve the problem?
Yes, end of procedure.
No, go to Step 12.

Troubleshooting your system: Step 12


1. Type dspmsg qsysopr on any command line and press Enter to display system operator messages. Did
you find a message that is highlighted or has an asterisk(*) by it?
Yes, go to Step 18.
No, go to Step 13.

Management Central’s message monitor can also inform you when a problem has developed.

Troubleshooting your system: Step 13


1. Did you find a message at or near the time the problem occurred?
Yes, go to Step 14.
No, go to Step 16.

System Operator Messages

Chapter 9. Handling system problems and getting help through electronic customer support 149
To determine the time a message occurred, display additional information about the message by using
Option 5 (Display details and reply) on the Work with Messages display. The Additional Message
Information display shows the time that the message was sent.

If the problem seems to affect only one display station, you might be able to use information from the Job
(JOB) menu to diagnose and solve the problem. Type GO JOB on any command line and press Enter to
find this menu.

End of procedure.

Troubleshooting your system: Step 14


1. Use option 5 (Display details and reply) to display additional information about the message; otherwise,
move the cursor to the message line and press the Help key. Record the message information that is
shown on the problem summary form. If possible, follow any recovery instructions that are shown. Did
this solve the problem?
Yes, end of procedure.
No, go to Step 15.

Additional Information:

If the additional message information tells you to run problem analysis, go to Step 18.

Troubleshooting your system: Step 15


1. Were you instructed by the message information to look for additional messages in the system
operator’s message queue (QSYSOPR)?
Yes, Press F12 (Cancel) to return to the list of messages, then look for other related messages. Go
to Step 12.
No, go to Step 16.

Troubleshooting your system: Step 16


1. Do you know which input/output device you are having a problem with?
Yes,
a. Type ANZPRB on the command line and press Enter.
b. See Analyzing a new problem for information on using the Analyze Problem (ANZPRB) command.
c. Report the problem.
d. See Reporting problems detected by the system for information about using the problem log to
report a problem electronically.
e. End of procedure.
No, go to Step 17.

Troubleshooting your system: Step 17


1. If you do not know the input/output device, describe the problems that you have observed by doing the
following:
a. Type go userhelp on any command line and press Enter.
b. Select option 10 (Save information to help resolve a problem) on the Information and Problem
Handling (USERHELP) menu.
c. Type a brief description of the problem and press Enter on the Save Information to Help Resolve a
Problem display. (If you specify the default Y for the Enter notes about problem field and press
Enter, the Select Text Type display appears that allows you to enter more text to describe your
problem).
d. Report the problem.

150 iSeries: Getting started with iSeries


Creating your own problem record

This step helps you isolate and describe the problems that you observed.

You can store system and job-related information in spooled files and create an entry (identified by the
problem ID) in the system problem log. This information can be used to assist your technical support
representative in solving the problem.

Note: Using go userhelp, you can create a brief note describing the problem you observed. To
describe your problem in greater detail, use the Analyze Problem (ANZPRB) command. Using the
Analyze Problem (ANZPRB) command may also run a test to further isolate the problem.

See Problem reporting for additional information.

End of procedure.

Troubleshooting your system: Step 18


1. Move the cursor to the message line and press the Help key.
Press F14, or use the Work with Problem (WRKPRB) command as instructed.
If this does not solve the problem, begin analyzing the problem.
Running Problem Analysis
With problem analysis you can gather more information about the problem to either solve it or report it
without the help of a service representative. You can run problem analysis on messages that are
highlighted (basic assistance level) or have an asterisk (*) next to them intermediate assistance level).
If you do not see any of these messages, you may not be authorized to the Work with Problem
(WRKPRB) command, or the message does not support additional problem analysis.
Besides running problem analysis on messages, you can also use F14 (Work with problem) if it is
available on your display. If F14 is not available, use the Work with Problem (WRKPRB) command to
run problem analysis. From the Work with Problems display, select Option 8 (Work with Problem), and
then select Option 1 (Analyze problem) from the Work with Problem menu. If you do not see Option 1
on the Work with Problem menu, analyze the problem before reporting it to IBM.
See Problem reporting for additional information about analyzing and reporting problems.
End of procedure.

Troubleshooting your system: Step 19


1. Record the system reference codes on the problem summary form in Problem Summary Forms.
Make sure you have collected all of the codes.
Go to Procedure 2.
Collecting System Reference Codes
If you have a Model 270 or 8xx:
a. Press the increment button until 05 appears on the Function/Data display.
b. Press the Enter pushbutton.
c. Record the information displayed.
d. Press the increment button again until 11 appears in the Function/Data display.
e. Press the Enter pushbutton.
f. Record the information displayed.
g. Press the increment button again. The number 12 displays on the first line of the Function/Data
display.
h. Press the Enter pushbutton.

Chapter 9. Handling system problems and getting help through electronic customer support 151
i. Record the 32-character code: 16 characters from line one, and 16 characters from line two, of
the Function/Data display.
j. Press the increment button again. The number 13 displays on the first line of the Function/Data
display.
k. Press the Enter pushbutton.
l. Record the 32-character code: 16 characters from line one, and 16 characters from line two, of
the Function/Data display.
m. Press the increment button again until the number 20 displays on the first line of the
Function/Data display.
n. Press the Enter pushbutton.
o. Record the 32-character code: 16 characters from line one, and 16 characters from line two, of
the Function/Data display.

For earlier models, if you have system expansion or extension tower attached to your system, select
Function 05, and record the system reference code.

If 11-3 is shown in the Function/Data display on the control display, then the numbers that follow are
the system reference code.

If a number other than 11-3 is shown in the Function/Data display, the number may not indicate a
problem with the system. These codes may indicate functions you select from the control panel
display.

Note: If you have a display station with Type and Reference Code columns on it, record the data
under the Type column as the first 4 characters of function 11 on the problem summary form. If an A,
B, C, or D is displayed as the first digit in the Type column, use the data in the Reference Code
column as the last four characters of function 11. Go to Getting Help with Problems for information on
who to contact if you need more help.

Analyzing problems with a symptom


Please read the symptom index from top to bottom. Find the symptom that describes the problem, and
click the procedure name listed.

Symptoms Recovery Procedure


You cannot power on the system Procedure 1
The system attention light is on, or a system reference Procedure 2
code is displayed on the control panel.
The Operations Console Remote Control Panel feature is Procedure 2A
not working properly.
A pushbutton or light onthe control panel is not working Procedure 3
properly.
You cannot perform an initial program load (IPL) or you Procedure 4
suspect an operating system failure.
Your workstation or device (such as display or printer) is Procedure 5
not working.
You are having a problem with a tape or optical device. Procedure 6
You are having a problem with a disk or diskette device. Procedure 7
You cannot communicate with another device or Procedure 8
computer.
Your system seems to be in a loop or hang condition. Procedure 9

152 iSeries: Getting started with iSeries


Symptoms Recovery Procedure
You are having an intermittent problem Procedure 10
You are having data compression problems and receive Go to ″Recovering from SRC 6xxx 7501″ in Backup and
this message: Message ID CPPEA02 along with system Recovery
reference code (SRC) 6xxx 7501 - Compressed device
and compression input-ouput adapter (IOA) are not
compatible.
You are having data compression problems and receive Go to ″Recovering from SRC 6xxx 7502″ in Backup and
this message: Message ID CPPEA03 along with SRC Recovery
6xxx 7052 - Data compression warning.
The system has logical partitions and a state of Failed or Procedure 2
Unit Attn is displayed on the Partition Status display of a
secondary partition. There is a reference code.
The system is logically partitioned and your partition Procedure 9
seems to be in a loop or hang condition.
The system is logically partitioned and you cannot Procedure 4
perform an initial program load (IPL) or you suspect an
operating system failure.
No symptom to match in the table. Go to Getting help with system operation problems

Procedure 1: Recovering from system power problem


1. Make sure that the power that is supplied to the system is adequate. If your system units are protected
by an emergency power off (EPO) circuit, check that the EPO switch is not activated.
2. Verify that your system power cables are properly connected to the electrical outlet. When power is
available, the Function/Data display on the control panel is lit.
3. If you have an uninterruptible power supply (UPS), verify that the cables are properly connected to the
system that the UPS is functioning.
4. Make sure all system units are powered on.
5. Turn on the system again.
6. Is a system reference code displayed on the control panel?
Yes. Go to Procedure 2.
No. Call your hardware service representative.

Procedure 2: Recovering when attention light is on or the System


Reference Code (SRC) is displayed
Use the table below to locate the SRC that is displayed. In the table, xxxx can be any number 0 through 9
or letter A through F. If you cannot find the SRC in this table, go to Getting help with system operation
problems.

The SRCs are grouped together in ranges. The recovery for each range may not apply to every SRC
within a specified range. The recovery procedure is attempting to clean up your systemand get it back to a
minimum operating environment.

For a list of SRCs and their descriptions that are specific to logical partitions, see Troubleshooting logical
partitions.

Chapter 9. Handling system problems and getting help through electronic customer support 153
System Reference Code starting with 11-3 What you should do
0000 AABB You attempted a timed, remote, or automatic IPL (initial
0000 AACC program load) with the system in the Secure or Manual
mode.
1. Set the system to the Normal or Auto mode and do
the IPL again.
2. If you are still not able to do an IPL, call your
hardware service representative.
0000 AADD You attempted a manual IPL with the system in the
Secure or Auto mode.
1. Set the system to the Normal or the Manual mode
and try the operation again.
2. If you are still not able to do an IPL, call your
hardware service representative.
1xxx D101 Battery Power Unit x failed. Battery Power Unit x test
1xxx D102 failed.

Replace the battery power unit.. If the battery still does


not work after the replacement, call your hardware
service representative.
63xx xxxx The tape unit failed. See Procedure 6.
93xx xxxx A disk or diskette unit failed. See Procedure 7.
A6xx 0277 A compression disk unit cannot complete an operation.

Do not power off the system when performing this


procedure.

Look at the 4 characters that are to the left of the Data


display of function 17-3. These 4 characters indicate the
type of problem that exists and the recovery action to
perform.

If these characters are 8402 or 2002, the compression


disk unit is temporarily full of data. The command to the
compression disk is being held. When the subsystem
controller has created sufficient space on the
compression disk unit to contain the data, the command
that is being held is released and the system resumes
normal processing. If the system does not resume normal
processing within 20 minutes, call your hardware service
representative.

If these characters are 8400 or 2000, the compression


disk unit is full o f data. The command to the
compression disk is being held. Go to Disk unit full
considerations in Backup and Recovery.
A6xx 500x Work station controller failure. See Procedure 5.
A1xx xxxx IPL load device failure. See Procedure 4.
B1xx xxxx

154 iSeries: Getting started with iSeries


System Reference Code starting with 11-3 What you should do
A900 2000 The IPL completed normal, does the system console
have a sign-on screen?

If the system console did not vary on, see Procedure 11.

If the system completed the IPL, check the QSYSARB job


log for the message and follow the corrective actions
indicated in the message. To view the QSYSARB job log,
use the Work with Active Jobs (WRKACTJOB) command,
then type 5 (Work with) next to the QSYSARB job. Select
Option 10 (Display jobs) to view the job log. You need
*QSECOFR user class, or *ALLOBJ and *JOBCTL
special authority to view the job log. If the problem
persists, call your hardware service representative.
B0xx xxxx Failure detected by communication Licensed Internal
Code.
1. Make sure the latest fix package is installed.
2. If this does not solve the problem, call your software
service representative.
B6xx xxxx Not enough auxiliary storage.
1. If your system unit has some disk storage space
available, add more to auxiliary storage pool 1.
2. If this does not solve the problem, call your software
srevice representative.
B9xx xxxx OS/400 IPL failure. See Procedure 4.
C1xx xxxx IPL status.
C3xx xxxx
C5xx xxxx This is a normal indication during the IPL. You may
suspect a hang or loop condition if the SRC does not
change during the two-minute period. See Procedure 9.
D1xx xxxx Diagnostic status.

This is a normal indication while the system main storage


is being saved to disk.

If the system is still not running correctly after 30 minutes,


call your hardware service representative.
D6xx xxxx Diagnostic Status.

This is a normal indication while the system is being


powered down.

If the system does not start normally after 30 minutes,


call your software service representative.

When xxxx is changing, the system is doing a main


storage dump.
B2xx xxxx IPL load failure.
1. Verify that the partition state is Failed. If the partition
state is not Failed, this SRC may disappear from the
partition status screen by refreshing the screen.
Refresh the screen until either the partition state
changes to Failed or the SRC disappears.
2. If the partition state is Failed, see Procedure 4.

Chapter 9. Handling system problems and getting help through electronic customer support 155
System Reference Code starting with 11-3 What you should do
C2xx xxxx IPL status.

This is a normal indication during the IPL. You may


suspect a hang or loop condition if the SRC does not
change in 15 minutes. See Procedure 9.
D2xx xxxx Diagnostic status.

This is a normal indication while the panel functions and


system code are powering down the system.

Procedure 2A: Recovering when Operations Console Remote Control


Panel feature is not working properly
1. Are you able to change modes or select system functions using the Remote Control Panel feature?
Yes. Continue to step 2.
No. Make sure the Operations Console cable is attached properly. Using the Operations Console
display, disconnect and then reconnect the server connection. If the same failure occurs, call your
hardware service representative.
2. Are the Remote Control Panel functions (Function/Data, Mode and Power) properly displayed?
Yes. Use the Remote Control Panel to start an IPL (initial program load) and continue to step 3.
No. Call your hardware service representative.
3. Was the IPL successfully started?
Yes. Continue the IPL process.
No. Call your hardware service representative.

Procedure 3: Recovering when control panel pushbuttons or lights are


not working properly
1. Are your control panel pushbuttons working properly?
Yes. Continue to step 2.
No. Try turning on the system again. If the same failure occurs, call your hardware service
representative.
2. Are the control panel lights working properly?
Yes. End of the procedure.
No. Call your hardware service representative.

Procedure 4: Recovering from IPL or system failure


If the system is logically partitioned, references to the system, system console, displays, system
commands, and system values are relative to the partition having a problem. References to the system
control panel refer to the Work with partition status display functions if the problem is in a secondary
partition. References to the system control panel refer to the actual system control panel if the problem is
in the primary partition.

If your system has logical partitions, see Troubleshooting logical partitions.

Verify the following:


v The device from which you did the IPL (initial program load) is powered on.
v The tape and CD are loaded properly.
v The sign-on User ID and password are correct.
v The system is set to the correct mode (Manual, Normal, Auto, or Secure)
v The system value for date/time and control panel mode is set correctly if this is a timed IPL.

156 iSeries: Getting started with iSeries


v The phone, modem, control panel mode, and QRMTIPL value are set up ocrrectly if this is a remote
IPL.

Follow these steps:


1. Do an IPL from the system control panel or Operations Console Remote Control panel as follows:
a. Set the system to the Manual mode.
b. If the system is powered on:
1) Select Function 03.
2) Press the Enter pushbutton to start an IPL
c. If the system is powered off, ensure that the control panel is in either Normal or Manual mode and
press the power on pushbutton.
2. Sign on the system when the Sign On display appears. If you do not see the Sign On display, do you
have a new SRC?
Yes. Go to Procedure 2.
No. Go to Getting help with system operation problems.
3. On the IPL Options display, specify Yes for the following parameters:
v Define or change the system at IPL
v Clear output queues
v Clear job queues
v Clear incomplete job logs
4. Change the system value for QMCHPOOL to a smaller value.
5. Make sure the system value for QCTLSBSD has the correct spelling, or assign an alternative
controlling subsystem.
6. Change the system value for QPWRDWNLMT to a larger value.
7. Continue the IPL process. If the same failure occures, set the system to the Normal mode, and then
call your hardware service representative.

Procedure 5: Recovering from workstation failure


1. Make sure all workstations and devices (such as displays or printers) are turned on.
2. If the Operations Console is being used as the console, ensure that the cable from the PC to the
system is attached properly. Make sure that the PC has been properly configured.
3. Make sure all workstation cables are attached properly and set to the proper address. For information
about workstation address, see Determining the primary or alternative consoles if you are using system

console, or Local Device Configuration if you are using other workstations.


4. Make sure recently attached workstations have been properly configured to the systm.
v Workstation addreses are unique (if applicable).
v Workstations are terminated (if applicable).
5. Check all workstation printers for mechanical problems such as paper jams, ribbon failure and so on.
6. Vary off the failing workstation controller if any other workstation is operational, and then vary it on
again. End all active jobs before varying off the workstation controller. To end active jobs, use the Work
with Active Jobs (WRKACTJOB) command.
To vary on or off the workstation controller:
a. Enter WRKCFGSTS *CTL on any command line. The Work with Configuration Status display appears.
b. Specify 1 (Vary on) or 2 (Vary off) in the opt column next to your workstation controller, and press
Enter.
7. Try the operation again. If you are still having the same problem, call your hardware service
representative.

Chapter 9. Handling system problems and getting help through electronic customer support 157
Procedure 6: Recovering from tape or optical device problem
Verify the following:
v All tapes or optical devices are powered on and in a Ready (enabled) condition.
v Cables between the system and the tape or optical device are properly connected (if applicable).
v Tape density and tape bits per inch (BPI) match.
v Tape path is cleaned.
v CD-ROM disc is clean, the format is supported, and the disc is loaded properly with the label side
showing.

Do the following:
v Do all the tapes or CD-ROM device fail to read or write?
Yes. Call your hardware service representative.
No. Replace the tape and CD, and try the operation again. If the same failure occurs, call your
hardware service representative.

Procedure 7: Recovering from disk or diskette drive problem


1. Make sure that all disk and diskette devices are powered on and enabled. Some disk units may have
enable switches.
2. Make sure cables are properly connected between the system and disk or diskette device (if
applicable).
3. Do all diskettes fail to read or write?
Yes. Call your hardware service representative.
No. Replace the diskette and dtry the operation again. If the same failure occurs, call your hardware
service representative.

Procedure 8: Recovering from communication problem


1. Make sure that all communication equipment such as modems or transceiver are powered on. Make
sure all communication cables are properly connected.
2. Make sure the remote system is ready to receive your communication.
3. Verify the network equipment (or provider) is functional. This includes phone service (for example,
verify the status of communication lines).
4. Verify that the configuration is correctly specified for the failing communication or LAN facility.

If you still have the same problem, call your hardware service representative.

Procedure 9: Recovering from system hang or loop condition


If the system is logically partitioned, references to the system, system console, displays, system
commands, and system values are relative to the partition having a problem.

The system appears unable to accept commands. This problem can be caused by the system hardware or
the system may be in a loop or hang condition.

Complete the following tasks:


1. Perform a system main storage dump
A system main storage dump gathers data on the current state of the system during the loop or hang
condition. This information is critical for problem solving. Valuable diagnostic information will be lost if
you do not collect the storage dump information before you try to do an IPL.
2. Call IBM Software Service after performing the system main storage dump.

158 iSeries: Getting started with iSeries


Procedure 10: Recovering from intermittent problem
1. Enter the Analyze Problem (ANZPRB) command on any command line. The Select Type of System
display appears.
2. Select Option 1 (This server or attached device). The Analyze problem display appears.
3. Select Option 3 (Hardware problem). The Problem Frequency display appears.
4. Select Option 1 (Yes) to get an intermittent checklist and follow instructions.

If you still have the same problem, call your hardware service representative.

Procedure 11: Recovering when system console did not vary on


If the system is logically partitioned, references to the system, system console, displays, system
commands, and system values are relative to the partition having a problem. References to the system
control panel refer to the Work with partition status display functions if the problem is in a secondary
partition. References to the system control panel refer to the actual system control panel if the problem is
in the primary partition.
1. Locate the workstation that is used as the primary system console. See Determining the primary or
alternative consoles for information about determining system consoles.
2. Make sure the workstation cables are attached properly, and set to the correct address.
3. Can you sign on to an alternative console?
Yes. Go to Step 4.
No. Go to Step 5.
4. If you can sign on to an alternative console, do the following:
a. Make sure the primary console controller (for example, CTL01) and device description (for
example, DSP01) have been created or restored. To check the device description, use the
command WRKCFGSTS *CTL.
b. If descriptions exist, check the system operator message to determine why the primary console
failed. Take corrective actions indicated in the message.
If you still cannot solve the problem, set the system to the Normal mode, and call your software
service representative.
5. If you cannot sign on to an alternative console, do the following:
a. Set the system to the Manual mode, select function 3, and press the Enter pushbutton to start an
IPL (initial program load) until you see the IPL Option display.
b. Were you able to get to the IPL Option display?
Yes. Continue with Step 5c.
No. Contact your IBM service representative.
c. On the IPL Options display, specify Y (Yes) in the Define or change system at IPL field, N (No) in
the Set major system option field and press Enter.
d. On the Define or Change the System at IPL display, select Option 1 (Configuration commands),
and press Enter. The Configuration Commands menu appears.
e. Select Option 2 (Controller description commands) to see the controller description for the system
console. Very that the controller (for example, CTL01) was created correctly. If the name has been
changed, see Finding the primary console when system is operational“Finding the primary console
when system is operational” on page 175.
f. Select Option 3 (Device description commands) to see the device description for the system
console. Verify that the device (for example, DSP01) was created correctly. If the name has been
changed, see Finding the primary console when system is operational“Finding the primary console
when system is operational” on page 175.

Chapter 9. Handling system problems and getting help through electronic customer support 159
Problem summary forms
The problem summary form is used to record information displayed on the system unit control panel.
When you perform problem analysis, you may be instructed to fill out this form so that your service
representative can further analyze the problem. There are four forms, one for each of the following:
1. Systems with a single partition (except Model 270 and 8xx)
2. Systems with multiple partitions (except Model 8xx)
3. Model 270 and 8xx systems with a single partition
4. Model 8xx systems with multiple partitions

Print out additional forms as required.

Problem summary form for systems with a single partition (except


Model 270 and 8xx)
Date and time that the problem occurred: ____/____/____ ___:___:___
PRM or service request number: _______________________
Describe the problem: _______________________

Message Message From/Send Instruction To/Receive Instruction


ID Text Program Number Program Number
________ ________ ________ ________ ________ ________
________ ________ ________ ________ ________ ________
________ ________ ________ ________ ________ ________

1. Record the mode.


2. Set the mode to Manual.
3. Place a check on the lines below to indicate which lights on the panel are on. Refer to control panel
for the system units for a diagram of the control panel.

_____ Power On
_____ Processor Active/Activity
_____ System Attention

4. Press the Increment/Decrement buttons until 11-3 is shown in the Function/Data display. Press the
Enter pushbutton.
5. Record the 8 characters shown in the Data display for function 11-3.

05 __________
11xx __________
12xx __________
13xx __________
14xx __________
15xx __________
16xx __________
17xx __________
18xx __________
19xx __________
20xx __________

Some systems will not have the 05 on the Function/Data display.

160 iSeries: Getting started with iSeries


6. Press the Increment button. This action steps the Function/Data display to the next higher number
(12, 13, and so on) and blanks the Data display.
7. Press the Enter pushbutton. This action shows a new set of 8 characters in the Data display. Record
this data on the form.
8. Repeat steps 6 and 7 until data has been recorded through function 20. All functions may not be
displayed, depending on the failure.
9. Set the same mode as recorded in step 1 of this form. Press the Increment/Decrement buttons until
the number 11-3 is shown in the Function/Data display. Press the Enter pushbutton. The original
system reference code (SRC) appears.
10. Return to the step that sent you here.

Comments: _______________________________________________________________________

Problem summary form for systems with multiple partitions (except


Model 8xx)
Date and time that the problem occurred: ____/____/____ ___:___:___
Partition state: _______________________
Partition ID: _______________________
Partition version: _______________________
Partition name (optional): _______________________
Partition release: _______________________
Describe the problem: _______________________

Message Message From/Send Instruction To/Receive Instruction


ID Text Program Number Program Number
________ ________ ________ ________ ________ ________
________ ________ ________ ________ ________ ________
________ ________ ________ ________ ________ ________

1. Record the mode.


2. From Work with Partitions screen, use option 10 to set the mode to Manual. For help getting to this
screen, refer to Accessing panel functions on a secondary partition.
3. Place a check on the lines below to indicate which lights on the panel are on. Refer to control panel for
the system units for a diagram of the control panel.

_____ Power On
_____ Processor Active/Activity
_____ System Attention

4. Record the 8 characters shown in the Display Partition Status screen for Reference Codes 11x through
19xx.

05 __________
11xx __________
12xx __________
13xx __________
14xx __________
15xx __________
16xx __________
17xx __________
18xx __________
19xx __________
20xx __________

Chapter 9. Handling system problems and getting help through electronic customer support 161
5. Go to the system control panel to find and record the value for the 20xx Reference Code.
6. Set the same mode as recorded in step 1 of this form.
7. Return to the step that sent you here.

Comments: _______________________________________________________________________

Problem summary form for Model 270 and 8xx systems with a single
partition
Date and time that the problem occurred: ____/____/____ ___:___:___
Describe the problem: _______________________

Message Message From/Send Instruction To/Receive Instruction


ID Text Program Number Program Number
________ ________ ________ ________ ________ ________
________ ________ ________ ________ ________ ________
________ ________ ________ ________ ________ ________

1. Record the mode.


2. Place a check on the lines below to indicate which lights on the panel are on. Refer to control panel for
the system units for a diagram of the control panel.

_____ Power On
_____ Processor Active/Activity
_____ System Attention

3. Go to the system control panel to find and record the value for functions 05, 11, 12, and 13. See
Collecting System Reference Codes for step-by-step instructions on finding System Reference Codes.
Use the grid below to record the characters shown on the Function/Data display.
4. Set the same mode as recorded in step 1 of this form.

Comments: _______________________________________________________________________

05 ____ ____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____ ____

____ ____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____ ____
11 ____ ____ ____ ____ ____ ____ ____
____ ____ ____ ____ ____ ____ ____
____ ____

____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____
____ ____

162 iSeries: Getting started with iSeries


12 ____ ____ ____ ____ ____ ____ ____
____ ____ ____ ____ ____ ____ ____
____ ____

____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____
____ ____
13 ____ ____ ____ ____ ____ ____ ____
____ ____ ____ ____ ____ ____ ____
____ ____

____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____
____ ____
20 ____ ____ ____ ____ ____ ____ ____
____ ____ ____ ____ ____ ____ ____
____ ____

____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____
____ ____

Problem summary form for Model 8xx systems with multiple partitions
Date and time that the problem occurred: ____/____/____ ___:___:___
Partition state: _______________________
Partition ID: _______________________
Partition version: _______________________
Partition name (optional): _______________________
Partition release: _______________________
Describe the problem: _______________________

Message Message From/Send Instruction To/Receive Instruction


ID Text Program Number Program Number
________ ________ ________ ________ ________ ________
________ ________ ________ ________ ________ ________
________ ________ ________ ________ ________ ________

1. Record the mode.


2. From Work with Partitions screen, use option 10 to set the mode to Manual. For help getting to this
screen, refer to Accessing panel functions on a secondary partition.
3. Place a check on the lines below to indicate which lights on the panel are on. Refer to control panel for
the system units for a diagram of the control panel.

_____ Power On
_____ Processor Active/Activity
_____ System Attention

4. On the grid below, record the characters shown on the Display Partition Status screen for functions 05,
11, 12, 13.

Chapter 9. Handling system problems and getting help through electronic customer support 163
In the product activity log and other software displays, the System Reference Code (SRC) appears
much like it does for earlier releases. One differenc eis that the first word will have up to 32 characters
of text. Another difference is that the word will be a number from 1 to 9 instead of 11 to 19. This helps
to avoid confusing the word number with the function number used to find it.
5. Go to the system panel to find and record the value for function 20. See Collecting system reference
codes for step-by-step instructions.

Comments: _______________________________________________________________________

05 ____ ____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____ ____

____ ____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____ ____
11 ____ ____ ____ ____ ____ ____ ____
____ ____ ____ ____ ____ ____ ____
____ ____

____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____
____ ____
12 ____ ____ ____ ____ ____ ____ ____
____ ____ ____ ____ ____ ____ ____
____ ____

____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____
____ ____
13 ____ ____ ____ ____ ____ ____ ____
____ ____ ____ ____ ____ ____ ____
____ ____

____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____
____ ____
20 ____ ____ ____ ____ ____ ____ ____
____ ____ ____ ____ ____ ____ ____
____ ____

____ ____ ____ ____ ____ ____ ____


____ ____ ____ ____ ____ ____ ____
____ ____

Accessing panel functions on a secondary partition


Note: Most partition panel functions for a secondary partition are available from the console of the
secondary partition. All partition panel functions for a secondary partition are available from the partition
status screens on the primary partition console. If the panel function required is not available from the
console of the secondary partition, go to the primary partition console to access that panel function.
1. From the console of the primary partition or the secondary partition, enter STRSST on any command
line to start SST (or enter STRDST on any command line to start DST).

164 iSeries: Getting started with iSeries


2. From the SST or DST screen, select Option 11 (Work with system partitions).
3. From Work with System Partitions, select Option 2 (Work with partition status).
Additional panel functions and information are available by pressing F10 (Display partition status), F11
(Work with partition configuration), and F23 (More options).
For panel functions 11 through 19:
v Press F10 (Display partition status).
v Press F9 (Include reference code detail).
4. For panel function 20, use the system control panel.

Additional information on this topic can be found in these sources:

Logical partitions

Analyzing a new problem


A new problem is one that you detect while using the system and which has not been recorded in the
problem log, or one that is in the problem log with a status of opened.

If the system is logically partitioned, references to the system, system console, displays, system
commands, and system values are relative to the partition having a problem. When reporting problems
electronically, use the same contact information for each partition on the system.

To analyze a new problem that has not been recorded in the problem log
1. Use the Analyze Problem (ANZPRB) command.
2. Select the option that most closely corresponds to the problem you have encountered on the Analyze a
New Problem display. A series of steps then guides you through problem analysis. As you progress, a
symptom string is built from your responses.
If you encounter the Problem Analysis display while you are building your symptom string, contact IBM
service before continuing. See Getting help with problems for more information on who to call.
3. When you complete problem analysis, the collected information is placed in the problem log.

To analyze a problem that has been recorded in the problem log with opened status
1. Type DSPMSG QSYSOPR on any command line and press Enter to see the system operator
messages.
v If the message is highlighted, use option 5 (Display details and reply) for the message. On the
Additional Message Information display, press F14 (Work with problem).
v If the message has an asterisk (*) next to it, press F14 (Work with problme) on the Display
Messages display.
2. Select option 8 (Work with problem), and then option 1 (Analyze problem). As you probgress through
problem analysis, a symptom string is built from your responses.
3. When you complete problem analysis, the collected information is placed in the problem log.

You can also use the following method to analyze a problem with open status in the problem log:
1. Enter the Work with problem (WRKPRB) command on any command line.
2. Select option 8 (Work with problem) for the problem, and then option 1 (Analyze problem).

Reporting hardware and software problems


For hardware failures that do not disable system operation, electronic customer support provides a fast,
electronic method for requesting the assistance of an IBM service representative with replacement parts.
Using this method, you may report failures occuring on your system and selected input or output devices.

Chapter 9. Handling system problems and getting help through electronic customer support 165
For problems with software or Licensed Internal Code, you should notify the IBM service system of the
failure and related symptoms. The problems that are detected by the system can be reported either
manually“Reporting problems detected by the system” or automatically“Setting Up Automatic Cleanup” on
page 57. The system searches a file of known problems and, if available, sends a fix to your system for
installation.

If a problem is new, a problem management record (PMR) is created by the IBM service system. The
PMR number is returned to your iSeries system. Depending on your contract with IBM, you may or may
not be entitled to voice support (telephone). If you have voice support, IBM service center personnel will
contact you, if requested, and work with you to resolve the problem. If you do not have voice support, you
may view the service centers response by using the Query Problem Status (QRYPRBSTS) command. For
more information on the QRYPRBSTS command, see Querying problem status“Querying problem status”
on page 167.

To send a service request or log a problem, go to one of the following:


v Sending a service request immediately“Sending a service request immediately” on page 167
v Sending a service request later“Sending a service request later” on page 168
v Reporting problems by voice“Reporting problems by voice” on page 169
v Adding notes to your problem record“Adding notes to your problem record” on page 169

For information on how to find a problem, see Finding a previously reported problem“Finding a previously
reported problem” on page 169.

Reporting problems detected by the system


The system problem log allows you to display a list of all the problems recorded on the system. You can
also display detailed information about a specific problem. For example, you can see the product type and
serial number of the device that had the problem, the date and time of the problem, the part that failed,
where the part is found, and the problem status. You can also analyze and report a problem, or determine
any service activity.

To report a problem that has an entry in the problem log, do the following:
1. Type WRKPRB on any command line and press Enter. The Work with Problems (WRKPRB) display
appears.
2. If you have a problem ID, look for an entry with the same ID on the Work with Problems display. Select
option 8 (Work with problem) for the problem you want to work with. Press Enter and the Work with
Problems display appears.
3. Select option 2 (Report problem) on the Work with Problems display. Press Enter and the Verify
Contact Information display appears.
4. To change any fields that appear on the Verify Contact Information display, type over the current
information and press Enter. The system includes the new information in the service request.
5. Select the severity level that closely relates to the severity of the problem on the Select Problem
Severity display.
6. Select who should receive and process your request on the Select Service Provider display.
7. Select when and how you want to send the service request on the Select Reporting Option display.

Automatic problem reporting


The automated problem analysis function runs problem analysis routines automatically when the system
detects a problem. The problem reporting function notifies the service provider of the software problem. To
run these functions, the appropriate service attributes must be set to *YES. If these attributes are set to
*NO, you will need to run the problem analysis manually. The default value for service attributes is *NO.

Use the Display Service Attribute (DSPSRVA) command to display the service attributes, or use the
Change Service Attributes (CHGSRVA) command to change the service attributes.

166 iSeries: Getting started with iSeries


To change service attributes, fill in the appropriate information in the fields. Specify *YES in the Analyze
problem field to automatically run problem analysis at the time of the failure. Problem analysis includes
programs that attempt to isolate or correct the problems. Automated problem analysis applies mostly to
hardware problems, and some software problems in Licensed Internal Code. To determine which problems
are analyzed automatically and which ones are not, use the Work with Problem (WRKPRB) command. If
the status is Opened, it indicates that the problem has not been analyzed. For problems that are not
analyzed automatically, you can use the Work with Problems (WRKPRB) command to run the problem
analysis manually. Go to Problems with a symptom for detailed information about the command, and for
examples of how the command is used.

When *YES is specified in the Report problem automatically field, software problems are reported
automatically to the service provider. Your service provider is specified in the Control point name field. For
hardware problem reporting, contact your service provider.

Querying problem status


To retrieve the latest status of a previously reported problem“Finding a previously reported problem” on
page 169, use one of the following methods:

Method 1:
1. On any command line, type QRYPRBSTS on any command line, and press F4. The Query Problem
Status (QRYPRBSTS) display appears.

Note: Currently, the QRYPRBSTS command is not enabled to


query hardware problems.

2. If you know the problem management record (PMR) number, type *PMR in the Problem identifier field
and press Enter. Additional fields appear on the display. Type the PMR number in the Service number
field and press Enter. If you know the WRKPRB problem ID number, type the 10-digit ID number for
the problem in the Problem identifier field and press Enter. If you don’t know the problem ID number,
see Finding a previously reported problem“Finding a previously reported problem” on page 169 for
instructions on how to find this 10-digit number.
3. After the query is complete, enter: WRKPRB xxxxxxxxxx where xxxxxxxxxx is the 10-digit problem ID
number. The Work with Problem display appears.
4. Type Option 12 (Enter text) next to the problem entry and press Enter. The Select Text Type display
appears.
5. Select Option 10 (Query Status text). The Query results are shown.

Method 2:
1. On any command line, type WRKPRB and press Enter. The Work with Problems display appears.
2. Find the problem entry for which you want to query the status. To start a query, the problem entry must
have a status of Answered or Sent.
3. Type Option 8 (Work with problem) next to the problem entry. The Work with Problem menu appears.
4. Select Option 41 (Query problem status text). The Results of the query are shown.

Note: The QRYPRBSTS command does not apply to problem


entries that have a Fix request specified in the problem
description column of the Work with Problem display.

Sending a service request immediately


If you decide to send a service request now, select option 1 (Send service request now) on the Select
Reporting Option display. The system packages the problem log entry as a service request. Then your
iSeries system automatically dials the IBM service provider system, and the system transmits the problem
to the service provider.

Chapter 9. Handling system problems and getting help through electronic customer support 167
The service provider determines whether the request is for hardware or software service, and takes the
appropriate action that is described below.

Hardware Service:

If the service provider is IBM, and if no fixes are found that match your problem symptoms, one of the
following happens:
v Your request is sent to an IBM service representative.
v An IBM Customer Assistance Group representative calls you to assist in further problem definition. The
connection to the service provider system ends, and the status of the problem in the problem log is
changed to SENT.

Software Service:
v A search is performed against the database of fixes by using the symptom string you created during
problem analysis.
v If the service provider is IBM, a match is found, and a fix is available, IBM transmits the fix to you
electronically. Or, IBM sends a fix tape to you through normal mail channels. The size of the fix and its
requisites determine whether IBM sends the fix electronically or through the mail. The fixes that you
receive electronically are placed in the QGPL library with a file name of the fix number that is preceded
by a Q and a file type of SAVF.
v If a match is not found or the fix is not available, you see the Save APAR Data display. This display
saves the following information about your problem:
– History log
– Job information
– Hardware and software resources
– Error log entries
– Vertical Licensed Internal Code log entries
– Problem log entries
– Pictures of displays

You can then forward this information to the IBM Software Support Center to help you solve your
problem.

The connection to the service provider ends when you receive a fix or when your problem is opened for
further investigation. The system changes the status of the problem to SENT or to ANSWERED in the
problem log.

Note: Whenever you use electronic customer support, the


iSeries needs to dial out to the IBM system. Remember to
have the electronic customer support modem available
and powered on.

Sending a service request later


If you decide to send a service request later, select option 2 (Do not send service request) on the Select
Reporting Option display. The status of the problem in the problem log changes to PREPARED.

To submit a problem with PREPARED status, follow the directions in Reporting problems detected by the
system“Reporting problems detected by the system” on page 166. When the system reports the problem,
the problem log entry is packaged as a service request. Then your system automatically dials the service
provider system, and the system transmits the problem to the service provider.

To report all problems in the problem log that have a status of PREPARED, do one of the following:
1. On the Work with Problems display, press F16 (Report prepared problems).

168 iSeries: Getting started with iSeries


2. On any command line, type SNDSRVRQS *PREPARED and press Enter.

The connection to the service provider system ends when you receive a fix or when your problem is
opened for further investigation. The system changes the status of the problem to SENT or to
ANSWERED in the problem log.

Note: Whenever you use electronic customer support, the


iSeries needs to dial out to the IBM system. Remember to
have the electronic customer support modem available
and powered on.

Reporting problems by voice


If you find that you are not connected to a telephone line, or your communications lines are down, you can
report a problem with your system by voice (telephone). To report the problem by telephone, follow the
directions in Reporting problems detected by the system“Reporting problems detected by the system” on
page 166. When you get to the Select Reporting Option display, select option 3 (Report service request by
voice). The Report Service Request by Voice display gives you the telephone number of the service
provider for your specific problem.

Note: If the service provider is IBM, IBM assigns a service


number to the problem. To put this number in the problem
log, press F14 (Specify service-assigned number) on the
Report Service Request by Voice display.

Adding notes to your problem record


To attach a note or add to an existing note in the problem record, do the following:
1. Use the Work with Problem (WRKPRB) command.
2. Select option 12 (Enter text) on the Work with Problems display. The Select Text Type display appears.
3. Select Option 1 (Problem description) to enter problem description. Only the text that is entered with
this option is sent to the service provider along with the problem.

Notes should be typed in the following format to keep a chronological record of events.
v On the first line, type a brief description of the problem.
v On the second line, type the current date.
v On the third line, type in the note that you want to send. Use as many additional lines (up to 20) as you
need.

Include the following information in your notes:


v Any recent release update that you have applied to the system
v Any changes you made in the system configuration
v Any new program or feature that you are using
v Anything that may be different since the last time the program was run

Finding a previously reported problem


To find a previously reported problem, you need to know the IBM Service-assigned number, also known as
the problem management record (PMR).

Once you have this number, type the following on any command line:
WRKPRB SRVID(XXXXX)

where XXXXX is the PMR number, then press the Enter key.

Chapter 9. Handling system problems and getting help through electronic customer support 169
If you do not have the PMR number, use the Work with Problem (WRKPRB) command and search the list
for the problems with a status of SENT, VERIFIED, ANSWERED, and CLOSED.

Replacing Battery Power Unit on Models 5xx, and Tower FC507x and
FC508X
The part number for the battery power unit is 86G8040.

1. Do not power off the system.


2. Remove the front cover (1).
3. Pull out and lift to remove the screen (2).
Attention: Removing the battery power unit while the system is running on battery power will cause
the system to fail and may damage the battery power unit and the card enclosure.
Ensure that the system is not running on battery power. As a test, be sure that the console accepts
system commands before removing the battery power unit.
4. Caution:
Be careful when removing or installing this part or unit. This part or unit is heavy, but has a weight
smaller than 18 kilograms (39.7 pounds). (RSFTC201)

170 iSeries: Getting started with iSeries


Loosen the screws and use two hands to pull the battery power unit out (3).
5. Install the battery power unit by reversing the removal procedure.

Caution:
The battery is a lead-acid battery. To avoid possible explosion, do not burn. Exchange only with the
IBM-approved part. Recycle or discard the battery as instructed by local regulations.

In the United States, IBM has a process for the collection of this battery. For information, call
1-800-426-4333. Have the IBM part number for the battery unit available when you call.

Performing a main storage dump


If the system is logically partitioned, references to the system, system console, displays, system
commands, and system values are relative to the partition having a problem.

A main storage dump (MSD) is a process of collecting data from the system’s main storage. A main
storage dump can be formed in the following ways:
v Automatically: by the service processor as the result of a system failure.
v Manually: by performing a function 22 on the control panel when the system waits, loops, or appears to
have an operating system failure. You can perfrom this task by selecting option 22 from the Work with
partition status display.

Choose the task to perform:


v Performing an automatic MSD“Setting Up Automatic Cleanup” on page 57
v Performing a manual MSD“Performing a manual MSD” on page 172
v Performing a manual MSD on a logical partition6 on page 172
v Reporting and copying a current MSD“Copying a profile” on page 34
v Reporting a MSD“Reporting a MSD” on page 173
v Deleting an MSD“Deleting an MSD” on page 174

Performing an automatic MSD

After a failure that causes the system to perform an MSD , the Main Storage Dump Occurred display will
appear. When that happens, go to reporting and copying a current MSD“Copying a profile” on page 34

Main Storage Dump Occurred


+--------------------------------------------------------------------------------+
| Main Storage Dump Occurred |
| S/N 10xxxxx |
|The system has failed. Report the following information to |
|your IBM Service representative. |
| |
| Function 11 ...........: A1D03000 |
| Function 12 ...........: 69E0015F |
| Function 13 ...........: 0000308F |
| Function 14 ...........: FFFFFC00 |
| Function 15 ...........: 0C211008 |
| Function 16 ...........: 00000000 |
| Function 17 ...........: 00000000 |
| Function 18 ...........: 003954B0 |
| Function 19 ...........: 00311050 |
| Type/Model/Feature.....: 9402 400 2131 |
| |
| Warning: The Main Storage Dump (MSD) must be copied for service. |
| Failure to copy the Main Storage Dump will limit |
| the ability to diagnose the failure. |
| |
|Press Enter to copy the MSD for service or view the MSD. |

Chapter 9. Handling system problems and getting help through electronic customer support 171
| |
| F3=Exit F12=Cancel |
+--------------------------------------------------------------------------------+

Performing a manual MSD


Use this procedure on the primary partition or on a system without logical partitions. To place the data
from the system’s main storage to the load-source disk, perform the following procedure:
1. If your system has logical partitions, try to power them off.
2. Verify that there are no interactive jobs running.
a. Select Manual mode.
b. Use the Increment/Decrement buttons to display function 22 (main storage dump).
c. Press Enter pushbutton on the control panel.
3. Is 0000 0000 displayed on the control panel for more than 30 seconds?
Yes. The multiple function IOP or service processor is not responding to a request from the control
panel. Go to Getting help with problems. This ends the procedure.
No. Continue to the next step.
4. An attention SRC, A1xx 3022, is displayed, which indicates that function 22 has been selected.
Reselect function 22, press Enter on the control panel, and wait for the dump to complete. When the
dump is complete, the Main Storage Dump Occurred display is shown as below.
5. Did the MSD complete successfully? The appearance of an A1D0 300x or A6Dx 3000 SRC on the Main
Storage Dump Occurred display indicates a successful manual MSD.
6. Go to Getting help with problems. This ends the procedure.

Performing a manual MSD on a logical partition

Use this procedure on a logical partition. You should only perform a secondary partition MSD if under the
direction of customer support.

To place the data from system’s main storage to the load-source disk, perform the following procedure:
1. On the logical partition or on the primary partition, start Dedicated Service Tools (DST).
2. Select option 11 (Work with system partitions).
3. Select option 2 (Work with partition status).
4. Select the logical partition on which you want to perform the MSD. Initiating a MSD against the primary
partition is equivalent to initiating a MSD from the control panel.
5. Is the partition in Manual mode?
Yes. Continue to the next step.
No. Select option 10 (Mode manual).
6. Select option 22 (Force Main Storage Dump).
7. Select option 10 to confirm. Wait for the dump to complete. When the dump is complete, the Main
Storage Dump Occurred display is shown on the selected logical partition.
8. Did the MSD complete successfully? The appearance of an A1D0 300x or A6Dx 3000 SRC on the Main
Storage Dump Occurred display indicates a successful manual MSD.
9. Go to Getting help with problems. This ends the procedure.

Reporting and copying a current MSD

This procedure copies a MSD to a predefined storage area on the system. This will prevent MSD from
being overwritten in the event another dump occurs.
1. From the Main Storage Dump Occurred display, press Enter. The Main Storage Dump Manager
appears.
2. Select option 1 (Work with current main storage dump). The Work with Current Main Storage Dump
display appears.

172 iSeries: Getting started with iSeries


3. Select option 1 (Display/Print). The Display Main Storage Dump display appears.
4. Select option 1 (MSD summary). The Main Storage Dump Summary display appears. This display
shows the system reference code, date, and time of the MSD, and Licensed Internal Code level.
5. Record the summary information and report it to your service provider.
6. Press F12 (Cancel) twice to return to the Main Storage Dump Manager display.
7. Select option 3 (Copy to ASP). The Copy Main Storage Dump to ASP display appears. Type a dump
description, then press Enter to start copying the dump. After the dump is copied, a message will be
displayed indicating whether the MSD copy completed.
If the message indicates ″Copy completed normally,″ you are done with this procedure. If you do not
see this message, continue to the next step.
8. Has your service provider requested a tape copy of the MSD?
Yes. Continue to the next step.
No. Work with your service provider on the problem.
9. To copy MSD to a tape device, do the following:
a. Select option 2 (Copy to media). The Copy Main Storage Dump to Media display appears.
b. Load the media and follow the instruction on the display.
c. When the copy procedure is successfully completed, process the tape according to your service
provider’s instruction. If you encounter a problem with the copy procedure, contact your service
provider.

This ends the procedure.

Reporting a MSD
If your system has the Main Storage Dump auto copy enabled, your system may have automatically
copied the current MSD to the ASP using dump description ″Auto Copy,″ and then re-IPLed the system.
1. On any command line, enter STRSST.
2. Select option 1 (Start a service tool). The Start a Service Tool display appears.
3. Select option 6 (Main storage dump manager). The Main Storage Dump Manager display appears.
4. Select option 2 (Work with copies of main storage dumps). The Work with Copies of Main Storage
Dumps display appears.
5. Find the dump with the description of ″Auto Copy″ and select option 5 (Display/Print). The Display
Main Storage Dump display appears.
6. Select option 1 (MSD Summary). The Main Storage Dump Summary display appears. This display
shows the system reference code, date, and time of the MSD, and Licensed Internal Code level.
7. Report the summary information to your service provider.
8. Press F3 (Exit) to return to the Work with Copies of Main Storage Dumps Display.
9. If the dump has a description of ″Auto Copy,″ rename it so that another auto copy and re-IPL can
occur if necessary. Select option 7 (Rename). The Rename Main Storage Dump display appears. Type
a new dump description, then press Enter.
10. Has your service provider requested a tape copy of the MSD?
Yes. Continue to the next step.
No. Work with your service provider on the problem.
11. To copy MSD to a tape device, do the following:
a. Select option 8 (Copy to media). The Copy Main Storage Dump to Media display appears.
b. Load the media and follow the instructions on the display.
c. When the copy procedure is successfully completed, process the tape according to your service
provider’s instruction. If you encounter a problem with the copy procedure, contact your service
provider.

Continue with the procedure in Deleting an MSD“Deleting an MSD” on page 174

Chapter 9. Handling system problems and getting help through electronic customer support 173
Deleting an MSD
This procedure is used when dump copies are no longer needed by your service provider.
1. On any command line, enter STRSST.
2. Select option 1 (Start a service tool). The Start Service Tool display appears.
3. Select option 6 (Main storage dump manager). The Main Storage Dump Manager display appears.
4. Select option 2 (Work with copies of main storage dumps). The Work with Copies of Main Storage
Dumps display appears. From this display you can see the list of dump copies. If you want to delete
any dump compies, type 4 next to the dump copies, and press Enter twice. To exit SST, press F3
(Exit) three times, and then press Enter.

Determining the primary or alternate consoles


If the Operations Console has been configured as the primary console, the system will start the Operations
Console. If the Operations Console has not been configured, the primary console is a workstation that is
attached to the first Input/Output Processor (IOP) that is capable of supporting workstations.

In addition to the primary console, the system can assign up to two alternative consoles. The first
alternative console can only be a TWINAX workstation tat is attached to the same IOP as the primary
console. The second alternative console is a workstation that is attached to the next IOP or Input/Output
Adaptor (IOA) that is capable of supporting workstations.

The IOP that supports the console must be on the first system bus (bus 1).

If a workstation is not correctly attached to the first IOP that is capable of attaching workstations, then the
system will not assign a primary console. The system will display a reference code on the operator’s
panel. In addition, if the IPL (initial program load) mode is set to Manual, the system will stop.

Primary console workstation requirements


In order to be the primary console, the workstation must be operational and have the correct port and
address. If the workstation is a PC, it must also have anactive emulation program on the workstation.

The workstation requirements are:


v TWINAX workstation
- Port 0 Address 0
v ASCII workstation
- Port 0
v PC attached to ASCII IOP or IOA
- Port 0
- PC software to emulate a 316x or 3151 terminal
v PC attached to TWINAX IOP
- Port 0 Address 0
- 5250 emulator software active on PC
v PC attached to a LocalTalk IOA (6054)
- SNAps 5250 Version 1.2 (or above) application
- Console capable selected on MacIntosh (IOA converts to Port 0 Address 0)
v PC attached to a 2609, 2612, 2699, or 2721 communications IOA
- Client Access Console cable attached to the 2609 or 2612 P2 port (part number 46G0450 or
46G0479), 2699 (part number 21H3779), or 2721 (part number 44H7504)
- Operations Console cable attached to the 2609 or 2612 (part number 97H7555), 2699 (part number
97H7556), or 2721 (part number 97H7557)
- 5250 emulation or Rumba active on PC

174 iSeries: Getting started with iSeries


Finding the primary console when system is operational
The following methods can be used to find the primary console:

Method 1: Look for a sign-on display with a DSP01 in the upper-right corner.

Method 2: If the device name (DSP01) for the console has been changed, you can verify the device name
for the primary console by doing the following:
1. Enter DSPCTLD QCTL on any command line. The Display Controller Description display appears.
Find the Resource name parameter (such as CTL01) and record it.
2. Enter PRTDEVADR rrrrr on any command line, where rrrr is the resource name you recorded.

If the printer is active, the data will be printed.

Method 3:
1. Enter STRSST on any command line. The System Service Tools display appears.
2. Select option 1 (Start a service tool). The Start a Service Tool display appears.
3. Select option 7 (Hardware service manager). The Hardware Service Manager display appears.
4. Select option 2 (Logical hardware resources). The Logical Hardware Resources display appears.
5. Select option 1 (System bus resources). The Logical Hardware Resources on System Bus display
appears. The < symbol indicates the IOP that the system console is attached to. Use option 9
(Resource associate with IOP and display detail) to find the location of the system bus, board, and
card.

Finding the primary console when system power is off

Use one of the following:


v Power on the system in the Manual mode and look for the IPL and Install System display.
v Power on the system in the Normal mode and look for DSP01 on the sign on display. Note that the
name may have been changed. See Finding the primary console when system is operational“Finding
the primary console when system is operational” to determine the display name.

Getting help with system operation problems


The following table shows an overview of the system support structure and gives you guidelines on who to
call for your specific problem. Before calling for help, fill out the appropriate problem summary form. Your
service representative may need the information you have filled in to further analyze the problem.

For up-to-date contact information, visit the IBM web site.

Then, print this page and use information from the site to complete the table below. Refer to the page
whenever you need contact information.

Chapter 9. Handling system problems and getting help through electronic customer support 175
Type of Problem Call Telephone Numbers
Question
v Advice v IBM iSeries 400 Support Line or v 1-800-237-5511
v Migrating IBM Business Partner v
v ″How to″ v v
v Operating v v
v Configuring v v
v Ordering v v
v Performance v v 1-800-IBM-CALL
v General information v v 1-800-IBM-4YOU
v iSeries 400 Marketing Specialist or
IBM Direct Support Line or IBM
Business Partner
Software
v Fix information
v Operating system problem IBM Software Service 1-800-237-5511
v IBM application program
v Loop, hang, or message
Hardware
v IBM system hardware broken
v Hardware system reference code
IBM Hardware Service 1-800-IBM-SERV
(SRC)
v IBM input/output (I/O) problem
v Upgrade

176 iSeries: Getting started with iSeries




Printed in U.S.A.

You might also like