CICS VSAM Transparency for a low risk VSAM to DB2 migration strategy
Quickgen Mastering the Possibilities - go2vanguard.com · • VSAM file used to save the templates...
Transcript of Quickgen Mastering the Possibilities - go2vanguard.com · • VSAM file used to save the templates...
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.
©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. 3
How does it work?
• It’s magic!
©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. 4
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
©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. 5
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
©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. 6
Generating Commands (cont.)
©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. 7
Generating Commands (cont.)
©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. 8
Use FIELDS to Choose Variables
©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. 9
Select the Fields
©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. 10
Generating Commands (cont.)
©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. 11
Generating Commands (cont.)
©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. 12
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
©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. 13
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
©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. 14
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
©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. 15
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
©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. 16
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
©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. 17
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
©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. 18
A Simple Report
©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. 19
A Simple Report (cont.)
©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. 20
Insert the Report Tags
©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. 21
Use FIELDS to Choose Variables
©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. 22
Use GEN to Generate the Output
©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. 23
A Simple Report (cont.)
©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. 24
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.
©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. 25
A Report with Header and Footer
©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. 26
A Report with Header and Footer (cont.)
©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. 27
EMAIL or Print the Report
©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. 28
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.
©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. 29
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
©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. 30
How will I remember all of these tags?
©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. 31
How will I remember all of these tags?
©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. 32
How will I remember all of these tags?
©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. 33
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.
©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. 34
How do I save these templates? (cont.)
©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. 35
How do I save these templates? (cont.)
©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. 36
How do I save these templates? (cont.)
©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. 37
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
©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. 38
How do I use these templates? (cont'd)
©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. 39
How do I use these templates? (cont'd)
©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. 40
How do I use these templates? (cont'd)
©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. 41
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.
©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. 42
QGTL – Running in Batch (cont.)
©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. 43
QGTL – Running in Batch (cont.)
©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. 44
QGTL – Running in Batch (cont.)
©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. 45
QGTL – Running in Batch (cont.)
©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. 46
QGTL – Running in Batch (cont.)
©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. 47
QGTL – Running in Batch (cont.)
©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. 48
QGTL – Running in Batch (cont.)
©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. 49
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.
©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. 50
Using HILITE DTL
©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. 51
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.
©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. 52