BULLETIN INSTALLATION GUIDE July, 1986 This document contains detailed instructions for installing the York University VAX/VMS Bulletin Software. UPDATE INFORMATION: This is a new guide. OPERATING SYSTEM AND VERSION: VAX/VMS V4.0 and later SOFTWARE VERSION: VAX/VMS Bulletin Software V4.0 The information in this document is subject to change without notice. Neither York University, the Department of Computer Science nor the authors assume any responsibility for the use or reliability of this software. Copyright (C) 1984, 1985, 1986, York University Department of Computer Science All rights reserved. General permission to copy or modify, but not for profit, is hereby granted, provided that the above copyright notice is included and reference is made to the fact that reproduction privileges were granted by the York University, Department of Computer Science. CONTENTS I PREFACE . . . . . . . . . . . . . . . . . . . . . . 1 II NEW FEATURES AND BUG FIXES . . . . . . . . . . . . . 1 III SYSTEM REQUIREMENTS . . . . . . . . . . . . . . . . 1 IV INSTALLING BULLETIN SOFTWARE . . . . . . . . . . . . 2 IV.1 SET DEFAULT TO THE WORKING DIRECTORY . . . . . . . 2 IV.2 CONVERT OLD VERSION . . . . . . . . . . . . . . . 3 IV.3 CREATE A NEW BULLETIN LIBRARY . . . . . . . . . . 3 IV.4 DEFINE LOGICAL NAMES . . . . . . . . . . . . . . . 3 IV.5 UPDATE DCLTABLES.EXE . . . . . . . . . . . . . . . 4 IV.6 INSTALL BULLETIN.EXE AND BULLMAINT.EXE . . . . . . 5 V POSTINSTALLATION TASKS . . . . . . . . . . . . . . . 5 V.1 ADD A BULLETIN MESSAGE . . . . . . . . . . . . . . 5 V.2 DELETE A BULLETIN MESSAGE . . . . . . . . . . . . 6 V.3 EXPIRE BULLETIN MESSAGES . . . . . . . . . . . . . 6 V.4 EDIT A BULLETIN MESSAGE . . . . . . . . . . . . . 6 V.5 WHEN BULLETIN INDEX IS FULL . . . . . . . . . . . 6 VI WHERE TO GO FROM HERE . . . . . . . . . . . . . . . 6 APPENDIX A SOFTWARE DISTRIBUTION LIST APPENDIX B READER COMMENTS I PREFACE This guide provides the VAX system manager with a step-by-step procedure for installing the York university VAX/VMS Bulletin Software Version 4.0 (V4.0). It also gives instructions for updating an earlier version of Bulletin Software Version 3.0 (V3.0), as well as for installing it for the first time. II NEW FEATURES AND BUG FIXES NEW FEATURES 1) You can mark a bulletin message as "UNREAD" while it is displayed by pressing 'U'. It then displays next bulletin message if there is any. 2) You can file or print a bulletin message at marking phase as well as at displaying phase. This bulletin message will not be displayed but is recorded as "READ". 3) More information about a bulletin message such as how long it is, who posts it, etc. is available upon pressing 'M' at marking phase. 4) Qualifier /DEFAULT is available. It has three values: DATE, POSTER, and SIZE. Type $ BULLETIN/HELP for details. 5) If you add a bulletin message, you are prompted for the title, and file if the qualifier /BATCH is not present. If it is present, the qualifiers /TITLE=[title], and /FILE=[file] are required. 6) The help and info windows are smaller. 7) PF2 is equivalent to '?'. 8) You will get screen mode rather then line mode upon setting host to another node. BUG FIXES 1) The Bulletin library name is displayed in the form given in the logical DEF_BULLETIN. (See DEFINE LOGICAL NAMES for details) 2) The message "No bulletin message available" is an informational message rather than a warning. III SYSTEM REQUIREMENTS Bulletin V4.0 runs under the VMS operating system, V4.0 or later. It needs no privilege. It can be installed with header resident for 1 Installing Bulletin Software faster speed. IV INSTALLING BULLETIN SOFTWARE To prepare your VAX/VMS system for the installation, complete the following steps: 1) Make sure that you are in the working directory where the Bulletin Software is to reside. 2) Convert version V3.0 software to version V4.0 if applicable. 3) Create a new bulletin library if this is the first time your system is running Bulletin Software. 4) Define logical names. 5) Add bulletin.cld and bullmaint.cld to dcltables.exe. 6) Install bulletin.exe and bullmaint.exe. Following is the restriction in naming a bulletin_library_spec. The maximum length of a bulletin_library_spec = node::device:[directory]filename.type;version = 127 The filename itself can have the maximum length of 11 characters long. Note that all examples below uses DSK0:[BULLETIN] as the directory where the Bulletin Software resides, and DSK0:[PUBLIC] where the bulletin library, BULL.BLB, and index file, BULL.IND, reside. IV.1 SET DEFAULT TO THE WORKING DIRECTORY Make sure that you are in the working directory where the Bulletin Software resides. Your disk quota must be at least 2000 blocks. If your system is running the Bulletin Software, then disable public access to the bulletin library and index files as follows: $ SET DEFAULT working_directory $ SET PROTECTION=(G,W) bulletin_library, bulletin_index For example: $ SET DEFAULT DSK0:[BULLETIN] $ SET PROTECTION=(G,W) DSK0:[PUBLIC]BULL.BLB,BULL.IND 2 Installing Bulletin Software IV.2 CONVERT OLD VERSION If you are running Bulletin V3.0, you have two options. You can either convert the old bulletin index file V3.0 or create a new bulletin library. If this is the first time your system is running Bulletin Software, skip this part. $ CONVERT/FDL=CONVERT.FDL/PAD=%X20 old_bulletin_index new_bulletin_index $ @CONVERT old_bulletin_library new_bulletin_library For example: $ CONVERT/FDL=CONVERT.FDL/PAD=%X20 - $_ DSK0:[PUBLIC]BULL.IND DSK0:[PUBLIC]NEWBULL.IND $ @CONVERT DSK0:[PUBLIC]BULL.BLB DSK0:[PUBLIC]NEWBULL.BLB If you prefer to create a new bulletin library, make sure that it has different name: $ LIBRARY/TEXT new_bulletin_library /CREATE For example: $ LIBRARY/TEXT DSK0:[PUBLIC]NEWBULL.BLB /CREATE Note that NEWBULL.IND will be created later automatically when you add a bulletin message to this NEWBULL.BLB. IV.3 CREATE A NEW BULLETIN LIBRARY If you have done CONVERT OLD VERSION, then ignore this part. If this is the first time your system is running Bulletin Software, then create a bulletin library: $ LIBRARY/TEXT bulletin_library /CREATE For example: $ LIBRARY/TEXT DSK0:[PUBLIC]BULL.BLB /CREATE Note that BULL.IND will be created later automatically when you add a bulletin message to this BULL.BLB IV.4 DEFINE LOGICAL NAMES There are four logical names to be defined: 1) Define DEF_BULLETIN: 3 Installing Bulletin Software $ DEFINE/SYSTEM/EXEC DEF_BULLETIN PUBLIC_BULLETIN $ DEFINE/SYSTEM/EXEC PUBLIC_BULLETIN DSK0:[PUBLIC]BULL.BLB Note that you can chose any name other than PUBLIC_BULLETIN. This name will be displayed later as "Public Bulletin". If your system has more than one bulletin library, you can define DEF_BULLETIN as a search list: $ DEFINE/SYSTEM/EXEC DEF_BULLETIN PUBLIC_BULLETIN,PRIVATE_BULLETIN $ DEFINE/SYSTEM/EXEC PUBLIC_BULLETIN DSK0:[PUBLIC]BULL.BLB $ DEFINE/SYSTEM/EXEC PRIVATE_BULLETIN DSK0:[PRIVATE]BULL.BLB Everything else remains the same. 2) Define USER_HELPLIB: $ DEFINE/SYSTEM/EXEC USER_HELPLIB DSK0:[BULLETIN]BULLETIN.HLB $ SET PROTECTION=(G:R,W:R) DSK0:[BULLETIN]BULLETIN.HLB 3) Define MAINT_HELPLIB: $ DEFINE/SYSTEM/EXEC MAINT_HELPLIB DSK0:[BULLETIN]BULLMAINT.HLB Usually, general users can read BULLETIN.HLB, and only system managers can read BULLMAINT.HLB. In our environment, we don't restrict this: $ SET PROTECTION=(G:R,W:R) DSK0:[BULLETIN]BULLMAINT.HLB If you wish to restrict access to BULLMAINT.HLB, then set your own protection to this file. 4) Define BUL: $ DEFINE/SYSTEM/EXEC BUL DSK0:[BULLETIN] IV.5 UPDATE DCLTABLES.EXE Two files - bulletin.cld and bullmaint.cld should be added to DCLTABLES.EXE. $ SET COMMAND/TABLE=SYS$LIBRARY:DCLTABLES.EXE BULLETIN.CLD $ SET COMMAND/TABLE=SYS$LIBRARY:DCLTABLES.EXE BULLMAINT.CLD $ SET PROTECTION=(G:RE,W:RE) DSK0:[BULLETIN]BULLETIN.EXE $ SET PROTECTION=(G:RE,W:RE) DSK0:[BULLETIN]BULLMAINT.EXE If you wish to restrict access to BULLMAINT.HLB, then set your own protection to this file. 4 Installing Bulletin Software IV.6 INSTALL BULLETIN.EXE AND BULLMAINT.EXE Two files - bulletin.exe and bullmaint.exe should be installed: $ INSTALL :== $INSTALL/COMMAND $ INSTALL INSTALL> CREATE DSK0:[BULLETIN]BULLETIN.EXE /OPEN/HEADER/SHARED INSTALL> CREATE DSK0:[BULLETIN]BULLMAINT.EXE /OPEN/HEADER/SHARED CTRL-Z $ If you are converting version V3.0 software to V4.0, it is time to reset protection to the bulletin library and index as readable. Otherwise, go to the part ADD A BULLETIN MESSAGE. $ SET PROTECTION=(W:R) DSK0:[PUBLIC]BULL.BLB $ SET PROTECTION=(W:R) DSK0:[PUBLIC]BULL.IND V POSTINSTALLATION TASKS V.1 ADD A BULLETIN MESSAGE To add a bulletin message, you should first create this file via EDT and RUNOFF. The template is as follows: $ EDIT FOO.RNO *CHANGE .page size 1000,70 .left margin 10 .autoparagraph .nohead This is the test to see how it looks. This is the test to see how it looks. This is the test to see how it looks. CTRL-Z *EXIT $ Then, runoff: $ RUNOFF FOO.RNO /OUT=FOO.MEM Finally, add it to the bulletin library: $ BMAINT _Title: This is the first bulletin message _File: FOO.MEM $ If you haven't set protection to the bulletin library and index as readable, then do it now: $ SET PROTECTION=(W:R) DSK0:[PUBLIC]BULL.BLB 5 Installing Bulletin Software $ SET PROTECTION=(W:R) DSK0:[PUBLIC]BULL.IND V.2 DELETE A BULLETIN MESSAGE To delete a bulletin message: $ BMAINT/DELETE At this point, Bulletin Software displays the titles of all bulletin messages. Press 'X' to mark the one you want to delete. Upon pressing , a marked bulletin message will be deleted. V.3 EXPIRE BULLETIN MESSAGES To expire bulletin messages: $ BMAINT/EXPIRE V.4 EDIT A BULLETIN MESSAGE To edit a bulletin message: $ BMAINT/EDIT At this point, Bulletin Software displays titles of all bulletin messages. Press 'X' to mark the one you want to edit. Upon pressing , a marked bulletin message will be edited. You will be prompted for a new title, expiry date, and a new file. V.5 WHEN BULLETIN INDEX IS FULL When the bulletin index file, in our example BULL.IND, gets full, (the threshold limit is 9,000.000 bulletin messages), adding a bulletin message will produce warning. At this point, you should create a new bulletin library and index, and redefine DEF_BULLETIN. Users won't notice the difference because the logical name DEF_BULLETIN is used rather than the real filenames. (Refer to DEFINE LOGICAL NAMES) VI WHERE TO GO FROM HERE If you need more help, consult the help files available: $ BULLETIN/HELP $ BMAINT/HELP 6 Installing Bulletin Software or contact: Ozan S. Yigit Department of Computer Science York University 4700 Keele Street Downsview, Ontario M3J 1P3 UTZOO!YETTI!OZ (USENET) OZ@YUSOL (BITNET) 7 APPENDIX A SOFTWARE DISTRIBUTION LIST This appendix lists the files contained on the Bulletin Software distribution volumes: BUILD.COM A command procedure to build BULLETIN.EXE, and BULLMAINT.EXE BULL.H Definition file BULLCMD.C 1st level code of commands BULLCMD.OBJ Object code of BULLCMD BULLETIN.C Main level code of BULLETIN BULLETIN.CLD CLD for BULLETIN BULLETIN.EXE Image file of BULLETIN BULLETIN.HLB Help library BULLETIN.HLP Help file of BULLETIN BULLETIN.OBJ Object code of BULLETIN BULLETIN.RNH RNH file of BULLETIN.HLP BULLIO.C I/O code BULLIO.OBJ Object code of BULLIO BULLMAINT.C Main level code of BULLMAINT BULLMAINT.CLD CLD for BULLMAINT BULLMAINT.EXE Image file of BULLMAINT BULLMAINT.HLB Help library BULLMAINT.HLP Help file of BULLMAINT BULLMAINT.OBJ Object code of BULLMAINT BULLMAINT.RNH RNH file of BULLMAINT.HLP BULLMISC.C Miscellaneous code BULLMISC.OBJ Object code of BULLMISC BULLMSG.MSG Message code BULLMSG.OBJ Object code of BULLMSG BULLSCR.C 2nd level code of commands CLIMSGDEF.H Definition file CONVERT.COM A command procedure to convert bulletin library from V3 to V4 CONVERT.FDL FDL file used to convert bulletin index from V3 to V4 DESCDEF.H Definition file HLPDEF.H Definition file INSTALL.H Definition file LBRDEF.H Definition file LIBCLIDEF.H Definition file LNMDEF.H Definition file A-1 SOFTWARE DISTRIBUTION LIST SYIDEF.H Definition file USERGUIDE.RNO RNH file of USERGUIDE.MEM USERGUIDE.MEM User guide There may be other files on the distribution volumes. Do not use these files. A-2 APPENDIX B READER COMMENTS Your comments and suggestions are welcome. They will help us in our continuing effort to improve the quality and usefulness of our publications. Thank you for completing this form and forward it to: Ozan S. Yigit Department of Computer Science York University 4700 Keele Street Downsview, Ontario M3J 1P3 UTZOO!YETTI!OZ (USENET) OZ@YUSOL (BITNET) 1) How would you rate this manual for completeness of information, accuracy of information, ease of use? 2) What suggestions do you have for improving Bulletin Software. 3) What is your job title? 4) Please provide your name and address. B-1