wcgstats

wcgstats

This program can be used to retrieve statistics about your projects on World Community Grid as well as about your device(s).

You need to configure wcgstats, see [Configuration], by at least specifying your e-mailaddress and password that you use for World Community Grid, so that the program can retrieve your statistics. Without this precious information there's not much that wcgstats can do for you. Remember to keep your credentials in a safe place.

Default

The default operating mode for wcgstats is to retrieve your basic member statistics, i.e. your personal and your team's scores and rankings by Total Runtime, Generated Points and Returned Results. The output will always be one line (if succesfully retrieved) that will look something like this:
2021-10-10T12:06:02+0000 71:270:14:27:12 1,990 173,400,998 839 616,126 361
Explanation: The line begins with a timestamp (date and time of the last update). What follows are your personal scores and rankings: Total Runtime (in the format years:days:hours:minutes:seconds - in short y : d : h : m : s) and its ranking, then Generated Points and its ranking, then Returned Results and its ranking. Between each of these values there is a tab. The line will be continued with your team's scores and rankings in the same vein as your personal scores and rankings.

See also option -x for extended statistics.

Logfile

You can use this output to write to a logfile on a daily basis where the team statistics are involved, since they are generated once a day. Your personal statistics are generated twice a day. If retrieving the statistics fails in some or other way, nothing will be printed on standard output. So you can be sure that column 1 is always the timestamp and column 7 is always your personal ranking by Returned Results.

Other uses

Other things that wcgstats can do for you, are a.o.:

• to list your known devices, see options -M and -Z
• to list the known science-projects, see options -N and -n
• to look up details of your current results, see option -w
• to add formatting-codes to result-details for posting on the forum, see option -f

In case you're using the option -w you could see something like this, i.e. some details of all results from a certain workunit (of which one result is yours):

MCM1_0190193_1457_0  Android  Error    2022-02-14T10:18:29  2022-02-14T17:08:02   2.32/2.62    19.2/0.0
MCM1_0190193_1457_1  Android  Valid    2022-02-14T10:18:17  2022-02-16T00:03:28  15.00/15.09   81.3/100.5
MCM1_0190193_1457_2  Android  TooLate  2022-02-14T17:08:27  2022-02-24T15:04:53  13.06/27.20  191.0/0.0
MCM1_0190193_1457_3  Android  Valid    2022-02-20T17:08:34  2022-02-22T03:11:21  17.78/24.95  119.7/100.5
MCM1_0190193_1457_4  Android  NoReply  2022-02-21T13:11:34  2022-02-24T13:11:34   0.00/0.00     0.0/0.0 

If you want to switch to using formatting-codes at that point (as if you're using the option -f), you would see:

If you copy this output and post it in the forum of World Community Grid, your result would be recognizable thanks to one line above that starts with [color=blue] and the resultname MCM1_0190193_1457_1 would then turn up in the colour blue.

Options

Main options

Option -f

(This option will query the server of World Community Grid.)
This option tells the program to locate a workunit (see also option -w) and to help generate formatting-code for a post on the forum of World Community Grid.

When a workunit is shown with this option, the same output will be written to a file with its name ending in ".wcgpost". When you quit the program, this file will not be removed, so that you can review the output for later perusal if needed. However, if you specified the option -f twice, this file will be removed after quitting the program.

NB: You may need to install the Term::CharWidth module of Perl. In that case, this is what you should do as superuser:
For users of Fedora: dnf install perl-Term-CharWidth
For users of Ubuntu: apt install libtext-charwidth-perl

Option -g

(This option will query the server of World Community Grid.)
This option will show the daily history of global statistics for a certain science and takes an argument as shown in the column short in the output of option -N.
The list of records that is generated will be shown in reverse chronological order (newest first), listing the date, amount of runtime, number of generated points and number of returned results.
If needed, you can limit the pagesize (the amount of records per page) by using the option -P, you can also specify the pagenumber by using the option -p.
When the statistics are being updated, you may get the message "Statistics update" as output.
If option -f has been specified, forumcodes will be added.

Option -M

This option will list your (numbered) devices, as configured/defined bywcgstats in your setup; add another -M to also show the IDs of your devices, as they are known by World Community Grid.

Option -N

(This option will query the server of World Community Grid.)
This option will show the complete list of projects so far on World Community Grid. The output will look like this (showing three separate entries as an example in a snapshot stemming from 2022):

short     name                                           status        released    completed 
mcm1      Mapping Cancer Markers                         Active        2013-11-08            
scc1      Smash Childhood Cancer                         Intermittent  2017-01-26            
cep1      The Clean Energy Project                       Completed     2008-12-05  2009-10-12

Option -n

(This option will query the server of World Community Grid.)
This option takes an argument of a shorthand for a project, as shown in the column short in the output of option -N, and will display its characteristics.
Example:

Fig.: wcgstats -n zika (snapshot from 2018)

Option -T

This option is actually all about teamcodes. Even if you don't specify a teamcode and query the server, a teamcode needs to be used. Let's see what this means.
First of all, option -T needs an argument. Argument '?' is a possibility: when using this, the program will explain the other possible arguments in short. The other arguments are '=' and 'S' (and using these means that the program will query the server of World Community Grid).
If you want to find out your own teamcode and you have configured the credentials to be used by the program, then specifying just '=' or 'S' is a possibility.
- Specifying just '=' will retrieve your teamcode from the server and print it on standard output.
- Specifying '=' as argument followed by a specific teamcode, e.g. "=NJRC652KS1" (whitespace is not allowed between the '=' and the teamcode), will retrieve the daily statistics for that team.
- Specifying just 'S' as argument will retrieve your own team's daily statistics.

Option -U

This option lets you update the program. The argument specifies the file that is the new version. In this way your credentials inside the program itself will be kept intact.

Option -V

This option shows the version of the program.

Option -w

(This option will query the server of World Community Grid.)
This option tells the program to locate a workunit. You can do this by making use of the option -* or by using other options if you wish, then go interactively from there. See section Locating a workunit below.

When a workunit is shown with this option, the same output will be written to a file with its name ending in ".wcgpost". When you quit the program, this file will not be removed, so that you can review the output for later perusal if needed.

NB: You may need to install the Term::CharWidth module of Perl. In that case, this is what you should do as superuser:
For users of Fedora: dnf install perl-Term-CharWidth
For users of Ubuntu: apt install libtext-charwidth-perl

Option -X

(This option will query the server of World Community Grid.)
This option will show the daily history per app and takes an argument that consists of two parts in this order: a date (formatted as yyyy-mm-dd) and a set of shorthands for science-apps, as shown in the column short in the output of option -N. The date specifies the beginning of the selection (up until today), the set of shorthands specifies which science-apps you want to select.
The two parts are separated from each other by a colon, while the set of shorthands are separated from each other by a comma, e.g. 2022-12-21:arp1,mcm1,opn1.
You may leave out one of the parts (date or shorthands) or both. (If you omit both, you are left with a bare colon : as argument, of course.)
Examples:
2022-12-21: (when you leave out a set of shorthands; it will select all records since that date)
:arp1,mcm1,opn1 (when you omit the date; it will select all records for the three shorthands 'arp1', 'mcm1' and 'opn1')
:mcm1 (this will select all records for shorthand 'mcm1' only, while : will select all records, for any shorthand)
The list of records that is generated will be sorted in reverse chronological order (newest first), listing the date, amount of runtime, number of generated points, number of returned results and shorthand, all pertaining to that day.
If needed, you can limit the amount of records by using the option -L, which is also being regarded as the pagesize here.
If needed, you can specify the pagenumber by using the option -p in combination with option -L (which is being regarded as the pagesize).
See also option -H.

Option -Y and option -y

(Both of these options will query the server of World Community Grid.)
Option -Y will show the daily history for all of your devices, while option -y will show the daily history for a specific device of yours. When using option -y you can specify the device by using the option -m, else you will be asked for it interactively.
The list of records that is generated will be sorted in reverse chronological order (newest first), listing the date, the amount of runtime, the number of generated points and the number of returned results pertaining to that day.
If needed, you can limit the amount of records by using the option -L, which is also being regarded as the pagesize here.
If needed, you can specify the pagenumber by using the option -p in combination with option -L (which is being regarded as the pagesize).
See also option -H.

Option -Z

(This option will query the server of World Community Grid.)
This option will show you a list of your devices by ID, name, operating system, date of registration, date of last returned result and their venue (Default, home, school, work), plus Runtime, Points and Results, all separated by a tab. (A headerline will be inserted only in this case if you also specify option -H.)
By specifying the option -Z twice, wcgstats will show a list of your devices by name, operating system, date of registration, date of last returned result and their venue (Default, home, school, work), while each line will be preceded by a sequential number. (A headerline will be inserted.)
If you have specified option -Z twice in combination with option -R (with a trailing numerical value, see below), three extra columns will appear per device: Runtime (in seconds), Points and Results.
By specifying the option -Z three times, a certain kind of output will appear that can be used as part of the configuration of wcgstats, even in combination with the option -u (for other accounts that you're administering).

Example 1:

Fig.: wcgstats -ZZ

Example 2:

Fig.: wcgstats -ZZZ

You can copy the output of wcgstats -ZZZ and insert it into the configuration. See [Configuration].
Note that the order of the devices is determined by the time their last result was returned, so to obtain a different order you could use let n=1;, let n=2;, etc. instead of let n++; when defining their order.
See also option -R.

Modifiers

Option -A

This option is used to omit ANSI-escape-sequences in the output on your screen.

Option -c

When operating in its default mode, wcgstats will retrieve your basic statistics; in this mode, without specifying option -c, Generated Points, Returned Results and rankings will be displayed by using a decimal separator, i.e. a comma to separate groups of thousands. However, when option -c has been specified the comma will be omitted.

Option -D

This option takes an argument that specifies the name of the directory in which to store temporary files. The default directory is /tmp.

Option -k

This option says to keep the time displayed as a total number of seconds whenever a duration is listed and to not convert that total number of seconds to the format y : d : h : m : s (e.g. 0:001:00:28:48).
This applies to options -X, -Y and -y.
It also applies to wcgstats when operating in its default mode, except that the total runtime of your team will always be displayed as y : d : h : m : s.

Option -R

This option takes an argument that specifies the maximum number of devices to show when using the option -Z. This option might also be useful if you haven't returned a result in a long time (say more than 90 days ago) because of some default values that are used. With this same option -R, one of these default values can be changed instead. Explanation:
pageNumber - The pagenumber of the list (where pageLimit is 20). You can change this value using -RN followed by its new value.
lastResult - The device has returned at least one result within this number of days. You can change this value using -RR followed by its new value. Example: -RR365 (without a space)
installedSince - The device has been installed since this number of days. You can change this value using -RS followed by its new value.
pageLimit - The maximum number of devices to be shown on one page. You can change this value using -R+ followed by its new value. (If you omit its new value (behind the '+'), the default values for installedSince and lastResult will be set to unlimited.)
The option -R can be specified only once, even when using -RN, -RR, -RS or -R+.

Option -u

If you have other accounts, this option lets you specify which other account to use. Probably best practice is to number your accounts 1, 2, 3, etc. Example: wcgstats -u1 lets you download basic statistics for an alternative account that you named '1'.
Note: if you're using crontab to save your personal statistics, this option can also be used to save statistics from other accounts that you administer.

Option -x

When operating in its default mode, wcgstats will retrieve your basic statistics, i.e. your personal statistics and your team's statistics. By using this option your extended statistics will be added. Extended statistics include the scores per project: Total Runtime, Generated Points and Returned Results. Each project will take up one column; the column will consist of the shorthand name and the scores for the project, each value separated by an equals sign (=). Example: scc1=0:032:11:53:46=45,246=136. Each column in the line of output is, as usual, separated by a tab. The output of the program is still one line, symbolically: your personal statistics, tab, your team's statistics, tab, your extended statistics.
See also option -c.

Locating a workunit

Why?

Because you want to investigate what is happening with certain results or what happened to a certain result.

How?

When trying to locate a workunit (when the option -f or -w has been specified), certain options can be used to reach that goal.

Before we dive into the options, there is some casual information about the program when showing workunits.
There are actually two modes for the program when the option -f or -w has been specified: (1) when the workunit-selector is active and (2) when the workunit-displaymode is active. The program starts with the workunit-selector and if successful, it will show one or more workunits, where each result in a workunit will be preceded by the same sequential number between < and > characters. As soon as you select a workunit (by confirming that the first one in the selection should be used or by typing the correct sequential number) you will enter workunit-displaymode where you will be able to view more details of each result in the workunit. After completing this, you will be able to return to the workunit-selector.

Guiding options

Option -*

This option takes an argument that is used to search for an exact match in your current results. Example:

$ wcgstats -w -S -S -* OPN1_0109418_02082_0
* Let's try to locate the workunit.
There are 1028 pages of results available.

* Showing page 746/1028 of all tasks with status ’0’ for all of your devices:
 <1> * OPN1_0109418_02082_0  Linux Fedora  Pending Verification  2022-02-13T21:19:24  2022-02-19T22:41:19
 <1>   OPN1_0109418_02082_1  RHEnterprise  Valid                 2022-02-19T21:19:27  2022-02-19T23:15:40

As you can see, wcgstats is showing one matching workunit (of which one task is yours, denoted by an asterisk between the sequential "<1>" and the resultname "OPN1_0109418_02082_0".
Note: Because of the restricted width of the lines on this page, option -S is being used twice here to omit the columns 'CPU Time' and 'Credit'.
NB: Of course, it goes without saying, if the option -* coincides with any filename beginning with a dash in your current directory, you should prevent expansion of the asterisk and use quotes around the asterisk (-'*') or put a backslash in front of it (-\*).

Option -a

This option takes an argument that is used to select the science application on World Community Grid by their prefix. The default is the value 0, i.e. to select all prefixes. Currently, the available prefixes are: BETA, MCM1, HST1, SCC1, ARP1, OPN1.

Option -L

This option takes an argument to indicate how many of your results (as a maximum) should be downloaded. The default is the value 0, which means that the limit is determined by the server.

Option -m

This option takes an argument that is used to select the ID of your device as configured/defined bywcgstats. The default is the value 0, i.e. to select all your devices.

Option -o

This option reverses the order in which workunits are presented within a page.

Option -P

Normally, a maximum of 15 workunits will be shown on your screen, i.e. one page. This option takes one argument to indicate how many workunits should be shown on one page (as a maximum).

Option -p

This option takes an argument that is used to indicate the pagenumber of your results. The default is 1.

Option -s

This option takes an argument to indicate the value of the Status of a result (i.e. a task). Indicating this value will select all results with this value. Known values are: 1, A, C, E, F, I, L, N, P, Q, S, V, W. The default is 0, i.e. all values. In the table below, the correlation between value and its meaning is shown, i.e. describing the Status of a result.

value	meaning
1	In progress
A	Abandoned
C	Completed
E	Error
F	Validation error
I	Invalid
N	No reply
P	Pending validation
Q	Pending verification
S	Success
T	Too late
V	Valid
W	Workunit error

Option -t

This option takes an argument to express the sorting order of your results. The default is to sort by 'sentTime'. In the table below, the correlation between value and its meaning is shown, i.e. describing the sorting order.

value	meaning
0	sentTime
1	dueTime
2	returnedTime
3	runTime
4	deviceId

Option -z

This option takes an argument that is used to select the device by its sequential number according to World Community Grid. This sequential number always starts at 1. The default is the value 0, i.e. to select all your devices. See also option -Z to list your devices.

More modifiers

Option -e

This option says to add the errorlog to each result in the workunit (in the output of wcgstats, obviously).

Option -G

This option indicates that the shellcommand that would be used to generate the output (showing the workunit) should be inserted when the forumcodes are being used (see option -f), meaning that a line looking like "(Output generated by '...')" will be produced, to be used on the forum. If you specify the option -G twice, a link to the Wiki Homepage of WCGtools will be added.

Option -H

When option -f or -w has been specified, this option indicates that the headertext (of the workunit) should be added. This text involves Project Name, Created, Name, Minimum Quorum and Replication.
This option can also be used in combination with any one of the options -X, -Y and -y. In this case, the headertext involves Statistics date, Runtime, Points and Results.

Option -I

That's a capital i. This option indicates that the URL (of the workunit) should be added. See also option -W.

Option -i

This option indicates that the signature of the program wcgstats should be added.

Option -J

This option indicates that Sent Time, Due Time, Time Returned and Result-ID, for each result in the workunit, should be added to the output.
If option -f has been specified, the URL of a link to the errorlog will also be added.

Option -O

This option indicates that only your own results should be shown (as part of a workunit).

Option -r

This option is used to shorten (reduce) the text in the column 'Status'. The option -r may be repeated, its maximum is four times. In the following table the correlation is shown between how many times option -r is used and its impact on the text in the column 'Status'.

without option -r	with -r	-rr	-rrr	-rrrr
Detached	Detached	Detach.	Dtach	D
Error	Error	Error	Error	E
In Progress	In Progr.	InProgr	InPrg	1
Invalid	Invalid	Invalid	Inval	I
No Reply	No Reply	NoReply	NoRep	N
Other	Other	Other	Other	O
Pending Validation	P. Valid.	P.Valid	P.Val	P
Pending Verification	P. Verif.	P.Verif	P.Ver	Q
Server Aborted	S.Aborted	S.Abort	SAbrt	S
Too Late	Too Late	TooLate	2Late	L
User Aborted	U.Aborted	U.Abort	UAbrt	U
Valid	Valid	Valid	Valid	V
Waiting to be sent	W.2B sent	Waiting	Wait.	W

Option -S

Specifying this option once will omit the column 'Credit'; specifying this option twice will omit the columns 'CPU Time' and 'Credit'. See e.g. the output without option -S:

$ wcgstats -rrrr -w*OPN1_0109418_02082_0
* Let's try to locate the workunit.
There are 1028 pages of results available.

* Showing page 746/1028 of all tasks with status ’0’ for all of your devices:
 <1> * OPN1_0109418_02082_0  Linux Fedora  Q  2022-02-13T21:19:24  2022-02-19T22:41:19    2.55/2.59      88.2/0.0
 <1>   OPN1_0109418_02082_1  RHEnterprise  V  2022-02-19T21:19:27  2022-02-19T23:15:40    1.90/1.90      77.1/77.1

Compare this, with option -S specified once, to:

$ wcgstats -rrrr -w*OPN1_0109418_02082_0 -S
* Let's try to locate the workunit.
There are 1028 pages of results available.

* Showing page 746/1028 of all tasks with status ’0’ for all of your devices:
 <1> * OPN1_0109418_02082_0  Linux Fedora  Q  2022-02-13T21:19:24  2022-02-19T22:41:19    2.55/2.59
 <1>   OPN1_0109418_02082_1  RHEnterprise  V  2022-02-19T21:19:27  2022-02-19T23:15:40    1.90/1.90

Then compare this, with option -S specified twice, to:

$ wcgstats -rrrr -w*OPN1_0109418_02082_0 -S -S
* Let's try to locate the workunit.
There are 1028 pages of results available.

* Showing page 746/1028 of all tasks with status ’0’ for all of your devices:
 <1> * OPN1_0109418_02082_0  Linux Fedora  Q  2022-02-13T21:19:24  2022-02-19T22:41:19
 <1>   OPN1_0109418_02082_1  RHEnterprise  V  2022-02-19T21:19:27  2022-02-19T23:15:40

That isn't the end of the story. You could also specify the option -S three or four times to suppress even more fields.
Specifying the option -S three times suppresses the fields Credit, CPU-time and Due/Returned Time and yields:

$ wcgstats -rrrr -w*OPN1_0109418_02082_0 -S -S -S
* Let's try to locate the workunit.
There are 1028 pages of results available.

* Showing page 746/1028 of all tasks with status ’0’ for all of your devices:
 <1> * OPN1_0109418_02082_0  Linux Fedora  Q  2022-02-13T21:19:24
 <1>   OPN1_0109418_02082_1  RHEnterprise  V  2022-02-19T21:19:27

Finally, specifying the option -S four times suppresses the fields Credit, CPU-time, Due/Returned Time and Sent Time, yielding:

$ wcgstats -rrrr -w*OPN1_0109418_02082_0 -S -S -S -S
* Let's try to locate the workunit.
There are 1028 pages of results available.

* Showing page 746/1028 of all tasks with status ’0’ for all of your devices:
 <1> * OPN1_0109418_02082_0  Linux Fedora  Q
 <1>   OPN1_0109418_02082_1  RHEnterprise  V

Option -v

When using this option, the version of the Operating System will be shown, in the workunit-selector as well as in the workunit-displaymode.
In the workunit-selector you will see something like this:

<12>   MCM1_0190193_1457_0  Android       3.4.0-gad29d11 (Android 6.0.1)
<12> * MCM1_0190193_1457_1  Android       3.4.67 (Android 4.4.4)
<12>   MCM1_0190193_1457_2  Android       4.4.223-g52750b8f2138-ab6846512 (Android 11)
<12>   MCM1_0190193_1457_3  Android       4.19.87-23526978 (Android 12)
<12>   MCM1_0190193_1457_4  Android       5.4.129-23364085-abG991BXXU4BULF (Android 12)

Option -W

This option indicates that the URL of the API page (of the workunit) should be added. Using this URL you will see the details of the workunit in JSON format instead of the output when using option -I (capital i).

So how does a session look like?

Here is an example of a session where a workunit will be located with status 'P' (Pending Validation) or 'Q' (Pending Verification). The field that is named Status in the output will be reduced to 5 characters (thanks to option -rrr). As soon as the workunit is located, its characteristics will be shown, together with its details using forumcodes, so that the output can be posted in the forum (thanks to option -f). Also, the headertext for the workunit will be added (thanks to option -H).

$ wcgstats -frrr -sPQ -H
* Let's try to locate the workunit.

* The following is a list of all your locally defined devices:
seq.  devicename
 <1>  desktop
 <3>  smartphone
 <5>  laptop
 <7>  newlaptop
 <9>  anothercomputer
<11>  sparesmartphone

To locate the workunit, first some questions are asked. The first one:
- What is the sequential <number> of the device? [Z (query the server)/q (quit)/NUMBER] (e.g. 11; 0 = select all, default 1): 0
Let's say you answered 0 (i.e. you selected all devices).
Then the program will explain:
"A task is part of a certain science, named appname here, e.g. MCM1 or HST1." and it will ask:
- What is the (shorthand) name for the task's appname? [<RETURN> to select from list] (e.g. OPN1; 0 = select all): 0
Let's say you answered 0 (i.e. you selected all appnames).
At this point, the program will make a selection of all results and compute the number of available pages:
"There are 2 pages of results available." and it will ask which pagenumber you want:
- What is the pagenumber of the results where the task can be found? [l (last)/q (quit)/PAGENUMBER] (e.g. 4; default 1): 2
Let's say you answered 2 (i.e. you selected page 2).
All workunits of page 2 that you requested will then be shown:
"Showing page 2/2 of all tasks with status ’P/Q’ for all of your devices:"

 <1>   MCM1_0190149_9394_0  Android       Valid  2022-02-14T13:02:10  2022-02-20T13:59:36   21.60/21.91     73.3/76.2
 <1>   MCM1_0190149_9394_1  Android       NoRep  2022-02-14T13:00:49  2022-02-20T13:00:49    0.00/0.00       0.0/0.0
 <1>   MCM1_0190149_9394_2  Android       InPrg  2022-02-20T13:00:54  2022-02-23T13:00:54    0.00/0.00       0.0/0.0
 <1> * MCM1_0190149_9394_3  Android       Valid  2022-02-20T13:10:09  2022-02-21T13:02:13   14.48/14.53     79.1/76.2

 <2>   OPN1_0109556_02075_0  Linux Ubuntu  UAbrt  2022-02-14T08:57:09  2022-02-20T01:01:22    0.00/0.00       0.0/0.0
 <2> * OPN1_0109556_02075_1  Linux Ubuntu  P.Val  2022-02-20T01:01:27  2022-02-21T03:05:46    2.08/2.09      82.2/0.0

 <3>   OPN1_0109405_01935_0  Linuxmint     Error  2022-02-13T15:28:04  2022-02-19T15:28:50    0.00/0.00      77.0/0.0
 <3>   OPN1_0109405_01935_1  Linux Ubuntu  P.Val  2022-02-13T15:28:21  2022-02-14T18:28:24    3.28/3.28      93.7/0.0
 <3> * OPN1_0109405_01935_2  Linux Ubuntu  P.Val  2022-02-19T15:43:31  2022-02-21T02:22:19    2.17/2.19      86.2/0.0

Some more questions will be asked:
- Did this show the desired workunit? [Y (yes)/n (no, next)/p (previous)/l (last)/q (quit)/c (change)/* (match)/PAGENUMBER] y
Let's assume you answered y (which is the default, so just typing a RETURN in this case would also suffice here).

- What is the sequential <number> of the workunit? [q (quit)/NUMBER] (e.g. 3; 0 = none, default 1):
Let's assume you typed a RETURN here (to accept the default value of 1, i.e. the first workunit on the selected page).
At this point, all needed questions are answered and the result can be shown by the program:

"Then this is the result:"

The output above can be posted on the forum and it will also be saved to a file:

"Output is also saved to file ”/tmp/wcgstats.1592027.wcgpost”."

You can then still make some adjustments to the output (or even tweak some more by typing m):
- Is there some output from this result that you want to adjust? [e (add errlog)/r (reduce)/v (show OS version)/f (stop forumcodes)/m (more)/N (no)/q (quit)] m
By typing m you selected more possibilities (i.e. one level deeper) to tweak the output:
- Is there more output from this result that you want to tweak? [H (hide workunitheader)/I (show workunit-URL)/i (show signature)/J (show due time etc.)/O (hide wingmen's tasks)/S (hide CPU-time+credit)/W (use Workunit-URL for the JSON format)/N (no)/q (quit)] q
Typing RETURN here will take you back to the previous level, however typing q will quit the program's session (while it will also remove all temporary files - except the file with its name ending in .wcgpost - that were created by the session).
(NB: The switch 'I (show workunit-URL)' will not be available here if you are in "forumcodes-mode" (see option -f).)

Another way to select a workunit

Let's suppose you want to view some task(s) in a certain workunit of which you know the workunit-ID. It doesn't have to be an ID of a workunit that contains one of your own tasks.

Option -=

This option takes an argument that should be the exact number of an existing workunit-ID (not necessarily from any of your tasks). Example:

$ wcgstats -=203179972 -wS
MCM1_0192028_4303_0  Linux Ubuntu  Pending Validation    2022-11-06T13:02:58  2022-11-07T06:14:08
MCM1_0192028_4303_1  Linux Ubuntu  In Progress           2022-11-06T13:04:02  2022-11-12T13:04:02

Note that you will not be offered any means to modify your view or selection. So if you want to change the view, you need to make a change to the command and run it again. Example:

$ wcgstats -=203179972 -fSrr
[url=https://www.worldcommunitygrid.org/contribution/workunit/203179972][u]workunit 203179972[/u][/url][code]MCM1_0192028_4303_0  Linux Ubuntu  [color=limegreen]P.Valid[/color]  2022-11-06T13:02:58  2022-11-07T06:14:08
MCM1_0192028_4303_1  Linux Ubuntu  InProgr  2022-11-06T13:04:02  2022-11-12T13:04:02
[/code]

This change to the command (using -f instead of -w) just made it suitable to post the output, with formatting, on the forum.