z/OS software
This document defines z/OS software entity and documents how to populate other entities, such as host
in the context of mainframes.
Status:
type: zos.software
Description: A software resource running on a z/OS system.
Attribute | Type | Description | Examples | Requirement Level | Stability |
---|---|---|---|---|---|
zos.smf.id | string | The System Management Facility (SMF) Identifier uniquely identified a z/OS system within a SYSPLEX or mainframe environment and is used for system and performance analysis. | SYS1 | Required | |
zos.sysplex.name | string | The name of the SYSPLEX to which the z/OS system belongs too. | SYSPLEX1 | Required | |
mainframe.lpar.name | string | Name of the logical partition that hosts a systems with a mainframe operating system. | LPAR01 | Recommended |
Host
The following table describes how to populate attributes on the host
entity on mainframes.
Attribute | Type | Description | Examples | Requirement Level | Stability |
---|---|---|---|---|---|
host.arch | string | The CPU architecture the host system is running on. | s390x | Recommended | |
host.name | string | Name of the host. On z/OS, SHOULD be the full qualified hostname used to register the z/OS system in DNS. | SYS1.DOMAIN.COM | Recommended | |
host.id | string | Unique host ID. On z/OS, SHOULD be the concatenation of sysplex name and SMFID, separated by a dash | SYSPLEX1-SYS1 | Opt-In |
host.arch
has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
Value | Description | Stability |
---|---|---|
amd64 | AMD64 | |
arm32 | ARM32 | |
arm64 | ARM64 | |
ia64 | Itanium | |
ppc32 | 32-bit PowerPC | |
ppc64 | 64-bit PowerPC | |
s390x | IBM z/Architecture | |
x86 | 32-bit x86 |
Operating System
The following table describes how to populate the operating system attributes on mainframes.
Attribute | Type | Description | Examples | Requirement Level | Stability |
---|---|---|---|---|---|
os.type | string | The operating system type. | zos | Required | |
os.version | string | The version string of the operating system. On z/OS, SHOULD be the release returned by the command d iplinfo . | 3.1.0 | Recommended | |
os.description | string | Human readable OS version information, e.g., as reported by command d iplinfo . | IBM z/OS 3.1 | Opt-In | |
os.name | string | Human readable operating system name. | z/OS | Opt-In |
os.type
has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
Value | Description | Stability |
---|---|---|
aix | AIX (Advanced Interactive eXecutive) | |
darwin | Apple Darwin | |
dragonflybsd | DragonFly BSD | |
freebsd | FreeBSD | |
hpux | HP-UX (Hewlett Packard Unix) | |
linux | Linux | |
netbsd | NetBSD | |
openbsd | OpenBSD | |
solaris | SunOS, Oracle Solaris | |
windows | Microsoft Windows | |
z_os | Deprecated. Use zos instead. | |
zos | IBM z/OS |
Process
The following table describes how to populate attributes on the process
entity on mainframes.
Attribute | Type | Description | Examples | Requirement Level | Stability |
---|---|---|---|---|---|
process.command | string | The command used to launch the process (i.e. the command name). On z/OS, SHOULD be set to the name of the job used to start the z/OS system software. | CICSSTRT | Required | |
process.pid | int | Process identifier (PID). [1] | 008A | Required | |
process.owner | string | The username of the user that owns the process. [2] | CICSUSR | Opt-In | |
process.runtime.description | string | An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment. | IBM Customer Information Control System (CICS) Transaction Server for z/OS Version 5.6 | Opt-In | |
process.runtime.name | string | The name of the runtime of this process. | CICS Transaction Server z/OS Version 5.6 | Opt-In | |
process.runtime.version | string | The version of the runtime of this process, as returned by the runtime without modification. | 5.6 | Opt-In |
[1] process.pid
: On z/OS, SHOULD be set to the Address Space Identifier.
[2] process.owner
: On z/OS, SHOULD be set to the user under which the z/OS system software is executed.
Feedback
Was this page helpful?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!