15
Fri, Nov
2 New Articles

Partner TechTip: Small but Mighty: Controlling the *CLS Object Type

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

What happens when multiple jobs compete for resources? It's all about the routing.

 

Things don't always go according to plan on IBM i. Or do they? While the instinct for administrators and IT managers is to always hunt down a culprita rogue job, an inactive journal receiver, or something elsesometimes the very building blocks of a common process, or rather the specifics that define processes, can be where the trouble at hand resides.

 

In such situations, these core definitions are often the last places to seek out the source of an issue as they are not problematic in themselves but can be problematic in certain circumstances. Class (CLS) object type is a good example of a small definition that packs a big punch when it comes to cause and effect of problem jobs in an IBM i environment.

 

What is CLS? Essentially, a CLS contains the parameters that control the running of a routing step. This criteria dictates the "what happens next" process for jobs. Breaking that process down in step-by-step manner, we can see the cause and effect in motion: When you submit a job via SBMJOB > the RTGDTA parameter identifies > the Subsystem Routing Entry > which in turn identifies the program that the job will run in.

 

Many IBM subsystems ship with a "catch all" *ANY routing entry. For this example, we'll use the "catch all" subsystem QBATCH.

 

040113CCSSFigure1

Figure 1

 

In the example, if a SBMJOB is run with any routing data other than the three compare values shown (QIGC, QS36EVOKE, and QCMD38), then the job will be matched against routing entry 9999, and the entry will be used to supply various run-time values when the job executes.

 

So, going back to our SBMJOB command: The job queue directs the job to run in a particular subsystem, as shown below:

 

040113CCSSFigure2

Figure 2

 

As the next screenshot shows, the routing data directs the job to the required subsystem routing entry. But why is this important?

 

040113CCSSFigure3

Figure 3

 

The reason is class: The subsystem routing entry contains the class that will be used when this entry is selected. In our example, the routing entry of 9999 will select class QBATCH.

 

040113CCSSFigure4

Figure 4

 

Class Values: In our examples, we've been looking at class QBATCH. The object's class contains a number of values that can in themselves determine what happens next, and further, what happens when multiple jobs compete for resources. A closer examination of the most important class values demonstrates why.

 

Run priority: This is the run priority that jobs will use when using this class. (Now you know why most batch jobs run at priority 50!) A job with a run priority of 20 will be treated with more importance than one with 50 if both are competing for resource at the same processing time.

 

Time slice in milliseconds: A job with a large time slice will stay in memory longer and hence use more CPU. Obviously, if there's only a single job running, then changing the time slice has very little effect. However, if there are multiple jobs with the same run priority and one job has a high time slice, this would result in the other jobs being ineligible, assuming there is insufficient memory available. This explains why you may experience high A/I (Active to Ineligible) and W/I (Wait to Ineligible) figures from time to time.

 

This may also help to explain why users may run a CHGJOB before executing an interactive query. Generally, changing the time slice for an interactive job has little effect, particularly on systems where response time is fast. An increased time slice, however, will have a big effect on system resources for interactive jobs when they're performing a lot of processing after pressing Enter, as in the case of query.

 

Eligible for purge: Indicates whether or not this job is eligible to be moved out of main storage (memory) and put in auxiliary storage at the end of a time slice.

 

If your end of day is suddenly taking longer, it might be worth checking to see if there are other jobs with higher run priorities. If so, investigate the CLS being used for these jobs, as these may be using resources, resulting in longer-running jobs. Alternatively, you could also see if the time slice is high, or maybe the "eligible for purge" is set to No.

 

Where issues pertain to temporary storage or CPU limits, it's also worthwhile using Class parameters to assist as Maximum CPU time in milliseconds can control how much CPU a job can use before the system will end it, and the maximum temporary storage parameter in megabytes can be used to control the amount of temporary storage a job can use before the system will end it.

Kurt Thomas

Kurt Thomas is a System Engineer for CCSS, a provider of flexible, affordable solutions to monitor performance and manage messages on IBM i. Based in Bonn, Germany, Kurt works with businesses worldwide to realize the potential of their IBM i environments. This email address is being protected from spambots. You need JavaScript enabled to view it..

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: