Author |
Message
|
mqtablet |
Posted: Thu Apr 05, 2012 9:48 am Post subject: WebSphere MQ - PCF to MQSC Document |
|
|
Acolyte
Joined: 09 Jun 2009 Posts: 71
|
Is there any document from IBM which maps the PCF parameter to the corresponding MQSC parameter and values?
For example,
MQIA_AUTH_INFO_TYPE = PCF parameter.
Corresponding MQSC parameter = AUTHTYPE.
For this, the possible values are
MQAIT_CRL_LDAP or MQAIT_OCSP
For the above, corresponding MQSC Values are CRLLDAP and OCSP.
Is there any document which maps all the parameters and values of all the queue manager object in any document by IBM?
Thanks in advance
Last edited by mqtablet on Thu Apr 05, 2012 10:34 am; edited 1 time in total |
|
Back to top |
|
|
bruce2359 |
Posted: Thu Apr 05, 2012 9:56 am Post subject: |
|
|
Poobah
Joined: 05 Jan 2008 Posts: 9442 Location: US: west coast, almost. Otherwise, enroute.
|
WMQ Constants manual. _________________ I like deadlines. I like to wave as they pass by.
ב''ה
Lex Orandi, Lex Credendi, Lex Vivendi. As we Worship, So we Believe, So we Live. |
|
Back to top |
|
|
mqtablet |
Posted: Thu Apr 05, 2012 10:05 am Post subject: |
|
|
Acolyte
Joined: 09 Jun 2009 Posts: 71
|
Thanks Bruce for the response. However,
1. I've refered this document earlier. This gives information only on the PCF params and values, but not the corresponding MQSC params and values.
2. I've also searched the entire MQ 7 infocenter, but could not find a document which says
"this PCF parameter -> this is the corresponding MQSC parameter"
"this PCF value -> this is the corresponding MQSC value"
|
|
Back to top |
|
|
bruce2359 |
Posted: Thu Apr 05, 2012 10:12 am Post subject: |
|
|
Poobah
Joined: 05 Jan 2008 Posts: 9442 Location: US: west coast, almost. Otherwise, enroute.
|
And you found nothing useful in the WMQ Programmable Command Formats and Administration Interface manual? _________________ I like deadlines. I like to wave as they pass by.
ב''ה
Lex Orandi, Lex Credendi, Lex Vivendi. As we Worship, So we Believe, So we Live. |
|
Back to top |
|
|
mqtablet |
Posted: Thu Apr 05, 2012 10:24 am Post subject: |
|
|
Acolyte
Joined: 09 Jun 2009 Posts: 71
|
No, I did not find anything useful even there - only PCF params and values are described. Not MQSC params and values.
Why I'm looking for this kind of mapping document is, as you know there are some differences between the pcf and mqsc param/values. Lets take the one more example..
PCF Parameter : MQIA_INHIBIT_PUT
PCF Values : MQQA_PUT_ALLOWED, MQQA_PUT_INHIBITED
where as,
MQSC Parameter : PUT
MQSC Values : ENABLED, DISABLED
From the above pcf and mqsc params and values, its understood that these params/values they may be different.
At a basic level, we can understand and remember the commonly used parameters. But for very rarely used params, say Display Archive parameters, the MQSC params/values may be different from PCF params/values. How do we know what these values could be?
I refered the DISPLAY ARCHIVE command responses in infocenter, but no luck. So, basically I'm looking for any document which can give this information and the differences in it.
Thanks. |
|
Back to top |
|
|
mqjeff |
Posted: Thu Apr 05, 2012 11:18 am Post subject: |
|
|
Grand Master
Joined: 25 Jun 2008 Posts: 17447
|
There is a direct correlation between each MQSC command and a relevant PCF command.
This correlation is very poorly documented.
As the current and former maintainer of two supportPacs that make heavy use of this correlation (previously of MS03 and still of MS0S), I am well aware of how painful this poor documentation is.
You must sit with two copies of the InfoCenter open. One that is open to the relevant command under http://publib.boulder.ibm.com/infocenter/wmqv7/v7r1/topic/com.ibm.mq.doc/zr00150_.htm and one that is open to the same command under http://publib.boulder.ibm.com/infocenter/wmqv7/v7r1/topic/com.ibm.mq.doc/zr00120_.htm
And then you occasionally have to go back and forth to the Constants section to make sure you haven't missed something.
At least with an InfoCenter format, you can get a full link to the direct command you're interested in, rather than only being able to jump to the page that starts the discussion of the command, at the very bottom, with about two lines of text before it goes on to another page and you have to skip past that to the middle of the third following page to get to the start of the table you're interested in, which covers the next two and a half pages, with all of the useful stuff right at page margins. |
|
Back to top |
|
|
mqjeff |
Posted: Thu Apr 05, 2012 11:21 am Post subject: |
|
|
Grand Master
Joined: 25 Jun 2008 Posts: 17447
|
Oh, and. Don't forget to file Feedback or open a PMR when you discover that the MQSC manual describes different text values for parameters than RUNMQSC accepts. |
|
Back to top |
|
|
mqtablet |
Posted: Thu Apr 05, 2012 11:52 am Post subject: |
|
|
Acolyte
Joined: 09 Jun 2009 Posts: 71
|
I'm exactly doing the same, Jeff.. Really frustrated.. My left hand is fixed on the ALT + TAB keys of the key board. With more than 500 parameters and 850+ values, I can understand how much time and patience it takes to document it.
Planning to compile a java jar file to accomplish this, and share it with the MQ community, so that it would be helpful for someone, some time. |
|
Back to top |
|
|
mqjeff |
Posted: Thu Apr 05, 2012 12:41 pm Post subject: |
|
|
Grand Master
Joined: 25 Jun 2008 Posts: 17447
|
mqtablet wrote: |
Planning to compile a java jar file to accomplish this, and share it with the MQ community, so that it would be helpful for someone, some time. |
I have plans to add an interface to MS0S that will allow for the easy translation between MQSC and PCF.
The difficulty is that you need to construct a full blown model of all of the command. In theory, the PCF model already works. But then you need to associate the correct MQSC word with each object in the model, and the PCF command model doesn't hold that.
It's just messy.
Oh, and there's no good solid way to extract the necessary data automatically - either from the infocenter or from the runmqsc command output. You can ... mostly... extract the data from the runmqsc output, but there are several confusing edge cases.
And, of course, you can't get access to zOS commands if you only have runmqsc on a distributed platform... |
|
Back to top |
|
|
bruce2359 |
Posted: Thu Apr 05, 2012 12:45 pm Post subject: |
|
|
Poobah
Joined: 05 Jan 2008 Posts: 9442 Location: US: west coast, almost. Otherwise, enroute.
|
mqtablet wrote: |
No, I did not find anything useful...
PCF Parameter : MQIA_INHIBIT_PUT
PCF Values : MQQA_PUT_ALLOWED, MQQA_PUT_INHIBITED
where as,
MQSC Parameter : PUT
MQSC Values : ENABLED, DISABLED
|
These are not PCF-specific. Rather...
MQIA_ represents the name of object integer attributes; MQCA_ represents the name of object character attributes. You use these, for example, in MQINQ/MQSET MQI commands.
MQQA_ are queue attribute values returned from MQINQ or set by MQSET.
These (MQIA and MQCA) are documented in the WMQ Constants manual. MQINQ/MQSET are documented in the two relevant programming manuals. _________________ I like deadlines. I like to wave as they pass by.
ב''ה
Lex Orandi, Lex Credendi, Lex Vivendi. As we Worship, So we Believe, So we Live. |
|
Back to top |
|
|
mqtablet |
Posted: Thu Apr 05, 2012 12:49 pm Post subject: |
|
|
Acolyte
Joined: 09 Jun 2009 Posts: 71
|
mqjeff wrote: |
You can ... mostly... extract the data from the runmqsc output, but there are several confusing edge cases. |
|
|
Back to top |
|
|
mqtablet |
Posted: Thu Apr 05, 2012 12:57 pm Post subject: |
|
|
Acolyte
Joined: 09 Jun 2009 Posts: 71
|
Hi Bruce,
Jeff exactly understood what I'm asking.
I'm not asking what the MQCA_*, MQIA_*, MQIACF_* blah blah parameter types.
I just wanted to check if there is a single document which corelates PCF parameter attribute names and values with MQSC parameter attribute names and values, instead of refering multiple infocenter pages.
Thanks. |
|
Back to top |
|
|
bruce2359 |
Posted: Thu Apr 05, 2012 1:01 pm Post subject: |
|
|
Poobah
Joined: 05 Jan 2008 Posts: 9442 Location: US: west coast, almost. Otherwise, enroute.
|
mqtablet wrote: |
Hi Bruce,
Jeff exactly understood what I'm asking.
I'm not asking what the MQCA_*, MQIA_*, MQIACF_* blah blah parameter types.
I just wanted to check if there is a single document which corelates PCF parameter attribute names and values with MQSC parameter attribute names and values, instead of refering multiple infocenter pages.
Thanks. |
IMO, the manuals make this research much easier than InfoCenter pages. _________________ I like deadlines. I like to wave as they pass by.
ב''ה
Lex Orandi, Lex Credendi, Lex Vivendi. As we Worship, So we Believe, So we Live. |
|
Back to top |
|
|
mqjeff |
Posted: Thu Apr 05, 2012 2:07 pm Post subject: |
|
|
Grand Master
Joined: 25 Jun 2008 Posts: 17447
|
bruce2359 wrote: |
mqtablet wrote: |
Hi Bruce,
Jeff exactly understood what I'm asking.
I'm not asking what the MQCA_*, MQIA_*, MQIACF_* blah blah parameter types.
I just wanted to check if there is a single document which corelates PCF parameter attribute names and values with MQSC parameter attribute names and values, instead of refering multiple infocenter pages.
Thanks. |
IMO, the manuals make this research much easier than InfoCenter pages. |
I'm sorry, no, they don't. This page is much more confusing to read than this page.
and this section is much more informative than this one.
And the v7.1 Info center stuff has the relevant tasks about using MQSC nicely located with the rest of the stuff on administering the queue manager itself, rather than making you read a section of the system's administration guide (in one physical book) to find out you have to runmqsc and then a section of another guide (in another physical book) to find out what commands you have to use.
And more importantly, to the best of my knowledge there is NO documentation that has EVER shown the direct correlation between a given MQSC and PCF command that perform the same task. All of the MQ Documentation has always documented MQSC and PCF as separate interfaces. Even though they're really just different ways of sending messages to the command server! |
|
Back to top |
|
|
Michael Dag |
Posted: Fri Apr 06, 2012 1:09 am Post subject: |
|
|
Jedi Knight
Joined: 13 Jun 2002 Posts: 2602 Location: The Netherlands (Amsterdam)
|
Interesting discussion
mqjeff wrote: |
Even though they're really just different ways of sending messages to the command server! |
when using runmqsc locally the command server is not involved I was told once _________________ Michael
MQSystems Facebook page |
|
Back to top |
|
|
|