CF Web>Administration>StaffAway (revision 14)~~EditAttach~~

Staff Absences

Staff Absences

Staff Send E-mail to "cscf-away@cs"

Staff who will not be coming in are requested to send email to cscf-away@cscf.cs to let management know that they will be away and provide a brief summary of the reason. This can include for illness, courses and other ProfessionalDevelopment, vacation, etc.

Updating the "away" File

Updates are usually done by the manager of the person who is away.

Find the File

Since many absences are due to vacations, there is a separate "away" file for each vacation year. The files reside near the page https://www.cs.uwaterloo.ca/cscf/internal/staff-absences/

which may be edited on any of the general.cs Unix systems. The "away" file for the vacation year starting in July of Y1 and ending in June of Y2 resides in

/software/wwwdata_cs.uwaterloo.ca/data/vhosts/cs/cscf/internal/staff-absences/data/

with a name of the form

Y1-Y2

E.g. for the 2010-2011 vacation year, that's

2010-2011

Update the File

Now that multiple people may be updating these files, we use RCS to avoid collisions. Files will be checked in quickly.

For each person, there is a stanza describing days away, and reason, as well as some other data.

The general form of absence dates is:

  Reason:
    Year:
      Month: Day,...,Day

where Day is of the form

  <number>[h[(a)|(p)]]

where h means a half-day absence, and the commented a or p refer to the morning (A.M.) or afternoon (P.M.). e.g.

  Vacation Dates:
    2009:
      Jul: 20h(p),21

means away the afternoon of the 20th, and all day the 21st.

There is a template in ./.ReadMe showing all possible headings, and provides some details about the fields. Comments may be appended to any line by enclosing the comments in parentheses "()".

The fields:

Total Used:
Total Left:
Total Days Sick:

may be left blank, as they can be computed from the absence dates. See ./.Readme for details. If they are non-empty, make sure that they are accurate.

Although not critical, indentation is currently done with a single tab per column, rather than spaces.

Update the WWW Page

Once the file has been updated, run `make` in the containing directory to update the data in ./vacation-staff, which is included by the WWW page ./index.shtml. E.g.

cd ..
make

Tell Staff of the Update

Let cscf-staff@cscf.cs know who's away.

Explicit Example for 2010-2011

On www.cs

On cscf.cs

ssh www.cs
cd /software/wwwdata_cs.uwaterloo.ca/data/vhosts/cs/cscf/internal/staff-absences/data
co -l 2010-2011
vi 2010-2011
...
ci -u 2010-2011
cd ..
make

ssh cscf.cs
cd /autofs/www/cs/cscf/internal/staff-absences/data
co -l 2010-2011
vi 2010-2011
...
ci -u 2010-2011
cd ..
make

Confidentiality

The illness history of staff isn't considered public, so the contents of the "away" files are private. Access is controlled by membership in group "mgmt".

Querying the "away" File

On linux.cs and www.cs there is a command to report on absences; it's called `absences`. E.g.


  linux.cs% absences | align
  2014-2015
  Trevor    39.8
  Ed        13.5
  Adrian      10
  Clayton    8.5
  Fraser     7.5
  Dan          5
  Ronaldo      4
  Lawrence   3.5
  Phil         3
  Dave         2
  Isaac        2
  Guoxiang     1
  Gord         0
  Lori         0
  Mike         0
  Omar         0
  Stephen      0
  Bill         0
  Daniel    -3.5

It defaults to time left to take. Use `absences -v -h` for various options.

Because it exists, one needn't use these fields:

  Total Left           - use `absences left`
  Total Used           - use `absences planned`
  Total Days Sick      - use `absences illness`

in the data.

There's also vacation-left-mail that's used to send reminder mail. And a few other things in /software/absences/maintenance/

Topic revision: r14 - 2015-11-02 - BillInce

Information in this area is meant for use by CSCF staff and is not official documentation, but anybody who is interested is welcome to use it if they find it useful.

Other Webs

My links
- People
- CERAS
- WatForm
- Tetherless lab
- Ubuntu Main.HowTo
- eDocs
- RGG NE notes
- RGG
- CS infrastructure
- Grad images

Edit