semantic-conventions/docs/resource/zos.md

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
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.