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: HVRL100 INTRODUCTORY TEXT PG 007 OF 026 *********************** * SUBSET HVRL100 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR OVERLAY GENERATION LANGUAGE (OGL)/370 BASE, VERSION 1, RELEASE 1, MODICATION 0 FOR MVS ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST CHANGED SECTION 1. 92/10/15 INSTALLATION INFORMATION 2. YY/MM/DD DOCUMENTATION CHANGES NO ENTRIES 3. 98/02/24 GENERAL INFORMATION 4. YY/MM/DD SERVICE RECOMMENDATIONS NO ENTRIES 5. 91/03/11 CROSS PRODUCT DEPENDENCIES UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 008 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. 3. 92/10/15 The last two paragraphs of section 6.4.2 of the Program Directory have incorrect information. The next to last paragraph reads: "For each of the coded fonts which has a name ending in TR (for instance X1BRTR, if the coded font name is XnyyTR, then the required character set will be call CnD0yyTR (for instance C1D0BRTR)." UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 009 OF 026 Where is says "CnD0yyTR" and C1D0BRTR" it should say "CnS0yyTR" and "C1S0BRTR". The last paragraph reads: "All the other required coded fonts have a name of the form XnGTzz (for instance X0GT10) and the required character set will be called CnS0GTzz (for instance C0S0GT10)." Where is says "CnS0GTzz" and C0S0GT10" it should say "CnD0GTzz" and "C0D0GT10". 2. 92/01/16 SECTION: 6.2 IT SHOULD BE NOTED, FOR STEP 5 'TRANSFER OWNERSHIP OF DFP MACRO SGDZI4OG TO OGL/370', THAT THIS MACRO IS NO LONGER SHIPPED AT HDP3300 OR HIGHER. CONSEQUENTLY, THE UCLIN IN 6.2.5 DOES NOT NEED TO BE RUN 1. 91/01/11 OGL PACKAGING PROBLEM. THERE ARE TWO EXTRA MEBMERS (S1PALM2 AND S1SIGNAT) ON FILE 4 OF OGL/370'S PRODUCT TAPE. THESE ARE PAGE SEGMENTS THAT WERE SHIPPED WITH THE PSF PRODUCT TAPE AND SHOULD ALREADY BE IN THE CUSTOMERS UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 010 OF 026 PAGE SEGMENT LIBRARY. THIS CAUSES NO ERRORS OR PROBLEMS DURING INSTALL. ************************************************************************ * 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 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. 11. 97/10/23 PQ07878 ADDS INCLUDE OBJECT SUPPORT AND PUTS FONT UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 011 OF 026 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: APAR LANGUAGE PTF PQ07942 English UQ09392 PQ07943 German UQ09393 PQ07944 Japanese UQ09426 MVS customers: PLEASE APPLY BASE PTF & PTFS FOR YOUR LANGUAGE FEATURES: MVS BASE-UQ09326 MVS ENGLISH-UQ09327 MVS GERMAN-UQ09328 MVS JAPANESE-UQ09329 UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 012 OF 026 10. 97/09/15 ITEM DELETED 98/02/24 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 request is ignored. 8. 97/04/15 The DZISAMP4 source file shipped with OGL sets the overlay UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 013 OF 026 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 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 UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 014 OF 026 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. 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 VM: Base UN93030 English UN93031 German UN93032 Japanese UN93033 UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 015 OF 026 VSE: Base PN86535 UN93034 English PN86623 UN93115 German PN86624 UN93116 Japanese PN86625 UN93117 5. 95/11/29 Msg "IEW2609W 5104 Section DZILPSFC Usability Attribute of Non-reusable Conflicts With Requested Usability of Refreshable" and RC04 is normal and expected when linkediting OGL with the Program Management Binder. With the old IEWL linkeditor however, you should not receive IEW warning messages and the link step should end with RC00. 4. 95/07/10 The following information concerns apar PN71601 which adds 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 UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 016 OF 026 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 PTF UN79148 Apar PN72642 is VSE Japanese PTF UN79149 UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 017 OF 026 3. 95/03/24 Apar PN69377 changes dashed 1 and 2 pel thick DRAWRULES. The image produced was indistinguishable as a dashed rule. With PN69377 each dash is a little longer and there is additional whitespace between each dash. DRAWRULES defined with the LIGHT subparm are 2 pel thick rules. 2. 92/07/16 SEE INFORMATIONAL APAR II06186 (ATTACHED) - OGL SHADING problem. 1. 91/10/02 WHEN RUNNING A SAMPLE OGL/370 JOB WITHOUT SPECIFYING LRECL AND BLOCKSIZE, MESSAGE DZI0320I IS RECEIVED ALONG WITH RC8. THE MESSAGE INDICATES AN LRECL AND BLOCKSIZE WERE NOT SPECIFIED, AND DEFAULT VALUES OF 8205 AND 8209 WILL BE USED. THE RETURN CODE OF RC8 IS ONLY A WARNING. THE RETURN CODES FOR OGL ARE DIFFERENT THAN SYSTEM RETURN CODES AND MAY BE CONFUSING TO THE USER. SEE APAR PL77971 (ATTACHED) FOR INFORMATION ON OGL/370 RETURN CODES. ************************************************************************ UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 018 OF 026 * 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 ************************************************************************ * 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. 91/03/11 INTERDEPENDENT PRODUCT: SMP/E PROBLEM DESCRIPTION: (IR91665) GIM38401 APPLY PROCESSING FAILED FOR HGL1200 AND HVRL100. HGL1200 DELETES OTHER SYSMODS BUT IS SUPERCEDED BY HVRL100. UPGRADE: OGL370 SUBSET: HVRL100 INTRODUCTORY TEXT PG 019 OF 026 USERS AFFECTED: THOSE APPLYING HVRL100 WITH SMPE 5.0 OR SMPE 5.1. RECOMMENDATION: INSTALL UR33827 ON VOLID 9103 (R500) INSTALL UR33828 ON VOLID 9103 (R502) ************************************************************************ * 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: HVRL100 APAR II06186 PG 020 OF 026 APAR NUMBER = II06186 LAST UPDATE = 98/03/02 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: HVRL100 APAR II06186 PG 021 OF 026 SUBPARAMETERS. ITEM 4. DOUBLE BYTE OUTLINE FONT INCORROUT ITEM 5. MSGDZI0998I insert code *** missing ************************************************************ 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 UPGRADE: OGL370 SUBSET: HVRL100 APAR II06186 PG 022 OF 026 01100000 01100000 01100000 01100000 00000000 00000000 00000000 00000000 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 UPGRADE: OGL370 SUBSET: HVRL100 APAR II06186 PG 023 OF 026 is placed relative to this origin. When POSITIONING TOPLEFT is the current SETUNITS value, the x & y 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. UPGRADE: OGL370 SUBSET: HVRL100 APAR II06186 PG 024 OF 026 3. Many of the OGL commands and subcommands are flexible in how they allow you to specify the subparameters. For example 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. 4. * DBCS OUTLINE INCORROUT * 1/12/98 PN80020 added support for Double Byte Outline Fonts. However, certain AFCCU printers have incorrect output when implementing their DBCS Outline fonts. If you use dble byte outline fonts and see that the dbcs text is misaligned please contact your hardware CE and request a microcode upgrade. As of 01/12/98, the following microcode versions correct the problem in the listed printers: PRINTER MODEL FIXED IN D/T3900 D01, D02, OW1, OW3, DW1, DW2 v8.521 & later D/T4000 DR1, DR2, IS1, IS2 v8.521 & later UPGRADE: OGL370 SUBSET: HVRL100 APAR II06186 PG 025 OF 026 Infoprint4000 IP4000 D/T4000 IS2 w/RPQ8B4018, ID1, ID2, IR1, v9.214 IR2, ID3, ID4 D/T3130 03, 02D v10.23.3 D/T3160 01 new DB version IP60 v6.02 IP62 02,03 InfoPrint62 D/T4370 v3.2.2 & later 4. * MSGDZI0998I * 03/02/98 This message may be issued if cust has applied a New Function Apar without its corresponding Language fix. Please note that VSE language apars will have a different apar number than the original NF apar. ************************************************************ TEMPORARY FIX: PROBLEM SUMMARY: PROBLEM CONCLUSION: PSPGEC MODULES/MACROS: SRLS: UPGRADE: OGL370 SUBSET: HVRL100 APAR II06186 PG 026 OF 026 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 el01/12/98 Add DBCS incorrout el03/02/98 Add DZI0998I APPLICABLE COMPONENT LEVEL/SU: