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

Key	Stability	Requirement Level	Value Type	Description	Example Values
zos.smf.id		Required	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
zos.sysplex.name		Required	string	The name of the SYSPLEX to which the z/OS system belongs too.	SYSPLEX1
mainframe.lpar.name		Recommended	string	Name of the logical partition that hosts a systems with a mainframe operating system.	LPAR01

Host

The following table describes how to populate attributes on the host entity on mainframes.

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
host.arch		Recommended	string	The CPU architecture the host system is running on.	s390x
host.name		Recommended	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
host.id		Opt-In	string	Unique host ID. On z/OS, SHOULD be the concatenation of sysplex name and SMFID, separated by a dash	SYSPLEX1-SYS1

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.

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
os.type		Required	string	The operating system type.	zos
os.version		Recommended	string	The version string of the operating system. On z/OS, SHOULD be the release returned by the command d iplinfo.	3.1.0
os.description		Opt-In	string	Human readable OS version information, e.g., as reported by command d iplinfo.	IBM z/OS 3.1
os.name		Opt-In	string	Human readable operating system name.	z/OS

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.

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
process.command		Required	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
process.pid		Required	int	Process identifier (PID). [1]	008A
process.owner		Opt-In	string	The username of the user that owns the process. [2]	CICSUSR
process.runtime.description		Opt-In	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
process.runtime.name		Opt-In	string	The name of the runtime of this process.	CICS Transaction Server z/OS Version 5.6
process.runtime.version		Opt-In	string	The version of the runtime of this process, as returned by the runtime without modification.	5.6

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