Command | Parameters | Description |
OPENGROUP |
GROUP |
Opens the group window for the indicated group. The GROUP
parameter may be either the name of a subscribed-to newsgroup, or
the ordinal position of the group in the NewsRog groups list
starting from 0. Due to ARexx capitalization of unquoted
strings, it is necessary to quote newsgroup names. Examples:
/* open c.s.a.misc */
OPENGROUP 'comp.sys.amiga.misc'
/* open the first group in the group list */
OPENGROUP 0
|
CLOSEGROUP |
GROUP [NOSAVE] [FORCE] |
Closes the group window for the indicated group. The GROUP
parameter is a group name or ordinal number as described for the
OPENGROUP command. If the optional keyword NOSAVE is
given, then the group overview will not be saved when the group
is shut down. If the optional keyword FORCE is given, then no
questions will be asked if the group overview information has
been modified and would be lost when the group is shut down.
Examples:
/* close c.s.a.misc */
CLOSEGROUP 'comp.sys.amiga.misc' SAVE FORCE
/* close the first group in the group list */
CLOSEGROUP 0
|
ISGROUPOPEN |
GROUP |
The secondard result string RESULT is set to 1 if the
indicated group is open, and to 0 otherwise. The GROUP
parameter is a group name or ordinal number as described for the
OPENGROUP command. Examples:
ISGROUPOPEN 'comp.sys.amiga.misc'
|
GROUPEXISTS |
GROUP |
The secondard result string RESULT is set to 1 if the
indicated group exists in the NewsRog subscription list, and to 0
otherwise. The GROUP parameter is a group name or ordinal number
as described for the OPENGROUP command. Examples:
GROUPEXISTS 'comp.sys.amiga.misc'
|
GROUPCOUNT |
None |
The secondard result string RESULT is set to the
number of newsgroups in the NewsRog subscription list.
|
GETGROUP |
GROUP |
The secondard result string RESULT is set to the name
of the indiciated group. This is useful to determine the
newsgroup name given an ordinal position in the subscription
list. Example:
|
UPDCOUNT |
GROUP |
The new article count for the indiciated group is updated
from the NNTP server.
|
MARKREAD |
GROUP |
All current articles in the indicated group are marked as
read.
|
MAKRUNREAD |
GROUP |
All current articles in the indicated group are marked as
unread.
|
SORTGROUPS |
GROUP |
The list of groups in the subscription list is sorted based
on the current sort criteria.
|
ADDGROUP |
GROUPNAME |
A group with the given name is added to the subscription
list.
|
OPENSERVERGROUPS |
None |
The Server Groups window is opened if it is not open already.
|
CLOSESERVERGROUPS |
None |
The Server Groups window is closed if it is open.
|
CLEARSERVERGROUPS |
None |
The list of server groups in the Server Groups window is
cleared.
|
FETCHSERVERGROUPS |
[PATTERN] |
The groups from the server matching the given pattern is
fetched from the NNTP server. If no pattern is given, an
asterisk (*) is used to fetch all the groups. Like all
network IO in NewsRog, this operation is started asynchronously,
and may take some time to complete. The SGFETCHPENDING command
may be used to determine if the operation has completed.
|
SGFETCHPENDING |
None |
The secondard result variable RESULT is set to 1 if
a FETCHSERVERGROUPS command is currently running, and to 0
otherwise.
|
SERVERGROUPCOUNT |
None |
The secondard result variable RESULT is set to the
number of groups currently in the server groups list.
|
GETSERVERGROUP |
POSITION |
The secondard result variable RESULT is set to the
name of the group at the given position in the server groups
list. The first group is number 0.
|
GROUPCMD |
GROUP GROUPCOMMAND |
The GROUPCOMMAND is sent to the indiciated group (which may
be a group name or an ordinal position in the group list starting
from 0). The valid GROUPCOMMANDs are listed in the next table.
Example:
GROUPCMD alt.test FETCHNEW
|
The following ARexx commands may be sent to a specific group by using the
GROUPCMD command described above:
Command | Parameters | Description |
SAVEOV |
None |
The group overview database for the current group is saved.
The group window for this group must be open for this command to
function. Example:
GROUPCMD 'alt.test' SAVEOV
|
FETCHNEW |
None |
New headers are fetched from the NNTP server. Like all
network I/O in NewsRog, this operation is asynchronous. The
FETCHPENDING command may be used to determine if a FETCHNEW is
currently pending. The group window for this group must be open
for this command to function.
|
FETCHPENDING |
None |
The secondard result variable RESULT is set to 1 if a
FETCHNEW command is currently pending, and to 0 otherwise.
|
EXPIRE |
None |
Old articles are expired from the newsgroup. The group
window for this group must be open for this command to function.
|
OPENFAQLIST |
None |
The FAQ List window for this group is opened.
|
CLOSEFAQLIST |
None |
The FAQ List window for this group is closed.
|
ISFAQLISTOPEN |
None |
The secondard result variable RESULT is set to 1 if
the FAQ List window for this group is open, and to 0 otherwise.
|
OPENARTSEARCHWIN |
None |
The article list search window is opened. The group
window for this group must be open for this command to function.
|
OPENBODYSEARCHWIN |
None |
The article body search window is opened. The group
window for this group must be open for this command to function.
|
BATCHDLHDRS |
None |
Headers for this group will be downloaded in batch mode, even
if the group window is closed.
|
BATCHDLHDRSPENDING |
None |
The secondard result variable RESULT will be set to 1
if a BATCHDLHDRS operation is currently pending, and to 0
otherwise.
|
BATCHDLARTS |
None |
Headers and articles for this group will be downloaded
in batch mode, even if the group window is closed.
|
BATCHDLARTSPENDING |
None |
The secondard result variable RESULT will be set to 1
if a BATCHDLARTS operation is currently pending, and to 0
otherwise.
|
DISPARTCOUNT |
None |
The secondard result variable RESULT will be set to
the number of articles currently displayed in the group's article
list. The group window for this group must be open for this
command to function.
|
GROUPARTCOUNT |
None |
The secondard result variable RESULT will be set to
the number of articles in this group, including even articles not
displayed in the article list. The group window for this group
must be open for this command to function.
|
SETTHREADMODE |
MODE |
The thread display mode for this group is set to MODE, which
must be one of: ALL, BASE, or 1THREAD. The group window for this
group must be open for this command to function. Example:
GROUPCMD 'alt.test' SETTHREADMODE ALL
|
GETTHREADMODE |
None |
The secondard result variable RESULT is set to one of
the following strings according to the current thread mode of the
group: ALL, BASE, or 1THREAD. The group window for this group
must be open for this command to function.
|
ARTBROWSE |
[BACK] [MODE] |
Browse through articles. If the optional BACK argument is
given, then browsing happens backwards. Otherwise it is
forwards. The optional MODE argument may be one of: THREAD, ART,
or NORMAL. NORMAL browsing pages forward in an article until the
end, and then moves to the next article. ART moves to the
beginning of the next article without scrolling the current
article. THREAD browsing moves to the beginning of the next
thread without moving to other articles in the current thread.
The group window for this group must be open for this command to
function. Examples:
GROUPCMD 'alt.test' ARTBROWSE
GROUPCMD 'alt.test' ARTBROWSE THREAD
GROUPCMD 'alt.test' ARTBROWSE BACK ART
|
ARTSCROLL |
[BACK] |
Scroll in the currently displayed article. The optional BACK
argument causes a reverse scroll. The group window for this
group must be open for this command to function. Examples:
GROUPCMD 'alt.test' ARTSCROLL
GROUPCMD 'alt.test' ARTSCROLL BACK
|
ARTICLETOP |
None |
Move to the top of the currently displayed article. The group
window for this group must be open for this command to function.
|
ARTICLEBOTTOM |
None |
Move to the bottom of the currently displayed article. The
group window for this group must be open for this command to
function.
|
DISPART |
POSITION |
Fetch the article indicated by POSITION, which is an ordinal
number in the article list starting from zero, and display it in
the article viewer when it is available. The article will be
fetched from the local disk cache if available, and from the
network otherwise. The group window for this group must be open
for this command to function. Example:
GROUPCMD 'alt.test' DISPART 25
|
SETACTIVE |
POSITION |
The article indicated by POSITION is made the active article
in the article list. If done in BASE thread mode, then this is
the thread that will be entered when the thread mode is changed
to 1THREAD. The group window for this group must be open
for this command to function. Example:
GROUPCMD 'alt.test' SETACTIVE 25
|
ARTFETCHPENDING |
None |
The secondard result variable RESULT is set to 1 if
there are articles currently in the download queue for this
group, and to 0 otherwise. The group window for this group must be open
for this command to function.
|
WINCTRL |
WINDOW POS |
WINDOW may be either ARTLIST or ARTVIEW. POS may be either
BACK or FRONT. The indicated window, if open, is moved to the
back or front of the window stack for this screen. Example:
GROUPCMD 'alt.test' WINCTRL ARTLIST FRONT
|
ARTCMD |
POSITION ARTCOMMAND |
The ARTCOMMAND is sent to the indiciated article, which is an
ordinal position in the current article list starting from 0.
The group window for this group must be open for this command to
function. The valid ARTCOMMANDs are listed in the section on
Article Commands.
|