Professional Documents
Culture Documents
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 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
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.
Getting started with iSeries 400: Introductory reference material for users new to the iSeries.
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.
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.
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.
Installing Fixes
Extreme Support
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.
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
Now that the iSeries is powered on correctly, you are ready to begin your Initial Program Load
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.
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.
Like Operations Navigator, the command line interface emulation is installed as a part of Client Access
Express.
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.
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.
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.
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!
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.
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.
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.
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.
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.
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.
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.
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.
Universal Connection
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.
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:
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
Handling messages
Working with messages
Create a message monitor
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.
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:
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.
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
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.
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.
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.
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.
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:
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.
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.
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.
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.
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.
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.
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.
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.
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.
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
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.
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 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.
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.
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:
Check out Management Central’s user administration function if you need to administer profiles across
multiple systems.
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.
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 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.
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.
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.
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.
Your selection under Audit these actions specifies the level of activity that is audited for a user profile.
Management Central
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.
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.
Security Reference
Management Central’s user administration function
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.
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:
Security Reference
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
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.
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
QIPLTYPE
The IPL type system value defines the type of IPL the system does from the control panel.
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
QRMTIPL
The remote IPL system value allows you to start the remote system by using your telephone and a
modem or the SPCN signal.
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.
See the Uninterruptible power supply delay time system value (QUPSDLYTIM) for more detailed
information about QUPSDLYTIM.
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.
Depending on what you selected on the IPL Options display, the following is shown next:
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).
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.
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
Tip: Press Enter to continue with the IPL from the Edit Rebuild of Access Paths display.
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.
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.
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.
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.
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:
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
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).
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.
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.
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.
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.
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.
When the IPL has finished, you will receive hourly messages that tell how much time is left in the bypass
period.
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.
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.
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)
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.
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.
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.
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.
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.
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)
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.
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.
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
——————————————————————————————————————————————
——————————————————————————————————————————————-
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.
—————————————————————————————-
ACTIVATION INSTRUCTIONS:
———————————————————
NONE.
SPECIAL INSTRUCTIONS:
———————————————————
NONE.
SUPERSEDES
PTF/FIX NO(S).áá APAR TITLE LINE
———————áá—————————————————————————————
SIxxxxxááááááááá OSP-RSTS36F-MSGCPA2C6C RESTORING ALL FILES FROM SYSTEM/34
Description of fields:
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
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.
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 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.
These PSPs can be ordered through your software service provider or by using electronic customer
support.
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.
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.
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.
To process your PTF order in batch, use the Submit Job (SBMJOB) command.
Note: get more information before you install fixes on a logically partitioned iSeries.
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.
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.
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.
If the cumulative fix package was not installed successfully, you see error messages like the following:
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
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.
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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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)
CPYPTF LICPGM(5769SS1)
FROMDEV(TAP01)
TODEV(*SAVF)
OMIT(SF00600)
FROMSEQNBR(16)
FROMENDOPT(*LEAVE)
TOSAVF(QGPL/PCUMPSS1)
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.
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.
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.
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)
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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) .
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.
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.
Get the latest SNMP configuration and troubleshooting information from the IBM Knowledge Base ,
Get the latest PJL configuration and troubleshooting information from the IBM Knowledge Base , or
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.
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
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
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.
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.
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.
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.
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.
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.á
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.
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.
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
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.
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.
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.
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.
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
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
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.
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.
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.
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
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 *.
An active file has an expiration date that is equal to or later than the current date.
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
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.
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.
If you are not able to make a device ready, contact your service representative.
Note: The CD-ROM drive on the iSeries system is not enabled for the digital audio disc.
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.
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.
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
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.
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.
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.
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.
Note: For more detailed information about using 1/2-inch tape cartridges, see Care and Handling of the
IBM Magnetic Tape Cartridge GA32-0047
Note: For more detailed information about using Magstar MP tape cartridges, see the IBM 3570 Magnetic
Tape Subsystem Operator’s Guide
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.
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
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:
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:
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:
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.
The various on/off combinations of the status lights are shown in the following chart.
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.
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.
SAFE
Write-Protected
OR
SAFE
Not Write-Protected
RV2P749-0
Write-Protected
OR
Not Write-Protected
RV2P986-0
The 7208 Models 002, 012, 222, 232, 234, and 342 are external tape units for the iSeries System Units.
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.
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.
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.
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
Flashing
or Off or On
or Off or
Flashing
RV3P176-1
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.
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.
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.
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.
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.
If the tape cartridge cannot unload and has to be removed manually from the drive, contact your service
representative.
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.
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.
Tape must be
1.5 mils thick
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.
When loading a tape reel, ensure that the loose end of the tape is on the tape reel and not under the reel.
If the tape unit is cleaned thoroughly and a particular tape is causing errors, discard the tape.
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.
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.
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.
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.
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.
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.
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.
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.
Additional Information:
Press the Enter pushbutton to alternate between function and data.
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.
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.
Management Central’s message monitor can also inform you when a problem has developed.
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.
Additional Information:
If the additional message information tells you to run problem analysis, go to Step 18.
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.
End of procedure.
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.
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.
If the system console did not vary on, see Procedure 11.
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.
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.
If you still have the same problem, call your hardware service representative.
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.
If you still have the same problem, call your hardware service representative.
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
_____ 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 __________
Comments: _______________________________________________________________________
_____ 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: _______________________
_____ 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: _______________________________________________________________________
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: _______________________
_____ 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: _______________________________________________________________________
Logical partitions
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).
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.
For information on how to find a problem, see Finding a previously reported problem“Finding a previously
reported problem” on page 169.
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.
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.
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.
Method 1:
1. On any command line, type QRYPRBSTS on any command line, and press F4. The Query Problem
Status (QRYPRBSTS) display appears.
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.
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.
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).
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.
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.
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.
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.
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.
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
Chapter 9. Handling system problems and getting help through electronic customer support 171
| |
| F3=Exit F12=Cancel |
+--------------------------------------------------------------------------------+
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.
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.
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.
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.
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.
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.
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.
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
Printed in U.S.A.