All variables listed below are available for all event types. However, some variables are not applicable for all events. If a variable represents event data that is not applicable for a particular event, the variable will have a zero length for that event.
Indicates alarm message.
Character, read-only, 1 character.
Not an alarm message.
Alarm message.
0
HWSOSMSG
Name of application providing the event.
Character, read-only, up to 8 characters.
Application name
HIS
Note: HIS is the Hardware Interface Service
All events
Capacity change value.
Character, read-only, up to 10 characters.
Capacity change value.
2
HWSCAPCHG
FENCED_BOOK
DEFECTIVE_PROCESSOR
CONCURRENT_BOOK_REPLACE
CONCURRENT_BOOK_ADD
CHECK_STOP
CHANGES_ALLOWED
CHANGES_NOT_ALLOWED
Capacity record value.
Character, read-only, up to 10 characters.
Capacity record value
3
HWSCAPREC
RECORD_ADD
RECORD_DELTA
RECORD_DELETE
RECORD_ACCOUNTING
ACTIVATION_LEVEL
PRIORITY_PENDING
RECORD_OTHER
Indicates command last.
Character, read-only, 1 character.
Flag is off.
Flag is on.
0
HWSCMDRESP
Command return code.
Character, read-only, up to 10 characters.
Return Code
12
HWSCMDRESP
Command type.
Character, read-only, up to 10 characters
Command type
5
HWSCMDRESP
Disabled wait partition ID.
Character, read-only, up to 10 characters
Partition ID
4
HWSDBLWAIT
Disabaled wait processor number
Character, read-only, up to 10 characters
Processor number
1
HWSDBLWAIT
Disabled wait PSW.
Character, read-only, up to 32 characters.
PSW
00020000000000000000000000009003
HWSDBLWAIT
Disabled wait serial number.
Character, read-only, up to 16 characters
Serial number
00001316F574
HWSDBLWAIT
The variables API.NUMENTRIES, API.ELEVELx, API.ETYPEx, and API.ENAMEx describe the hierarchy of entities for an event. For each entity related event, the entity level, type and name are returned for the entity directly related to the event. In addition, the entity level, type and name are returned for each entity in the event entity hierarchy. That is, the level, type and name are returned for each parent, grandparent, and any other entity of the event entity. There can be up to 10 entities defined in the entity hierarchy.
Variables API.ELEVELx, API.ETYPEx, and API.ENAMEx where x is 1 through 10 are always defined for each event.
Variable API.NUMENTRIES indicates how many entities are actually returned in the hierarchy.
API.ENAME1, APIETYPE1, and APIELEVEL1 will contain the information for the entity which is directly related to the event. Starting at API.ENAME2, API.ETYPE2, and API.ELEVEL2, the variables will contain information related to the parent, grandparent, and any other entity. The entities go up the topology hierarchy.
If API.NUMENTRIES=2, two entities are returned in the hierarchy. Variables API.ELEVEL1, API.ETYPE1, API.ENAME1, API.ELEVEL.2, API.ETYPE2, and API.ENAME2 will be filled in with entity information.
Variables API.ELEVELx, API.ETYPEx, and API.ENAMEx where x is 3-10 will have a zero length.
Level of entity in the returned entity hierarchy.
Character, read-only, up to 10 characters.
Level of entity in the hierarchy
3
Entity related events
Name of entity in the returned entity hierarchy
Character, read-only, up to 32 characters.
Name of entity
IBM500EX.SY01
Entity related events
Type of entity in the returned entity hierarchy.
Character, read-only, up to 10 characters.
Entity type values:
Enterprise or Root
Installation or Data Center
Ensemble
Machine
CPC
zBX
LPAR
Capacity Record
Reset Activation Profile
Image Activation Profile
Load Activation Profile
Sysplex
System
Coupling Facility
15
Entity related events
Event date.
Character, read-only, 10 characters.
Format: YYYY/MM/DD
2011/04/01
All events.
Event description.
Character, read-only, up to 60 characters.
Each event has its own description. See the values listed with individual events in the Event ID, Associated Entity, and Description Table below.
ENTITY STATUS CHANGE
All events.
Entity hierarchy level.
Character, read only, up to 10 characters.
0 for system related event, otherwise level of event entity in hierarchy.
6
All events
Event time
Character, read-only, up to 11 characters.
Format: HH:MM:SS.TH
10:53:56.97
All events
Exception State.
Character, read-only, 1 character.
Not exception state
Exception state
0
HWSENTEXC
Indicates held message
Character, read-only, 1 character
Not a held message
Held message
0
HWSOSMSG
Hardware I/F name. This is the name of the underlying hardware interface being used by the application in API.APPLICATION.
Character, read-only, up to 16 characters.
Name of underlying interface.
BCPII
HWSINTFUP, HWSINTFDWN
Name of the event.
Character, read-only, up to 10 characters.
Each event has its own event ID. The event ID is the value used to match API rules. See the values listed with individual events in the Event ID, Associated Entity, and Description Table below. All event IDs start with the HWS prefix.
HWSSTATCHG
All events.
Image List
Character, read-only, up to 32000 characters.
List of images
TS03 TS12 TS22 TS30 COUPLEA1 COUPLEA2
HWSHWMSG, HWSHWMSGD
Indicates event was issued while topology initialization was in progress by application in API.APPLICATION.
Character, read-only, 1 character.
Topology initialization not in progress when event issued
Topology initialization was in progress when event issued
0
HWSNEWCHLD, HWSNEWENT
Reserved for future use.
Character, read-only, up to 8 characters.
Text indicating reserved field.
RESERVED
All events.
Message Date
Character, read-only, 8 characters.
Format: YYYYMMDD
20110402
HWSOSMSG
Message ID
Character, read-only, up to 16 characters
ID of message
187898401
HWSOSMSG
Message Text.
Character, read-only, up to 32000 characters.
Text of message. May include multiple lines separated by the EBCDIC ‘NL’ (X’15’) character. API.MTNUML specifies the number of lines and can be used in conjunction with the ‘NL’ character to parse into individual lines if desired. The ‘NL’ character is only present if there are two or more lines.
The reset profile RESETSY01. was changed.
HWSOSMSG, HWSHWMSG, HWSSECUR
Message Time
Character, read-only, 8 characters.
Format: HHMMSSTH
17015043
HWSOSMSG
Message time stamp.
Character, read-only, up to 32000 characters.
Time stamp
03-28-2011 16:14:03:806
HWSHWMSG, HWSSECUR
Number of lines in API.MSGTEXT.
Character, read-only, up to 10 characters.
0 if no message text is included with the event, 1 or more if message text is included.
2
HWSHWMSG, HWSOSMSG, HWSSECUR
New entity type.
Character, read-only, up to 10 characters.
See Values under API.ETYPEx
15
HWSNEWCHLD, HWSNEWENT
Indicates new message.
Character, read-only, 1 character.
Not a new message.
New message.
0
HWSOSMSG, HWSHWMSG
New name.
Character, read-only, up to 32 characters.
Name
SY03
HWSNEWCHLD, HWSNEWENT, HWSACTPCHG
New power mode value.
Character, read-only, up to 10 characters.
Power mode value
4
HWSPOWCHG
New power save mode allowed.
Character, read-only, up to 10 characters
Power mode allowed.
3
HWSPOWCHG
New status value.
4 byte binary (unprintable), read-only.
See Status Values.
'00000002'X
HWSSTATCHG
OPERATING
NOT_OPERATING
NO_POWER
NOT ACTIVATED
EXCEPTIONS
STATUS_CHECK
SERVICE
LINKNOTACTIVE
POWERSAVE
SERIOUSALERT
ALERT
ENVALERT
SERVICE_REQ
DEGRADED
STORAGE_EXCEEDED
LOGOFF_TIMEOUT
FORCED_SLEEP
IMAGE_NOT_OPERATING
IMAGE_NOT_ACTIVATED
IMAGE_NOT_CAPABLE
Number of entries for entity hierarchy.
Character, read-only, up to 10 characters.
A number between 0 and 10.
4
All events, but generally 0 for system related events.
Old/prior name.
Character, read-only, up to 32 characters.
Name
COUPLEA1
HWSACTPCHG
Old power mode value.
Character, read-only, up to 10 characters.
Power mode value.
5
HWSPOWCHG
Old power save mode allowed.
Character, read-only, up to 10 characters.
Power mode allowed.
6
HWSPOWCHG
Old/prior status value.
4 byte binary (unprintable), read-only.
See Status Values
'00000004'X
HWSSTATCHG
Name of CA OPS/MVS subsystem receiving the event.
Character, read-only, 4 characters.
CA OPS/MVS subsystem name.
OPSS
All events.
Operating system instance name.
Character, read-only, up to 16 characters.
Name of the operating system.
SY11
HWSOSMSG
Indicates permanent hardware error.
Character, read-only, 1 character.
Not permanent error (temporary error).
Permanent error
1
HWSHWCOMER
Prompt text.
Character, read-only, up to 32,000.
Text of prompt
NULL
HWSOSMSG
Indicates priority message.
Character, read-only, 1 character.
Not a priority message.
Priority message.
0
HWSOSMSG
Indicates system or entity related event.
Character, read only, 1 character.
Entity related event.
System related event.
0
All events.
Text for event.
Character, read-only, up to 128 characters.
Order of text fields:
HWSSECUR SECURITY EVENT CPC IBM500EX.SY01 The reset profile RESETSY01. was changed.
All events.
Version of application identified in API.APPLICATION.
Character, read-only , up to 8 characters.
For application HIS (Hardware Interface Service) the version is in the form VV.MM.RR.
01.00.09
Note: This is example in the format used by the HIS application.
All events.
|
Copyright © 2011 CA.
All rights reserved.
|
|