LPAR function
The primary purpose of the Logical Partition (LPAR) function is to resolve the Managed System Name (MSN) for events correlation in a work flow. You need to construct the MSN to get the metrics from other agents to correlate the events.
For example, the zOS agent has the sysplex name in the MSN, but other agents do not know the sysplex name. In such a scenario, you can utilize the @LPAR function to return zOS MSN for event correlation.
Syntax
@LPAR($smfid)
Where ($smfid) is the variable name for SMF ID. You can change the variable name to suit your preferences.
For example, if you have created a variable smfid, you can enter @LPAR($smfid) in the Managed systems field of the Query Editor and @LPAR($smfid) will be resolved to the associated managed system during run time.
The following table presents the managed system returned from
@LPAR($smfid) during cross-product
linking for each application:
| @LPAR | Application | Result in MSN | Comment |
|---|---|---|---|
| @LPAR($smfid) | CICSplex | RS25::CICSplex | RS25 is the CICSplex name. |
| DB2 Subsystems | DBA1:RS25:DB2 | DBA1 is Db2's name, and RS25 is smfid. | |
| IMS Subsystems | IFA5:RSC1:IMS | IFA5 is the IMS name, and RSC1 is smfid. | |
| Integration Bus Agent | RSC1:KQIA | RSC1 is smfid. | |
| Integration Bus Broker Node | Q192BRK::KQIB | Q192BRK is the Integration Bus Broker Node. | |
| JVM Monitor | JJQ9:RS27:JVM | JJQ9 is the collector ID, and RS27 is smfid. | |
| Mainframe Networks | IVY1N3:RSD1:KN3AGENT | IVY1N3 is the network agent STC name, and RSD1 is smfid. | |
| MQ Queue Manager | Q192:RSC1:MQESA | Q192 is the MQ manager, and RSC1 is smfid. | |
| MQ Queue Sharing Group | QG23::MQQSG | QG23 is the MQ Queue Sharing Group. | |
| MVS CICS | RS25.CI2561NN | RS25 is smfid, and CI2561NN is the CICS region name. | |
| MVS CICSTG | RS25.TG2561NN | RS25 is smfid, and TG2561NN is CICS TG's name. | |
| Storage Subsystems | OMEGTEMS:RS22:STORAGE: | OMEGTEMS is TEMS STC name, and RS22 is smfid. | |
| TCP/IP | TCPIP:RSD2 | RSD2 is smfid. | |
| VTAM | VTAM:RSD2 | RSD2 is smfid. | |
| ZOS SYSPLEX | SYSPLEX01:MVS:SYSPLEX | SYSPLEX01 is sysplex name. | |
| ZOS SYSTEM | SYSPLEX01:RS22:MVSSYS | SYSPLEX01 is the sysplex name, and RS22 is smfid. |