Tuesday, March 21, 2017

System, Partition, and Processor pool information all in one place

qlzarcapi for system, partition, server pool information

I am the first admit I do not know everything about IBM i as, in my opinion, there is just too much to know. Therefore, I am always grateful when people send me things they have found as there are many times they are new to me too. I have Laurent Gomes to thank for bringing to my attention the API QLZARCAPI.

I find it interesting that I cannot find any mention of it IBM's KnowledgeCenter, and only a passing reference in the documentation for the QMGTOOLS. What this API does is to display the system, partition, and processor pool information for the current IBM i partition.

I have found the best place to display this information is in the QCMD screen.

  CALL QCMD

At the QCMD screen I type:

  CALL QSYS/QLZARCAPI

And the following information is displayed:

                              Command Entry                         MY_SYS

 Previous commands and messages:
  > call qsys/qlzarcapi
  SYSTEM INFO -> SYSTEM SERIAL NUMBER: XX-XXXXX  . SYSTEM TYPE-MODEL: 8406-
    70Y. PROCESSOR FEATURE CODE: 52CA. PROCESSOR GROUP:  P05. MAX PHYSICAL
    PROCS IN SYSTEM: 4. CONFIGURABLE PROCS IN SYSTEM: 4.
  PARTITION INFO -> NETWORK NAME: MY_SYS  . PARTITION NAME: MY_SYS,
    PARTITION ID: 2. SHARING TYPE: SHARED. SHARING MODE: CAPPED. MIN
    PROCESSING CAPACITY: 0.10. DESIRED PROCESSING UNITS: 0.40. MAX
    PROCESSING CAPACITY: 2.00. ENTITLED PROCESSING CAPACITY: 0.40. MIN
    VIRTUAL PROCESSORS: 1. DESIRED VIRTUAL PROCESSORS: 1. MAX VIRTUAL
    PROCESSORS: 4. ONLINE VIRTUAL PROCESSORS: 1
  PROCESSOR POOL INFO -> NUMBER OF VIRTUAL PROCESSOR POOLS CONFIGURED: 1.
    CURRENT PROCESSOR POOL ID: 0. MAXIMUM PROCESSING UNITS FOR PROCESSOR
    POOL 0: 4.
                                                                    Bottom 
Type command, press Enter.
===>                                                                     

Note:  I have changed some information for security reasons.

Lots of interesting stuff which will prove invaluable to have in one place if you need to provide system information to a helpdesk or something similar.

I just want to say "Merci" to Laurent. I just love that there is so much stuff in IBM i, and there is always something new to discover.

 

This article was written for IBM i 7.3, and should work for earlier releases too.

5 comments:

  1. Good tip. That's a whole lot more information than trying to piece things together using GO SERVICE option 6, and DSPDTAARA QSS1MRI)
    - Serial Number: (DSPSYSVAL QSRLNBR)
    - Model Number: (DSPSYSVAL QMODEL)
    - Processor Feature Code: (DSPSYSVAL QPRCFEAT)

    Paul

    ReplyDelete
  2. I think a post on what is actually a partition/pool/and rest would be an insight on this topic for developers like me when we display this API.

    ReplyDelete
  3. Toujours excellent

    ReplyDelete
  4. A good point.. we don't know all about the system.. is great to found tips like this

    ReplyDelete

To prevent "comment spam" all comments are moderated.
Learn about this website's comments policy here.

Some people have reported that they cannot post a comment using certain computers and browsers. If this is you feel free to use the Contact Form to send me the comment and I will post it for you, please include the title of the post so I know which one to post the comment to.