USERNET.EXE (USERNET) is a utility which allows you to modify the contents of your USERNET.DAT file. What is your USERNET.DAT file you ask? The USERNET.DAT file is where information is stored about who is online, where they are from, and what they are currently doing. The USERNET.DAT file is also the file that is used to determine if users are available for chat and to display who is online via the WHO command. An example WHO command looks like this:
(#) Status User --- --------------------- ----------------------------- 1 Available for CHAT JIM SHELBER (PLANTATION, FLORIDA) 2 Logging into System 3 Available for CHAT KIM KARBO (SALT LAKE CITY, UT)
As you can see it shows that the SysOp is on node 1 and unavailable for node chat. This display also shows that the SysOp is from ANYTOWN, ANYWHERE.
You can do all sorts of things with USERNET. Below are some sample uses:
As you can see there are quite a few things you can do with USERNET. If you use your imagination you can come up with several other uses.
USERNET [filename] [nodenum] [status] [name] [city] [text]
| filename | Specifies the full path and filename of the USERNET.XXX file to use. |
| nodenum | Specifies the node number you want to edit or ALL to modify all nodes. |
| status | Specifies the status the node(s) will be set to. For a list of status values, see the Status Values heading in this section. |
| name | Specifies the name of the caller (up to 25 characters) or * to leave the name unchanged. |
| city | Specifies the city or location of the caller (up to 24 characters) or * for no change. |
| text | Specifies the text (up to 48 characters) to place in the operational text field. This text is used to show the filename a user is transferring, the door that is currently opened, etc. To leave the text unchanged, enter * for the text. For a list of status values that expect text in the operational text field, refer to the 11 SysOp command in the PCBoard Commands chapter of this manual. |
NOTE: If multiple words are entered for name or city you must enclose them within quotation marks (e.g. “JOHN DOE” “NOWHERE, USA”).
| Letter | As shown in PCBMoni | As shown in PCBoard |
|---|---|---|
| A | Available for CHAT | Available for CHAT |
| B | Out to DOS | Out of Code in DOOR |
| C | Chatting with Sysop | Entering a Message |
| D | Inside a DOOR | Out of Code in DOOR |
| E | Entering a Message | Entering a Message |
| F | Viewing A File | Transferring a File |
| G | CHATTING with Group | CHATTING with Group |
| L | Auto Logoff Pending | Auto Logoff Pending |
| M | Message | |
| N | Chatting w/ Node # | CHATTING with NODE # |
| O | Logging Into System | Logging into System |
| P | Paging the Sysop | Paging the Sysop |
| R | CHAT Request Sent | CHAT Request Sent |
| S | Answering Script | Entering a Message |
| T | Transferring a File | Transferring a File |
| U | Unavailable for CHAT | Unavailable for CHAT |
| W | Waiting for Node # | Waiting for Node |
| X | Drop to DOS Pending | Drop to DOS Pending |
| Y | No Caller this Node | No Caller this Node |
| Z | (Inactive Node) |
NOTE: With the Y and Z status values no name or city parameters are needed.
Sometimes as a SysOp you may want to list your name in the USERNET.DAT even when you are not online. Your display might look like this:
(#) Status User --- --------------------- ----------------------------- 1 Unavailable for CHAT JOE USER (ANYTOWN, ANYWHERE) 2 Available for CHAT JIM USER (ANYWHERE, ANYPLACE) 3 No Caller Online SYSOP - NOT CURRENTLY ONLINE
To accomplish a similar display you would do the following:
USERNET C:\PCB\MAIN\USERNET.XXX 3 Y N3 N3 "SYSOP - GONE FISHING"
The two N3s in this example are place-holders for the user name and city.
When there is no caller online, the text field is displayed instead of the
user name and city. If you normally log into a node other than 3, you can
replace the 3s in this example with the node number you log into.
If you want to broadcast all of your nodes from a DOS prompt, you can do so using USERNET. For the example let's say that you need to take your system down. Rather than SysOp chatting with all nodes, you can run a batch file which looks like the following:
USERNET C:\PCB\MAIN\USERNET.XXX ALL M "PLEASE LOG OFF ASAP"
This example uses the M status value to send the message. This is quite similar to the BR SysOp command in PCBoard. One thing that is distinctly different in this example is that instead of a node number, the word ALL is shown. The word ALL tells USERNET to send this message to ALL nodes.
NOTE: If the user is not in PCBoard (i.e., they are in a door), the message will not be displayed to the user even when they come back to PCBoard. You may want to pay special attention to who is in a door when you broadcast a message.
You may run into circumstances when a user name is stuck in the node display.
This type of scenario is most likely to happen when your bulletin board
system involves local nodes, floating nodes, and users who reboot their
system while online. To clear a user's name out of node 11 on the system,
you could issue the following command at a DOS prompt:
USERNET C:\PCB\MAIN\USERNET.XXX 11 Z
This will make it so that node 11 will not show up on the node display (using the WHO user command).
In this example, we will show you how to immediately log off all nodes that
are currently in PCBoard. To do this, change all of the node's status to X.
This action will drop the node to DOS as soon as possible. If the user is
currently in a DOOR or some other application, they will be disconnected when
they return to PCBoard. To mark all of your nodes to drop to DOS, use the
following command line:
USERNET C:\PCB\MAIN\USERNET.XXX ALL X
When PCBoard reads the USERNET.DAT file, it will see the X status and will disconnect the user. Before the user is disconnected, the Automatic Logoff Completed message will be displayed.