Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (e - f) fmtmsg(3)
NAME
fmtmsg - Displays message on standard error or system console in specified format
LIBRARY
G-series native OSS processes: /G/system/sysnn/zosshsrl
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zosshdll |
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yosshdll |
SYNOPSIS
#include <fmtmsg.h>
int fmtmsg(
long classification,
const char *label,
int severity,
const char *text,
const char *action,
const char *tag);
PARAMETERS
classification Identifies the source of the message and tells how to display the message.
label Is a pointer to a string that gives the source of the message.
severity Is the severity of the condition that prompted the message.
text Is a pointer to a string that describes the condition encountered.
action Is a pointer to a string that describes the first step of error recovery.
tag Is a pointer to an identifier that references online documentation.
DESCRIPTION
The fmtmsg( ) function displays a message using the specified format. This is an alternative to
printf( ). Based on the value of the classification parameter, the message is written to the stan-
dard error, the console, or both.
The formatted message is specified as the following parameters:
classification Consists of identifiers from the following groups of major classifications and
subclasses. An identifier from one subclass can be combined with one identifier
from a different subclass. No more than one identifier from a single subclass
should be included, with the exception of the display subclass.
Major Classifications
Identifies the condition’s source. It can be one of MM_HARD (hardware),
MM_SOFT (software), or MM_FIRM (firmware).
Message Source Subclass
Identifies the software type in which the condition was detected. It can be one of
MM_APPL (application), MM_UTIL (utility), or MM_OPSYS (operating sys-
tem).
Display Subclass
Identifies where to display the message. It can be one or both of MM_PRINT
(standard error) or MM_CONSOLE (system console).
527187-017 Hewlett-Packard Company 2−97