Software Release Notice for VS/IIS - Document Access Subroutines Version 2.02.00 October, 1999 Copyright Wang Global, 1999 (001197) _______________________________________________________________________________ Page 1 VS/IIS - Document Access Subroutines 2.02.00 DISCLAIMER OF WARRANTIES AND LIMITATION OF LIABILITIES The staff of Wang Global, has taken due care in preparing this manual; however, nothing contained herein modifies or alters in any way the standard terms and conditions of the Wang purchase, lease, or license agreement by which this software package was acquired, nor shall Wang Global, or its subsidiaries be liable for incidental or consequential damages in connection with or arising from the use of the software package, the accompanying manual, or any related manuals. NOTICE All Wang Program Products are licensed to customers in accordance with the terms and conditions of the Wang Global, Standard Program Products License; no ownership of Wang Software is transferred and any use beyond the terms of the aforesaid License, without the written authorization of Wang Global, is prohibited. _______________________________________________________________________________ Page 2 VS/IIS - Document Access Subroutines 2.02.00 TABLE OF CONTENTS SECTION PAGE 1.0 Release Abstract. . . . . . . . . . . . . . . . . . . 4 2.0 Prerequisites . . . . . . . . . . . . . . . . . . . . 4 3.0 Restrictions & Special Considerations . . . . . . . 4 4.0 Enhancements . . . . . . . . . . . . . . . . . . . . 4 5.0 Problems Corrected . . . . . . . . . . . . . . . . . 5,6 6.0 Known Anomalies . . . . . . . . . . . . . . . . . . . 6 7.0 Media Contents . . . . . . . . . . . . . . . . . . . 7 8.0 Software Installation & Operation Information . . . . 8 9.0 References . . . . . . . . . . . . . . . . . 8 _______________________________________________________________________________ VS/IIS - Document Access Subroutines 2.02.00 Page 3 1.0 Release Abstract VS WP Document Access Subroutines provide a data processing interface to VS word processing documents. The subroutines allow the Assembler, BASIC, COBOL, or PL/I programmer to create, read, modify, print, and search a VS word processing document under program control. 2.0 Pre-requisites 1) Operating System 7.40.00 or greater. 2) VS/IIS (VS WP) version 5.0 or greater. 3) VS/IIS Peripheral Package version 7.32 or greater. 3.0 Restrictions & Special Considerations BASIC programs that use the Document Access Subroutines should be compiled with compiler versions lower than 3.4.3, or 3.5.0 and above. Otherwise, the running program may terminate with a Data Exception Error. The current release of the Document Access Subroutines can now utilize three digit printer numbers. If a document with the extra digit specified is edited by releases of Word Processing earlier than this release, or if installed with "Allow Modified Document Admin" set to NO, the digit will be lost. G100014247/ M800006628 Due attention must be paid by programmers to the possible return codes that may be received from the Document Access Subroutines. Anomalous results may follow inaccurate handling of some responses. M800021291 An attempt to update the next document id. from 9999 is handled as if the prototype document were damaged or missing. 4.0 Enhancements 4.0.1 Enhancements since Release 2.01.0E New Printer Forms Support In addition to Continuous, Standard, Form 1 and Form 2, Form 3 has been added to the programmer's interface to be consistent with the WP Print Menu selections. 4.0.2 Enhancements since Release 2.01.11 The Document Access Subroutines now look for the third printer digit; if the feature has been defined during the VS/IIS WP release 5.0 installation process. WPPRINT supports printer numbers up to 255. _______________________________________________________________________________ Page 4 VS/IIS - Document Access Subroutines 2.02.00 5.0 Problems Corrected 5.0.1 Problems Corrected since Release 2.01.0F Release 2.01.0F was created from release 2.01.0D and, therefore, did not include the following fixes: G200021430/ M200019569/ M410011615 PUTPRINT routine no longer corrupts the DFB-MARGIN-1 field. G400007965 WPDELETE routine positions its document pointers correctly after deleting a whole page and no longer fails deleting page 1 of a two page document. G500010575 WPPRINT routine correctly handles the DFB-THRU-PAGE parameter on dual-column documents. 5.0.2 Problems Corrected since Release 2.01.11 G200021430/ M200019569/ M410011615 PUTPRINT routine no longer corrupts the DFB-MARGIN-1 field. G400007965 WPDELETE routine positions its document pointers correctly after deleting a whole page and no longer fails deleting page 1 of a two page document. G500010575 WPPRINT routine correctly handles the DFB-THRU-PAGE parameter on dual-column documents. 5.0.3 Problems Corrected since Release 2.01.10: Error code 3024 was returned when WPPRINT was called to print a document. 5.0.4 Problems Corrected since Release 2.01.09: G400008029 When all the text on a sector was deleted and a write was issued, if the previous sector was full, the text was inserted in the wrong place. WPOPEN failed with return code 3015 the next time an attempt was made to open the document. _______________________________________________________________________________ VS/IIS - Document Access Subroutines 2.02.00 Page 5 5.0.5 Problems Corrected since Release 2.01.08: WPPRINT correctly specifies the volume name for dual column and secondary merge documents when the volume name is less than six characters in length. M100015915 Documents stayed in the print queue when WPPRINT was used to print documents on a system running C2 Operating System M100017588 WPPRINT submitted entries to the print queue in the user's default print class instead of class 'Z' when running on C2 Operating System. M100017608 WPPRINT was not queuing.requests to non-integrated print queue on OS 7.40 pre-release system. M200011666 When a document being written to has reached its extent limit, the document is now automatically reorganized back to 1 extent, if the volume it is on is not fragmented. M200019159 WPOPEN routine is now returning valid hexadecimal data in the DFB-FORM-NUMBER field and therefore WPPRINT is no longer getting a PC07 error. 6.0 Known Anomalies Internal WPSEARCH: It is not documented that the maximum search string length is 255 characters. Strings of 256 or greater will always have a return code of 5 - text not found. M800020245 WPSEARCH: Style underscore is significant on a STOP graphic, as it is considered a formatting character. _______________________________________________________________________________ Page 6 VS/IIS - Document Access Subroutines 2.02.00 7.0 Media Contents All files that have changed since Release 2.01.0E have been noted by '***'. LIBRARY - @LINKLIB _______ Protection Blocks Modules Version Class Allocated Description _______ _______ __________ _________ ___________ WPDOCLIB 2.02.00 *** $ 30 Link Module to WPDOCLIB. WPOPEN 2.02.00 *** $ 30 Object code for all WPSUBS. WPPRINT 2.02.00 *** $ 30 Link Module to WPPRINT. LIBRARY - @MACLIB@ _______ DFB 2.02.00 *** $ 26 ASSEMBLER DSECT file. WPCALL 2.02.00 *** $ 8 ASSEMBLER Macro. LIBRARY - WPCOPYB _______ DFBGET 2.02.00 *** $ 7 BASIC data definition files. DFBINIT 2.02.00 *** $ 31 DFBPUT 2.02.00 *** $ 7 LIBRARY - WPCOPYC _______ DFA 2.02.00 *** $ 26 COBOL copy files. DFB 2.02.00 *** $ 27 DFC 2.02.00 *** $ 5 LIBRARY - WPCOPYP _______ DFB 2.02.00 *** $ 35 PL/I include file. LIBRARY - CSRNLIB _______ WPSUB220 2.02.00 *** 5 Software Release Notice. _______________________________________________________________________________ VS/IIS - Document Access Subroutines 2.02.00 Page 7 8.0 Software Installation & Operation Information The VS utility BACKUP should be used to retrieve the routines from WPSUBS. To find the version number of the WP Subroutines, perform the following steps: 1) Run EZPATCH 2) Enter FILE = WPOPEN, LIBRARY = @LINKLIB, VOLUME = system volume, UPDATE= NO 3) Enter SECTION = WPOPDATE, POSITION = 6 4) The version number is displayed in the three bytes in unsigned packed ___________________ decimal representation immediately to the right of the second diamond. _______ For example, if '020110' is displayed, the WPOPEN version is 02.01.10. 9.0 References VS/IIS Operator's Guide (800-1109WO) VS Programmer's Guide to VS/IIS (800-1304PW) The entry point for WPCLOSE is imbedded in WPOPEN, WPDOCLIB, and WPPRINT. _______________________________________________________________________________ Page 8 VS/IIS - Document Access Subroutines 2.02.00