In addition to the System z API manual that Walt mentioned,
there are also a couple of members in SYS1.MACLIB(HWI*)
that I found useful.
/jack
----- Original Message -----
From: "Tom Ambros" <[email protected]>
Newsgroups: bit.listserv.ibm-main
To: <[email protected]>
Sent: Tuesday, August 16, 2011 8:50 AM
Subject: Naive BCPii questions
- I have the zSeries API documentation and the BCPii specific zOS docs but
I am not able to find items related to returned values, for example
HWIQUERY of HWI_OPERSTAT. I can probe and knowing the state of what I'm
seeing can infer what I am getting but I'd like to find wherever these
flags are defined to make sure I'm writing my app correctly. For example,
querying a deactivated lpar I get x'0008', an activated lpar that's varied
from the sysplex I see x'0002' and a running CF gives me x'0001'. That's
great but I am concerned about what I don't know here. Where can I find
this stuff?
- Event notifications... I'd like to automate the responses when I start
my sysplex on the DR machines. Activating and IPLing is pretty easy.
Receiving events, I find not so easy. I do not have a C compiler at my
disposal, so at least that part is easier... but the scheme I am not sure
how to approach. I believe I'll call the event notification exit by
virtue of the HWIEVENT registration, and I'm guessing that I let the exit
do whatever processing I want. Two thoughts come to mind there. I can
wait for the activation to complete by looping a bunch of queries until I
get my x'0001' (or hit what loop limit I set) or I can register for the
state change. How to return to my HWIEVENT registering program the state
change so it can proceed to do the rest of its business? This is where my
program management skills are showing their weakness. I'm guessing
something like feeding Reg15 a return code would work but that has its
limitations when I start dealing with things not so straightforward.
I'd really like to register for operating system messages and process the
various WTORs as they appear (IEA347A, IXC this and that for CFs, couple
datasets, etc., subduing automation and so on... remember I don't have
ProcOps on the first system in). When I call the exit, is it setting up
connections of its own and processing the ENF info itself? The examples
in the manuals are pretty amusing, responding with WTOs to the events, but
that'd be a bit useless in this case.
Probably the best answer I'm looking for is which docs I should be looking
at so I can figure this stuff out... mostly I'm looking to shorten the
research path as much as I can. Thanks...
Thomas Ambros
Operating Systems and Connectivity Engineering
518-436-6433
----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [email protected] with the message: GET IBM-MAIN INFO
Search the archives at http://bama.ua.edu/archives/ibm-main.html
