Loading decus/vax85c/bulletin/aaareadme.doc +73 −73 Original line number Diff line number Diff line The following are instructions for creating the BULLETIN executable and installation of the utility. A brief explanation of how the internals of the BULLETIN utility works can be found in BULLETIN.TXT . None of the command procedures included here are sophisticated, so it is likely that several modifications will have to be made by the installer. The installer should enable all privileges before installation. 1) CREATE.COM This will compile and link the BULLETIN sources. Also, there are severalu INCLUDE files for the fortran sources (.INC files). BULLFILES.INC must first be modified before this procedure is run. It contains the names of data files which BULLETIN creates. It also has the username for the BBOARD account.t BBOARD is an option by which mail sent to the specified username will bet converted into bulletins. This allows a user on a different system, which is connected via a network, to be able to submit a bulletin. This feature can be disabled if it is not desired by specifying the username NONE. In any case, you should edit BULLFILES.INC and specify the appropriate device ands directories in which you desire that the files be located. (NOTE: Although the BBOARD feature can be used over DECNET, a more sophisticated method is available to easily allow one to add bulletins to other DECNET nodes with all the features of BULLETIN. See below). 2) STARTUP.COM The data files that BULLETIN creates should be owned by a system UIC, and MUST be protected from users being able to have access them.L STARTUP.COM sets the process UIC to [1,4] (you should change this ifc you want something else), sets the WORLD and GROUP protection to NONE,t adds the bulletin found in the file INSTRUCT.TXT (it is added withl /PERMANENT, so it never expires), and then resets the UIC and PROTECTION to what they were before running the procedure. INSTRUCT.BUL contains a bulletin with instructions to the users as to how to use the BULLETIN utility. You may want to modify it. 3) INSTALL.COM The following procedure copies the executable image to SYS$SYSTEM and installs it with certain privileges. It also installs the necessaryh help files in SYS$HELP. 4) LOGIN.COM This contains the comands that should be executed at login time by SYS$MANAGER:SYLOGIN.COM. It defines the BULLETIN commands.d It also executes the command BULLETIN/LOGIN in order to notifyu the user of new bulletins. If desired, the /READNEW qualifierd can also be added. If there are any new non-system bulletins, this qualifier creates a prompt asking the user if the non-systemv bulletins are to be displayed or not. Normally, only system bulletins are displayed in full, and only the subjects of the non-systema bulletins are displayed. ( Some systems might have a lot of userso who are not interested in reading the non-system bulletins, in which case /READNEW should probably not be added. Instead, you could let users enable this feature by entering the BULLETIN utility andh typing the command SET READNEW ). (NOTE: Since /LOGIN and /READNEW are system commands, they are not included in the help file). 5) BULLSTART.COM This procedure contains the commands that should be executed afterd a system startup. It should be executed by SYS$MANAGER:SYSTARTUP.COM as a batch job. It simply installs the BULLETIN utility with correct privileges. 6) BULLETIN.COMc If one wants the feature of using BULLETIN between DECNET nodes,t this file must be put in each node's DECNET default user's directoryA (usually [DECNET]). Once this is done, the /NODE qualifer for the ADD command can be used.i NOTE: Presently, privileged functions such as /SYSTEM will worka on other nodes only if you have an account on the other node with the same username, and with appropriate privileges. You will bet prompted for the password for the account on the remote node. However, due to unknown reasons, the software I have to check the password will' only work for passwords that have been set under V4.x. If the password was created under V3.x, the program will not work, and you password wills be treated as invalid.u The following are instructions for creating the BULLETIN executable and installation of the utility. A brief explanation of how the internals of the BULLETIN utility works can be found in BULLETIN.TXT . None of the command procedures included here are sophisticated, so it is likely that several modifications will have to be made by the installer. The installer should enable all privileges before installation. 1) CREATE.COM This will compile and link the BULLETIN sources. Also, there are severalu INCLUDE files for the fortran sources (.INC files). BULLFILES.INC must first be modified before this procedure is run. It contains the names of data files which BULLETIN creates. It also has the username for the BBOARD account.t BBOARD is an option by which mail sent to the specified username will bet converted into bulletins. This allows a user on a different system, which is connected via a network, to be able to submit a bulletin. This feature can be disabled if it is not desired by specifying the username NONE. In any case, you should edit BULLFILES.INC and specify the appropriate device ands directories in which you desire that the files be located. (NOTE: Although the BBOARD feature can be used over DECNET, a more sophisticated method is available to easily allow one to add bulletins to other DECNET nodes with all the features of BULLETIN. See below). 2) STARTUP.COM The data files that BULLETIN creates should be owned by a system UIC, and MUST be protected from users being able to have access them.L STARTUP.COM sets the process UIC to [1,4] (you should change this ifc you want something else), sets the WORLD and GROUP protection to NONE,t adds the bulletin found in the file INSTRUCT.TXT (it is added withl /PERMANENT, so it never expires), and then resets the UIC and PROTECTION to what they were before running the procedure. INSTRUCT.BUL contains a bulletin with instructions to the users as to how to use the BULLETIN utility. You may want to modify it. 3) INSTALL.COM The following procedure copies the executable image to SYS$SYSTEM and installs it with certain privileges. It also installs the necessaryh help files in SYS$HELP. 4) LOGIN.COM This contains the comands that should be executed at login time by SYS$MANAGER:SYLOGIN.COM. It defines the BULLETIN commands.d It also executes the command BULLETIN/LOGIN in order to notifyu the user of new bulletins. If desired, the /READNEW qualifierd can also be added. If there are any new non-system bulletins, this qualifier creates a prompt asking the user if the non-systemv bulletins are to be displayed or not. Normally, only system bulletins are displayed in full, and only the subjects of the non-systema bulletins are displayed. ( Some systems might have a lot of userso who are not interested in reading the non-system bulletins, in which case /READNEW should probably not be added. Instead, you could let users enable this feature by entering the BULLETIN utility andh typing the command SET READNEW ). (NOTE: Since /LOGIN and /READNEW are system commands, they are not included in the help file). 5) BULLSTART.COM This procedure contains the commands that should be executed afterd a system startup. It should be executed by SYS$MANAGER:SYSTARTUP.COM as a batch job. It simply installs the BULLETIN utility with correct privileges. 6) BULLETIN.COMc If one wants the feature of using BULLETIN between DECNET nodes,t this file must be put in each node's DECNET default user's directoryA (usually [DECNET]). Once this is done, the /NODE qualifer for the ADD command can be used.i NOTE: Presently, privileged functions such as /SYSTEM will worka on other nodes only if you have an account on the other node with the same username, and with appropriate privileges. You will bet prompted for the password for the account on the remote node. However, due to unknown reasons, the software I have to check the password will' only work for passwords that have been set under V4.x. If the password was created under V3.x, the program will not work, and you password wills be treated as invalid.u decus/vax85c/bulletin/bboard.com +5 −5 Original line number Diff line number Diff line $ SET PROTECT=(W:RWED)/DEFAULT $ MAIL READ EXTRACT/ALL USRD$:[BBOARD]BBOARD.MAI DELETE/ALL $ SET PROTECT=(W:RWED)/DEFAULT $ MAIL READ EXTRACT/ALL USRD$:[BBOARD]BBOARD.MAI DELETE/ALL decus/vax85c/bulletin/bullcom.cld +36 −36 Original line number Diff line number Diff line MODULE BULLETIN_SUBCOMMANDS DEFINE VERB ADD PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE) QUALIFIER BELL QUALIFIER BROADCAST QUALIFIER EDIT QUALIFIER NODES, LABEL=NODES, VALUE(REQUIRED,LIST) QUALIFIER PASSWORD, LABEL=PASSWORD, VALUE(REQUIRED) QUALIFIER PERMANENT QUALIFIER SHUTDOWN QUALIFIER SYSTEM QUALIFIER USERNAME, LABEL=USERNAME, VALUE(REQUIRED) DEFINE VERB BACK DEFINE VERB DELETE PARAMETER P1, LABEL = BULLETIN_NUMBER, VALUE(TYPE=$FILE) DEFINE VERB DIRECTORY DEFINE VERB EXITA DEFINE VERB FILEE PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE,REQUIRED),C PROMPT="File" QUALIFIER HEADER, DEFAULTL DEFINE VERB HELPD PARAMETER P1, LABEL = HELP_TOPIC, VALUE(TYPE=$REST_OF_LINE) DEFINE VERB NEXTN DEFINE VERB READT PARAMETER P1, LABEL = BULLETIN_NUMBER, VALUE(TYPE=$NUMBER) DEFINE VERB REPLACE PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE)E QUALIFIER EXPIRATION QUALIFIER HEADER QUALIFIER NUMBER, VALUE(TYPE=$NUMBER,REQUIRED) QUALIFIER TEXT DEFINE VERB SET PARAMETER P1, LABEL = SET_PARAM1, VALUE(REQUIRED), PROMPT="What" MODULE BULLETIN_SUBCOMMANDS DEFINE VERB ADD PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE) QUALIFIER BELL QUALIFIER BROADCAST QUALIFIER EDIT QUALIFIER NODES, LABEL=NODES, VALUE(REQUIRED,LIST) QUALIFIER PASSWORD, LABEL=PASSWORD, VALUE(REQUIRED) QUALIFIER PERMANENT QUALIFIER SHUTDOWN QUALIFIER SYSTEM QUALIFIER USERNAME, LABEL=USERNAME, VALUE(REQUIRED) DEFINE VERB BACK DEFINE VERB DELETE PARAMETER P1, LABEL = BULLETIN_NUMBER, VALUE(TYPE=$FILE) DEFINE VERB DIRECTORY DEFINE VERB EXITA DEFINE VERB FILEE PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE,REQUIRED),C PROMPT="File" QUALIFIER HEADER, DEFAULTL DEFINE VERB HELPD PARAMETER P1, LABEL = HELP_TOPIC, VALUE(TYPE=$REST_OF_LINE) DEFINE VERB NEXTN DEFINE VERB READT PARAMETER P1, LABEL = BULLETIN_NUMBER, VALUE(TYPE=$NUMBER) DEFINE VERB REPLACE PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE)E QUALIFIER EXPIRATION QUALIFIER HEADER QUALIFIER NUMBER, VALUE(TYPE=$NUMBER,REQUIRED) QUALIFIER TEXT DEFINE VERB SET PARAMETER P1, LABEL = SET_PARAM1, VALUE(REQUIRED), PROMPT="What" decus/vax85c/bulletin/bullcoms.hlp +135 −135 Original line number Diff line number Diff line 1 ADD Adds a bulletin to the bulletin file. A file can be specified which contains the bulletin. Otherwise, BULLETIN will prompt for the text. BULLETIN will ask for an expiration date and a header to contain the topic of the bulletin. Format ADD [file-name] All the qualifiers except for /EDIT and /NODES are restricted to users with SETPRV privileges. 2 /BELL This option is restricted to privileged users. It is used in conjunction with the /BROADCAST qualifier. If specified, the bell is rung on the terminals when the bulletin is broadcasted.t 2 /BROADCAST This option is restricted to privileged users. If specified, bulletin is both saved in the bulletin file and broadcasted to all users logged in at the time.f 2 /EDIT Determines whether or not the EDT editor is invoked to edit the bulletin you are sending. 2 /NODES=(nodes[,...]) Specifies to send the bulletin to other DECNET nodes. The BULLETIN utilityh must be installed properly on the other nodes. You will prompted for thel username to use at the other node. If you give a different username thanc that of the local node, or if privileged qualifiers are specified, you willi be prompted for the password of your account on the other nodes. At present, if the password is invalid, the bulletin will be rejected on then node, but no error message will be displayed on the local node that this happened. 2 /PERMANENT This option is restricted to privileged users. If specified, bulletin will be a permanent bulletin and will never expire.r 2 /SHUTDOWNg This option is restricted to privileged users. If specified, bulletin will be automatically deleted after a computer shutdown has occurred.o 2 /SYSTEM This option is restricted to privileged users. If specified, bulletin is both saved in the bulletin file and displayed in full as a system notice when a user logs in. System notices should be as brief as possible to avoid the possibility that system notices could scroll off the screen. 1 BACK Displays the bulletin preceding the current bulletin.r 1 DELETE Deletes the specified bulletin. If no bulletin is specified, the currentf bulletin is deleted. Only the original owner or a privileged user can delete a bulletin. Format DELETE [bulletin-number] The bulletin's relative number is found by the DIRECTORY command. 1 DIRECTORY Lists a summary of the bulletins. The bulletin number, submitter's name,a date, and subject of each bulletin is displayed. 1 EXIT Exits the BULLETIN program.h 1 FILE Copies the current bulletin to the named file. The file-name parameters is required, and consists of up to 9 alpha-numeric characters in length. Format:s FILE file-name 2 /HEADER /[NO]HEADER[ Controls whether a header containing the owner, subject, and date of the c bulletin is written in the file. The default is to write the header.i 1 Bulletin The BULLETIN utility permits a user to create a bulletin for reading by all users. Users are notified upon logging in that new bulletins have been added, and what the topic of the bulletins are. Actual reading off the bulletins is optional. (See the command SET READNEW for info onE automatic reading.) Bulletins are automatically deleted when theirh expiration date has passed.j 1 HELP To obtain help on any topic, type: HELP topic 1 NEXT Skips to the next bulletin and displays it. This is useful when pagingt through the bulletins and you encounter a particularly long bulletin that you would like to skip over.n 1 READ Displays the specified bulletin. If you do not specify a bulletin, then the first time you enter the command, the oldest bulletin will bee displayed. However, if there are new bulletins, the first new bulletin will be displayed. Each time you enter the command, the next page, or if there are no more pages, the next bulletin will be displayed. Format READ [bulletin-number] The bulletin's relative number is found by the DIRECTORY command.d Pressing just <RETURN> performs the same as the READ command.f 1 REPLACEp Replaces an existing bulletin in the bulletin file. This is for changingl part or all of a bulletin without causing users who have already seen then bulletin to be notified of it a second time. If the text of the bulletin is to be changed, a file can be specified which contains the text. Otherwise, BULLETIN will prompt for the text. The expiration date and header can also be changed. If neither /EXPIRATION, /HEADER, nor /TEXTT are specified, it is assumed the whole bulletin will be replaced.s Format REPLACE [file-name]i 2 /EXPIRATIONc Specifies that the bulletin expiration date is to be replaced. 2 /HEADERe Specifies that the bulletin header is to be replaced.f 2 /NUMBER=ne Specifies the bulletin number to be replaced. If this qualifier is omitted, the bulletin that is presently being read will be replaced. 2 /TEXT Specifies that the bulletin text is to be replaced./ 1 SETo Defines or changes characteristics associated with automatic reading of bulletins.m Format: SET option 2 READNEWp Controls whether you will be prompted upon logging in if you wish to read new non-system bulletins (if any exist). The default is that you are notc prompted. (Previously this was done by including the BULLETIN/READNEW command in one's login command procedure). Format: SET [NO]READNEWt 1 ADD Adds a bulletin to the bulletin file. A file can be specified which contains the bulletin. Otherwise, BULLETIN will prompt for the text. BULLETIN will ask for an expiration date and a header to contain the topic of the bulletin. Format ADD [file-name] All the qualifiers except for /EDIT and /NODES are restricted to users with SETPRV privileges. 2 /BELL This option is restricted to privileged users. It is used in conjunction with the /BROADCAST qualifier. If specified, the bell is rung on the terminals when the bulletin is broadcasted.t 2 /BROADCAST This option is restricted to privileged users. If specified, bulletin is both saved in the bulletin file and broadcasted to all users logged in at the time.f 2 /EDIT Determines whether or not the EDT editor is invoked to edit the bulletin you are sending. 2 /NODES=(nodes[,...]) Specifies to send the bulletin to other DECNET nodes. The BULLETIN utilityh must be installed properly on the other nodes. You will prompted for thel username to use at the other node. If you give a different username thanc that of the local node, or if privileged qualifiers are specified, you willi be prompted for the password of your account on the other nodes. At present, if the password is invalid, the bulletin will be rejected on then node, but no error message will be displayed on the local node that this happened. 2 /PERMANENT This option is restricted to privileged users. If specified, bulletin will be a permanent bulletin and will never expire.r 2 /SHUTDOWNg This option is restricted to privileged users. If specified, bulletin will be automatically deleted after a computer shutdown has occurred.o 2 /SYSTEM This option is restricted to privileged users. If specified, bulletin is both saved in the bulletin file and displayed in full as a system notice when a user logs in. System notices should be as brief as possible to avoid the possibility that system notices could scroll off the screen. 1 BACK Displays the bulletin preceding the current bulletin.r 1 DELETE Deletes the specified bulletin. If no bulletin is specified, the currentf bulletin is deleted. Only the original owner or a privileged user can delete a bulletin. Format DELETE [bulletin-number] The bulletin's relative number is found by the DIRECTORY command. 1 DIRECTORY Lists a summary of the bulletins. The bulletin number, submitter's name,a date, and subject of each bulletin is displayed. 1 EXIT Exits the BULLETIN program.h 1 FILE Copies the current bulletin to the named file. The file-name parameters is required, and consists of up to 9 alpha-numeric characters in length. Format:s FILE file-name 2 /HEADER /[NO]HEADER[ Controls whether a header containing the owner, subject, and date of the c bulletin is written in the file. The default is to write the header.i 1 Bulletin The BULLETIN utility permits a user to create a bulletin for reading by all users. Users are notified upon logging in that new bulletins have been added, and what the topic of the bulletins are. Actual reading off the bulletins is optional. (See the command SET READNEW for info onE automatic reading.) Bulletins are automatically deleted when theirh expiration date has passed.j 1 HELP To obtain help on any topic, type: HELP topic 1 NEXT Skips to the next bulletin and displays it. This is useful when pagingt through the bulletins and you encounter a particularly long bulletin that you would like to skip over.n 1 READ Displays the specified bulletin. If you do not specify a bulletin, then the first time you enter the command, the oldest bulletin will bee displayed. However, if there are new bulletins, the first new bulletin will be displayed. Each time you enter the command, the next page, or if there are no more pages, the next bulletin will be displayed. Format READ [bulletin-number] The bulletin's relative number is found by the DIRECTORY command.d Pressing just <RETURN> performs the same as the READ command.f 1 REPLACEp Replaces an existing bulletin in the bulletin file. This is for changingl part or all of a bulletin without causing users who have already seen then bulletin to be notified of it a second time. If the text of the bulletin is to be changed, a file can be specified which contains the text. Otherwise, BULLETIN will prompt for the text. The expiration date and header can also be changed. If neither /EXPIRATION, /HEADER, nor /TEXTT are specified, it is assumed the whole bulletin will be replaced.s Format REPLACE [file-name]i 2 /EXPIRATIONc Specifies that the bulletin expiration date is to be replaced. 2 /HEADERe Specifies that the bulletin header is to be replaced.f 2 /NUMBER=ne Specifies the bulletin number to be replaced. If this qualifier is omitted, the bulletin that is presently being read will be replaced. 2 /TEXT Specifies that the bulletin text is to be replaced./ 1 SETo Defines or changes characteristics associated with automatic reading of bulletins.m Format: SET option 2 READNEWp Controls whether you will be prompted upon logging in if you wish to read new non-system bulletins (if any exist). The default is that you are notc prompted. (Previously this was done by including the BULLETIN/READNEW command in one's login command procedure). Format: SET [NO]READNEWt decus/vax85c/bulletin/bulldir.inc +8 −8 Original line number Diff line number Diff line COMMON /BULL_DIR/ DESCRIP,FROM,DATE,TIME,BLOCK,LENGTH,EXDATE & ,NEWEST_EXDATE,NEWEST_DATE,NEWEST_TIME,SYSTEM,NBULL,NBLOCK & ,SHUTDOWN,SHUTDOWN_DATE,SHUTDOWN_TIME CHARACTER*53 DESCRIP CHARACTER*12 FROM CHARACTER*11 DATE,EXDATE,NEWEST_EXDATE,NEWEST_DATE,SHUTDOWN_DATE CHARACTER*8 TIME,NEWEST_TIME,SHUTDOWN_TIME LOGICAL SYSTEM COMMON /BULL_DIR/ DESCRIP,FROM,DATE,TIME,BLOCK,LENGTH,EXDATE & ,NEWEST_EXDATE,NEWEST_DATE,NEWEST_TIME,SYSTEM,NBULL,NBLOCK & ,SHUTDOWN,SHUTDOWN_DATE,SHUTDOWN_TIME CHARACTER*53 DESCRIP CHARACTER*12 FROM CHARACTER*11 DATE,EXDATE,NEWEST_EXDATE,NEWEST_DATE,SHUTDOWN_DATE CHARACTER*8 TIME,NEWEST_TIME,SHUTDOWN_TIME LOGICAL SYSTEM Loading
decus/vax85c/bulletin/aaareadme.doc +73 −73 Original line number Diff line number Diff line The following are instructions for creating the BULLETIN executable and installation of the utility. A brief explanation of how the internals of the BULLETIN utility works can be found in BULLETIN.TXT . None of the command procedures included here are sophisticated, so it is likely that several modifications will have to be made by the installer. The installer should enable all privileges before installation. 1) CREATE.COM This will compile and link the BULLETIN sources. Also, there are severalu INCLUDE files for the fortran sources (.INC files). BULLFILES.INC must first be modified before this procedure is run. It contains the names of data files which BULLETIN creates. It also has the username for the BBOARD account.t BBOARD is an option by which mail sent to the specified username will bet converted into bulletins. This allows a user on a different system, which is connected via a network, to be able to submit a bulletin. This feature can be disabled if it is not desired by specifying the username NONE. In any case, you should edit BULLFILES.INC and specify the appropriate device ands directories in which you desire that the files be located. (NOTE: Although the BBOARD feature can be used over DECNET, a more sophisticated method is available to easily allow one to add bulletins to other DECNET nodes with all the features of BULLETIN. See below). 2) STARTUP.COM The data files that BULLETIN creates should be owned by a system UIC, and MUST be protected from users being able to have access them.L STARTUP.COM sets the process UIC to [1,4] (you should change this ifc you want something else), sets the WORLD and GROUP protection to NONE,t adds the bulletin found in the file INSTRUCT.TXT (it is added withl /PERMANENT, so it never expires), and then resets the UIC and PROTECTION to what they were before running the procedure. INSTRUCT.BUL contains a bulletin with instructions to the users as to how to use the BULLETIN utility. You may want to modify it. 3) INSTALL.COM The following procedure copies the executable image to SYS$SYSTEM and installs it with certain privileges. It also installs the necessaryh help files in SYS$HELP. 4) LOGIN.COM This contains the comands that should be executed at login time by SYS$MANAGER:SYLOGIN.COM. It defines the BULLETIN commands.d It also executes the command BULLETIN/LOGIN in order to notifyu the user of new bulletins. If desired, the /READNEW qualifierd can also be added. If there are any new non-system bulletins, this qualifier creates a prompt asking the user if the non-systemv bulletins are to be displayed or not. Normally, only system bulletins are displayed in full, and only the subjects of the non-systema bulletins are displayed. ( Some systems might have a lot of userso who are not interested in reading the non-system bulletins, in which case /READNEW should probably not be added. Instead, you could let users enable this feature by entering the BULLETIN utility andh typing the command SET READNEW ). (NOTE: Since /LOGIN and /READNEW are system commands, they are not included in the help file). 5) BULLSTART.COM This procedure contains the commands that should be executed afterd a system startup. It should be executed by SYS$MANAGER:SYSTARTUP.COM as a batch job. It simply installs the BULLETIN utility with correct privileges. 6) BULLETIN.COMc If one wants the feature of using BULLETIN between DECNET nodes,t this file must be put in each node's DECNET default user's directoryA (usually [DECNET]). Once this is done, the /NODE qualifer for the ADD command can be used.i NOTE: Presently, privileged functions such as /SYSTEM will worka on other nodes only if you have an account on the other node with the same username, and with appropriate privileges. You will bet prompted for the password for the account on the remote node. However, due to unknown reasons, the software I have to check the password will' only work for passwords that have been set under V4.x. If the password was created under V3.x, the program will not work, and you password wills be treated as invalid.u The following are instructions for creating the BULLETIN executable and installation of the utility. A brief explanation of how the internals of the BULLETIN utility works can be found in BULLETIN.TXT . None of the command procedures included here are sophisticated, so it is likely that several modifications will have to be made by the installer. The installer should enable all privileges before installation. 1) CREATE.COM This will compile and link the BULLETIN sources. Also, there are severalu INCLUDE files for the fortran sources (.INC files). BULLFILES.INC must first be modified before this procedure is run. It contains the names of data files which BULLETIN creates. It also has the username for the BBOARD account.t BBOARD is an option by which mail sent to the specified username will bet converted into bulletins. This allows a user on a different system, which is connected via a network, to be able to submit a bulletin. This feature can be disabled if it is not desired by specifying the username NONE. In any case, you should edit BULLFILES.INC and specify the appropriate device ands directories in which you desire that the files be located. (NOTE: Although the BBOARD feature can be used over DECNET, a more sophisticated method is available to easily allow one to add bulletins to other DECNET nodes with all the features of BULLETIN. See below). 2) STARTUP.COM The data files that BULLETIN creates should be owned by a system UIC, and MUST be protected from users being able to have access them.L STARTUP.COM sets the process UIC to [1,4] (you should change this ifc you want something else), sets the WORLD and GROUP protection to NONE,t adds the bulletin found in the file INSTRUCT.TXT (it is added withl /PERMANENT, so it never expires), and then resets the UIC and PROTECTION to what they were before running the procedure. INSTRUCT.BUL contains a bulletin with instructions to the users as to how to use the BULLETIN utility. You may want to modify it. 3) INSTALL.COM The following procedure copies the executable image to SYS$SYSTEM and installs it with certain privileges. It also installs the necessaryh help files in SYS$HELP. 4) LOGIN.COM This contains the comands that should be executed at login time by SYS$MANAGER:SYLOGIN.COM. It defines the BULLETIN commands.d It also executes the command BULLETIN/LOGIN in order to notifyu the user of new bulletins. If desired, the /READNEW qualifierd can also be added. If there are any new non-system bulletins, this qualifier creates a prompt asking the user if the non-systemv bulletins are to be displayed or not. Normally, only system bulletins are displayed in full, and only the subjects of the non-systema bulletins are displayed. ( Some systems might have a lot of userso who are not interested in reading the non-system bulletins, in which case /READNEW should probably not be added. Instead, you could let users enable this feature by entering the BULLETIN utility andh typing the command SET READNEW ). (NOTE: Since /LOGIN and /READNEW are system commands, they are not included in the help file). 5) BULLSTART.COM This procedure contains the commands that should be executed afterd a system startup. It should be executed by SYS$MANAGER:SYSTARTUP.COM as a batch job. It simply installs the BULLETIN utility with correct privileges. 6) BULLETIN.COMc If one wants the feature of using BULLETIN between DECNET nodes,t this file must be put in each node's DECNET default user's directoryA (usually [DECNET]). Once this is done, the /NODE qualifer for the ADD command can be used.i NOTE: Presently, privileged functions such as /SYSTEM will worka on other nodes only if you have an account on the other node with the same username, and with appropriate privileges. You will bet prompted for the password for the account on the remote node. However, due to unknown reasons, the software I have to check the password will' only work for passwords that have been set under V4.x. If the password was created under V3.x, the program will not work, and you password wills be treated as invalid.u
decus/vax85c/bulletin/bboard.com +5 −5 Original line number Diff line number Diff line $ SET PROTECT=(W:RWED)/DEFAULT $ MAIL READ EXTRACT/ALL USRD$:[BBOARD]BBOARD.MAI DELETE/ALL $ SET PROTECT=(W:RWED)/DEFAULT $ MAIL READ EXTRACT/ALL USRD$:[BBOARD]BBOARD.MAI DELETE/ALL
decus/vax85c/bulletin/bullcom.cld +36 −36 Original line number Diff line number Diff line MODULE BULLETIN_SUBCOMMANDS DEFINE VERB ADD PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE) QUALIFIER BELL QUALIFIER BROADCAST QUALIFIER EDIT QUALIFIER NODES, LABEL=NODES, VALUE(REQUIRED,LIST) QUALIFIER PASSWORD, LABEL=PASSWORD, VALUE(REQUIRED) QUALIFIER PERMANENT QUALIFIER SHUTDOWN QUALIFIER SYSTEM QUALIFIER USERNAME, LABEL=USERNAME, VALUE(REQUIRED) DEFINE VERB BACK DEFINE VERB DELETE PARAMETER P1, LABEL = BULLETIN_NUMBER, VALUE(TYPE=$FILE) DEFINE VERB DIRECTORY DEFINE VERB EXITA DEFINE VERB FILEE PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE,REQUIRED),C PROMPT="File" QUALIFIER HEADER, DEFAULTL DEFINE VERB HELPD PARAMETER P1, LABEL = HELP_TOPIC, VALUE(TYPE=$REST_OF_LINE) DEFINE VERB NEXTN DEFINE VERB READT PARAMETER P1, LABEL = BULLETIN_NUMBER, VALUE(TYPE=$NUMBER) DEFINE VERB REPLACE PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE)E QUALIFIER EXPIRATION QUALIFIER HEADER QUALIFIER NUMBER, VALUE(TYPE=$NUMBER,REQUIRED) QUALIFIER TEXT DEFINE VERB SET PARAMETER P1, LABEL = SET_PARAM1, VALUE(REQUIRED), PROMPT="What" MODULE BULLETIN_SUBCOMMANDS DEFINE VERB ADD PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE) QUALIFIER BELL QUALIFIER BROADCAST QUALIFIER EDIT QUALIFIER NODES, LABEL=NODES, VALUE(REQUIRED,LIST) QUALIFIER PASSWORD, LABEL=PASSWORD, VALUE(REQUIRED) QUALIFIER PERMANENT QUALIFIER SHUTDOWN QUALIFIER SYSTEM QUALIFIER USERNAME, LABEL=USERNAME, VALUE(REQUIRED) DEFINE VERB BACK DEFINE VERB DELETE PARAMETER P1, LABEL = BULLETIN_NUMBER, VALUE(TYPE=$FILE) DEFINE VERB DIRECTORY DEFINE VERB EXITA DEFINE VERB FILEE PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE,REQUIRED),C PROMPT="File" QUALIFIER HEADER, DEFAULTL DEFINE VERB HELPD PARAMETER P1, LABEL = HELP_TOPIC, VALUE(TYPE=$REST_OF_LINE) DEFINE VERB NEXTN DEFINE VERB READT PARAMETER P1, LABEL = BULLETIN_NUMBER, VALUE(TYPE=$NUMBER) DEFINE VERB REPLACE PARAMETER P1, LABEL = FILESPEC, VALUE(TYPE=$FILE)E QUALIFIER EXPIRATION QUALIFIER HEADER QUALIFIER NUMBER, VALUE(TYPE=$NUMBER,REQUIRED) QUALIFIER TEXT DEFINE VERB SET PARAMETER P1, LABEL = SET_PARAM1, VALUE(REQUIRED), PROMPT="What"
decus/vax85c/bulletin/bullcoms.hlp +135 −135 Original line number Diff line number Diff line 1 ADD Adds a bulletin to the bulletin file. A file can be specified which contains the bulletin. Otherwise, BULLETIN will prompt for the text. BULLETIN will ask for an expiration date and a header to contain the topic of the bulletin. Format ADD [file-name] All the qualifiers except for /EDIT and /NODES are restricted to users with SETPRV privileges. 2 /BELL This option is restricted to privileged users. It is used in conjunction with the /BROADCAST qualifier. If specified, the bell is rung on the terminals when the bulletin is broadcasted.t 2 /BROADCAST This option is restricted to privileged users. If specified, bulletin is both saved in the bulletin file and broadcasted to all users logged in at the time.f 2 /EDIT Determines whether or not the EDT editor is invoked to edit the bulletin you are sending. 2 /NODES=(nodes[,...]) Specifies to send the bulletin to other DECNET nodes. The BULLETIN utilityh must be installed properly on the other nodes. You will prompted for thel username to use at the other node. If you give a different username thanc that of the local node, or if privileged qualifiers are specified, you willi be prompted for the password of your account on the other nodes. At present, if the password is invalid, the bulletin will be rejected on then node, but no error message will be displayed on the local node that this happened. 2 /PERMANENT This option is restricted to privileged users. If specified, bulletin will be a permanent bulletin and will never expire.r 2 /SHUTDOWNg This option is restricted to privileged users. If specified, bulletin will be automatically deleted after a computer shutdown has occurred.o 2 /SYSTEM This option is restricted to privileged users. If specified, bulletin is both saved in the bulletin file and displayed in full as a system notice when a user logs in. System notices should be as brief as possible to avoid the possibility that system notices could scroll off the screen. 1 BACK Displays the bulletin preceding the current bulletin.r 1 DELETE Deletes the specified bulletin. If no bulletin is specified, the currentf bulletin is deleted. Only the original owner or a privileged user can delete a bulletin. Format DELETE [bulletin-number] The bulletin's relative number is found by the DIRECTORY command. 1 DIRECTORY Lists a summary of the bulletins. The bulletin number, submitter's name,a date, and subject of each bulletin is displayed. 1 EXIT Exits the BULLETIN program.h 1 FILE Copies the current bulletin to the named file. The file-name parameters is required, and consists of up to 9 alpha-numeric characters in length. Format:s FILE file-name 2 /HEADER /[NO]HEADER[ Controls whether a header containing the owner, subject, and date of the c bulletin is written in the file. The default is to write the header.i 1 Bulletin The BULLETIN utility permits a user to create a bulletin for reading by all users. Users are notified upon logging in that new bulletins have been added, and what the topic of the bulletins are. Actual reading off the bulletins is optional. (See the command SET READNEW for info onE automatic reading.) Bulletins are automatically deleted when theirh expiration date has passed.j 1 HELP To obtain help on any topic, type: HELP topic 1 NEXT Skips to the next bulletin and displays it. This is useful when pagingt through the bulletins and you encounter a particularly long bulletin that you would like to skip over.n 1 READ Displays the specified bulletin. If you do not specify a bulletin, then the first time you enter the command, the oldest bulletin will bee displayed. However, if there are new bulletins, the first new bulletin will be displayed. Each time you enter the command, the next page, or if there are no more pages, the next bulletin will be displayed. Format READ [bulletin-number] The bulletin's relative number is found by the DIRECTORY command.d Pressing just <RETURN> performs the same as the READ command.f 1 REPLACEp Replaces an existing bulletin in the bulletin file. This is for changingl part or all of a bulletin without causing users who have already seen then bulletin to be notified of it a second time. If the text of the bulletin is to be changed, a file can be specified which contains the text. Otherwise, BULLETIN will prompt for the text. The expiration date and header can also be changed. If neither /EXPIRATION, /HEADER, nor /TEXTT are specified, it is assumed the whole bulletin will be replaced.s Format REPLACE [file-name]i 2 /EXPIRATIONc Specifies that the bulletin expiration date is to be replaced. 2 /HEADERe Specifies that the bulletin header is to be replaced.f 2 /NUMBER=ne Specifies the bulletin number to be replaced. If this qualifier is omitted, the bulletin that is presently being read will be replaced. 2 /TEXT Specifies that the bulletin text is to be replaced./ 1 SETo Defines or changes characteristics associated with automatic reading of bulletins.m Format: SET option 2 READNEWp Controls whether you will be prompted upon logging in if you wish to read new non-system bulletins (if any exist). The default is that you are notc prompted. (Previously this was done by including the BULLETIN/READNEW command in one's login command procedure). Format: SET [NO]READNEWt 1 ADD Adds a bulletin to the bulletin file. A file can be specified which contains the bulletin. Otherwise, BULLETIN will prompt for the text. BULLETIN will ask for an expiration date and a header to contain the topic of the bulletin. Format ADD [file-name] All the qualifiers except for /EDIT and /NODES are restricted to users with SETPRV privileges. 2 /BELL This option is restricted to privileged users. It is used in conjunction with the /BROADCAST qualifier. If specified, the bell is rung on the terminals when the bulletin is broadcasted.t 2 /BROADCAST This option is restricted to privileged users. If specified, bulletin is both saved in the bulletin file and broadcasted to all users logged in at the time.f 2 /EDIT Determines whether or not the EDT editor is invoked to edit the bulletin you are sending. 2 /NODES=(nodes[,...]) Specifies to send the bulletin to other DECNET nodes. The BULLETIN utilityh must be installed properly on the other nodes. You will prompted for thel username to use at the other node. If you give a different username thanc that of the local node, or if privileged qualifiers are specified, you willi be prompted for the password of your account on the other nodes. At present, if the password is invalid, the bulletin will be rejected on then node, but no error message will be displayed on the local node that this happened. 2 /PERMANENT This option is restricted to privileged users. If specified, bulletin will be a permanent bulletin and will never expire.r 2 /SHUTDOWNg This option is restricted to privileged users. If specified, bulletin will be automatically deleted after a computer shutdown has occurred.o 2 /SYSTEM This option is restricted to privileged users. If specified, bulletin is both saved in the bulletin file and displayed in full as a system notice when a user logs in. System notices should be as brief as possible to avoid the possibility that system notices could scroll off the screen. 1 BACK Displays the bulletin preceding the current bulletin.r 1 DELETE Deletes the specified bulletin. If no bulletin is specified, the currentf bulletin is deleted. Only the original owner or a privileged user can delete a bulletin. Format DELETE [bulletin-number] The bulletin's relative number is found by the DIRECTORY command. 1 DIRECTORY Lists a summary of the bulletins. The bulletin number, submitter's name,a date, and subject of each bulletin is displayed. 1 EXIT Exits the BULLETIN program.h 1 FILE Copies the current bulletin to the named file. The file-name parameters is required, and consists of up to 9 alpha-numeric characters in length. Format:s FILE file-name 2 /HEADER /[NO]HEADER[ Controls whether a header containing the owner, subject, and date of the c bulletin is written in the file. The default is to write the header.i 1 Bulletin The BULLETIN utility permits a user to create a bulletin for reading by all users. Users are notified upon logging in that new bulletins have been added, and what the topic of the bulletins are. Actual reading off the bulletins is optional. (See the command SET READNEW for info onE automatic reading.) Bulletins are automatically deleted when theirh expiration date has passed.j 1 HELP To obtain help on any topic, type: HELP topic 1 NEXT Skips to the next bulletin and displays it. This is useful when pagingt through the bulletins and you encounter a particularly long bulletin that you would like to skip over.n 1 READ Displays the specified bulletin. If you do not specify a bulletin, then the first time you enter the command, the oldest bulletin will bee displayed. However, if there are new bulletins, the first new bulletin will be displayed. Each time you enter the command, the next page, or if there are no more pages, the next bulletin will be displayed. Format READ [bulletin-number] The bulletin's relative number is found by the DIRECTORY command.d Pressing just <RETURN> performs the same as the READ command.f 1 REPLACEp Replaces an existing bulletin in the bulletin file. This is for changingl part or all of a bulletin without causing users who have already seen then bulletin to be notified of it a second time. If the text of the bulletin is to be changed, a file can be specified which contains the text. Otherwise, BULLETIN will prompt for the text. The expiration date and header can also be changed. If neither /EXPIRATION, /HEADER, nor /TEXTT are specified, it is assumed the whole bulletin will be replaced.s Format REPLACE [file-name]i 2 /EXPIRATIONc Specifies that the bulletin expiration date is to be replaced. 2 /HEADERe Specifies that the bulletin header is to be replaced.f 2 /NUMBER=ne Specifies the bulletin number to be replaced. If this qualifier is omitted, the bulletin that is presently being read will be replaced. 2 /TEXT Specifies that the bulletin text is to be replaced./ 1 SETo Defines or changes characteristics associated with automatic reading of bulletins.m Format: SET option 2 READNEWp Controls whether you will be prompted upon logging in if you wish to read new non-system bulletins (if any exist). The default is that you are notc prompted. (Previously this was done by including the BULLETIN/READNEW command in one's login command procedure). Format: SET [NO]READNEWt
decus/vax85c/bulletin/bulldir.inc +8 −8 Original line number Diff line number Diff line COMMON /BULL_DIR/ DESCRIP,FROM,DATE,TIME,BLOCK,LENGTH,EXDATE & ,NEWEST_EXDATE,NEWEST_DATE,NEWEST_TIME,SYSTEM,NBULL,NBLOCK & ,SHUTDOWN,SHUTDOWN_DATE,SHUTDOWN_TIME CHARACTER*53 DESCRIP CHARACTER*12 FROM CHARACTER*11 DATE,EXDATE,NEWEST_EXDATE,NEWEST_DATE,SHUTDOWN_DATE CHARACTER*8 TIME,NEWEST_TIME,SHUTDOWN_TIME LOGICAL SYSTEM COMMON /BULL_DIR/ DESCRIP,FROM,DATE,TIME,BLOCK,LENGTH,EXDATE & ,NEWEST_EXDATE,NEWEST_DATE,NEWEST_TIME,SYSTEM,NBULL,NBLOCK & ,SHUTDOWN,SHUTDOWN_DATE,SHUTDOWN_TIME CHARACTER*53 DESCRIP CHARACTER*12 FROM CHARACTER*11 DATE,EXDATE,NEWEST_EXDATE,NEWEST_DATE,SHUTDOWN_DATE CHARACTER*8 TIME,NEWEST_TIME,SHUTDOWN_TIME LOGICAL SYSTEM
