UPGRADE: OGL370 INTRODUCTORY TEXT PG 001 OF 027 ************************ * 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 027 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 027 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 027 UPGRADE: OGL370 ADDITIONAL TEXT PG 005 OF 027 UPGRADE: OGL370 ADDITIONAL TEXT PG 006 OF 027 UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 007 OF 027 *********************** * SUBSET VM/106 * *********************** THIS SUBSET CONTAINS INSTALLATION INFORMATION FOR OVERLAY GENERATION LANGUAGE (OGL)/370 BASE, VERSION 1, RELEASE 1, MODICATION 0 FOR VM ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ DATE LAST CHANGED SECTION 1. 91/07/26 INSTALLATION INFORMATION 2. 92/03/17 DOCUMENTATION CHANGES 3. 98/02/24 GENERAL INFORMATION 4. YY/MM/DD SERVICE RECOMMENDATIONS NO ENTRIES 5. YY/MM/DD CROSS PRODUCT DEPENDENCIES NO ENTRIES UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 008 OF 027 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. 91/07/26 SECTION: 6.2.2 THE INSTALLATION EXEC I5688191 DOES NOT ALLOW FOR 3390 DASD TO BE USED FOR TDISK. TO CIRCUMVENT MODIFY I5688191 EXEC AT LINE 281, AS FOLLOWS: DISKTYPES = 'T3390 T3330 T3350 T3380 T3375 T3340 TFB-512'; DISKSPACE = ' 5 10 5 5 5 10 14000'; UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 009 OF 027 ************************************************************************ * 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. 92/03/17 Msgdzi0337i received when printing from OGL/VM exec. Message occurs whether using the OGL/VM exec or just issuing the overlay command on the command line and requesting the print option. See DOC apar PL85507 attached. ************************************************************************ * 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. UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 010 OF 027 8. 97/10/23 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: APAR LANGUAGE PTF PQ07942 English UQ09392 PQ07943 German UQ09393 PQ07944 Japanese UQ09426 VM customers: Please apply base PTF & PTFs for your language features: VM Base-UQ09330 VM ENGLISH-UQ09331 VM GERMAN-UQ09332 UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 011 OF 027 VM JAPANESE-UQ09334 7. 97/09/15 ITEM DELETED 02/24/98 6. 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. UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 012 OF 027 5. 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 bounds of the logical page. UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 013 OF 027 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. 4. 97/04/15 OGL does not support ASCII codepages. 3. 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 UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 014 OF 027 German UN93032 Japanese UN93033 VSE: Base PN86535 UN93034 English PN86623 UN93115 German PN86624 UN93116 Japanese PN86625 UN93117 2. 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 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 UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 015 OF 027 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 1. YY/MM/DD NO ENTRIES ************************************************************************ * SECTION 4. S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 016 OF 027 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. YY/MM/DD INTERDEPENDENT PRODUCT: PROBLEM: USERS AFFECTED: RECOMMENDATION: INSTALL XXXXXXX ON VOLID XXXX UPGRADE: OGL370 SUBSET: VM/106 INTRODUCTORY TEXT PG 017 OF 027 ************************************************************************ * 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: VM/106 APAR PL85507 PG 018 OF 027 APAR NUMBER = PL85507 LAST UPDATE = 91/07/12 PTF IN ERROR = PIN = YES CURRENT APAR STATUS = CLOSED CLOSING CODE = DOC ORIGINAL APAR NUMBER = SECURITY/INTEGRITY = NO SERVICE NUMBER = 0X60888 REPORTED COMPONENT = 568819101 R106 OGL/370 FIXED COMPONENT = FAILING MODULE = PROBLEM ABSTRACT: MSGDZI0337I RECEIVED WHEN PRINTING FROM OGLVM EXEC REPORTED SCP RELEASE: 106 ERROR DESCRIPTION: MSGDZI0337I RECEIVED WHEN PRINTING AN OVERLAY USING THE OGLVM EXEC. TEMPORARY FIX: PROBLEM SUMMARY: **************************************************************** * USERS AFFECTED: ALL OGL/370 USER'S RUNNING IN THE VM * UPGRADE: OGL370 SUBSET: VM/106 APAR PL85507 PG 019 OF 027 * ENVIRONMENT. OCCURS WHETHER USING THE OGLVM * * EXEC OR JUST ISSUING THE OVERLAY COMMAND ON * * THE COMMAND LINE AND REQUESTING THE PRINT * * OPTION. * **************************************************************** WHEN AN OVERLAY IS COMPILED AND THE PRINT OPTION IS USED (INSTEAD OF FILE), USER GETS MESSAGE DZI0337I INDICATING THAT PSF IS NOT AVAILABLE AND THE SAMPLE OVERLAY HAS BEEN STORED ON THE USER'S A-DISK. THE SAMPLE OVERLAY CAN THEN BE PRINTED VIA PSF. PROBLEM CONCLUSION: IN ORDER TO PRINT THE SAMPLE FILE DIRECTLY (RATHER THAN PRINTING IT FROM A FILE), THE USER MUST HAVE ACCESS TO THE PSFCMD LOADLIB. THIS LOADLIB IS PART OF PSF/VM AND PSF'S INSTALLATION ALLOWS THE PSFCMD LOADLIB TO BE STORED WHEREVER THE SYSTEM PROGRAMMER CHOOSES. OGL/370 USER'S GUIDE AND REFERENCE (S5443702) WILL BE MODIFIED WHEN NEXT UPDATED TO REFLECT THE NEED FOR USER'S ACCESS TO THE UPGRADE: OGL370 SUBSET: VM/106 APAR PL85507 PG 020 OF 027 PSFCMD LOADLIB IN ORDER TO PRINT THE SAMPLE OVERLAY IMMEDIATELY AS PART OF THE COMPILE. THIS WILL BE INCLUDED IN APPENDIX C, (TOPIC) IN THE VM ENVIRONMENT. IT WILL BE ADDED AS A NOTE IN THE FILE/PRINT BULLETED ITEM (PAGE 422). MODULES/MACROS: SRLS: S544370200 CIRCUMVENTION: APPLICABLE COMPONENT LEVEL/SU: UPGRADE: OGL370 SUBSET: VM/106 APAR II06186 PG 021 OF 027 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: VM/106 APAR II06186 PG 022 OF 027 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: VM/106 APAR II06186 PG 023 OF 027 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: VM/106 APAR II06186 PG 024 OF 027 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: VM/106 APAR II06186 PG 025 OF 027 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: VM/106 APAR II06186 PG 026 OF 027 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: VM/106 APAR II06186 PG 027 OF 027 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: