RE: Using UIM for help text even easier with V5R3 -- MIDRANGE-L

db

I need to clarify, and I think I may have misled y'all. This is only for help text in a PNLGRP that is associated with a given command. Look for the HLPPNLGRP parameter on CRTCMD.

GENCMDDOC does use an existing help PNLGRP when you want to generate *HTML, but when you want *UIM, it seems only to generate a skeleton. Maybe that is on purpose, to prevent reverse-engineering, as I'd like to do. But I'm going to look further.

There is also an API that's been around since at least V5R1, QUHRHLPT (retrieve help text) that works right off of the *PNLGRP or *MENU (UIM type). It generates an XML file of the help. Not as useful as I'd like in reverse-engineering.

I apologize for raising hopes too high.

Vern

At 06:57 AM 9/24/2004, you wrote:

> If there is a PNLGRP, the command will generate the UIM
> source for it.

Just to clarify (cuz this is what I was asking [pining?] for in a prior
related post):  The GENCMDDOC "retrieves the source" from *PNLGRP objects?
Even IBM's?  Can someone on v5r3 do this for *PNLGRP object QGSPWRKF in
QSYS?  (This is, I think, the WRKSPLF display.)  Oh, and whatever the
*PNLGRP object is used by WRKMBRPDM?

'twould be nice to see the hidden goodies.

db

> -----Original Message-----
> From: midrange-l-bounces@xxxxxxxxxxxx / Vern Hamberg
> Sent: Thursday, September 23, 2004 10:26 PM
>
> James Lampert mentioned how easy it is to write help text with UIM. V5R3
> has made it even better, with the GENCMDDOC command. This command is used
> to generate either HTML or UIM source based on a retrieved command
> description (QDCRCMDD command does not have a help PNLGRP attached, you
> will get a skeleton based on the parameters, etc., with places to
> put your
> text. If there is a PNLGRP, the command will generate the UIM
> source for it.
>
> There are a couple nice things - the source is not version-dependent. So,
> if you are like us, who develop on V5R1, you could bring your
> commands to a
> V5R3 machine, run the command, then bring the source back to the
> V5R1 machine.
>
> You can also reverse-engineer IBM's help text with this. This could give
> you ideas on how to do some of the neat things we see.
>
> Then, once you have created the PNLGRP, run the command again to
> get HTML,
> if you want. No more syntax diagrams (BOO! HOO!), but a nice parameter
> table with links to the individual parameter help.
>
> Guy Vig, of IBM, had webcasts in the last 2 weeks on both the new CL flow
> control stuff, etc., and the command documentation thing. Go to
> www.search400.com and look for webcast archives. He's also going to be at
> Toronto COMMON.
>
> Vern

--
This is the Midrange Systems Technical Discussion (MIDRANGE-L) mailing list
To post a message email: MIDRANGE-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: http://lists.midrange.com/mailman/listinfo/midrange-l
or email: MIDRANGE-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at http://archive.midrange.com/midrange-l.