UPGRADE: OGL370 INTRODUCTORY TEXT PG 001 OF 026 ************************ * UPGRADE OGL370 * ************************ THIS UPGRADE CONTAINS INSTALLATION INFORMATION AND/OR HIGH IMPACT/PERVASIVE APAR INFORMATION FOR VERSION 1, RELEASE 1, MODIFICATION 0 FOR OVERLAY GENERATION LANGUAGE (OGL) ************************************************************************ * P R O D U C T I N D E X * ************************************************************************ PID NUMBER SYSTEM DESCRIPTION SUBSET ID 5688191 MVS OGL/370 BASE MVS HVRL100 5688191 VSE OGL/370 BASE VSE A05 5688191 VM OGL/370 BASE VM VM/106 UPGRADE: OGL370 ADDITIONAL TEXT PG 002 OF 026 HIGH IMPACT/PERVASIVE (HIPER) APAR INSTRUCTIONS Included in this Upgrade may be one or more APARs that describe problems that are of a High Impact or extremely pervasive nature. The following fields provide an outline of those APARs in section 4: "PROBLEM:" Brief description of the APAR "USERS AFFECTED:" If you have this Product/device/situation, you are exposed to the problem. The APAR or PTF fix should be applied in those cases. "RECOMMENDATION:" Take action that is described, most often that will be the application of an APAR or PTF fix. VOLID'S VOLID 1000 - Reflects corrective service (not on a PUT tape) UPGRADE: OGL370 ADDITIONAL TEXT PG 003 OF 026 VOLID 9XXX - Reflects a PUT tape that the PTF can be located on. VOLID FXXX - Reflects a PUT tape. The 'F' represents a '9' and the XXX represents a PUT number. ******* ATTENTION: MVS SMP/E USERS (CBPDO NO CHARGE OFFERING): ***** Customers ordering the Custom Built Product Delivery Offering (CBPDO) also receive PSP information in softcopy. In addition, CBPDO "VOLIDs" will appear in the PSP subset sections 3, 4 and 5. A VOLID of "1YWW", where Y is the year and WW is the week within that year, indicates that the PTF was included on that CBPDO and successive CBPDOs. Customers wishing more information should contact their IBM Marketing Branch Office. UPGRADE: OGL370 ADDITIONAL TEXT PG 004 OF 026 UPGRADE: OGL370 ADDITIONAL TEXT PG 005 OF 026 UPGRADE: OGL370 ADDITIONAL TEXT PG 006 OF 026 UPGRADE: OGL370 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 007 OF 026 ******************** * SUBSET CHG/INDEX * ******************** THE PURPOSE OF THIS SUBSET IS TO TRACK ALTERATIONS TO THE VARIOUS ELEMENTS OF THIS UPGRADE. *********************************************************************** * C H A N G E I N D E X * *********************************************************************** DATE SUBSET ALTERED COMMENTS 21. 97/09/15 A05 SECTION 3, ADDED ITEM 10 HVRL100 SECTION 3, ADDED ITEM 10 VM/106 SECTION 3, ADDED ITEM 7 20. 97/07/08 A05 SECTION 3, ADDED ITEM 9 HVRL100 SECTION 3, ADDED ITEM 9 VM/106 SECTION 3, ADDED ITEM 6 UPGRADE: OGL370 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 008 OF 026 19. 97/04/15 A05 SECTION 3, ADDED ITEMS 7-8 HVRL100 SECTION 3, ADDED ITEMS 7-8 VM/106 SECTION 3, ADDED ITEMS 4-5 18. 96/07/29 A05 SECTION 3, ADDED ITEM 5 HVRL100 SECTION 3, ADDED ITEM 6 VM/106 SECTION 3, ADDED ITEM 3 17. 96/01/18 A05 SECTION 3, ADDED ITEM 4 16. 95/11/29 HVRL100 SECTION 3, ADDED ITEM 5 15. 95/07/10 HVRL100 SECTION 3, ADDED ITEM 4 A05 SECTION 3, ADDED ITEM 3 VM/106 SECTION 3, ADDED ITEM 2 14. 95/03/24 HVRL100 SECTION 3, ADDED ITEM 3 13. 95/02/14 A05 SECTION 3, ADDED ITEM 2 12. 92/10/15 HVRL100 SECTION 1, ADDED ITEM 3 11. 92/07/30 A05 SECTION 3, ADDED ITEM 1 10. 92/07/16 HVRL100 SECTION 3, ADDED ITEM 2 VM/106 SECTION 3, ADDED ITEM 1 9. 92/03/17 VM/106 SECTION 2, ADDED ITEM 1 8. 92/01/16 HVRL100 SECTION 1, ADDED ITEM 2 UPGRADE: OGL370 SUBSET: CHG/INDEX INTRODUCTORY TEXT PG 009 OF 026 7. 91/10/02 HVRL100 SECTION 3, ADDED ITEM 1 6. 91/07/26 VM/106 SECTION 1, ADDED ITEM 1 5. 91/05/09 HVRL100 SECTION 5, UPDATED ITEM 1 4. 91/05/08 HVRL100 SECTION 5, UPDATED ITEM 1 3. 91/03/11 HVRL100 SECTION 5, ADDED ITEM 1 2. 91/01/11 HVRL100 SECTION 1, ADDED ITEM 1 1. 90/10/17 UPGRADE/SUBSETS CREATED - SMRG UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 010 OF 026 *********************** * SUBSET A05 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR OVERLAY GENERATION LANGUAGE (OGL)/370 BASE, VERSION 1, RELEASE 1, MODICATION 0 FOR VSE ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST CHANGED SECTION 1. YY/MM/DD INSTALLATION INFORMATION NO ENTRIES 2. YY/MM/DD DOCUMENTATION CHANGES NO ENTRIES 3. 97/09/15 GENERAL INFORMATION 4. YY/MM/DD SERVICE RECOMMENDATIONS NO ENTRIES 5. YY/MM/DD CROSS PRODUCT DEPENDENCIES NO ENTRIES UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 011 OF 026 SERVICE RECOMMENDATION SUMMARY DATE APAR PTF VOLID COMMENTS 1. YY/MM/DD XXXXXXX XXXXXXX XXXX X ************************************************************************ * SECTION 1. I N S T A L L A T I O N I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS CHANGES TO THE PRODUCT'S PROGRAM DIRECTORY. 1. YY/MM/DD NO ENTRIES ************************************************************************ * SECTION 2. D O C U M E N T A T I O N C H A N G E S * ************************************************************************ THIS SECTION OUTLINES MAJOR ERRORS IN THE PRODUCT'S PUBLISHED UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 012 OF 026 DOCUMENTATION. 1. YY/MM/DD NO ENTRIES ************************************************************************ * SECTION 3. G E N E R A L I N F O R M A T I O N * ************************************************************************ THIS SECTION CONTAINS GENERAL INFORMATION, I.E. SYSGEN HINTS/TIPS. 10. 97/09/15 PQ07878 adds include object support and puts font resolution information into the output file. The font resolution information is specifically for PSF/MVS APAR OW27622. Your AFP presentation system will ignore this information if it cannot process it. AFP Workbench supports include object but requires CSD level 2.13A if you want to view .TIF files. VSE customers: please be sure to apply the PTF for the language feature(s) you have installed: UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 013 OF 026 APAR LANGUAGE PTF PQ07942 English UQ09392 PQ07943 German UQ09393 PQ07944 Japanese UQ09426 9. 97/07/08 PQ03978 adds support for the color spaces documented in the MODCA Reference. The Reference containing the color definitions is due to be published Summer, 1997. For color and shading for the rectangular area inside a DRAWBOX box with square corners, the color is requested via the 4E triplet on the OBD record in an empty IOCA object. For colored text and solid rules, a Set Extended Text Color text control is put in the PTX record. For dashed and dotted rules generated by DRAWBOX, DRAWBOX, DRAWMASK and the pattern generated by DEFINE/PLACE PATTERN requesting OCA color, the OCA color value is put into the IID record in the IM1 image which is generated to render the dashed/dotted rules or pattern. If the requested color is not an OCA color, a message is issued and the color UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 014 OF 026 request is ignored. 8. 97/04/15 The DZISAMP4 source file shipped with OGL sets the overlay size to 7.75 inches by 10.75 inches with .5 inch offsets in both directions. OGL adds the offset to the user-specified overlay size and puts the resultant values in the PGD (Page Descriptor) record. For DZISAMP4, the PGD page size x value is 8.25 inches and the y value is 11.25 inches. This presents a problem for the 3800-3 printer if the printer is set up for an 8.5 inch by 11 inch page size using 8.5 by 12 inch paper because of the .5 inch unprintable area on either side of the perf--there are really only 11 inches available vertically but the PGD vertical page size is 11.25 inches. The printer detects the PGD size exceeds the paper size loaded and issues a sense code that results in the APS743I message from PSF/MVS. This is not a problem for the cut sheet or newer fanfold printers because they do not complain unless you try to actually print outside the UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 015 OF 026 bounds of the logical page. If you have a problem printing the DZISAMP4 sample output to a 3800-3, either load bigger paper to handle the OGL 8.25x11.25 inch page size or modify the DZISAMP4 source file to remove the .5 inch offsets on the OVERLAY statement before you run the DZISAMP4 job. 7. 97/04/15 OGL does not support ASCII codepages. 6. 97/01/30 Please refer to info apar II06186 (attached). 5. 96/07/29 PN86535 is the OGL YR2000 support. After you apply the PTF for your base product, please be sure to apply the appropriate language PTFs. MVS: Base UN93026 English UN93027 German UN93028 Japanese UN93029 UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 016 OF 026 VM: Base UN93030 English UN93031 German UN93032 Japanese UN93033 VSE: Base PN86535 UN93034 English PN86623 UN93115 German PN86624 UN93116 Japanese PN86625 UN93117 4. 96/01/18 ********************* Message MSGDZI0998i with insert codes 723, 721 and 722 can be received if the following apars are not applied: PN72640/UN78841 English PN72641/UN79148 German PN72642/UN79149 Japanese 3. 95/07/10 The following information concerns apar PN71601 which adds UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 017 OF 026 AFP outline and 300 pel font support: 1. when AFP outline or 300 pel technology fonts are mixed in the same overlay with a FONT38PP or DBCS raster font, OGL produces the 8E triplet in the MCF/2 repeating group for the FONT38PP and DBCS fonts. The 8E triplet requires PSF/MVS 2.2.0. PTFs for OGL outline/300 pel font support apar PN71601: UN78383 MVS Base UN78384 MVS English UN78385 MVS German UN78386 MVS Japanese UN78387 VM Base UN78388 VM English UN78389 VM German UN78390 VM Japanese UN78393 VSE Base Apar PN72640 is VSE English PTF UN78841 Apar PN72641 is VSE German UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 018 OF 026 PTF UN79148 Apar PN72642 is VSE Japanese PTF UN79149 2. 95/02/14 On VSE/ESA 1.3 systems, OGL/370 (PPFA/370) will not come up. You must apply PN67619 (PN66697) to keep this programs from abending with addressing exceptions RC0005 1. 92/07/30 See informational apar II06186 (attached) - OGL shading problem. ************************************************************************ * SECTION 4. S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ 1. YY/MM/DD PROBLEM: USERS AFFECTED: RECOMMENDATION: INSTALL XXXXXXX ON VOLID XXXX UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 019 OF 026 ************************************************************************ * SECTION 5. C R O S S P R O D U C T D E P E N D E N C I E S * ************************************************************************ THIS SECTION CONTAINS INFORMATION THAT IS DEPENDENT UPON ANOTHER PRODUCT OTHER THAN THIS SUBSET ID. 1. YY/MM/DD INTERDEPENDENT PRODUCT: PROBLEM: USERS AFFECTED: RECOMMENDATION: INSTALL XXXXXXX ON VOLID XXXX UPGRADE: OGL370 SUBSET: A05 INTRODUCTORY TEXT PG 020 OF 026 ************************************************************************ * I N F O R M A T I O N A L / D O C U M E N T A T I O N * * APARS FOLLOW (IF ANY) * ************************************************************************ UPGRADE: OGL370 SUBSET: A05 APAR II06186 PG 021 OF 026 APAR NUMBER = II06186 LAST UPDATE = 97/01/30 PTF IN ERROR = PIN = YES CURRENT APAR STATUS = CLOSED CLOSING CODE = CAN ORIGINAL APAR NUMBER = SECURITY/INTEGRITY = NO SERVICE NUMBER = 5NFO000 000 REPORTED COMPONENT = INFOPALIB R001 PA LIB INFO ITE FIXED COMPONENT = FAILING MODULE = PROBLEM ABSTRACT: OGL/370 COMMON PROBLEM APAR REPORTED SCP RELEASE: 000 ERROR DESCRIPTION: OGL370 COMMON PROBLEM APAR 568819101 ********************** I N D E X *************************** ITEM 1: OGL370 SHADING ITEM 2: POSITIONING CENTER ITEM 3: OGL COMMANDS AND SUBCOMMANDS ARE FLEXIBLE IN HOW THEY ALLOW THE SPECIFICATION OF THE UPGRADE: OGL370 SUBSET: A05 APAR II06186 PG 022 OF 026 SUBPARAMETERS. ************************************************************ 1. * OGL SHADING * OGL/370 creates shading by defining an 8 pel x 32 pel box; within this box it will place a shading pattern based on a number from 0 to 32, etc...). OGL tells the printer to repeat this 8x32 pattern over and over for the figure it is drawing. In the case of low numbers or light shading, it will place only 3 or 4 pels per each 8-pel square. OGL370 fills in more pels for higher numbers and darker shading. For example, a "2" shading pattern will look like this: 00000000 00000000 00000000 00000000 00000110 00000110 00000110 00000110 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 01100000 01100000 01100000 01100000 00000000 00000000 00000000 00000000 UPGRADE: OGL370 SUBSET: A05 APAR II06186 PG 023 OF 026 00000000 00000000 00000000 00000000 (where "1" is "on" or visible and "0" is "off" or not visible) The other thing to be aware of is that a figure (DRAWBOX, etc.) and shading are both positioned from the overlay origin. This may not position the shading or figure at an even multiple of 8 pels, so there can potentially be a situation where a figure or shading may be originating in the middle of the 8-pel x 32-pel rectangle. If, for example, a figure begins with row 3 of the above square, you can see that the pels in row 2 would not be printed. This problem occurs only when low numbers or very light shading is used. What we recommend is that if possible all figures to be shaded be positioned on an 8-pel boundary. 2. * POSITIONING CENTER clarification * When you draw a box, OGL/370 establishes the top-left origin of the inside of the box. Text inside the box is placed relative to this origin. When POSITIONING TOPLEFT is the current SETUNITS value, the x & y UPGRADE: OGL370 SUBSET: A05 APAR II06186 PG 024 OF 026 values for this origin is established as follows: x origin = current x position + box rule weight y origin = current y position + box rule weight When POSITIONING CENTER is the current SETUNITS value, the x and y values for the top-left origin are established as follows, regardless of the weight of the box rules: x origin = ((current x position-(box rule weight/2))+1) +box rule weight y origin = ((current y position-(box rule weight/2))+1) +box rule weight This means if you specify POSITIONING TOPLEFT and place a box with text and zero weight box rules on the page, then switch to POSITIONING CENTER and place a second box with text and zero weight box rules on top of the first box, the origin for the text in the second box will be 1 pel down and 1 pel over from the text in the first box. 3. Many of the OGL commands and subcommands are flexible in how they allow you to specify the subparameters. For example UPGRADE: OGL370 SUBSET: A05 APAR II06186 PG 025 OF 026 on the CONTROL command, the valid subparameter keywords maybe specified in any order. If you use third party software that parses OGL source files and relies on a certain order of commands, subcommands and/or subparameters, you should construct your source files using the order suggested by the syntax diagrams. ************************************************************ TEMPORARY FIX: PROBLEM SUMMARY: PROBLEM CONCLUSION: PSPGEC MODULES/MACROS: SRLS: CIRCUMVENTION: rp07/16/92 added error descrition to summary page rp07/17/92 added bucket keyword rp07/02/96 added positioning center words rp01/30/97 Add OGL commands positioning APPLICABLE COMPONENT LEVEL/SU: UPGRADE: OGL370 SUBSET: A05 APAR II06186 PG 026 OF 026