25
Mon, Nov
1 New Articles

Displaying and Understanding System Reference Codes

Typography
  • Smaller Small Medium Big Bigger
  • Default Helvetica Segoe Georgia Times

Understanding System Reference Codes (SRCs), their significance and their meanings, is critical in managing AS/400 operations and discovering potential problems that may have developed on your AS/400. It important to understand how SRCs are displayed by the system, and it is equally important to understand how to react and handle the situation they are referring to.

In this introduction to SRCs, I’ll attempt to dispel the mystery of these codes and, hopefully, alleviate your fears if, or perhaps more aptly when, you encounter them!

What Is an SRC?

An SRC is a set of characters that identify an error or condition detected by the OS/400 operating system and will be displayed on the control panel (Function/Data display) of the system unit. The first four characters indicate the type of error, and the last four give additional important information. The first character or two can also help identify the group (sometimes called category) within which the code resides. For example, if you receive an SRC of 93xx xxxx (where x indicates any other letter or number), it could indicate a possible disk unit failure has occurred! Figure 1 is a helpful chart to keep handy; it will help you determine in which direction to look for a problem. (This information is also provided and outlined in much more detail in table 7 of IBM’s AS/400 Basic System Operation, Administration, and Problem Handling V4R4.)

If an operating system or hardware failure occurs while the system is running normally, the SRC code will be sent to the QSYSOPR message queue. However, an SRC condition typically first rears its ugly head during an IPL, and will be displayed on the control panel (Function/Data display) of the system unit. (Later in this article is a brief discussion on how to use remote control panel APIs to access and react to SRCs.) Regardless of how an SRC code is communicated, it should be taken seriously. This could be the system’s first cry for help! Ignoring the situation or failing to properly record the code and act on it will make recovery more difficult, especially if your IBM service representative needs to get involved.

What Has Changed?


Unless an SRC is related to hardware failure, most conditions that create SRC exceptions can be traced to one of the following conditions:

• Power outage or fluctuation, which could create a hardware failure

• Hardware configuration change

• System software change

• New program installation or change (IBM program products), which can sometimes expose your system to new conditions; always apply any related PTFs with a new product.

Note: To make sure licensed programs and products have been properly installed, use the Check Product Option (CHKPRDOPT) command after installing a new product. This will report differences in the structure of the installed product. For more information, type in this command on any command line and prompt with F4, then review the online help.

• Recent PTF application

Always keep these possibilities in mind when diagnosing a problem. If help is required from IBM, make it aware of what has changed on your system. As I have indicated, do not ignore the SRC code. Record what is displayed so the IBM service representative can better understand the problem and know how to fix it.

Understanding the IPL Cycle

Other than disk failures, most SRC conditions usually occur during the IPL cycle. The IPL does a complete test of the hardware and configuration of your system. Load source is loaded from disk into memory during this process. Hard drives are powered up and recognized, and processors are started. An IPL is also the first process performed after new hardware is installed and configured using the service tools (DST), a new feature or card is added, or an abnormal power-down has occurred because of a power surge or outage.

Perhaps you just upgraded your operating system or applied a PTF or cumulative tape (cumulative PTF package). All of these conditions have created a change to your system and can therefore expose you to at least a potential problem that could generate an SRC.

While this article has implied that all SRCs indicate problems, it is important to mention that many SRC codes displayed on the panel of your system unit are simply informational. The next time you IPL your system, watch the control panel. Figure 2 lists the typical (normal) SRC codes that will be displayed as your system cycles through an IPL. (Your codes may vary somewhat, depending on the type of system unit you have.) Use this chart to benchmark the normal cycle times of each process, and keep those figures tucked away where you can easily retrieve them. Remember that these cycle times can change based on a number of situations, including the time that has lapsed since your last IPL, the installation of new hardware, or an abnormal power-down. It is always a good idea, however, to record a benchmark of the normal IPL cycle time of your system units. That way, you have something to compare with during subsequent IPLs.

If the IPL sign-on display (during an attended IPL) or normal sign-on screen (during an unattended IPL) does not appear after a reasonable amount of time, check the LCD panel of your system unit. You may see an (abnormal) SRC code displayed or even the System Attention light on your system control panel. This is the time to follow the instructions outlined in AS/400 Basic System Operation, Administration, and Problem Handling V4R4.


Reporting a Problem

Follow the instructions outlined in section 2 of the AS/400 Basic System Operation guide. If you encounter a situation that is confusing or not outlined clearly, do not hesitate to call an IBM customer service representative. After all, that’s why you pay those big bucks for your hardware service contract! You can reach IBM Service by dialing 1-800-IBM-SERV. Your IBM service representative may ask you to fill out a Problem Summary Form, which also can be found in section 2 of the guide. Record as much information as you can while it is available. You may also be instructed to obtain a main storage dump and run the authorized program analysis report (APAR) procedure.

All of these processes will collect valuable information that may be needed by your IBM service representative to diagnose and fix your system problems.

Using Remote Control Panel APIs to Improve SRC Alerts

You may want to consider harnessing the power of AS/400 APIs to alert and react to SRC conditions. APIs allow your custom-written program to interface with the system control panel. The IBM AS/400 Information Center (http://publib.boulder.ibm.com/pubs/ html/as400/infocenter.html) has a wealth of information on this topic. Search for the topic remote control panel APIs. Basically, remote control panel APIs can be established by using a standard TCP/IP Sockets connection and implemented with any programming language that supports Sockets, such as Java, C++, Visual Basic, and even RPG IV. Look to APIs, such as GetSPCNSRC or GetSRCs, to retrieve these values.

Consider using APIs and Java to create a Java applet that will pop up an alert on the system operator’s PC whenever an abnormal SRC condition is detected. You could even pass this information to a Palm Pilot or other wireless device by using Wireless Access Protocol (WAP). You might even want to take the information obtained from these APIs and display it in an Operations Navigator panel. (For more information on creating Operations Navigator plug-ins, see “How to Build OpsNav Plug-ins Using Java” in the July 2000 issue of MC.)

Prepare for a Disaster!

SRCs should be taken seriously. Get to know your individual system unit, IPL process, and system control panel, including the Function/Data display. Review, in detail, AS/400 Basic System Operation, Administration, and Problem Handling V4R4 before you need it. Understand what resources are available to you and get familiar with the recovery path you need to take in any situation. Educate yourself now before a disaster hits!

REFERENCES AND RELATED MATERIALS

• AS/400 Basic System Operation, Administration, and Problem Handling V4R4 (SC41- 5206-03, CD ROM QB3AGO03)

• IBM AS/400 Information Center: http://publib.boulder.ibm.com/pubs/html/as400/infocenter.html


SRC Series General Description or Category

0000 AABB Attempted a timed, remote, or automatic IPL with the 0000 AACC system in secure or manual mode

0000 AADD You attempted a manual IPL with the system in secure or auto mode
1xxx D101 Battery power unit failed or battery power unit test failed 1xxx D102
63xx xxxx Tape unit failed
93xx xxxx A disk unit failed
A6xx 0277 A compression disk unit can not complete an operation A900 2000 The IPL completed normally
BOxx xxxx Failure detected by communication Licensed Internal

Code (LIC) B6xx xxxx Not enough auxiliary storage (disk storage) B9xx xxxx OS/400 IPL Failure

Cxxx xxxx Occuring during an IPL. Will change frequently during a normal IPL
D1xx xxxx Diagnostic Status. Normal while system main storage is being saved to disk
D6xx xxxx Normal indication while system is being powered-down B2xx xxxx IPL Load Failure
D2xx xxxx Normal indication during powering-down of the system
Note: x can be any number from 0 to 9 or any letter from A to F.

SRC Series Activity

C1xx Bxxx Input/output processor testing C1xx 1xxx Input/output processor loading C3xx 3xxx System processor testing C1xx 2xxx System processor loading C1xx 202E Testing system main storage C1xx D009 System power hardware ready C1xx 2034 IPL control passed to system processor C6xx 4xxx Testing system configuration C6xx 4xxx IPLing OS/400
C6xx 4260 System disk data recovery
C9xx 2xxx Operating system starting
C900 29C0 Operating system (recovery)
Note: x can be any number from 0 to 9 or any letter from A to F.


Figure 1: Use this table to help determine system SRC codes.

Figure 2: Here are the typical (normal) SRC codes that will be displayed as your system cycles through an IPL.


BLOG COMMENTS POWERED BY DISQUS

LATEST COMMENTS

Support MC Press Online

$

Book Reviews

Resource Center

  • SB Profound WC 5536 Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application. You can find Part 1 here. In Part 2 of our free Node.js Webinar Series, Brian May teaches you the different tooling options available for writing code, debugging, and using Git for version control. Brian will briefly discuss the different tools available, and demonstrate his preferred setup for Node development on IBM i or any platform. Attend this webinar to learn:

  • SB Profound WP 5539More than ever, there is a demand for IT to deliver innovation. Your IBM i has been an essential part of your business operations for years. However, your organization may struggle to maintain the current system and implement new projects. The thousands of customers we've worked with and surveyed state that expectations regarding the digital footprint and vision of the company are not aligned with the current IT environment.

  • SB HelpSystems ROBOT Generic IBM announced the E1080 servers using the latest Power10 processor in September 2021. The most powerful processor from IBM to date, Power10 is designed to handle the demands of doing business in today’s high-tech atmosphere, including running cloud applications, supporting big data, and managing AI workloads. But what does Power10 mean for your data center? In this recorded webinar, IBMers Dan Sundt and Dylan Boday join IBM Power Champion Tom Huntington for a discussion on why Power10 technology is the right strategic investment if you run IBM i, AIX, or Linux. In this action-packed hour, Tom will share trends from the IBM i and AIX user communities while Dan and Dylan dive into the tech specs for key hardware, including:

  • Magic MarkTRY the one package that solves all your document design and printing challenges on all your platforms. Produce bar code labels, electronic forms, ad hoc reports, and RFID tags – without programming! MarkMagic is the only document design and print solution that combines report writing, WYSIWYG label and forms design, and conditional printing in one integrated product. Make sure your data survives when catastrophe hits. Request your trial now!  Request Now.

  • SB HelpSystems ROBOT GenericForms of ransomware has been around for over 30 years, and with more and more organizations suffering attacks each year, it continues to endure. What has made ransomware such a durable threat and what is the best way to combat it? In order to prevent ransomware, organizations must first understand how it works.

  • SB HelpSystems ROBOT GenericIT security is a top priority for businesses around the world, but most IBM i pros don’t know where to begin—and most cybersecurity experts don’t know IBM i. In this session, Robin Tatam explores the business impact of lax IBM i security, the top vulnerabilities putting IBM i at risk, and the steps you can take to protect your organization. If you’re looking to avoid unexpected downtime or corrupted data, you don’t want to miss this session.

  • SB HelpSystems ROBOT GenericCan you trust all of your users all of the time? A typical end user receives 16 malicious emails each month, but only 17 percent of these phishing campaigns are reported to IT. Once an attack is underway, most organizations won’t discover the breach until six months later. A staggering amount of damage can occur in that time. Despite these risks, 93 percent of organizations are leaving their IBM i systems vulnerable to cybercrime. In this on-demand webinar, IBM i security experts Robin Tatam and Sandi Moore will reveal:

  • FORTRA Disaster protection is vital to every business. Yet, it often consists of patched together procedures that are prone to error. From automatic backups to data encryption to media management, Robot automates the routine (yet often complex) tasks of iSeries backup and recovery, saving you time and money and making the process safer and more reliable. Automate your backups with the Robot Backup and Recovery Solution. Key features include:

  • FORTRAManaging messages on your IBM i can be more than a full-time job if you have to do it manually. Messages need a response and resources must be monitored—often over multiple systems and across platforms. How can you be sure you won’t miss important system events? Automate your message center with the Robot Message Management Solution. Key features include:

  • FORTRAThe thought of printing, distributing, and storing iSeries reports manually may reduce you to tears. Paper and labor costs associated with report generation can spiral out of control. Mountains of paper threaten to swamp your files. Robot automates report bursting, distribution, bundling, and archiving, and offers secure, selective online report viewing. Manage your reports with the Robot Report Management Solution. Key features include:

  • FORTRAFor over 30 years, Robot has been a leader in systems management for IBM i. With batch job creation and scheduling at its core, the Robot Job Scheduling Solution reduces the opportunity for human error and helps you maintain service levels, automating even the biggest, most complex runbooks. Manage your job schedule with the Robot Job Scheduling Solution. Key features include:

  • LANSA Business users want new applications now. Market and regulatory pressures require faster application updates and delivery into production. Your IBM i developers may be approaching retirement, and you see no sure way to fill their positions with experienced developers. In addition, you may be caught between maintaining your existing applications and the uncertainty of moving to something new.

  • LANSAWhen it comes to creating your business applications, there are hundreds of coding platforms and programming languages to choose from. These options range from very complex traditional programming languages to Low-Code platforms where sometimes no traditional coding experience is needed. Download our whitepaper, The Power of Writing Code in a Low-Code Solution, and:

  • LANSASupply Chain is becoming increasingly complex and unpredictable. From raw materials for manufacturing to food supply chains, the journey from source to production to delivery to consumers is marred with inefficiencies, manual processes, shortages, recalls, counterfeits, and scandals. In this webinar, we discuss how:

  • The MC Resource Centers bring you the widest selection of white papers, trial software, and on-demand webcasts for you to choose from. >> Review the list of White Papers, Trial Software or On-Demand Webcast at the MC Press Resource Center. >> Add the items to yru Cart and complet he checkout process and submit

  • Profound Logic Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application.

  • SB Profound WC 5536Join us for this hour-long webcast that will explore:

  • Fortra IT managers hoping to find new IBM i talent are discovering that the pool of experienced RPG programmers and operators or administrators with intimate knowledge of the operating system and the applications that run on it is small. This begs the question: How will you manage the platform that supports such a big part of your business? This guide offers strategies and software suggestions to help you plan IT staffing and resources and smooth the transition after your AS/400 talent retires. Read on to learn: