Quickgen Mastering the Possibilities - go2vanguard.com · • VSAM file used to save the templates –Some sample reports are provided. –Use QGVSAM JCL in the SAMPLIB to create

Quickgen

Mastering the Possibilities

Presented by

Vanguard Integrity Professionals

Copyright

©2013 Vanguard Integrity Professionals, Inc. All Rights Reserved. You

have a limited license to view these materials for your organization’s

internal purposes. Any unauthorized reproduction, distribution, exhibition

or use of these copyrighted materials is expressly prohibited.

Trademarks

IBM, RACF and z/OS are trademarks or registered trademarks of

International Business Machines Corporation in the United States, other

countries, or both. Vanguard Administrator, Vanguard Advisor, and

Vanguard Analyzer are trademarks of Vanguard Integrity Professionals –

Nevada.

Legal Notice

2

©2013 Vanguard Integrity Professionals, Inc. All Rights Reserved. You have a limited license to

view these materials for your organization’s internal purposes. Any unauthorized reproduction,

distribution, exhibition or use of these copyrighted materials is expressly prohibited.

QuickGen History

• Introduced in Release 4.3

• Designed for Command Generation

– Quick way to generate commands from the data in a

report.

• QuickGen Tag Language introduced in Release 5.3.

– Used for custom report formatting.



distribution, exhibition or use of these copyrighted materials is expressly prohibited. 3

How does it work?

• It’s magic!




How does it work?

• Works with Report Data

– Selection of data performed through normal application

interface.

• It’s just Symbolic Substitution

– Leading ‘&’ indicates a symbol.

– Uses field data from the rows of an application report

– System Symbols

• Date, Time, Page Number




Generating Commands

Let’s change the default group for all user IDs with an

Owner of VANGUARD

• Create a User Summary Report with masking:

– OWNER = VANGUARD

• Create the commands to connect the users and alter

their default group




Generating Commands (cont.)








Use FIELDS to Choose Variables




Select the Fields












Command Mode vs Report Mode

• Command Mode

– Default mode

– Field value is never truncated during data substitution

• Uses the actual length of the data.

– Fields won’t always start in the same column as defined in

the template

– TSO command syntax is used to wrap the data

– Commands may be executed




Command Mode vs. Report Mode (cont.)

• Report Mode

– Not the default mode

• <REPORT> tag needed to define a report

– Field value may be truncated during data substitution

• Uses the amount of space available

– Fields always start in the same column as defined in the

model

– A report line is never wrapped

• Field values will be truncated

– Reports may be printed or emailed




QuickGen Tag Language

• QuickGen Tag Language (QGTL)

– Same concept as DTL, HTML and XML

– It’s a simple mark up language

• Simple Syntax

– Tags must be first text on a line

– Not all tags have an ending tag

– Tags are not case sensitive




QGTL – What is a tag?

• Tags provide formatting instructions

• Basic format of a tag is…

– <tagName attr=xyz>info

• Some tags have an end tag that is required

– </tagName>

– Not all tags have an ending tag

• Tags do not show up in the generated output




QGTL – Getting Started

• <REPORT>

– Starts the definition of a report

– </report> End tag required

• <HEADER>

– Used to define the header for a report

– </header> End tag required

• <FOOTER>

– Used to define the footer for a report

– </footer> End tag required




A Simple Report

• We will use the same data as in the Command

creation example

• Start with just the report tag

• We will then add a header and footer




A Simple Report




A Simple Report (cont.)




Insert the Report Tags




Use FIELDS to Choose Variables




Use GEN to Generate the Output




A Simple Report (cont.)




A Simple Report with Header and Footer

• Now let’s add a header and a footer

– <header> The HEADER tag defines the header to be

generated in a report.

– <footer> The FOOTER tag defines the footer to be

generated in a report.




A Report with Header and Footer




A Report with Header and Footer (cont.)




EMAIL or Print the Report




QGTL – The other Tags

• <COMMAND> – Defines commands to be generated. Does not need to be specified if

that is all you are doing.

• <BREAKON> – When the specified field changes value a page break will occur.

– Must be nested in a HEADER tag.

• <INSERT> – Used to insert a saved template.

• <PAGE1> – Used with a header/footer tag to define a different header/footer for

page one.

– Must have a </PAGE1> ending tag.

• <COMMENT> – For placing comments in your template. Has no effect on the report

formatting.




How will I remember all of these tags?

• Help Panel

– Contains full description of all tags

– How to use tutorials

• TAGS command

– TAGS command is similar to the ISPF edit model

command

– Use to insert into tags into your template

– ISPF edit notes explain tag usage
















QGTL – How do I save these templates?

• QuickGen Templates can be saved

– Both Command templates and Report templates

• VSAM file used to save the templates

– Some sample reports are provided.

– Use QGVSAM JCL in the SAMPLIB to create and initialize

the VSAM file.

– Name of VSAM file specified in the QUICKGEN options

member in the VANOPTS dataset.




How do I save these templates? (cont.)












How do I use these templates?

• OPEN dialog provides a few choices

– Select a template to bring the template into the edit

session

– Delete a template

– Generate the report/commands using a template

– View the information about the template




How do I use these templates? (cont'd)












QGTL – Running in Batch

• Create the template online

• Save the template

• Use the <INSERT> tag for batch

– Option on the open panel in the batch dialog to easily

generate an <INSERT> tag.




QGTL – Running in Batch (cont.)




























QGTL – Tips and Tricks

• More than one <REPORT> and <COMMAND> can

be specified in a template.

– Reports will show up one at a time online.

– In batch, each report will go to a different QGRPTSnn DD

– In batch, all generated commands will go to the

VSSQGOUT DD.

• HILITE DTL

– The ISPF edit command “HILITE DTL” makes a template

easier to read.




Using HILITE DTL




QGTL – The Future

• Additional fields available for reporting

• Expanded availability of QG in the AAA products

– Vanguard AdministratorTM

– Vanguard AdvisorTM

– Vanguard AnalyzerTM

• Enhancements will be driven by our customers.




Questions




Documents

Quickgen Mastering the Possibilities - go2vanguard.com · • VSAM file used to save the templates –Some sample reports are provided. –Use QGVSAM JCL in the SAMPLIB to create