1 BULLMAINT .s1 .lm+2 The command $ BULLMAINT invokes the bulletin maintenance utility. This utility is used to create, update, and delete bulletins. .s1 .lit Format: $ BULLMAINT [/qualifiers] [bulletin_library_spec[,...]] .end lit .lm-2 2 Choosing__bulletin .lm+2 .s1 .c;Video Terminal .skip If you use a video terminal, BULLMAINT displays a list of bulletin titles for you to choose from. The arrow keys may be used to position the cursor to the desired bulletin title. A bulletin may be marked with 'X' for deletion or editing. The key may be used to cancel the marking. A Carriage-return terminates the bulletin selection process. The bulletins that are marked with 'X' will be then be deleted or edited in turn, depending on whether /DELETE or /EDIT was specified. .skip You can also press 'F' or 'P' to file or print a bulletin. To know more about a bulletin message such as who posts it, how long it is, etc., you just press 'M'. .skip .c;Hardcopy Terminal .skip If you use a hard copy terminal or the one whose type is unknown to BULLETIN, it displays a list of bulletin titles for you to choose from. The bulletin is then selected for deletion or editing by pressing 'X'. Carriage-return is used to skip to the next bulletin title. When you get down to the end of the list, or type 'Q', The bulletins that are marked with 'X' will be then be deleted or edited in turn, depending on whether /DELETE or /EDIT was specified. .skip You can also press 'F' or 'P' to file or print a bulletin. .lm-2 2 Clean__up .lm+2 .s1 The bulletin library should be compressd from time to time when old bulletins are removed from the library. This can be accomplished by using the the following DCL commands. .s1 .lit $ library/com/text/out=bull.blb bull.blb $ set file/trun bull.blb $ pur bull.blb Now, set protection this new file as that of the old one. .end lit .s1 [Warning:If an existing bulletin library is to be removed or replaced, the library and the associated index file (see Installation) should be deleted before a new one of the same name is created. The bulletin users' BULLETIN.DAT file in their login directories will then be in error with respect to the new library, but users must not delete BULLETIN.DAT if they are accessing any other bulletin libraries, since BULLETIN.DAT contains the status information for all bulletin libraries consulted by the user. Instead, users should simply flag obsolete bulletin titles with 'N'. To avoid this problem, it is a good idea to change the name of the bulletin library and index each time you remove or replace them. Users won't notice the difference because the logical name DEF__BULLETIN is used.] .lm-2 2 Installation .lm+2 .s1 See the USERGUIDE.MEM for details. .skip Following is the restriction in naming a bulletin__library__spec. .lit 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. .end lit .lm-2 2 Logical__name .lm+2 .s1 Define the logical name BUL pointing to the directory containing bulletin.exe and bullmaint.exe. .s Define the logical name USER__HELPLIB in the system logical name table. This logical name points to the user help library. Also define the logical name MAINT__HELPLIB in the system logical name table. This logical name points to the maintenance help library. If there is no logical name for the help libraries, the constants which define the help libraries in the file "INSTALL.H" are used. You can edit the file "INSTALL.H" to customize it with your system. In this case, all files have to be re-compiled and linked again. .s Define the logical name DEF__BULLETIN pointing to the default bulletin libraries. .lm-2 2 Parameters .lm+2 .s1 bulletin__library__spec .s1 .lm+1 Specifies the name of the bulletin library you want to access. No wild card characters are allowed in the bulletin__library__spec. The default library file type is BLB. .s1 This parameter may be omitted if there is a list of default bulletin libraries (i.#e., if the logical name DEF__BULLETIN is defined). In this case, the translation of DEF__BULLETIN will be used as the bulletin libraries. The parameter may also be used to override a default bulletin library. If this parameter is missing on the command line, and there is no logical name DEF__BULLETIN defined, you will be prompted for the bulletin libraries. .lm-3 2 Qualifiers .lm+2 .s1 If no qualifier is specified, /ADD is the default. .lm-2 .s1 /ADD .br .lm+2 Adds a new bulletin text to the bulletin library. /TITLE=title (maximum 64 characters), /FILE=filename (maximum 127 characters) must be present if /BATCH is used. Otherwise, you will be prompted for title and file. /EXPIRY__DATE=expiry__date is optional. If it is not specified, it means there is no expiration date for that bulletin. The file specified should contain the bulletin text. The added bulletin will have the status 'New' for all users. The format for specifying the expiry date is dd-mmm-yyyy hh:mm:ss.mm. A control-Z may be typed to any prompt to abort the operation. .s1 .lm-2 /BATCH .br .lm+2 If this qualifier, together with /TITLE, and /FILE, are on the command line, you will not be prompted for "title" and "file". .s1 .lm-2 /DELETE .br .lm+2 Deletes one or more bulletin messages from bulletin libraries. .lm-2 .s1 /EDIT .br .lm+2 Replaces an existing bulletin with new text. The user will be prompted for a new title, new expiration date and a file name. The file should contain the new bulletin text. If the expiration date is not specified, it means there is no expiration for that bulletin. The date of the edited bulletin will be updated automatically, but the bulletin will not have the status "new" for users who have read the previous version. A control-Z may be typed to any prompt to abort the operation. .lm-2 .s1 /EXPIRE .br .lm+2 Deletes all expired bulletins from bulletin libraries. .lm-2 /DEFAULT .lit /DEFAULT=value .end lit .lm+2 .s1 Value can be DATE, which is the default, displays the date on which the bulletin message was posted. POSTER displays the person who posts the bulletin message. SIZE displays the size (number of lines) of the bulletin message. .lm-2 /TITLE .lit /TITLE=title .end lit .lm+2 .s1 Title length max is 64. It is valid only if /BATCH and /FILE is present. .lm-2 /FILE .lit /FILE=file .end lit .lm+2 .s1 File length max is 127. It is valid only if /BATCH and /TITLE is present. .lm-2 /EXPIRY__DATE .lit /EXPIRY_DATE=date .end lit .lm+2 .s1 Date has the form dd-mmm-yyyy:hh:mm:ss.mm.