Google
 

Trailing-Edge - PDP-10 Archives - decuslib20-07 - decus/20-0174/office.doc
There is 1 other file named office.doc in the archive. Click here to see a list.








        RESUME*PR  RAM*OFFICE*G  DE*RESUME*PR    M*OFFIC    IDE*RESUME*PROG
        *       PROG          *GUI       M  P    A  O  IC  GU  E          O
        E  ESUME  RO  AM*OFFICE*  IDE*RESU  *    R  *   ICE*   D  RESUME*PR
        D  RESUME  R  RAM*OFFIC  GUIDE*RES  E    G  M    IC    I  *
        I  *RESU  *P  GRAM*OFFIC  GUIDE*RE  M    O  A  O    E  U  E*RESU
        U       UME*       *OFFICE    DE*R  U    R  R  *O  IC  G       S
        G  DE*  SUME  ROGRAM*OFFICE*GU  E*  S    P  G  M*OFFI  *  IDE*RE
        *  IDE*  SUM  PROGRAM*OFFICE*GU  E  ES  E*  O  AM*OFF  E  U
        E  UIDE*  SU  *PROGRAM*OFFICE*  IDE  ESUM  PR  RAM*OF  C  GUIDE*RES
        C  GUIDE*  S          M       *GUIDE*    ME*P  GRAM*O  I          E
      FFICE*GUIDE*RESUME*PROGRAM*OFFICE*GUIDE*RESUME*PROGRAM*OFFICE*GUIDE*RESU
      O      GUID      ME*PROG   *OFFICE      *      *PROGRAM OFFIC  GUIDE*  S
      *  FICE  UI  *RES  E*P  GRA  OFF  E*GUIDE  ESUM  PROGR   OFFI   GUID   E
      M  FFICE  U  E*RES  E  ROGRA  O  ICE*GUID  RESUM  PRO  A  OFF    GU    R
      A  OFFI  *G  DE*R  UM  PROGR  *  FICE*GUI  *RES  E*P  GRA  OF  C    I  *
      R      ICE*      RESU  *PROG  M  FFI    U      SUME  ROGRA  O  IC  GU  E
      G  M*OFFICE  UI  *RES  E*PRO  A  OFFIC  G  DE  ESUM  PROGR  *  FICE*G  D
      O  AM*OFFIC  GUI  *RE  ME*PR  R  *OFFI  *  IDE  ESU         M  FFICE*  I
      R  RAM*OFFI  *GUI  *RE  ME*  OGR  *OFF  E  UIDE  ES  E*PRO  A  OFFICE  U
      P  GRAM*OFF  E*GUI  *RES   *PROGRA      C  GUIDE  E  ME*PR  R  *OFFIC  G
      *PROGRAM*OFFICE*GUIDE*RESUME*PROGRAM*OFFICE*GUIDE*RESUME*PROGRAM*OFFICE*
            RAM    ICE*          M          O      GUI       M          O
           OG  M*OF  CE  UIDE*RESU  *PROGRAM*OF  CE*  IDE*RESU  *PROGRAM*
           R  RAM*OF  C  GUIDE*RES  E*PROGRAM*O  IC  GUIDE*RES  E
           P  GRAM*O  I  *GUIDE*RE  ME*PROGRAM*  FI  *GUIDE*RE  ME*PRO
           *  OGRAM*  F       DE*R       ROGRAM  FF  E*GUIDE*R       R
           E  ROGRAM  F  CE*GUIDE*  SUME*PROGRA  OF  CE*GUIDE*  SUME*P
           M  PROGRA  O  ICE*GUIDE  ESUME*PROGR  *O  ICE*GUIDE  E
           UM  PROG  M*  FICE*GUID  RESUME*PROG  M*O  ICE*GUID  RESUME*PR
            UME    GRAM  FFICE*GUI  *RESUME*P      *OF       I          P
              ME*PROGRAM*OFFICE*GUIDE*RESUME*PROGRAM*OFFICE*GUIDE*RESUME*
                 *PR       F  CE*GUI  *      *       *OFF          R
                ME  ROGRAM*O  ICE*GU  E*R  UME  ROGRA  OF  CE*GUIDE*
                U  *PROGRAM*  FICE*G  DE*  SUM  PROGRA  O  I
                S  E*PROGRAM  FFICE*  IDE  ESU  *PROGR  *  FICE*G
                E  ME*     A  OFFICE  UID  RES  E*PROG  M       *
                R  UME*PR  R  *OFFIC  GUI  *RE  ME*PRO  A  OFFICE
                *  SUME*P  G  M*OFFI  *GU  E*R  UME*PR  R  *
                E*  SUME*  OG  M*OF  CE*G  DE*  SUME*  OG  M*OFFICE*
                 E*R       ROGR    FFIC      E       *PRO          E
                   *RESUME*PROGRAM*OFFICE*GUIDE*RESUME*PROGRAM*OFFIC



                            RESUME Program Office Guide

                                  Donald E. Barth

                                      8-Dec-83


























The student resume system described in this manual was developed at  the
Yale School of Management for the automatic assembly of resume books for
each class of the Masters Degree in Public and Private Management (MPPM)
program.   This manual describes the administrative procedures needed to
prepare for and process the resumes.  A  separate  manual  is  available
which instructs the students in how to enter and edit their resumes.












                           TABLE OF CONTENTS
                           ----- -- --------


      Introduction  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  1

      Overall Description of the Resume Collection Process .  .  2

      The Programs  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  9

      Computer Accounts   .  .  .  .  .  .  .  .  .  .  .  .  . 10

      Files which will Be Stored in the Accounts  .  .  .  .  . 11

      Validation of Accounts From which Programs are Run   .  . 14

      Using the RSMPSW Program to Assign Passwords   .  .  .  . 21

      Preparation for Student Use  .  .  .  .  .  .  .  .  .  . 24

      Instructions for Using the RSMADM Program   .  .  .  .  . 27

      Production of the Resume Book   .  .  .  .  .  .  .  .  . 36

      Using HC Program to Type Resumes to be Photocopied   .  . 41

      Differences Between Typed and Typeset Resume Books   .  . 42

      Conversion from First Year Resume Format to Second Year . 44

      Calculation of File Names Based on Passwords   .  .  .  . 46

      Machine Dependence  .  .  .  .  .  .  .  .  .  .  .  .  . 48

      Differences Between DECsystem10 and DECsystem20 Versions  50

      List of Files Included in this Package   .  .  .  .  .  . 52




                                    INTRODUCTION
                                    ------------

      The RESUME program is a simple line editor and word  processor  designed
      specially  for the production of resumes by the students enrolled at the
      school.  The students use the RESUME program to enter their resumes into
      the  computer.   They  then  run  the program again as many times as are
      necessary to revise their resumes.  When all of students have  completed
      their  resumes,  the resumes can be automatically collected together and
      typed ready to be photocopied and assembled into the resume book.

      Each resume can be limited to just a single page or can be several pages
      in  length.   The  student types as few or as many words on a line as is
      convenient.   The  words  will  be  accumulated   to   form   lines   of
      approximately  equal length in the resume.  The student's name and local
      and permanent addresses appear at the top of the resume.   The  rest  of
      the  resume  is  divided into sections which describe such things as the
      student's education and work experience.  Lines are  ruled  between  the
      sections  and  the  section  names appear in dark lettering at the upper
      left corners of the sections.  Selected words can also  be  darkened  or
      underlined.   Lists  can  be  included  in  which  each  item is shifted
      slightly to the right of the ordinary left margin and is marked  with  a
      bullet.

      The RESUME program is usually liked best by students who have had little
      or  no  previous  computer  experience.  They find that they can use the
      program even without any instruction in its use.  All  of  the  commands
      which  the  student  must  issue to enter a resume or edit it consist of
      short English language words.  The student can type a question mark  for
      a complete description of what the program expects at any point.  If the
      student makes a mistake and issues a command which would  be  likely  to
      damage  the  resume,  then  the program will always tell the student the
      possible consequences and will request confirmation that this really  is
      what the student wants.

      A student who has done no advance preparation usually takes from 3 to  4
      hours,  spread  over several sessions, to compose a new resume using the
      program.  Considerably less time is required to enter the resume if  the
      student  can  be convinced to prepare a rough draft of the resume before
      first using the computer.  Each student can run the RESUME program  from
      a  separate account or all of the students in a class can share a single
      account.  When many students share a single account, the passwords  used
      to  keep  their resumes separate from the rest can either be assigned to
      the students before they run  the  program  or  can  be  chosen  by  the
      students themselves when they first run the program.

      One or more members of the administrative office staff must be available
      to  set  up the central account in which the resumes are stored, to help
      the students enter and modify their resumes, to  proofread  and  correct
      the  resumes  after  the students have finished them, and to prepare the
      typed copies of the resumes which will be  photocopied  to  produce  the
      resulting  resume  book.   The  necessary  administrative  functions are
      enabled for certain accounts for particular classes.  The RESUME program
      can  be  run  by  the  administrator to modify any resume which has been
      finished by the student.  The administrator cannot modify a resume which
2                                            RESUME Program Office Guide


has  not  yet  been  finished by the student.  The student resume system
includes programs which can be run by the administrator  to  change  the
state  of  the  resumes,  to  change the passwords by which the students
access the resumes, and to collect together the final  versions  of  the
resumes so that these can be typed.

The student resume system was developed on a  DECsystem20  computer  and
has  been used over the course of 2 years.  During this time, the RESUME
program has been run by  nearly  600  students.   The  programs  in  the
package  can be run from practically any type of terminal.  The logic in
the programs is written entirely in machine independent FORTRAN.   There
are,  of  course,  sections of the programs which are machine dependent.
These have been localized as much  as  possible  and  should  be  easily
convertible  to  other  computer systems.  A version for the DECsystem10
computer is included.


          OVERALL DESCRIPTION OF THE RESUME COLLECTION PROCESS
          ------- ----------- -- --- ------ ---------- -------

The resumes which have been entered by the  students  are  stored  in  a
central  account  which  is  separate  from  the accounts from which the
students run the RESUME program.  This central account is used to  store
the resumes for all classes.  If each student has an individual computer
account, then the names of the files in which the resumes are stored can
be  based  upon  the  numbers  by  which  the  computer identifies these
accounts.  If several students share a single account, then the names of
the  files are based upon the passwords which the students type in after
starting the program.  Passwords are not needed  if  the  students  have
their  own  individual accounts, but the administrator can still require
that the students use passwords.

When a student runs the RESUME program, the program checks  whether  the
file  containing the current version of the resume exists in the central
account.  If the file exists, then the current version of the resume  is
read  from  this  file.   If the resume has not been submitted, then the
RESUME program will immediately ask the question "WHAT  NEXT?"  and  the
student  can  proceed  to modify the resume or to submit it.  The resume
cannot be modified if it has already been submitted, but the student can
still get a copy of the finished resume.

If the file does not exist and the student is not choosing a password to
gain  access  to  the  resume,  then  it is assumed that this particular
student has not run the program before.  If the file does not exist  and
the  student  is  choosing a password, then the program will ask whether
the student really wants to start a new resume.  This is merely a polite
way  of  asking  whether  the  student  made  an  error while typing the
password.

The student's name is the first thing which the  program  will  ask  for
which  will  appear  in  the resume.  The program then requests, line by
line, the student's address and list of phone numbers.  The program will
ask  whether  a permanent address is to be included in the resume.  If a
permanent  address  is  to  be  included,  then  this  address  and  the
associated phone numbers are also requested line by line.
      Overall Description of the Resume Collection Process                   3


      After  the  addresses  have  all  been  entered,  the  program  reads  a
      description  of the degree program in which the student is enrolled from
      a file which is used for all of the students in  the  same  class.   The
      text  in  this  file is in exactly the same format as the text which the
      student can enter.  The description of the  current  degree  program  is
      appended  to  the  resume  and  is  then  displayed to the student.  The
      program then asks for the student to type in anything else which  is  to
      be  in  the  EDUCATION  section.   The student presses the RETURN key an
      extra time when the EDUCATION section has been completed.   The  program
      then  asks  the  "WHAT  NEXT?" question.  At this point, the student can
      modify the name, the addresses or the EDUCATION section  or  can  create
      new  sections.   If  the file which describes the current degree program
      cannot be read, then the program does not ask for the completion of  the
      EDUCATION  section,  but  instead  immediately  asks  the  "WHAT  NEXT?"
      question after the name and addresses have been entered.

      Each time the student exits from the program, the current version of the
      resume  is  saved  in the central account.  Finally, when the student is
      satisfied with the contents of the resume, the student answers the "WHAT
      NEXT?"  question  by  typing  the word SUBMIT.  This marks the resume as
      being ready to be included in the resume collection.   Once  the  resume
      has  been submitted, it cannot be modified further by the student.  If a
      student submits a resume, but later finds a mistake,  the  administrator
      either  can  modify  the  resume using the RESUME program or can use the
      RSMADM program  to  unsubmit  the  resume.   RSMADM  stands  for  RESume
      ADMinistrator.   If  the  administrator  unsubmits  the resume, then the
      student will have to correct the resume and submit the resume again.

      A number which indicates the state of the resume is  stored  along  with
      the  text  of the resume in the file in the central account.  The resume
      progresses through the following series of states on its  way  to  being
      incorporated  into  the  resume book.  If the resume collection is to be
      typed rather than typeset, then the resume would never reach  the  final
      TRANSMITTED  state.   In  general,  the  resume progresses through these
      states in the order shown.  However, whenever the administrator uses the
      RESUME  program  to  edit  a  resume, the resume is placed in the EDITED
      state even if it was in one of the later states.  It is assumed that the
      resume  would not have been edited unless an error was discovered in it,
      and it would therefore be proofed and either typed or transmitted again.
      The  word  proofed here is taken to mean that the reformatted version of
      the resume has been written into a file which can  then  be  printed  or
      typed.  The word transmitted is taken to mean that a specially formatted
      version of the file containing  the  resume  has  been  copied  into  an
      account which can be accessed by the printing service.

      DRAFT         The student has used the RESUME program to  create  a  new
                    resume,  or  to  modify  it,  but  the student has not yet
                    submitted  the  resume  to  be  included  in  the   resume
                    collection.

      SUBMITTED     The student has used the RESUME program to  indicate  that
                    the   resume  is  ready  to  be  included  in  the  resume
                    collection.
4                                            RESUME Program Office Guide


SUBMIT+PROOF  The administrator has used the RSMADM program to produce a
              paper  copy  of  a  resume which has been submitted by the
              student.  The state of the resume does not change  if  the
              administrator  produces  a paper copy of a resume which is
              in any state other than SUBMITTED or EDITED.

EDITED        The administrator has used the RESUME program to modify  a
              resume  which  was  in  any  state other than the original
              unsubmitted DRAFT state.  The administrator cannot use the
              RESUME  program  to  change  a  resume  which has not been
              submitted, although the administrator could first use  the
              RSMADM program to submit the resume and would then be free
              to edit it.

EDIT+PROOF    The administrator has used the RSMADM program to obtain  a
              paper  copy  of  a  resume  which was in the EDITED state.
              Obtaining a paper copy of a resume which is in  any  state
              other  than  SUBMITTED or EDITED does not change the state
              of the resume.

TRANSMITTED   The administrator has used the RSMADM program to copy  the
              resume  into  the  printing  service  account.  The resume
              remains in the TRANSMITTED state unless it is subsequently
              edited  in  which  case it drops back to the EDITED state.
              It is assumed that it will then be proofed and transmitted
              again.

REPLACED      The administrator has used the RSMADM program to copy  the
              resume  into  a  new file which has a different name.  The
              file having the  original  name  is  then  placed  in  the
              REPLACED  state.   Files  are  copied with different names
              when  the  students  must  access  them   from   different
              individual  accounts, as might happen from one year to the
              next, or when the students want to change the passwords by
              which the resumes are accessed.  This state is not part of
              the regular  progression  from  the  DRAFT  state  to  the
              TRANSMITTED  state.   Files  in  the  REPLACED  state  are
              subsequently ignored by  the  RESUME  program.   For  most
              purposes,  the  file  can  be  thought  of  as having been
              deleted.  If a student selects a password  which  maps  to
              the  same  number as that of a replaced file, then the new
              file will replace the original file when the student exits
              from the program.

BLOCKED       The administrator has used the  RSMADM  program  to  block
              access  to  the  resume.   This  state  is not part of the
              regular  progression  from  the   DRAFT   state   to   the
              TRANSMITTED  state.   The  students  cannot gain access to
              resumes which are in the BLOCKED state.  Students who have
              not  used the computer prior to running the RESUME program
              often do not understand that there can be  several  levels
              of  access  each controlled by separate passwords.  If the
              students share a common computer account, then the  resume
              having  the  same password as that used for gaining access
              to the account should be blocked so that several  students
      Overall Description of the Resume Collection Process                   5


                    don't  each  try  to  use  this common password inside the
                    RESUME program and in  the  process  destroy  each  others
                    resumes.

      When some or all of the resumes have been submitted by the students, the
      RSMADM  program  should  be  run  to  produce  a file which contains the
      reformatted resumes which can be printed on the fast printer.  This will
      change  the  state of these resumes from SUBMITTED to SUBMIT+PROOF.  The
      RSMADM program can only be run from accounts which  are  listed  in  the
      RESUME.WHO file as being used by the administrator.

      The following is a typical dialog which  would  be  used  to  proof  the
      submitted resumes.

      Specify 1 number to select among following functions
      1=List student names, status and numbers in output file
      2=Unsubmit
      3=Submit
      4=Proof
      5=Transmit
      6=Proof and unsubmit
      7=Change number or password or class of resume file
      8=Block file from any further use
      Which function? 4
      Proofs will be in file RESUME.PRF
      CONTINUOUS, PAGED or TYPESET format? C
      Type of bolding (NONE, PRINTER, TYPEWRITER)? P
      Will resumes be selected individually (Y or N)? N
      Process resumes in preselected order (Y or N)? N
      Proof which classes (-1=all)? 85
      Type 1 or more of the following numbers
      0=REPLACED
      1=DRAFT
      2=SUBMITTED
      3=SUBMIT+PROOF
      4=EDITED
      5=EDIT+PROOF
      6=TRANSMITTED
      7=BLOCKED
      Type -1 for all states DRAFT through TRANSMITTED.
      Process which states (-1=all)? 2
      Reject resumes created before what date? 1 AUG 83
      Month:  8, Day:  1, Year: 1983
      Reject resumes created after what date? OCTOBER 30, 1983
      Month: 10, Day: 30, Year: 1983

      If it is desired that the resumes be processed in the alphabetical order
      of  the  students  names,  then  the  RSMADM program will have to be run
      twice.  The RSMADM program would be run the  first  time  to  write  the
      student  names  into  a  file  named RESUME.LST by selecting function 1.
      Then the RSMSRT program would be run to sort the names  and  write  them
      into  a new file named RESUME.SRT.  Finally, the RSMADM program would be
      run a second time to process the resumes in the preselected order.
6                                            RESUME Program Office Guide


The RSMADM program will write the reformatted resumes into a file  named
RESUME.PRF  which should then be printed on the fast printer.  If errors
are seen in the resumes, then the RESUME program  can  be  used  by  the
administrator  to  edit  the resumes.  The RESUME program can be used to
modify any submitted resume if the RESUME program is run from an account
which  is  listed  in the RESUME.WHO file as an account which is used by
the administrator.  The administrator will be asked to specify the class
and  student  number  identifying the resume.  The student number can be
obtained by running the RSMADM program and asking  for  a  list  of  all
resumes for the particular class.

If the students have  chosen  their  own  passwords,  then  the  student
numbers   are   6  digit  numbers  based  upon  the  passwords  and  the
administrator can use either the numbers or the  passwords  to  identify
the  resumes  when  running  the  RESUME  and  RSMADM  programs.  If the
administrator assigned the combination of a number  and  a  password  to
each  student,  then  the  student  number is the number assigned by the
administrator.  If the students are running from their own  accounts  on
either  the  DECsystem10  or  the  DECsystem20  computers  and not using
passwords, then the  student  numbers  are  the  DECsystem10  programmer
numbers.   On  the  DECsystem20, the administrator can issue a TRANSLATE
command to obtain the programmer number.  The programmer number  is  the
second  number which is enclosed in square brackets in the response made
by the  computer.   The  TRANSLATE  command  would  be  similar  to  the
following.

TRANSLATE PS:<S.E.SMITH>

The things which the RESUME program does differently  when  run  by  the
administrator rather than by the students are listed below.

 1.  The administrator can edit any submitted resume.  The administrator
     cannot  edit  a  resume  which  has  not  yet  been finished by the
     student.

 2.  The administrator is asked the "WHAT  NEXT?"  question  immediately
     after  the  EDIT command has performed a single modification of the
     line.  The administrator is not asked if editing of  the  line  has
     been  completed since it is assumed that only minor changes will be
     made.

 3.  The SAVE, EXIT and SUBMIT commands are identical when issued by the
     administrator.   All  of  these  commands  cause the changes to the
     current resume to be saved.  The resume will be marked as being  in
     the  EDITED  state.   The  administrator  is  then  asked to select
     another resume to be edited.  If the administrator issues  a  PAPER
     command,  the  program  will mark the resume as being in the EDITED
     state, will save the changes made by the administrator, will  write
     a  copy  of  the  resume  into a file named RESUME.DOC which can be
     typed or printed later, and will then exit.

 4.  The CANCEL command discards all changes which the administrator has
     made  to  the  current  resume,  but  does not destroy the original
     version.  The resume is not placed  into  the  EDITED  state.   The
     administrator is then asked to select another resume to be edited.
      Overall Description of the Resume Collection Process                   7


      If the administrator  runs  the  RSMADM  program  to  proof  the  edited
      resumes,  then  the  resumes  are  changed  from the EDITED state to the
      EDIT+PROOF state.   If  the  RESUME  program  is  used  to  correct  any
      additional  errors,  then  these  resumes  drop back from the EDIT+PROOF
      state to the EDITED state.

      Finally, when the resumes are seen to be correct, the RSMADM program  is
      run a final time to transmit the resumes.  The RSMADM program can either
      transmit individual resumes identified by student number or password, or
      can  transmit all of the resumes for a particular class or classes which
      are in a particular state or states.  It will  probably  be  desired  to
      transmit all of the resumes which are in the SUBMIT+PROOF and EDIT+PROOF
      states.  The resumes should  be  transmitted  sorted  by  the  students'
      names.   As  described earlier, transmitting the resumes sorted by names
      is a 3 stage process.  First the RSMADM program must be run to produce a
      file  containing  a  listing of the students and the numbers identifying
      their resumes.  Then the RSMSRT program must be run to  sort  the  names
      and  write  these into the RESUME.SRT file.  Finally, the RSMADM program
      is run again to process the resumes in the preselected order.  The files
      which  are written into the printing service account will be given names
      which are identical to the numbers which appear at the left ends of  the
      lines  containing the students' names in the RESUME.SRT file produced by
      the RSMSRT program.

      If individual resumes selected by student number or password  are  being
      transmitted,  then the administrator will be asked for the numbers which
      are to be used as the names of the files which will be placed  into  the
      printing   service  account.   If  the  resumes  being  transmitted  are
      corrected versions of resumes which have already been transmitted,  then
      probably  the  numbers  at  the  left  ends  of the lines containing the
      students' names in the RESUME.SRT file should be used so that the  files
      will  be  assigned  the  same names as when the resumes were transmitted
      earlier.

      The following is a typical dialog which might  be  used  to  transmit  a
      group of resumes in alphabetical order.

      Specify 1 number to select among following functions
      1=List student names, status and numbers in output file
      2=Unsubmit
      3=Submit
      4=Proof
      5=Transmit
      6=Proof and unsubmit
      7=Change number or password or class of resume file
      8=Block file from any further use
      Which function? 5
      Will resumes be selected individually (Y or N)? N
      Process resumes in preselected order (Y or N)? Y
      Transmit which classes (-1=all)? 85
      Type 1 or more of the following numbers
      0=REPLACED
      1=DRAFT
      2=SUBMITTED
      3=SUBMIT+PROOF
8                                            RESUME Program Office Guide


4=EDITED
5=EDIT+PROOF
6=TRANSMITTED
7=BLOCKED
Type -1 for all states DRAFT through TRANSMITTED.
Process which states (-1=all)? 3,5
States:     3     5
Reject resumes created before what date? 1-AUG-83
Month:  8, Day:  1, Year: 1983
Reject resumes created after what date? 30 OCTOBER 1983
Month: 10, Day: 30, Year: 1983

If some of the resumes which are in one of the PROOFED states still have
to be edited, but some are correct and are ready to be transmitted, then
the resumes which are to be transmitted must be selected individually by
number or password.

The following is a typical  dialog  which  might  be  used  to  transmit
individual resumes.

Specify 1 number to select among following functions
1=List student names, status and numbers in output file
2=Unsubmit
3=Submit
4=Proof
5=Transmit
6=Proof and unsubmit
7=Change number or password or class of resume file
8=Block file from any further use
Which function? 5
Will resumes be selected individually (Y or N)? Y
Transmit which class (-1=exit)? 84
Number of individual resume (-2 by password,-1 to exit)? -2
Password? SAMPLE
This password translates to number  90186
*** Description of resume ***
   Name: JOHN McSMITH
Account: S.D.MCSMITH
 Number:  90186, Class:  84, Password: SAMPLE
  Month: 10, Day: 13, Year:   83
 Status: Submitted+Proofed
Is this the correct resume? Y
Processing
  OLD STATUS   NEW STATUS NUMBER CLASS
SUBMIT+PROOF  TRANSMITTED  90186  84 JOHN McSMITH
Number to be name of transmitted file (-1= 90186)? 1
Number of individual resume (-2 by password,-1 to exit)? 508422
*** Description of resume ***
   Name: Jane Jones
Account: S.E.JONES
 Number: 508422, Class:  84, Password: JANE
  Month:  0, Day:  0, Year:    0
 Status: Edited+Proofed
Is this the correct resume? Y
Processing
      Overall Description of the Resume Collection Process                   9


        OLD STATUS   NEW STATUS NUMBER CLASS
        EDIT+PROOF  TRANSMITTED 508422  84 Jane Jones
      Number to be name of transmitted file (-1=508422)? 2

      If the resume book is to be photocopied directly from the copy typed  on
      the letter quality typewriter, then the procedure is much simpler.  When
      all of the resumes are ready to be printed, the RSMADM program is run to
      produce  a  proof  of the entire collection.  In response to the various
      questions asked by the RSMADM program, CONTINUOUS  format  with  bolding
      for  the  TYPEWRITER  is  chosen.   The file is then typed on the letter
      quality typewriter.  If errors are detected in some resumes, then  these
      are  corrected  using  the RESUME program, and the RSMADM program is run
      again later to produce proofs for those which are in the EDITED state.


                                    THE PROGRAMS
                                    --- --------

      The student resume system contains the following 5 programs.

      RESUME  This is the program which is run by the students  to  enter  and
              edit  their  resumes.   This  is  the only program in the resume
              package which the students can run.  The administrator  can  use
              the  program  to  edit  any  resume which has been submitted for
              inclusion in the resume collection.   The  administrator  cannot
              use  the  RESUME  program  to  edit  a resume which has not been
              submitted or to input a new resume.

      RSMADM  This is the program which the administrator uses to perform  all
              routine  manipulations  of the resumes other than the editing of
              the resumes which is done using the RESUME program itself.   The
              RSMADM  program  cannot be run by the students.  The program can
              process resumes selected by class, by state and by date of entry
              or  can  process  individually  selected  resumes.   The  RSMADM
              program can be used to list the resumes, to submit  or  unsubmit
              the  resumes,  to  produce  proofs or final copies of the resume
              book or to change the numbers and the passwords used  to  access
              the  resumes.   It can also be used to copy a special version of
              the resumes to another account which can then be accessed by the
              printing service.

      RSMMIX  This is a program which can  be  run  by  the  administrator  to
              process  the  resumes  before  the students return to modify the
              resumes which  they  entered  the  previous  year.   The  RSMMIX
              program  cannot  be run by the students.  It converts the second
              and subsequent letters in words which  are  formed  entirely  of
              capital  letters  to  small letters.  It is recommended that the
              students' names, company names, school names and  section  names
              be  entirely capitalized if the resumes are typed, but only have
              the first letters of the words capitalized if  the  resumes  are
              typeset.   The RSMMIX program helps in the conversion of resumes
              which were formatted for typing the previous year so that  these
              can  now  be  typeset.   The  RSMMIX  program reads a file named
              RESUME.WRD from the resume storage account which contains a list
              of  words  which are to be kept entirely capitalized.  If a word
10                                           RESUME Program Office Guide


        does not  appear  in  the  RESUME.WRD  file,  then  it  will  be
        converted.   Of  course,  whether  some words are converted will
        depend upon context, and the students will have to  correct  the
        capitalization of these.

RSMPSW  This program can be used to assign passwords selected at  random
        from any text file to the students.

RSMSRT  This is a program which the administrator uses to sort the  list
        of  resumes  produced  by  the  RSMADM program into alphabetical
        order based upon the students' names.  The RSMSRT program  reads
        a file named RESUME.LST from the account in which it is run, and
        writes a sorted list into a file named RESUME.SRT  in  the  same
        account.   The  file containing the sorted list can be typed for
        use by the office staff, or can be read by the RSMADM program to
        allow  it  to  process these resumes in alphabetical order.  The
        RSMSRT program is not protected from use by the students.


                           COMPUTER ACCOUNTS
                           -------- --------

The following accounts must be established in order to use  the  student
resume system.

   1 account in which the resumes for all of the students in all of  the
     classes  are  stored.   The  resumes for different classes are kept
     separate by the use of the class numbers as part of  the  names  of
     the  files.   The resumes for different classes cannot be stored in
     separate accounts.

   1 or more administrative accounts.  If 1  person  is  acting  as  the
     administrator  for all of the classes, then a single account should
     be used.  If there is a different  administrator  for  each  class,
     then  each should use a separate account and each of these accounts
     should be validated for use by the administrator for only 1  class.
     Instructions  for  validating accounts for use by the administrator
     are given later  in  this  manual.   There  can  be  overlap  here.
     Typically,  an  account  used  by  someone on the computer services
     staff would be validated for  use  by  the  administrator  for  all
     possible classes, but the accounts being used by the people editing
     the resumes would be validated only for use  by  the  administrator
     for a small range of classes.

   1 account to be used by the printing service.  This is not  necessary
     if the resumes will be typed rather than typeset.

   1 account from which all of the students in a  particular  class  can
     run the RESUME program.  There should be 1 of these shared accounts
     for each class.  Alternatively, if  the  students  have  their  own
     individual   accounts,  then  they  can  run  from  their  separate
     accounts.
      Computer Accounts                                                     11


      The minimum number of accounts which should be available for the use  of
      the  student  resume package would be 1 more than the number of classes.
      There would then be 1 account to be used by all the students in a single
      class and 1 account to be used both by the administrator and for storage
      of the resumes for all of the classes.

      With a lot of care on the part  of  everyone,  a  single  account  could
      actually  be  used for all of these purposes.  The RESUME.WHO file would
      then have to be  changed  whenever  any  administrative  functions  were
      needed.   The  RESUME.WHO  file would have to be changed back again when
      the students were allowed to run the RESUME program.  The use of just  a
      single  account  would also mean that the files in which the resumes are
      stored would be visible to the students.  The most obvious danger  which
      would  result  from  the  storage of the resumes in the account which is
      used  by  the  students  is  that  any  student  could  accidentally  or
      intentionally  delete  the  files  containing  the resumes of all of the
      students.  Experience with student exercises  in  which  the  files  are
      stored  in  the accounts used by the students has demonstrated that such
      destruction of the files is likely.  Also, processing of the resumes for
      just  a  single  class  would  be difficult if the students from several
      classes shared the same account, since a single account cannot  be  used
      for the entry of resumes having different class numbers.


                     FILES WHICH WILL BE STORED IN THE ACCOUNTS
                     ----- ----- ---- -- ------ -- --- --------

      The following files must be prepared by  the  administrator  before  the
      students  are allowed to run the RESUME program.  These files should all
      be in the resume storage account.

      MESAGE.XXX  contains messages which are to be displayed to the  students
                  in  the class when they run the program.  XXX represents the
                  class number.  If the class number is less  than  100,  then
                  extra  zeros  are  inserted  at the left to obtain 3 digits.
                  This file is not necessary if there are no  messages  to  be
                  sent.

      PASWRD.XXX  specifies the passwords which are assigned to  the  students
                  in  the  class.   XXX  represents  the class number.  If the
                  class number is less than 100, then extra zeros are inserted
                  at  the left to obtain 3 digits.  This file is not needed if
                  the students are not asked for  passwords  or  if  they  are
                  allowed to select their own passwords.

      RESUME.DIR  contains a list of the files in the resume storage  account.
                  This is produced periodically and automatically by the batch
                  job  which  is  controlled  by  the  RESUME.CTL  file.   The
                  administrator could also issue a DIRECT command to construct
                  this file.

      RESUME.WHO  specifies which accounts are to be used by the students, and
                  which  are  to  be  used  by  the  administrator.   For  the
                  students, this file specifies the class number, default type
                  of  terminal,  maximum  length  of  the  resumes and whether
12                                           RESUME Program Office Guide


            passwords  are  used.   For  the  administrator,  this  file
            specifies  what  privileges  are  available  and  for  which
            classes.

RESUME.WRD  contains a list of words which the RSMMIX program is not  to
            convert  from  being entirely capitalized to only having the
            leading letter capitalized.  This file is  not  required  if
            the  RSMMIX program is not used, or if the RSMMIX program is
            not to allow any exceptions.

SCHOOL.XXX  contains the description of the degree program in which  the
            student  is  currently  enrolled.   XXX represents the class
            number.  If the class number is less than  100,  then  extra
            zeros  are  inserted  at  the  left to obtain 3 digits.  The
            contents of this file are inserted into the resume after the
            name  and  address sections when the RESUME program is first
            run  by  the  student.   The  RESUME  program  can   operate
            correctly  without  this  file,  but  it  probably should be
            provided.

The following file should exist either in the resume storage account, or
in  an account which has the account privileges necessary for creating a
file containing a directory of  the  resume  storage  account.   On  the
DECsystem20,  the account containing this file and from which batch jobs
are run which are controlled by this file must also be able  to  expunge
deleted files from the resume storage account.  It is recommended that a
parent account be used on the DECsystem20 so that the  students  do  not
see jobs being run from the resume storage account itself.

RESUME.CTL  is a batch control file for the DECsystem20  which  expunges
            the  resume  storage  account  and  produces a new directory
            file.  A batch job which is controlled  by  this  file  runs
            periodically during the resume season.

The following file contains the RESUME program.  This file should  exist
on the system account from which programs can be run by the students.

RESUME.EXE  contains the RESUME program which can be run either  by  the
            students  or  by  the administrator.  If run from an account
            which is validated as being used by the administrator,  then
            the  RESUME  program  can  be  used  to modify any submitted
            resume.

The following files  contain  programs  which  are  run  solely  by  the
administrator.   These  files can be stored either on the system account
or in the administrative account.

RSMADM.EXE  allows   the   administrator   to   perform   all    routine
            manipulations of the resumes except editing them.

RSMSRT.EXE  sorts a list of student names produced by the RSMADM program
            into alphabetical order based upon the students' last names.
            If the last names are identical, then the  first  names  and
            middle names or initials are used.
      Files which will Be Stored in the Accounts                            13


      The following files are produced when the RESUME program is run  by  the
      students.  These files do not have to be prepared by the administrator.

      RESUME.DOC  (if the student is not using a password)
                  or
      YYYYYY.DOC  (if the student is using a password)
                  contains a reformatted  version  of  the  resume  which  the
                  student  can either print on the fast printer or type on the
                  letter  quality  typewriter.   YYYYYY  is  based  upon   the
                  password  or  identifies  the  account being used to run the
                  program.  If this number is less  then  100000,  then  extra
                  zeros  are  inserted  at the left to obtain 6 digits.  These
                  files are  written  into  the  account  being  used  by  the
                  students  when  the students select the PAPER command in the
                  RESUME program.

      YYYYYY.XXX  contains the text of a single resume.  YYYYYY is based  upon
                  the password or identifies the account being used to run the
                  program.  If this number is less  then  100000,  then  extra
                  zeros  are  inserted  at  the  left to obtain 6 digits.  XXX
                  represents the class number.  If the class  number  is  less
                  than  100,  then  extra  zeros  are  inserted at the left to
                  obtain 3 digits.  Each resume is  contained  in  a  separate
                  file.   These  files  are  written  into  the resume storage
                  account when the students select the commands  EXIT,  PAPER,
                  SAVE  and  SUBMIT in the RESUME program.  The files are read
                  by  the  RESUME  program  when  it  starts,  by  the  RSMADM
                  administrative  program,  and  by  the RSMMIX administrative
                  program.

      The following files are written into the administrator's account  during
      the processing of the resumes.

      RESUME.LST  contains a list  of  the  students  and  the  numbers  which
                  identify  the  files containing their resumes.  This file is
                  written by the RSMADM program when  the  listing  option  is
                  selected.   It  can be sorted into alphabetical order by the
                  RSMSRT program.

      RESUME.PRF  contains the  reformatted  resumes  ready  to  be  typed  or
                  printed.  It is written by the RSMADM program.

      RESUME.SRT  contains a list  of  the  students  and  the  numbers  which
                  identify  the  files containing their resumes.  This list is
                  sorted in alphabetical order based upon the students' names.
                  The  file is produced by the RSMSRT program.  The RESUME.SRT
                  file lists all of the  students  listed  in  the  RESUME.LST
                  file,  but  the  formats  of these 2 files are different and
                  cannot be used interchangeably.  The RESUME.SRT file can  be
                  typed  to  be used as a check-off list.  The RESUME.SRT file
                  can also be read by the RSMADM program to control the  order
                  in which the resumes are to be processed.
14                                           RESUME Program Office Guide


            The procedure which  is  used  to  process  the  resumes  in
            alphabetical  order  based upon the students' names is first
            to run the RSMADM program to select resumes by some criteria
            from  those  listed  in  the  RESUME.DIR  file in the resume
            storage account, and to have the RSMADM  program  write  the
            information  about  these  resumes into the RESUME.LST file.
            Then the RSMSRT program is run to read the  RESUME.LST  file
            and  to  write  the  RESUME.SRT  file.   Finally  the RSMADM
            program is run again to process the  resumes  in  the  order
            indicated by the RESUME.SRT file.


           VALIDATION OF ACCOUNTS FROM WHICH PROGRAMS ARE RUN
           ---------- -- -------- ---- ----- -------- --- ---

The RESUME program and the administrative programs can only be run  from
accounts  which  are specified in a validation file which resides in the
resume storage account.  The validation file  is  named  RESUME.WHO  and
contains  1  line  for each account, or for each group of accounts, from
which the programs can be run.  Lines are read from the validation  file
until a line is found which exactly specifies the account from which the
program is being run or which specifies a group of accounts of which the
current  account  is  a  member.  The subsequent lines in the validation
file are ignored even if they also specify the current account.   It  is
thus  possible to treat a few members of a group of accounts differently
than the rest of the members of  the  group  by  inserting  lines  which
specify  the  accounts  to  be  treated  specially before the line which
specifies the rest of the group of accounts.

A typical validation file is shown below.

1 0 1 2 <S.E.*>           !EVEN NUMBER YEAR CLASS
2 0 1 2 <S.O.*>           !ODD NUMBER YEAR CLASS
3 0 1 2 <S.G.*>           !GRADUATE STUDENTS
4 0 1 2 <S.N.*>           !NON-MAJORS
-1 999 999 2 <S.P.ADMIN>  !FORESTRY SCHOOL ADMINISTRATOR
999 1 1 2 <S.P.FORESTRY>  !FORESTRY SCHOOL STUDENTS
998 1 1 2 <S.D.SMITH>     !TESTING
-3 0 999 2 <S.D.BARTH>    !ADMINISTRATOR
-2 0 999 2 <S.W.JONES>    !WORD PROCESSING
0 0 1 2 <S.*>             !ALL OTHERS
=

The general form of an entry in the RESUME.WHO file is

NUMBER1 NUMBER2 NUMBER3 NUMBER4 <ACCOUNT.NAME>

or

NUMBER1 NUMBER2 NUMBER3 NUMBER4 [PROJECT NUMBER,PROGRAMMER NUMBER]
      Validation of Accounts from which Programs are Run                    15


      where

      NUMBER1 = -1 or less, enables administrative functions
              = -3, allows all administrative functions
              = -2, allows production  of  proofs  of  submitted  resumes  and
                unsubmitting of these same resumes
              = -1, allows editing of submitted resumes
              = 0 through 999, places account into class having this value
              = 1000 or greater, prevents use of the RESUME program

      NUMBER2 = for administrator, is lowest class which can be processed
              = -1 for students, indicates that class is not allow to run now
              = 0 for students, indicates each user has own account
              = 1 for students, indicates all students use  same  account  and
                select their own passwords
              = 2 for students, indicates all students use  same  account  and
                supply both numbers and passwords assigned to them

      NUMBER3 = for administrator, is highest class which can be processed
              = 0 for students, indicates that the final copies of the resumes
                in the resume collection will be typeset
              = 1 or greater for students, is  the  maximum  number  of  pages
                which  can  be  included  in  a submitted resume which will be
                typed on the letter quality typewriter

      NUMBER4 = 0, any terminal which  does  not  fit  one  of  the  following
                classifications
              = 1, video terminal which scrolls
              = 2, video terminal which scrolls and on which form feeds  clear
                the screen

      Anything which appears to the right of an exclamation point  is  treated
      as  a  comment  and is ignored.  The end of the file is marked by a line
      which starts with an equal sign.  The line which starts  with  an  equal
      sign and all lines which follow the line which starts with an equal sign
      are ignored.  It is not necessary however that the end of  the  file  be
      marked by a line which starts with an equal sign.

      The numbers which can appear on each line are described in  more  detail
      below.

      NUMBER1 = specifies the class number  which  will  be  assigned  to  the
                accounts  matching  the  specification  on  the  current line.
                NUMBER1 can also be used to grant administrator privileges  to
                the account.

              = -1 or less, the account can  be  used  by  the  administrator.
                NUMBER2  and NUMBER3 are taken as the lowest and highest class
                numbers associated with the resumes  which  can  be  processed
                from this account.

              = -3, enables all administrative functions.  The RESUME  program
                can  be used to edit any submitted resume.  The administrative
                programs can be used for all administrative functions.
16                                           RESUME Program Office Guide


        = -2, enables word processing functions only.   The  RESUME  and
          RSMMIX programs cannot be run.  The RSMADM program can be used
          to produce a file containing the  formatted  versions  of  the
          resumes  which the students have submitted.  These resumes are
          then marked as not having been submitted so that  the  resumes
          can be revised further by the students.  All resumes for which
          the class  numbers  are  in  the  range  NUMBER2  through  and
          including NUMBER3 and which are in the SUBMITTED or any higher
          state will be processed.  The RSMADM program cannot be used to
          perform  any other function.  The resulting file must be typed
          on the letter quality typewriter.

        = -1, enables publication office  functions  only.   The  RESUME
          program can be used to edit any existing resume which has been
          submitted by the student.  The administrative programs  cannot
          be run.

          For example, if the file contained the lines

          -1 999 999 2 <F.PUBLICATIONS>
          -3 999 999 2 <F.STAFF>       !COMPUTER SERVICES STAFF
          -1 1 4 2 <S.PUBLICATIONS>
          -3 1 4 2 <S.STAFF>           !COMPUTER SERVICES STAFF

          then the  account  <F.PUBLICATIONS>  would  be  able  to  edit
          submitted    resumes   for   class   999   and   the   account
          <S.PUBLICATIONS> would be able to edit submitted  resumes  for
          classes  1 through 4.  The account <F.STAFF> could perform all
          administrative  functions  for  class  999  and  the   account
          <S.STAFF>  could  perform  all  administrative  functions  for
          classes 1 through 4.

        = 0 through 999, allows the account to be used to run the RESUME
          program  to  create  or  modify  a resume.  The administrative
          programs cannot be run.  NUMBER1 is  taken  to  be  the  class
          number.  The RESUME program works identically for all classes.
          The class number appears in the name of the file in which  the
          resume  is  stored so that the resumes for the various classes
          can be kept separate.  The class number also  determines  from
          which file the description of the current degree program is to
          be read and which messages are to be shown to the students.

        = 1000 or greater, prevents running of the  programs  from  this
          account.   The programs also cannot be run from accounts which
          do not match any  of  the  accounts  specified  in  the  file.
          However,  putting  in  a line with NUMBER1=1000 can be used to
          block use of the programs by a subset of a group  of  accounts
          validated by a later line.

          For example, if the file contained the lines

          1000 0 0 2 <S.O.SMITH>
             2 0 0 2 <S.O.*>
      Validation of Accounts from which Programs are Run                    17


                then accounts such as <S.O.JONES> and <S.O.JOHNSON> which  are
                validated  by  the second line would be able to run the RESUME
                program, and would be taken to be in class 2, but the  account
                <S.O.SMITH> would not be able to run the program.

      NUMBER2 = if NUMBER1 is -1 or less so that administrative functions  are
                enabled  for  this  account, then NUMBER2 specifies the lowest
                class number of the resumes which can  be  processed  by  this
                account.

              = if NUMBER1 is  in  the  range  0  through  999,  then  NUMBER2
                specifies  whether each student will use a separate account or
                whether the students will run the RESUME program from a shared
                account.   If  the  students  run  the  program  from a shared
                account,  then  NUMBER2  also  specifies  whether   they   use
                passwords  which are assigned to them or will choose their own
                passwords.

                All of the accounts which are used by the students in the same
                class must have identical values for NUMBER2.  If it is really
                desired that some of the students  in  a  particular  academic
                class  run from a common account and use passwords to get into
                the program and that other students  in  the  same  class  use
                their  separate accounts without issuing passwords to get into
                the  program  (they  still  would  have  to  use  their  login
                passwords  to  gain  access  to  their  accounts) then these 2
                groups of students should  be  assigned  different  values  of
                NUMBER1  and  each  of these groups would need to have its own
                separate default education and message files.  The reason  for
                this  is  that the names of the resume storage files are based
                only on the  value  of  NUMBER1  and  a  second  number  which
                represents  either  the  password or the account.  The program
                protects against ambiguity in the conversion of  the  password
                to  a number, and the account numbers are unique, but there is
                no protection against the password being converted to a number
                which  happens  to  also  be  the  account  number  of another
                student.

                For example, a student running from  a  shared  account  might
                choose  the letter Z as a password which would be converted to
                the number 26.  If the same class number were  used  both  for
                students running from the shared account and for those running
                from individual accounts, then a student running  the  program
                later  from an individual account for which the account number
                also happened to be 26 would gain access to the resume started
                by the first person.

              = -1, and if NUMBER1 is in the range 0  through  999,  then  the
                members of the class are told that they are not allowed to run
                the RESUME program at this time, but any messages in the  file
                named MESAGE.XXX, where XXX is the class number, are displayed
                to them before they are kicked off.  The students will not  be
                asked  for  their  passwords,  and  will not be able to obtain
                paper  copies  of  their  submitted  resumes.   NUMBER1  could
                instead  be  set  to 1000 to prevent the students from running
18                                           RESUME Program Office Guide


          the program, but the students would then be told that they are
          not  authorized  to  run  the  program and no special messages
          would be displayed.

        = 0, and if NUMBER1 is in the range 0 through 999,  then  it  is
          expected  that each student has a separate account.  There can
          only be 1 resume associated with each of these accounts.   The
          student  will  not  be  asked to supply a password to identify
          which resume belongs to the student.

        = 1, and if NUMBER1 is in the range 0 through 999, then  several
          students can use the same account.  The student can access any
          resume for the current class for which the password is  known.
          To  create  a  new resume the student merely enters a password
          which is not already in use.   It  is  not  necessary  that  a
          resume which is to be modified have been created from the same
          account, only that it  have  been  created  using  a  password
          chosen  by  the  student from an account having the same class
          number.  There might, for example, be 5 accounts any of  which
          could  be  used by any of the students at any time, but all of
          these accounts would need to have the same value of NUMBER2.

        = 2, similar to NUMBER2=1, except that the student  must  supply
          both  a  number  and  a  password  which  the  RESUME  program
          administrator has assigned to the student.   This  number  and
          password  combination  must  appear in a file named PASWRD.XXX
          where XXX is the class number.   This  file  must  be  in  the
          resume  storage account.  Each line in this file starts with a
          number which must be unique to  that  student  in  the  class,
          followed  by  1  or  more  spaces and then by a password to be
          associated with this number.  The number must be in the  range
          0  through  999999  and  must be composed only of the digits 0
          through  9.   It  is  recommended  that  there  not   be   any
          duplication   of  the  passwords  within  a  class,  but  such
          duplication will not cause the programs any  difficulty.   The
          password  can  consist of 1 or more words.  Spaces between the
          words merely mark word boundaries.  It does not matter if just
          1  or several spaces appear between the words.  An exclamation
          mark followed by a comment or by the student's name can appear
          to  the  right  of  the  password.   The  following would be a
          typical line in the password file.

          2164 sticks and stones!John Doe

          The file can be terminated by a  line  which  starts  with  or
          contains  only  an  equal  sign,  although  such a line is not
          necessary.  Any lines following the line which starts with the
          equal  sign will not be read and will be ignored.  The student
          must type at least 1 space between  pairs  of  words,  and  at
          least  1  space  must appear between the words on the lines in
          the file, but the exact number  of  spaces  is  ignored.   The
          password  can  contain  up  to  20  characters,  counting  the
          separations between words as 1 character each.  The  passwords
          can  be constructed from any printing characters.  The capital
          and small forms of the alphabetic  letters  A  through  Z  are
      Validation of Accounts from which Programs are Run                    19


                considered  to  be  equivalent,  both  in  the file and in the
                password typed by the student.

      NUMBER3 = if NUMBER1 is -1 or less so that administrative functions  are
                enabled  for  this account, then NUMBER3 specifies the highest
                class number of the resumes which can  be  processed  by  this
                account.

              = if NUMBER1 is  in  the  range  0  through  999,  then  NUMBER3
                specifies  whether the final resumes will be typed on a letter
                quality typewriter or will  be  typeset.   Most  installations
                will  select the typed option here.  The page width and length
                for typeset resumes are based upon a particular type font, and
                the  installation  will  have  to arrange for insertion of the
                proper typesetting commands and for the shipping of the files.

              = 0, and if NUMBER1 is in the range  0  through  999,  then  the
                width and length of the pages will be based on the proportions
                of a particular type font.  More characters will be allowed on
                a  line  which  contains many narrow characters such as 1 or I
                than on lines which contain many wide characters such as M  or
                W.   The  tables  now  in  the program are for the Univers (no
                final letter e)  type  font  as  produced  on  a  Mergenthaler
                typesetter.   These  tables  were  obtained  by  measuring the
                widths of the characters on existing  typeset  resumes.   They
                are   not  based  upon  any  specifications  provided  by  the
                manufacturer of the typesetter.  Conversion  to  another  type
                font  would  be  much  easier if such tables could be obtained
                from the manufacturer.

              = 1 or greater, and if NUMBER1 is in the range  0  through  999,
                then  NUMBER3  is  the  maximum  number  of pages which can be
                included in a submitted resume which  will  be  typed  on  the
                letter  quality typewriter.  The width and length of the pages
                will be based on that appropriate for typing at 12  characters
                per  inch  and  6  lines per inch on an 8 1/2 by 11 inch page.
                Resumes to be included in the resume book should be limited to
                a  single  page.   However,  after  the  resume  book has been
                completed, the limit should probably be increased to 4  or  5.
                Putting  in  a  value  of  over 5 would be pointless since the
                array space in the program is dimensioned for a maximum of 300
                lines.

      NUMBER4 = specifies the type of terminal which will be used by  most  of
                the  students  using this account.  This specifies the general
                type  of  display,  not  the  particular  brand  or  model  of
                terminal.   If some students use a different type of terminal,
                then these students will have to specify the type of  terminal
                which  they  are  using  each  time  that  they run the RESUME
                program.  The terminal type can be  changed  either  when  the
                RESUME  program asks if the student wants general instructions
                or any time the program asks the "WHAT  NEXT?"  question.   If
                NUMBER1  is  -1  or  less,  then NUMBER4 specifies the type of
                terminal which will be used  by  the  administrator  when  the
                RESUME program is used to edit submitted resumes.
20                                           RESUME Program Office Guide


        = 0, the terminal produces paper output or does not match any of
          the other terminal types supported by the RESUME program.

        = 1, the terminal is a video terminal which  scrolls  the  lines
          currently  being displayed upwards to display the new lines at
          the bottom and to discard the oldest lines at  the  top.   The
          terminal cannot clear the screen when a form feed character is
          issued.  The screen can display 24 lines of 80  columns  each.
          The  RESUME  program  will  scroll short dialogs but will stop
          whenever the screen fills and wait for the  student  to  press
          the  RETURN key when typing drafts or proofs of the resume and
          when typing lengthy help messages.  The  program  will  scroll
          the  next  page  of  text  onto  the  screen after the student
          presses the RETURN key.

        = 2, same as NUMBER4=1 except that the screen can be cleared  by
          issuing a form feed character.  The RESUME program will scroll
          short dialogs, but will clear the screen before typing  drafts
          or proofs of the resume and before typing lengthy instructions
          or help messages.  Whenever the screen fills  when  drafts  or
          proofs  or long help messages are being displayed, the program
          will stop and wait for the student to  press  the  RETURN  key
          before  clearing the screen again and then displaying the next
          page of text.

The accounts which can be used to run the programs are specified by name
on  the  DECsystem20.   Accounts  are  arranged in a tree structure with
periods separating the list of nodes.  The account names which appear to
the  right of the numbers in the validation file should be preceded by a
less than sign and followed by a greater than sign although any sequence
of  printing  characters which does not start with a left square bracket
is also taken to be an account name.   There  must  not  be  any  blanks
either between the leading less than sign and the name of the account or
within the name of the account.  The alphabetic letters A through  Z  in
the account names can appear in either upper or lower case.  An asterisk
can be included at the right end of the account name if any sequence  of
nodes  is  to  be  allowed  starting at that point.  A period can appear
between the names of the nodes to the left and the asterisk but  is  not
required.   In  order  to be matched, the name of the account being used
must include a node at the location of the asterisk.   An  account  name
consisting  only  of  nodes  to the left of the location of the asterisk
will not be matched.

For example,

1 0 0 0 <*>         !allows any account

1 0 0 0 <S.O>       !allows <S.O> but not <S.O.SMITH> or <S.O.JONES>

1 0 0 0 <S.O.*>     !allows <S.O.SMITH> and <S.O.JONES> but not <S.O>

1 0 0 0 <S.O*>      !same as the above

1 0 0 0 <S.O.SMITH> !allows <S.O.SMITH> but not <S.O> or <S.O.JONES>
      Validation of Accounts from which Programs are Run                    21


      The accounts which can be used to  run  the  program  are  specified  by
      numbers  on the DECsystem10.  Each purpose for which the computer can be
      used is assigned a project number and these project numbers  are  paired
      with  a  programmer  number  which identifies a particular person who is
      allowed to use the computer.  The project  and  programmer  numbers  are
      octal  numbers,  and  never include either of the decimal digits 8 or 9.
      Accounts are specified in the validation file by a left square  bracket,
      followed  by  the  project  number, a comma, the programmer number and a
      right square bracket.  Spaces can appear on either side of  the  numbers
      and  can  replace  the  separating  comma.   A  question mark can appear
      anywhere in either number where any digit is to be allowed.  An asterisk
      can  appear instead of a number if any number is to be allowed.  A comma
      can separate the asterisk from the other number but is not necessary.

      For example,

      1 0 0 0 [201,3556]  !allows programmer 3556 to use project 201

      1 0 0 0 [*,3556]    !allows programmer 3556 to use any project

      1 0 0 0 [*3556]     !same as the above

      1 0 0 0 [201,*]     !allows any programmer to use project 201

      1 0 0 0 [?01,*]     !allows any programmer to use project 1 or 101
                          !or 201 or 301 or 401 or 501 or 601 or 701
      1 0 0 0 [?01*]      !same as the above


                    USING THE RSMPSW PROGRAM TO ASSIGN PASSWORDS
                    ----- --- ------ ------- -- ------ ---------

      The students can be required to use a number and a password assigned  to
      them  by the administrator to identify themselves to the RESUME program.
      This feature is enabled by setting NUMBER2 to have the value  2  in  the
      entry  in  the RESUME.WHO file for the account or accounts being used by
      the students.   The  instructions  for  validating  accounts  should  be
      consulted for additional information.

      The numbers and the passwords by which the students identify  themselves
      to  the  RESUME  program  must  be specified by a file named PASWRD.XXX,
      where XXX is the class number.  There must be one of these files in  the
      resume  storage  account  for  each  class for which passwords are being
      assigned.  Each line in this file contains  a  number  followed  by  the
      associated  password.   An  exclamation  point followed by a comment can
      appear to the right of the password.  The comment might consist  of  the
      students'  names  to aid a visual search of the file, but the comment is
      ignored by the password checker in the RESUME program.  The file can  be
      terminated  by a line starting with an equal sign and containing nothing
      else.

      Although the password file could be constructed by  hand,  selection  of
      hundreds  of  such  passwords  soon  becomes  a  mental word association
      exercise.  Provided that a file which contains a  list  of  the  student
      names  and  any arbitrary text file containing at least several pages of
22                                           RESUME Program Office Guide


text are available, the RSMPSW program can be used to  select  words  at
random from the text file and assign these as passwords to the students.
Each line in the resulting  file  contains  a  number,  a  password,  an
exclamation point and the student's name.

The RSMPSW program also produces a second file  which  can  be  used  to
insert  the  student's  name,  number  and  password  into a form letter
telling the student how to gain access to the RESUME program.  This file
contains  2  lines for each student.  The student's name is on the first
line and the number and password are on the second line.  This  file  is
meant  to be processed, along with a file which describes the basic form
letter, by the FROFF word processor.   An  example  of  the  file  which
describes the basic form letter is shown below.

.open splice.loop;To:
.splice 1.skip
You will use the following number and password to identify
yourself when you run the RESUME program.
.skip.indent 5.splice 1.skip
This password was chosen at random from a list of common
short words.  You can type the number and the password on
the same line, or you can type the number on the first line,
and the password on the next line.
.skip
If you have any difficulties with the program, please
contact the RESUME program administrator.
.reset.end loop

The .OPEN SPLICE and .LOOP commands at the start of  the  file  and  the
.RESET  and  .END LOOP  commands  at  the  end  merely  prepare  for and
terminate each form letter respectively.  The .SPLICE  1  commands  each
insert  the  contents  of the next line from the second file produced by
the RSMPSW program at that point into the letter.

The file of student names which is processed by the RSMPSW program  must
contain only 1 name per line.  The maximum length of a single name is 40
characters, counting each of the spaces between words.   The  names  are
copied into the resulting files in the order in which they appear in the
original file.  It is suggested that these names should have been sorted
in alphabetical order before they are processed by the RSMPSW program so
that a visual search can be used to locate  the  entry  belonging  to  a
particular  student.   It should be noted that the RSMMIX program is not
meant to be used for sorting these names.

The RSMPSW program can  extract  passwords  from  any  text  file  which
contains  enough  words  so  that  the same password does not have to be
assigned to many students.  The RSMPSW program would  operate  correctly
even  if  this  file  only  contained  a  single word, but the resulting
duplication of passwords wouldn't really  be  acceptable.   However,  it
doesn't matter if a few of the students have the same password, since it
is only the combination of number and password  which  must  be  unique.
The  lines in the file can each contain up to 80 characters.  Only words
containing from 4  to  8  letters  each  are  used  as  passwords.   The
passwords  can  also  be  based  upon the file named RSMPSW.DAT which is
supplied with this package.  The RSMPSW.DAT file contains 5000 different
      Using the RSMPSW Program to Assign Passwords                          23


      words 4 to 8 letters in length sorted by the frequency of the appearance
      of these words in a variety of text  files  which  originally  contained
      over 7.5 million words.

      The RSMPSW program is able to skip over any number of initial  words  in
      the  file  from  which  the  passwords  are being extracted.  The RSMPSW
      program stores 250 words read from the file in a hopper.  The  passwords
      are  selected from this hopper at random and are then discarded from the
      hopper.  If only a fraction of the words in the file are being  used  as
      passwords,  then the words which are to be discarded without having been
      used are also selected at random from the hopper.  When  the  hopper  is
      empty,  the  next  group of words read from the file are placed into the
      hopper.  Once all of the words in the original file have been processed,
      the  hopper  is  filled  with  words from the start of the original file
      again.  Duplicates are discarded each time the hopper is filled,  but  a
      password  assigned  in  1 filling of the hopper might have appeared in a
      previous filling of the hopper.

      The RSMPSW program asks the following questions.

      FILE CONTAINING LIST OF STUDENT NAMES?
      FILE CONTAINING LIST OF PASSWORDS?
      OUTPUT FILE FOR PASSWORD CHECKER?
      OUTPUT FILE FOR WORD PROCESSOR?

      These questions merely establish the names of the various files.  On the
      DECsystem10  and DECsystem20 computers, these file names must consist of
      1 to 6 letters or digits, a period which must be typed, and an  optional
      1 to 3 letters or digits.

      KERNEL FOR RANDOM NUMBERS?

      Either zero or a positive integer should be typed in  response  to  this
      question.   The  number  is used to select the sequence of numbers which
      are returned by the random number generator.

      DISCARD HOW MANY INITIAL PASSWORDS?

      Discarding the initial passwords is really useful only if a single large
      file  containing  many possible passwords is being used repeatedly.  The
      number typed here would then be the number of  passwords  processed  the
      last  time  that  passwords were selected from the file.  If a different
      file is being used, or if a different sampling interval selected by  the
      next  question  is being used, or if the file was scanned more than once
      the last time, then 0 should be typed here.

      ON AVERAGE, USE 1 PASSWORD OUT OF HOW MANY?

      If the same large file containing many possible passwords is being  used
      repeatedly,  and  if  the  contents  of  this file might be known by the
      students, then a portion of the possible passwords can  be  rejected  to
      make  guessing  the  passwords  based  upon  the  known  contents of the
      original file more difficult.  If either 0 or 1 is typed here, then  all
      of  the  passwords  in  the  file  will  be  used until enough have been
      obtained.  If a number greater than 1 is typed here, then  this  is  the
24                                           RESUME Program Office Guide


number  of  possible  passwords which are discarded each time 1 is used.
If 10 is typed here, then only 1 out of 10 possible passwords is used.

NUMBER TO ASSIGN TO FIRST STUDENT?
INCREMENT EACH STUDENT NUMBER HOW MUCH?

The answers to these questions are used to obtain the numbers which  are
assigned to the students.  If the initial number is 10 and the increment
is 5, then the students would be assigned the numbers 10,  15,  20,  25,
etc.


                      PREPARATION FOR STUDENT USE
                      ----------- --- ------- ---

Preparation for the use of the student resume system  on  a  DECsystem20
computer is described below.

 1.  Build the account in  which  the  resumes  will  be  stored.   This
     account should have the following characteristics:

     A.  Disk storage allocation of about 2  pages  per  student.   Most
         resumes  require just 1 page, but some require 2, and there has
         to be room for a modest set of deleted  former  versions  which
         have  not  yet been expunged.  There should also be enough disk
         allocation for a duplicate set of resumes for any class.   This
         is  necessary  since  the RSMADM program produces a new copy of
         each resume each time that the resume changes state.

     B.  Default  file  protection  of  776400.   This  prevents   other
         accounts  from  using  the  directory commands to find out what
         files are in the account.  The files can be overwritten by  new
         versions.

     C.  Directory protection of 774400.  This allows  accounts  in  the
         proper  user  group  to write new files into the resume storage
         account.

     D.  Directory group the same as the  user  group  of  the  accounts
         which  will  run  the  RESUME program.  If this cannot be done,
         then  make  sure  that  the  right  2  digits  of  the  various
         protection  codes  are  all  the  same  as  the middle 2 digits
         instead of 00.

     E.  The resume storage account must contain several files which are
         to be read from the students' accounts, but which should not be
         able to be rewritten from these accounts.  These  files  should
         have 775200 protection.
      Preparation for Student Use                                           25


               MESAGE.XXX  optional initial messages for class XXX
               PASWRD.XXX  optional passwords for class XXX
               RESUME.DIR  required to  run  RSMADM  program.   This  file  is
                           created   by   the  batch  job  controlled  by  the
                           RESUME.CTL file.
               RESUME.WHO  required to validate accounts
               RESUME.WRD  optional file used by RSMMIX program.
               SCHOOL.XXX  optional EDUCATION section for class XXX

               The contents of these files are  described  elsewhere  in  this
               manual.

           F.  The following file should be stored in an account  which  is  a
               parent of the resume storage account.

               RESUME.CTL  file which controls the batch job which  creates  a
                           directory  file  in  the  resume  storage  account,
                           expunges the resume storage account,  then  submits
                           itself to be run again later.

       2.  Insert the name of the account where the  resumes  will  be  stored
           into  the  DATA statement which defines the NUMDIR character string
           in the BLOCK DATA routine.   This  character  string  must  contain
           exactly 40 characters.  Fill out the right end of the string beyond
           the end of the name with spaces.  Do not include the less than  and
           greater than signs in the name.

       3.  If the resume storage account already exists, delete any resumes in
           it from the previous graduating class.

       4.  Validate an account or accounts to act as the  various  classes  of
           administrator  by inserting their account names into the RESUME.WHO
           file.   Instructions  for  validating  these  accounts  are   given
           elsewhere in this manual.

       5.  If this is the first year that these particular students  have  run
           the  RESUME  program,  validate  their accounts by inserting a line
           describing their accounts into the RESUME.WHO file.

       6.  If the students are all to use a single account to run  the  RESUME
           program,  set up this account.  It should be in the same user group
           as the directory group of the resume storage account.  Insert  this
           account  name  into  the  RESUME.WHO  file  and  indicate  that the
           students must use passwords to run the RESUME program.

       7.  If the passwords are to be assigned to the  students,  rather  than
           selected  by  the students, then construct a file named PASWRD.XXX,
           where XXX is the class number, in the resume storage account.  This
           should  have 775200 protection.  This file can be constructed using
           the RSMPSW program, or by hand using a text editor.   The  contents
           of  this  file  and  the  use  of  the RSMPSW program are described
           elsewhere in this manual.
26                                           RESUME Program Office Guide


 8.  If resumes from the previous year are to be used again,  but  words
     which  were  entirely  capitalized  are  to  have  the  second  and
     following letters converted to lower case, then  construct  a  file
     named RESUME.WRD containing any words which are to be left entirely
     in upper case.  The contents of the RESUME.WRD file  are  described
     elsewhere  in  this manual.  Then run the RSMMIX program to perform
     the conversion on all words except those listed in  the  RESUME.WRD
     file.

 9.  If the resumes from the previous year are to be used again,  change
     the  validation  of  the student accounts in the RESUME.WHO file to
     indicate whether the final output is to be typed or typeset.

10.  If this is the first year that the students in this class have used
     the RESUME program, construct a file named SCHOOL.XXX, where XXX is
     the class number, which describes the degree program in  which  the
     students  are  enrolled.   The  first  line should contain only the
     EDUCATION section name.  The next lines should define the  contents
     of  the  start of the EDUCATION section.  An asterisk should appear
     at the start of each line which is also to start a new line in  the
     finished  resume.  If the second line starts with an asterisk, then
     it will appear 1 line below the section name in the resume.  If  it
     does  not  start  with an asterisk, then it will appear on the same
     line but to the right of the section  name.   Use  circumflexes  in
     front  of each word of the school name to indicate that these words
     are to be darkened.  The final line should contain  only  an  equal
     sign.

     The SCHOOL.XXX file should define no more lines than will require 7
     lines  to  be displayed on the terminal, allowing 80 characters per
     line and the use of an extra  line  below  underlined  or  darkened
     letters.  A .PAGE POSITION +9 command in the rough form of the help
     messages for the RESUME program adjusts  the  count  of  the  lines
     displayed  on  the  screen  to  allow room for the insertion of the
     description of  the  degree  program  in  which  the  students  are
     currently  enrolled  and room for blank lines before and after this
     description.  If more lines  would  be  required,  then  the  .PAGE
     POSITION  command  will  have  to  be changed correspondingly where
     these lines are displayed, and the rough form of the help  messages
     will  have  to  be reprocessed by the FORMAT program to produce new
     FORTRAN source code.

     A typical SCHOOL.XXX file is shown below.

     EDUCATION
     *^NEW ^HARTFORD ^SCHOOL ^OF ^MANAGEMENT New Hartford,
     Connecticut
     *Candidate for Master's degree in Business
     Administration (MBA), 1985.
     =

     The asterisk at the start of the line containing  the  school  name
     forces  the school name to appear on the line below the name of the
     section.  If this asterisk is removed, then the name of the  school
     would  appear  on  the  same line as, and to the right of, the word
      Preparation for Student Use                                           27


           EDUCATION.

      11.  If the printing service is to have its own account, build  it  with
           the  same  default  file  protection  code  and  the same directory
           protection code as  were  used  for  the  resume  storage  account.
           Insert  the  name of this account into the definition of the NUMYPS
           character string in  the  BLOCK  DATA  routine.   If  this  account
           already  exists,  clean  out  any  old  resumes  left over from the
           previous year.

      12.  Replace the account named in the RESUME.CTL  file  by  the  current
           name  of  the resume storage account.  Either in the resume storage
           account, or preferably from an  account  higher  in  the  directory
           tree,  submit the RESUME.CTL to run a batch job.  This expunges the
           resume storage account, writes a new version of the directory  file
           RESUME.DIR into the resume storage account, and resubmits itself to
           run again later.  The time until the next run of the batch job must
           be short enough that the resume storage account will not run out of
           disk space until then.  A half hour interval is suggested.

      13.  Compile,  load  and   save   the   RESUME   program,   the   RSMADM
           administrative  program,  the  RSMSRT name sorting program, and the
           RSMMIX case conversion program.  Rename or copy the resulting  .EXE
           files  into  the  system  storage  account.   If the resume storage
           account and the printing service account are  unchanged,  then  the
           versions of these files from the previous year can still be used.

      14.  If the students  will  be  sharing  a  single  account,  then  some
           students  will  probably  type  the  login password when the RESUME
           program itself asks for a password.  To protect against  this,  log
           into  the  shared  account,  use  the RESUME program to construct a
           dummy resume which can be accessed using the  login  password,  and
           then use the RSMADM program to block further access to this resume.


                     INSTRUCTIONS FOR USING THE RSMADM PROGRAM
                     ------------ --- ----- --- ------ -------

      The RSMADM program is used by the administrator to list the authors  and
      the states of the resumes, to change the states of the resumes, to proof
      the resumes, to rename  the  resumes,  to  copy  the  resumes  into  the
      printing  service  account,  and  to block the resumes from further use.
      The program asks for the administrator to identify the function which is
      to be performed, then asks for the administrator to specify the criteria
      by which the resumes are to be selected.  The resumes  can  be  selected
      individually by class and by password or account number, or else a group
      of resumes can be selected by some combination of class,  date  of  last
      modification  and  state.   A group of resumes can either be selected in
      the order in which they appear in the directory of  the  resume  storage
      account,  or  can  be  selected  in  predetermined  order  based upon an
      alphabetic sort of the students' names.
28                                           RESUME Program Office Guide


Specifying the Function to be Performed

     The program first asks the following  question  to  determine  what
     function is to be performed.

     Specify 1 number to select among following functions
     1=List student names, status and numbers in output file
     2=Unsubmit
     3=Submit
     4=Proof
     5=Transmit
     6=Proof and unsubmit
     7=Change number or password or class of resume file
     8=Block file from any further use
     WHICH FUNCTION?

     The functions which are  selected  by  the  numbers  are  described
     below.   The  program  can only perform one of these functions each
     time it is run.  The program will have to be run again if a  second
     function is to be performed.

       1  List the author, the status and the  numbers  identifying  the
          resume.   These  will be written both to the terminal and into
          an output file named RESUME.LST

       2  Unsubmit the resume.  The resume  can  originally  be  in  any
          state.

       3  Submit the resume.  The resume can originally be in any state.
          The resulting resume will be in the SUBMITTED state even if it
          was in a later state such as EDITED or TRANSMITTED.

       4  Proof the resume.  The program will ask for the  administrator
          to specify the type of proofs which are desired.

       5  Transmit the resume.  Later, when the resume is  about  to  be
          transmitted,  the  program  will  ask for the administrator to
          select a number by which  the  typesetter  can  refer  to  the
          resume.   The  transmitted  file  will have this number as its
          name, nothing more.  Neither .DOC nor .LST nor  anything  else
          will  appear to the right of the number used as the file name.
          If the administrator assigns the number 12 to the resume, then
          the name of the transmitted file will be just 12.  This number
          does not correspond to and has no correlation with the 6 digit
          number  by  which the administrator identifies which resume is
          to be transmitted.

       6  Proof and unsubmit the resume.  This combines the proofing and
          unsubmitting functions in a single function.  After the resume
          book has been completed, some students want to customize their
          resumes  for  particular  companies.  If the resume collection
          was typeset, then the RESUME.WHO file will  also  have  to  be
          changed to allow typed resumes.  The students can submit their
          resumes to  indicate  that  they  want  the  administrator  to
          produce  new  copies  of  their  resumes  typed  on the letter
      Instructions for Using the RSMADM Program                             29


                quality typewriter.  After the new  copies  have  been  typed,
                this  function  unsubmits  the  resumes  so  that  they can be
                modified further.  If  the  RSMADM  program  is  run  from  an
                account  which  is  validated  for  use by the word processing
                office, rather than by the administrator, then  this  function
                is selected automatically.

             7  Change the 6 digit number or password which  can  be  used  to
                access  the  resume or change the class number associated with
                the resume.  This copies the file giving the copy a new  name.
                The administrator will be asked which type of naming scheme is
                to be used for the new  file.   The  names  will  depend  upon
                whether  the  students  run  from  their  own accounts without
                passwords, or use passwords assigned by the administrator,  or
                select  their  own passwords.  The administrator will be asked
                to specify the new password and/or the new  number,  whichever
                is  appropriate, for each resume which is renamed.  The resume
                will be copied into a new file with the number as its name  or
                with  a  number  based upon the password as its name.  The old
                file is also rewritten  and  is  marked  internally  as  being
                replaced.   The  existence  of the old file will be ignored if
                the RESUME program is used to access it again.

             8  Block the resume from further use.  The student will  be  told
                to contact the administrator if the student attempts to access
                this resume from an individual account or  using  an  assigned
                password.   If  the  student is selecting a password, then the
                RESUME program will tell the student  to  select  a  different
                password.   A  blocked  resume  might  be  used to prevent any
                student from selecting the login password as the password used
                within the RESUME program to select an individual resume.

           If either function 4 or 6 which produce proofs of  the  resumes  is
           chosen, then the administrator will be asked the following question
           to determine the format of the resumes.

           CONTINUOUS, PAGED OR TYPESET FORMAT?

           The answer to this question  selects  the  overall  format  of  the
           resumes  which  are  generated.  The administrator must select 1 of
           the following formats.

           CONTINUOUS  If the final copies of the resumes will be included  in
                the  typed  resume  book.  The resume for each student will be
                typed on a separate page.  No page  breaks  will  be  inserted
                into  resumes  which  are  longer than 60 lines and the letter
                quality typewriter will not enforce 60 lines per  page.   This
                usually allows resumes which have increased in length slightly
                due to editing by the administrator to still fit onto a single
                sheet of paper.

           PAGED  For resumes which have been individually  requested  by  the
                students  after  the resume book has been finished.  The pages
                will be the same size as  in  the  typed  resume  book.   Long
                resumes will be split into multiple pages.
30                                           RESUME Program Office Guide


     TYPESET  For checking resumes which will  be  typeset.   The  lines
          will  be divided the same as in the typeset resume book.  Long
          resumes will not be split into multiple pages.

     If either function 4 or 6 is chosen, then  the  administrator  will
     also  be  asked  the  following  question  to determine the type of
     output device which will be used to type or print the proofs of the
     resumes.

     TYPE OF BOLDING (NONE, PRINTER, TYPEWRITER)?

     Bold or darkened lettering must be indicated quite  differently  on
     the  fast  printer  than  on the letter quality typewriter.  On the
     fast printer, it is sufficient to merely print the line  containing
     the  characters  to be darkened several times.  The fast printer is
     imprecise enough that  the  several  strikes  of  the  letter  blur
     sufficiently  to give dark letters.  The letter quality typewriter,
     however, types each strike exactly over the other so  that,  except
     for  filling  in any gaps in the strokes that form the letters, the
     second and subsequent strikes do  not  make  the  letters  visually
     darker.   Therefore,  for  the  letter quality typewriter, a second
     strike is made exactly over the first strike, then the third strike
     is  offset  by 1/120th inch.  The various types of boldfacing which
     are available are selected by the following responses.

     NONE  If  the  resumes  are  not  to  include  either  bolding   or
          underlining.

     PRINTER  If bolding and underlining  are  to  be  included  in  the
          resumes and the resumes will be printed on the fast printer.

     TYPEWRITER  If bolding and underlining are to be  included  in  the
          resumes  and  the  resumes will be typed on the letter quality
          typewriter.

     If function 7 which copies the resume into  a  new  file  having  a
     different  name is chosen, then the administrator will be asked the
     following question to determine the manner in which the  new  files
     are named.

     Type 1 number to select type of account students will use
     1=Students run from own accounts without passwords
     2=Students use passwords assigned by administrator
     3=Students select their own passwords
     CONVERT TO WHICH TYPE OF ACCOUNT?

     The names of  the  files  in  which  the  resumes  are  stored  are
     constructed from the class number and a number which identifies the
     account from which the resume was entered or which is based upon  a
     password  chosen  by  the student or which is assigned along with a
     password to the student.  Function 7  could  be  chosen  to  change
     either  or  both of these numbers.  The program will report if some
     other resume has already been created which corresponds to the  new
     numbers.  The administrator must type 1 of the following numbers in
     response to this question to select the type of account which  will
      Instructions for Using the RSMADM Program                             31


           be used in the future to access the resumes.

             1  If the students in the new class use their own  accounts.   It
                will   be   necessary  for  the  administrator  to  add  lines
                specifying the new classes which are  to  be  associated  with
                these  accounts  to  the  RESUME.WHO  file.   These lines must
                appear before the lines which specify the  default  class  for
                the  group  of  accounts containing these particular accounts.
                The program will ask for the  new  class  number  and  student
                number  for  each  resume.   If  a file already exits for this
                class number and student number, then the  administrator  will
                be asked to specify a different student number.

             2  If the students in the  new  class  use  passwords  which  are
                assigned  to  them by the administrator.  The program will ask
                for the new class number, new student number and new  password
                which  are  to  be  associated  with  each  resume.  If a file
                already exits for this class number and student  number,  then
                the administrator will be asked to specify a different student
                number.

             3  If the students in the new  class  use  passwords  which  they
                themselves  select.   The  program  will ask for the new class
                number and password for each resume.  If a file already exists
                for this class number and the 6 digit number which the program
                calculates from the password, then the administrator  will  be
                asked to specify a different password.

           The program then asks the question shown below to determine whether
           the  resumes  will be selected individually, or will be selected by
           some combination of class, state and date of last modification.

           WILL RESUMES BE SELECTED INDIVIDUALLY (Y OR N)?

           The administrator should respond by typing either of the  following
           answers.

           YES  If the resumes will be specified individually by class and  by
                either  password  chosen by the student, or number assigned by
                the administrator or the account number.

            NO  If a group of the resumes which match certain criteria are  to
                be processed.


      Specifying Criteria for Selection of a Group of Resumes

           If a  group  of  resumes  which  match  certain  criteria  will  be
           selected, then the following question is asked to determine whether
           these resumes will be selected in the order in  which  the  resumes
           appear  in  the  directory  or in alphabetical order based upon the
           students' names.
32                                           RESUME Program Office Guide


     PROCESS RESUMES IN PRESELECTED ORDER (Y OR N)?

     The administrator should respond by typing either of the  following
     answers.

     YES  If the resumes are to be processed in the  alphabetical  order
          based  upon the students' names.  The RSMADM program must have
          been run previously with function 1 having  been  selected  to
          obtain a list of the students in the file name RESUME.LST, and
          the RSMSRT program must have been run to sort  the  names  and
          write  them  into a file named RESUME.SRT.  Only those resumes
          which were selected when the RSMADM program was run to  obtain
          the  list in the RESUME.LST file can be selected this time.  A
          more stringent set of criteria might be specified this time to
          obtain  some  subset  of  the resumes listed in the RESUME.SRT
          file.  For example, the RESUME.SRT file might list all of  the
          students in a particular class, but only the submitted resumes
          might be selected to be processed this time.

      NO  If the resumes are to be selected in the order  in  which  the
          files  containing  the  resumes  are  listed in the file named
          RESUME.DIR which is stored in the resume storage account.  The
          RESUME.DIR  file  is  created  by  the  batch  job  which also
          expunges deleted files from the resume storage account.

     The program will  ask  whichever  of  the  following  questions  is
     appropriate to determine the class number or numbers of the resumes
     which are to be processed.

     LIST INFORMATION FOR WHICH CLASSES (-1=ALL)?
     UNSUBMIT WHICH CLASSES (-1=ALL)?
     SUBMIT WHICH CLASSES (-1=ALL)?
     PROOF WHICH CLASSES (-1=ALL)?
     TRANSMIT WHICH CLASSES (-1=ALL)?
     PROOF AND UNSUBMIT WHICH CLASSES (-1=ALL)?
     NEW NUMBER/PASSWORD/CLASS FOR WHICH ORIGINAL CLASSES (-1=ALL)?
     BLOCK WHICH CLASSES (-1=ALL)?

     The administrator can respond by typing either  the  number  -1  or
     from 1 to 10 class numbers.  These responses are described below.

      -1  To allow all classes to be included.  It is assumed that other
          criteria  will  be  used to select the resumes which are to be
          processed.  If the resumes are being processed in alphabetical
          order,  then only those resumes which were originally selected
          when RSMADM was run to obtain the original list are candidates
          for selection now.

     One to ten numbers.  Resumes for any of these  classes  which  meet
          the  other  criteria  will  be  processed.  If the resumes are
          being processed in alphabetical order, then only those resumes
          which  were  originally selected when RSMADM was run to obtain
          the original list are candidates for  selection  now.   Commas
          are  allowed  between  the  numbers  in  the  list but are not
          required.  All of the class numbers must be typed on a  single
      Instructions for Using the RSMADM Program                             33


                line.

           The program then asks the following  question  to  determine  which
           state  or  states  are  to  be processed.  Resumes which are in any
           states which are not specified will be rejected.

           Type 1 or more of the following numbers
           0=REPLACED
           1=DRAFT
           2=SUBMITTED
           3=SUBMIT+PROOF
           4=EDITED
           5=EDIT+PROOF
           6=TRANSMITTED
           7=BLOCKED
           Type -1 for all states DRAFT through TRANSMITTED.
           PROCESS WHICH STATES (-1=ALL)?

           Usually the REPLACED and BLOCKED states would not be selected.   In
           order  to  process  resumes  which  are  in the REPLACED or BLOCKED
           states, either the resumes must be selected individually, or  these
           states  must  be  asked  for  explicitly.   All  8  states could be
           obtained either by typing the values 0 through 7 on a single  line,
           or  by  typing  the values -1, 0 And 7.  Commas are allowed between
           the numbers in the list but are not required.   All  of  the  state
           numbers must be typed on a single line.

           Finally, the administrator will be asked to  specify  the  earliest
           and latest dates for the most recent modifications of resumes which
           are to be included.

           REJECT RESUMES CREATED BEFORE WHAT DATE?
           REJECT RESUMES CREATED AFTER WHAT DATE?

           These dates can be specified in any conventional notation.  October
           20,   1983   could   be   represented   by  any  of  the  following
           specifications, among others.

           10/20/83
           20-Oct-83
           October 20 1983
           October 20, 1983
           20 October 83

           Either the full 4 digits or just the rightmost 2 digits of the year
           can  be given.  The full month name or just the first 3 letters can
           be used.  The month  name  can  be  either  capitalized  or  formed
           entirely  of small letters.  The date of last modification could be
           used to reject resumes which were  started  the  previous  year  by
           students who have since dropped out of school.
34                                           RESUME Program Office Guide


Selecting an Individual Resume

     If individual resumes rather than a group are being selected,  then
     the  program  will  ask one of the following questions to determine
     the class number.

     LIST INFORMATION FOR WHICH CLASS (-1=EXIT)?
     UNSUBMIT WHICH CLASS (-1=EXIT)?
     SUBMIT WHICH CLASS (-1=EXIT)?
     PROOF WHICH CLASS (-1=EXIT)?
     TRANSMIT WHICH CLASS (-1=EXIT)?
     PROOF AND UNSUBMIT WHICH CLASS (-1=EXIT)?
     NEW NUMBER/PASSWORD/CLASS FOR WHICH ORIGINAL CLASS (-1=EXIT)?
     BLOCK WHICH CLASS (-1=EXIT)?

     The program will next ask the administrator the following  question
     to identify the first resume to be processed.

     NUMBER OF INDIVIDUAL RESUME (-2 BY PASSWORD,-1 TO EXIT)?

     The administrator should respond by typing  one  of  the  following
     numbers.

      -2  If the students have selected  their  own  passwords  and  the
          administrator wishes to use one of these passwords to identify
          a particular resume.   The  program  will  then  ask  for  the
          password.   During  the  same  run of the RSMADM program, some
          resumes might be selected by password and  others  by  number.
          Resumes  for which the administrator assigned passwords to the
          students cannot be selected by passwords.

      -1  To exit from the program.

       0  or greater,  up  to  a  maximum  of  999999.   To  select  the
          particular  resume  for  which this is the identifying number.
          It makes no difference whether this number is based  upon  the
          individual account being used to enter the resume, or is based
          upon the password, or was assigned along with  a  password  by
          the administrator.

     The above question is  asked  again  after  each  resume  has  been
     processed.   The  administrator  can  merely  press  the RETURN key
     without having typed any other response to return to  the  question
     concerning which class is to be selected.
      Instructions for Using the RSMADM Program                             35


      Specifying New Class/Account/Password if Renaming Resumes

           If the resumes are being copied with new names,  and  if  passwords
           are  used  for  the  new files, then the program will ask for a new
           password for each file.

           PASSWORD?

           The password can consist of 1 or several words but must be no  more
           than 20 characters in length counting the spaces between words as 1
           character each.  The password cannot be formed from any  characters
           other  than  the  alphabetic  letters  A through Z and the digits 0
           through 9.

           This password can either have been chosen by the  student  or  have
           been  assigned  by  the administrator.  Regardless of who chose the
           password, if the other students in the new  class  have  also  been
           assigned passwords, then the administrator will be asked to specify
           a number to be used with the password.  If the students are running
           the  RESUME  program  from  their own individual accounts, then the
           administrator must identify the programmer number of each of  these
           accounts.   This  question is not asked if the students are allowed
           to choose their own passwords.

           NEW STUDENT NUMBER (-1=ORIGINAL VALUE)?

           The administrator can type the value -1 in response to the  request
           for  the  new  student number to retain the same number as was used
           for the original file.

           If  the  resumes  are  being  copied  with  new  names,  then   the
           administrator  will also be asked to specify the new class for each
           resume which is copied.

           NEW CLASS (-1=ORIGINAL VALUE)?

           The administrator can type the value -1 in response to the  request
           for  the  new  class  to  retain the same class as was used for the
           original resume.


      Specifying Names of the Transmitted Files

           If the resumes are being copied into the printing service  account,
           but  are  not  being  copied  in  a  preselected  order,  then  the
           administrator will be asked to specify a number which is to be used
           as  the  name of the transmitted resume.  This question will not be
           asked if the resumes are being transmitted in a preselected order.

           NUMBER TO BE NAME OF TRANSMITTED FILE (-1=STUDENT NUMBER)?

           The administrator can type -1 in response to the  request  for  the
           number  to be used as the name of the transmitted file to have this
           number be the same as the 6 digit number  which  identifies  either
           the account used to enter the resume or the password used to access
36                                           RESUME Program Office Guide


     the resume.


                     PRODUCTION OF THE RESUME BOOK
                     ---------- -- --- ------ ----

The various procedures which must be  performed  to  produce  the  typed
resume book are described below.  Where references are made to the staff
of the publications office, these are the people who will be editing the
the  resumes,  both  for  style  and  correctness.   The  resume book is
produced for  the  placement  office.   The  placement  office  has  the
ultimate say as to which resumes are included in the book.

The list given here should be used only as a general guide.  The  actual
sequence  of  events will depend greatly on human factors:  for example,
upon whether some students request that  exceptions  be  made  for  them
after  the  deadlines;  upon  whether the placement office asks that the
list of students be modified; and upon how many times the  resumes  have
to  be  proofed,  edited  and  transmitted.   It  is  essential that the
administrator understand why the various  operations  are  performed  so
that exceptions can be handled easily.

 1.  After the deadline for the submission of all  resumes  has  passed,
     check the terminal room to see if any students are still putting in
     their resumes.  If so, urge them to finish.

 2.  Issue the monitor command SYSTAT ALL  which  will  list  all  users
     currently  on  the  system.   Check  the type-out to insure that no
     student is still running the RESUME program.

 3.  In the RESUME.WHO file in the  file  storage  account,  change  the
     second  number  on  each  line  which  validates  the students just
     completing their resumes to the value -1.  This prevents them  from
     running  the  program  again,  but  gives  them the messages in the
     MESAGE.XXX file, where XXX is the class number with leading  zeros,
     before  kicking  them off.  This prevents the students from getting
     paper copies of their submitted resumes while the resumes are being
     edited by the publications office staff.

 4.  Change the message in the MESAGE.XXX file to tell the  students  in
     the  class  that the program is closed to them.  They will see this
     message if they try to run the RESUME  program  and  will  then  be
     kicked out of the program.

 5.  Make a copy of all of the resume files for  the  current  class  in
     another account just in case you goof up somewhere.

 6.  Run the RSMADM program and ask for a list of all of the students in
     the  current  class.   When  the  program  asks  for  the  earliest
     modification date which is to be  accepted,  give  a  date  just  a
     little  before  the start of the period when the students could run
     the RESUME program this time.  This will reject  any  resumes  from
     students who were in the class the previous year but who have since
     dropped out.  The list of students will be written to a  file  name
     RESUME.LST.
      Production of the Resume Book                                         37


       7.  If some students  have  worked  on  their  resumes,  but  have  not
           submitted them, then some of these may still have to be included in
           the resume collection.  The question of what to do with unsubmitted
           resumes   is   complicated  when  the  students  select  their  own
           passwords.  Some of the students will compose several  resumes  and
           then  only  submit  one.   Other  students  will practice using the
           program, then enter their real  resumes  with  different  passwords
           rather  than  just cancelling the practice resumes.  Some will just
           have forgotten to submit their resumes.

           The RSMADM program will have to be used to produce  proofs  of  the
           unsubmitted  resumes.   Some  of  these  resumes  can  obviously be
           discarded.  For example, any resume which does  not  start  with  a
           student's  name  can  be  discarded.   An  unsubmitted resume which
           starts with the name of a student who also submitted another resume
           can  also  be  discarded.  The resumes should be discarded by using
           the RSMADM program to transfer them into a  class  number  reserved
           for junk.  The students responsible for the rest of the unsubmitted
           resumes should be contacted to determine whether they  just  forgot
           to  submit  their  resumes.   If  some  of  these resumes are to be
           included in the resume collection, then the RSMADM  program  should
           be used to submit these resumes.  Alternatively, the RESUME program
           can be opened up again for awhile and the students can be asked  to
           finish their resumes and submit them.

           Finally, when all questions concerning the unsubmitted resumes have
           been resolved, run the RSMADM program again to produce a fresh list
           of the students.

       8.  Run the RSMSRT program to sort the student names in the  RESUME.LST
           file  which was produced by the RSMADM program.  The RSMSRT program
           will write a file named RESUME.SRT which  will  list  the  students
           sorted  by  last  name.   The  program  is  able  to recognize most
           suffixes of the names, such as II or Jr., but if an unusual  suffix
           is  used,  this could be treated as a last name causing the student
           to be out of alphabetical order.  The RSMSRT program has its  array
           space  dimensioned  for 400 students.  The appearance of 400 in the
           DIMENSION and DATA statements will have to be  increased  if  there
           are  more  than  400  students who must be included in alphabetical
           order in a single resume collection.  Type at least 3 copies of the
           RESUME.SRT file.

       9.  Run the RSMADM program to produce proofs of the resumes for all  of
           the  students  in  the  class.   When  the program asks whether the
           resumes are to be processed in a preselected order,  respond  "YES"
           so  that  these  can  be processed in the order in which these were
           sorted by the RSMSRT program.   The  CONTINUOUS  format  should  be
           selected with bolding for the TYPEWRITER.

           Follow the directions given later in this manual for  typing  these
           resumes  on the letter quality typewriter.  Photocopy the resulting
           resumes and give the photocopy of the resumes and  1  copy  of  the
           printout  of  the  RESUME.SRT file to the placement office staff so
           that they can verify that the list is correct.  Give the  originals
           of  the resumes and 2 copies of the printout of the RESUME.SRT file
38                                           RESUME Program Office Guide


     to the publications office staff who will be editing the resumes.

10.  Modify the RESUME.WHO file, if necessary, so that the account  used
     by  the  publications  office is listed as an administrator for the
     current class.  If they will only be doing editing but will not  be
     using  the  RSMADM  program  themselves, then do not give them full
     administrator privileges.

11.  If some students come in and say that they forgot  to  enter  their
     resumes,  some  provision  will have to be made to insure that they
     can enter their resumes.  If the  administrator  is  not  concerned
     that  other students who did not submit their resumes might use the
     opportunity of the RESUME program being opened to enter  their  own
     resumes,  then all that is necessary is to change the entry for the
     class in the RESUME.WHO file so that the class can run  the  RESUME
     program again.  In a class of about 150 persons, usually at least 1
     will have forgotten to enter a resume during  the  official  period
     but will then become very concerned afterwards.

     About 5 to 10 people in a class of  150  will  discover  errors  in
     their  resumes  after  the deadline has passed.  Unless the resumes
     require a lot of modification, it is usually easiest  to  have  the
     administrator  make these changes for the students.  If the changes
     have to be made by the students, then the administrator  will  have
     to  run  the RSMADM program to unsubmit the resumes which are to be
     changed.

     The following instructions suggest how to open the  RESUME  program
     to particular students but keep it closed to other students who did
     not submit their resumes.

     If the students are using their own individual accounts,  then  all
     that  is  necessary  is  to add lines opening their accounts to the
     RESUME.WHO file.  These lines would have to appear before the lines
     which  specify  the group of accounts used by the students since by
     now the group of accounts is closed to the RESUME program.

     If the students have been running from a single  account  and  were
     using  passwords  which  were  assigned  to  them,  then it will be
     necessary to move or copy the lines which define the passwords  for
     the  students who are still allowed to run the program to the start
     of the PASWRD.XXX file, where XXX stands for the class number,  and
     to  insert a line containing only an equal sign between these lines
     and the lines which specify the passwords  which  are  not  active.
     The  rest  of the lines, and in particular the line containing just
     an equal sign at the end of the file, should be  retained  so  that
     the  entire  list of students can be allowed access later merely by
     removing the line containing the equal sign which was inserted into
     the  middle  of  the  file.   The  line  which specifies the shared
     account in the RESUME.WHO file will also  have  to  be  changed  to
     allow use of the RESUME program again.

     If the students have been running from a single  account  and  have
     been  selecting  their  own passwords, then it will be necessary to
     change the entry in the RESUME.WHO file so that  the  students  use
      Production of the Resume Book                                         39


           assigned  passwords  instead.   Also,  this  line  will  have to be
           changed to allow use of the RESUME program.  A PASWRD.XXX file will
           have  to be created which contains the passwords which the students
           selected.  The numbers which appear to the left of the passwords in
           this  file  must be the 6 digit numbers to which the RESUME program
           converts the passwords.  A listing  of  either  the  RESUME.LST  or
           RESUME.SRT   file   can  be  consulted  to  obtain  these  numbers.
           Alternatively, either the RESUME program or the RSMADM program  can
           be  run by the administrator to obtain these numbers.  The students
           will have to be told the  values  of  the  6  digit  numbers.   The
           students  who  will be starting or changing their resumes after the
           deadline will have to use both the numbers and the passwords to run
           the  RESUME  program.   It  is not necessary that the administrator
           change the files which contain the resumes in  any  way.   Although
           both  the  number  and  the password appear in each resume file, it
           makes no difference to the programs whether an assigned  number  is
           selected at random by the administrator or is the same as the value
           which the program would produce when it constructs a  number  based
           upon the password.  Later, to open the RESUME program to all of the
           students after the resume book has been completed, it will only  be
           necessary to change the single line entry in the RESUME.WHO file to
           allow student selected passwords again and to delete the PASWRD.XXX
           file.

      12.  If the placement office decides that some of the students who  have
           entered their resumes are not entitled to have their resumes in the
           resume book, then the RSMADM program will have to be run for  these
           students  to  move  their resumes to some other class or to a class
           reserved for junk resumes.  It is suggested that the class  numbers
           should  be  based  upon  the right 2 digits of the expected year of
           graduation for the class and that the hundreds digit  indicate  the
           type of account being used.

           For example, the following class numbers might be  chosen  for  the
           class of '85.

             85 if the student is running from the shared account.

            185 if the student is running from an  individual  account.   This
                account  is a member of a group of similar individual accounts
                used by the members of this class.

           Students who were using their own accounts for the  original  class
           will  continue  to  use  their  own  accounts  for  the  new class.
           Students who were using a shared account  for  the  original  class
           will  have  to use the different shared account which is being used
           for the new class.

           In most cases if the students chose their own passwords to run  the
           RESUME  program,  then  their original passwords can continue to be
           used for the new class.   If  a  password  already  being  used  by
           someone  else in the new class matches their old password, then the
           RSMADM program will block the transfer and will  require  that  the
           administrator  select  another  password.  The RESUME.WHO file does
           not have to be changed, but the students will have to be  told  how
40                                           RESUME Program Office Guide


     to  gain  access to the shared account being used for the new class
     and will have to be told the new  passwords  if  these  had  to  be
     changed.

     If numbers and passwords were assigned to the  students,  then  the
     lines defining the passwords must be moved from the PASWRD.XXX file
     for the old class to that of  the  new  class.   Since  the  number
     portion  of each combination of number and password assigned by the
     administrator must be unique within the class, it  is  likely  that
     the  administrator  will have to pick a new number but the password
     can be left unchanged even if it duplicates a password  already  in
     use  in  the  new  class.   The RESUME.WHO file does not have to be
     changed, but the students will have to be told how to  gain  access
     to the shared account being used for the new class and will have to
     be told what the new numbers are.

     If the student has been using an individual account,  then  a  line
     must  be  inserted  into  the  RESUME.WHO  file  defining  the  new
     association of the account with the class number.  This  line  must
     be  inserted  before  the line which defines the class for students
     using similar accounts.  The student will not see any change.

     The following is a typical set  of  account  validations  from  the
     RESUME.WHO file.

     -3 1 999 2 <S.D.BARTH>  !ADMINISTRATOR
     84 1 0 2 <S.RESUME.84>  !CLASS OF 84 SHARED ACCOUNT
     85 1 1 2 <S.RESUME.85>  !CLASS OF 85 SHARED ACCOUNT
     184 0 0 2 <S.O.SMITH>   !CLASS OF 84, OTHERWISE IN 85
     185 0 1 2 <S.E.JONES>   !CLASS OF 85, OTHERWISE IN 84
     184 0 0 2 <S.E.*>       !CLASS OF 84 INDIVIDUAL ACCOUNTS
     185 0 1 2 <S.O.*>       !CLASS OF 85 INDIVIDUAL ACCOUNTS
     =

13.  When the list of students  who  will  be  included  in  the  resume
     collection has finally settled down, run the RSMADM program to list
     the resumes again, and then run the  RSMSRT  program  to  sort  the
     list.   Type  the  RESUME.SRT file and give copies to the placement
     office staff and to the publications office staff.

14.  Whenever some students have been added to the list, or some of  the
     resumes  have  been edited, run the RSMADM program again to produce
     proofs of their resumes.  The resumes for  added  students  can  be
     produced  by  selecting  resumes  in the SUBMITTED state, and those
     which have been edited can be  produced  by  selecting  the  EDITED
     state.  Both of these states can be selected for in a single run of
     the RSMADM  program.   Type  the  resumes  on  the  letter  quality
     typewriter  as  before,  and  give  the  resulting  resumes  to the
     publications office staff.

15.  When all of the resumes have been checked  and  verified,  a  final
     typed copy of all of the resumes may have to be prepared to be used
     as  the  master  copy  for   production   of   the   resume   book.
     Alternatively,  if  the final copies of each resume which have been
     checked by the publications office staff have not been  marked  and
      Production of the Resume Book                                         41


           are still clean, then that set might be used as the master.

      16.  Finally, after  the  master  copy  of  the  resume  book  has  been
           prepared,  use  the  RSMADM program to unsubmit the resumes so that
           the students can modify the resumes and type  them  on  the  letter
           quality  typewriter.   Change the third number on each of the lines
           in the RESUME.WHO file which validate the  accounts  which  can  be
           used  by  the  class  from  1 which allowed them just a single page
           resume to a value of 4 to allow them a resume of up to 4 pages.


                 USING HC PROGRAM TO TYPE RESUMES TO BE PHOTOCOPIED
                 ----- -- ------- -- ---- ------- -- -- -----------

      The following is a complete list of the steps necessary for  typing  the
      resumes   on   the  letter  quality  typewriter  attached  to  the  Yale
      DECsystem20 computer once the RSMADM program  has  written  the  resumes
      into the RESUME.PRF file.  This procedure will differ elsewhere.  The HC
      (HardCopy) program which is used in this  procedure  reads  a  file  and
      types  it onto the controlling terminal.  The HC program is used because
      it causes escape characters (the alt-mode) and control characters to  be
      transmitted unchanged to the terminal.  This is necessary for the proper
      positioning of the multiple  strikes  used  for  darkening  the  student
      names,  section  names,  school  names and company names in the resumes.
      The HC program is not distributed with the student resume system.

      1.  Connect to or log into <s.diablo> on the Diablo 1750 terminal.   Any
          other  account  could be used as well, since the HC program sets the
          terminal characteristics regardless of those which are standard  for
          the account.

      2.  Put the Master 12 wheel on the Diablo.
          Set the pitch switch to 12.  This switch is  located  at  the  right
          front corner inside of the terminal and is exposed when the cover is
          removed.
          Press down the bottom ends of the 2  switches  at  the  top  of  the
          keyboard  which  are above the 88 marking.  The Master 12 wheel does
          not contain all of the printing ASCII  characters  so  the  full  96
          character setting cannot be used.

      3.  Put the heavy duty fanfold paper feeder (the one  with  the  chromed
          release  bars  on the top edges) onto the terminal.  This feeder has
          sprocket drives on both sides  of  the  platen  to  hold  the  paper
          securely.

      4.  Move the left sprocket drive as far to the left as it will go,  then
          back  1/4th  inch to the right.  Load the 8 1/2 x 11 bond 25% cotton
          paper into the sprocket drive mechanism.  This paper has  very  tiny
          perforations  so  that  it looks like ordinary typing paper when the
          edges are torn off.

      5.  Press the FF switch located above the keyboard.  Use  the  knobs  at
          the  ends of the platen to line up the perforations between the next
          two pages with the top edge of the guard plate which is in front  of
          the  printhead and which rides against the paper.  Turn the platen 2
42                                           RESUME Program Office Guide


    clicks so that about 1/6th inch of the piece of paper extends  above
    the guard plate.

6.  Type HC to run the hardcopy program.

7.  Type in the file name RESUME.PRF/C and press the RETURN key.

8.  Press the G key.

9.  The margin between the left edge of the paper  (after  the  sprocket
    edge  is torn away) and the left edge of the typed characters should
    be 1 inch.

    If it is not:

    A.  Hold down the CONTROL key and press the S key a few times  until
        the typing pauses.

    B.  Adjust the paper position by the estimated amount.

    C.  Hold down the CONTROL key and press the Q key to resume typing.

    Check the new left margin.  If it is still wrong, adjust  it  again.
    Once  the  left  margin  is  correct, the HC program must be started
    over.  To do so, hold down the CONTROL key and press the C key a few
    times  to  stop  the  program.   Then  repeat the above instructions
    starting with those for running the HC program.


           DIFFERENCES BETWEEN TYPED AND TYPESET RESUME BOOKS
           ----------- ------- ----- --- ------- ------ -----

The RESUME program can prepare the resumes  either  to  be  typed  on  a
letter  quality  typewriter or to be typeset.  Typed resumes are assumed
to have pages which are 87 characters wide and to be typed with a  pitch
of  12 characters per inch.  Extra characters are inserted into the file
to cause overstriking to be  misaligned  slightly  in  order  to  darken
selected  words.  The characters which are inserted are specific for the
Diablo 1600 series and Xerox 1700 series of terminals and will  probably
have to be changed for use on other types of letter quality typewriters.
The program can also produce darkened characters on a fast printer.  The
imprecision  inherent  in  such  fast  printers misaligns the characters
enough that darkened words can be obtained merely  by  overprinting  the
words several times.

The technique used for darkening characters on the Diablo terminal is to
shift  the  typing  slightly  before  overprinting  the characters.  The
entire line is first typed normally.  Then a carriage return  is  issued
without  a line feed and the portion of the line which is to be darkened
is overprinted.  This insures that a complete strike of each letter  has
been  obtained,  but does not produce much darker characters since the 2
strikes are precisely aligned.  After another carriage  return,  special
characters  are  sent to the terminal to cause it to make all characters
be 1/120 inch wide, a space is sent to the terminal which will move  the
printhead  1/120  inch, and then more special characters are sent to the
      Differences Between Typed and Typeset Resume Books                    43


      terminal to set the character width back  to  1/12  inch.   Finally  the
      characters  to  be  darkened  are typed a last time but now they will be
      shifted 1/120 inch to the right.

      When the resumes are to be typeset rather than typed, the RESUME program
      calculates  the  width of each word based upon the character widths in a
      particular type font.  The proofs which the students can  print  on  the
      fast  printer  will  have a very ragged right edge because the number of
      characters in each line is calculated  to  match  the  typeset  resumes.
      After  the  resumes  have  been completed, the RSMADM program copies the
      resumes into an account used by the printing service.   In  the  resumes
      copied  into  the  printing service account, the words in adjacent lines
      which are not prevented from being  wrapped  around  are  combined  into
      single lines which can become very long.  Initial spaces are removed and
      multiple spaces are compressed to  single  spaces.   The  rules  between
      sections  are  indicated by the capitalized word RULE.  Other than this,
      the resumes copied into the printing service  account  are  pretty  much
      what the students saw.  No typesetting commands are inserted.  It is the
      responsibility of the printing service to  copy  the  files  onto  their
      typesetting  equipment  and  then  to insert the appropriate typesetting
      commands.

      The character widths currently defined in the BLOCK DATA routine are for
      the  Univers  font.   These  widths  were  obtained  by  measuring  each
      character in the typeset resumes from  a  previous  year.   The  allowed
      maximum  length of a line was adjusted until the correct number of words
      in a line was obtained in most cases.  A new  set  of  character  widths
      would have to be determined in order to use any other font.

      The proofreading copies of the resumes  which  are  to  be  typeset  are
      printed  on  a fast hardcopy terminal.  Since both the maximum number of
      characters on a line and the maximum number  of  lines  on  a  page  are
      greater  than  would  be acceptable for normally proportioned pages, the
      hardcopy terminal should be capable of producing reduced  size  letters.
      Alternatively,  larger  sheets  of  paper  could  be used.  The hardcopy
      terminal which is used for production of the proofreading copies of  the
      resumes  is a DECWRITER LA120.  Narrow 8.5 inch wide paper should be put
      into the DECWRITER terminal.  The DECWRITER should be  set  to  give  16
      characters  per inch, 8 lines per inch, and 88 lines per page.  The left
      margin should be about 1.5 inches to the right of the left edge  of  the
      paper  after  the  perforations  are removed.  To change these settings,
      hold down the SETUP key and press the H (for horizontal) key  until  the
      12  appears, then the V (for vertical) key until the 8 appears, and then
      the F (for form length) key until the 88 appears.   Still  holding  down
      the  SETUP  key, press the space bar until the number 15 appears showing
      that the printhead is in column 15, then press the numeric  key  in  the
      upper  row  which  has MARGIN LEFT written above it.  If the left margin
      were to be set before setting the pitch (characters per inch), then  the
      margin  setting  would  be  lost.   Release the SETUP key and adjust the
      paper position until there is a 1.5 inch left margin  and  about  a  0.5
      inch  top  margin.   Finally  use the HC program to type the file.  If a
      TYPE command is used instead to type the file, then the monitor  command
      must be issued which allows long lines.  On the DECsystem20, the command
      shown below would be issued to allow long  lines  to  be  typed  on  the
      terminal.
44                                           RESUME Program Office Guide


TERMINAL WIDTH 0

The RESUME.SRT file is used by the RSMADM program both to determine  the
order  in  which the resumes are processed, and to determine the numbers
which will be used as the names of the files which  are  transmitted  to
the  printing  service.   The RSMSRT program should not be run after the
publications office has started to use these  numbers  to  identify  the
resumes.  If resumes are added to or removed from the collection but the
original numbering must be maintained, then the text  editor  should  be
used  to  modify  the  RESUME.SRT  file  rather  than running the RSMSRT
program again.  Care must be taken when editing the RESUME.SRT  file  to
insure  that the numbers are placed into the proper columns in the added
lines and that no duplicates appear in the numbers at the  left  end  of
the lines.  Care should also be taken that no non-numeric characters are
placed into the columns which contain numbers.  The non-numeric stuff on
the  lines  is not used by the RSMADM program and need not be duplicated
on the added lines although it is a good idea to  insert  the  student's
name where this appears in the original lines.

The first time that the RSMADM program is used to copy  resumes  to  the
printing  service account, the question about whether the resumes are to
be processed in a preselected order  should  be  answered  "YES".   This
sends  the  resumes in the alphabetical order of the students' names and
gives them names which are based upon the numbers appearing at the start
of the lines in the RESUME.SRT file.

If all of the edited resumes must be transmitted again, then  these  can
also  be  transmitted in preselected order.  The RSMADM program will use
the numbers which appear at the left ends of the lines in the RESUME.SRT
file  as  the  names  of  the  files  which are copied into the printing
service account.  If the resumes which are to be transmitted  again  are
selected  individually,  or  are  selected  as  a  group  but not in the
preselected order, then the program will ask for  the  administrator  to
specify  the  numbers  to be used as the names of the transmitted files.
The administrator will have to consult a copy of the RESUME.SRT file  to
determine these numbers.


        CONVERSION FROM FIRST YEAR RESUME FORMAT TO SECOND YEAR
        ---------- ---- ----- ---- ------ ------ -- ------ ----

The final version of the resume book for the first year class  is  typed
on  a  Diablo  terminal.   The  second  year  resumes are typeset at the
printing service.  The resumes which the students entered  during  their
first  year  form  the  starting  point  for the second year collection.
Since typed and typeset resumes have different line widths and different
line  spacings,  the  RESUME  program  must  know  upon which device the
resumes will be produced.  This is specified by the third number on  the
line  in the RESUME.WHO file which validates the accounts from which the
RESUME program will be run.  Before the students start to  modify  their
resumes  for the second year collection, the third number on the line or
lines which validate their accounts should be changed from the  value  1
or  greater  which specified the maximum number of pages of typed output
to the value 0 which specifies typeset output.
      Conversion From First Year Resume Format to Second Year               45


      If the students are running the RESUME program from their own  accounts,
      but these accounts have changed, then the RSMADM program will have to be
      used to rename the files containing the  resumes.   The  RSMADM  program
      will  also  have  to be run to unsubmit any submitted resumes in the new
      second year class.  Resumes for the previous graduating class should  be
      deleted.

      For the first year collection, the students are instructed to  use  only
      capital letters for their own names and for the names of the sections of
      the resumes and for the names of organizations.  An exception  was  made
      for  last names which have prefixes such as du or La or Mc, in which the
      use of lower case letters in the conventional locations  in  the  prefix
      was  recommended.   For  the  second  year  collection, the students are
      instead asked to capitalize only the first letters of the words in  most
      names.   The students could be instructed to make these case conversions
      themselves, but the administrator  should  use  the  RSMMIX  program  to
      perform these conversions in all of the resumes for the entire class.

      The RSMMIX  program  converts  the  second  and  subsequent  letters  in
      sequences formed entirely of capital letters to lower case.  The program
      does not change any letters which are already in lower case.  In a  name
      such  as  McDONALD,  in  which there is an embedded lower case letter c,
      both the capital letter at the start of the name and the capital  letter
      after  the  lower  case  letter  are left capitalized.  All of the files
      which are read and written by the  RSMMIX  program  are  in  the  resume
      storage  account.  The account from which the RSMMIX program is run must
      be able to both read and write into the resume storage account, and must
      be  validated  for  all administrative functions by the RESUME.WHO file.
      The RSMMIX program can process the resumes for up to  10  class  numbers
      each  time that it is run.  The RSMMIX program asks the administrator to
      specify which classes are to be  processed,  then  processes  the  files
      which are specified for these classes in the RESUME.DIR directory file.

      A file named RESUME.WRD which specifies the words which are to  be  left
      capitalized  by  the RSMMIX program is also read from the resume storage
      account.  The RESUME.WRD file is not required.  Each line in  this  file
      should  contain  a  single word which is to be left capitalized when the
      resumes are processed.  The appearance of this word  in  the  RESUME.WRD
      file   must  itself  be  capitalized.   If  a  word  which  is  entirely
      capitalized in the resumes is to be converted entirely to lower case, as
      for  example  if  the words AND and OR appear in company or school names
      which were originally entirely capitalized, then the capitalized version
      of each word should be followed on the same line by 1 or more spaces and
      then by the desired lower case form of the word.  The  2  appearance  of
      the  word on the line must each contain the same number of letters.  The
      RSMMIX program cannot be used to change to or from the abbreviations  of
      words.   There  can be at most 1000 reserved words containing a total of
      5000 letters.
46                                           RESUME Program Office Guide


The following lines are typical of  those  which  might  appear  in  the
RESUME.WRD file.

USA
UN
AND and
OR or
NATO


              CALCULATION OF FILE NAMES BASED ON PASSWORDS
              ----------- -- ---- ----- ----- -- ---------

The names of the files in which the resumes are stored  are  constructed
from  the  class  number  and  from a number which uniquely identifies a
particular student in that class.   If  the  students  are  running  the
RESUME  program  from their own individual accounts, then the numbers by
which the computer system identifies their accounts from all others  are
used as the student numbers.  If the students are each assigned a number
and a password by the administrator, then these numbers are used in  the
construction  of  the  file  names  and  it is the responsibility of the
administrator to make sure that these numbers are unique  among  all  of
the students in the class.

If the students select their own passwords, then the program  calculates
a  number  based  upon  the password, and the program verifies that this
number is not being used for any other resume in the  same  class.   The
alphabetic letters A through Z and the digits 0 through 9 are allowed in
the passwords.  The password can consist of up to 20 of these characters
counting  each  separation  between  words  as 1 character.  The program
converts this password into a 6 digit number.  The resulting numbers are
not  unique  since there are many more possible passwords than resulting
numbers.  For example, all of the numbers 0 through 1 less  than  10  to
the 20th power could be used as passwords, and then there are all of the
possible combinations of up to 20 alphabetic letters and digits.

If half a million students in the  same  class  were  to  put  in  their
resumes  using  the  program, there would be 1 chance in 2 that the next
student who had not run the program before would choose a password which
would  be  converted  to  a number which was the same as that calculated
from a password which was already in use.  To guard against this student
from  gaining access to an existing resume, the password selected by the
student is stored in the same file as  the  resume.   The  program  then
checks  the  password  stored  in the selected file against the password
which the user has typed in, and if these do not match, then the user is
instructed  to  select  another password.  Although both the password as
typed by the student and that stored in the file must  be  divided  into
the same number of words, capitalization and the actual number of spaces
between the words are ignored.

The method used to convert the password to a number treats the  password
as a radix 37 number.  Each allowed character is assigned a value in the
range 0 through 36.  Moving from the right  end  of  the  password,  the
value  assigned  to the first or rightmost character is multiplied by 1,
the second is multiplied by 1*37 (where * represents times or multiplied
      Calculation of File Names Based on Passwords                          47


      by)  and  is  added  to the first, the third is multiplied by 1*37*37 or
      1369 and is added to the sum of the first and the  second,  and  so  on.
      This  is  analogous  to  the  way in which an ordinary decimal number is
      evaluated, except that, in the  ordinary  case,  the  second  number  is
      multiplied by 1*10 and the third by 1*10*10 and so on.  The values which
      are assigned to the allowed characters are as follows:

                  0 = The separation between words
       1 through 26 = the alphabetic letters A through Z
      27 through 36 = the digits 0 through 9

      When the resulting number is 1000000 or greater, only  the  rightmost  6
      decimal  digits  are  retained.   Thus,  the number corresponding to the
      password S0QB, in which the second character is the digit zero, would be
      calculated in the following manner:

      S has a value of 19
      0 has a value of 27
      Q has a value of 17
      B has a value of  2

      19*1*37*37*37 + 27*1*37*37 + 17*1*37 + 2*1
      =    19*50653 +    27*1369 +   17*37 +   2
      =      962407 +      36963 +     629 +   2
      =     1000001

      The resulting rightmost 6 digits have the value 1, which is identical to
      the  value  calculated for a password consisting of the single letter A.
      The first 20 passwords for which the rightmost 6 digits of  the  numbers
      calculated  from  them  have  the  same  value  as  that  for a password
      consisting of the single letter A are listed below.

        S0QB= 1000001 CGP1G= 6000001 E5FBL=11000001 HS5MQ=16000001
       ABQ7C= 2000001 C0GHH= 7000001 FN6SM=12000001 IBV3R=17000001
       AVHND= 3000001 DI7YI= 8000001 F7W9N=13000001 IVMJS=18000001
       BD84E= 4000001 D2YEJ= 9000001 GQNPO=14000001 JEC0T=19000001
       BXZKF= 5000001 ELOVK=10000001 H D6P=15000001 JX4GU=20000001

      Since the space between  words  is  represented  by  the  absence  of  a
      character, there are no passwords with rightmost spaces.  This is unlike
      the evaluation of ordinary decimal numbers in which 1 is not  equivalent
      to  10  or to 100 since zero is itself a placeholder.  As one progresses
      through all possible passwords, some of  the  corresponding  values  are
      therefore skipped.  For example in the following table

        99  = 1368    A 9  = 1405    A99  = 2737    B 9  = 2774
      (A--) = 1369   (AA-) = 1406   (B--) = 2738   (BA-) = 2775
       A A  = 1370    AAA  = 1407    B A  = 2739    BAA  = 2776

      the passwords shown in parentheses  with  minus  signs  where  the  word
      separations  would  be  necessary  for  the calculation of the indicated
      values would have to have word separations beyond  the  rightmost  words
      and  are  impossible.  There are, of course, longer passwords which have
      the rightmost 6 digits of their  calculated  values  equivalent  to  the
      values  corresponding  to  these  impossible  cases so all values in the
48                                           RESUME Program Office Guide


range 0 through 999999 can actually be used for file names.

The file name is constructed of the 6 digit number followed by a  period
and  then  by  the  class  number represented as a 3 digit number.  Both
numbers are right justified with zeros being filled in at the left.  The
password  B  used  by  a  member of the class of '83 would select a file
having 000002.083 as its name.


                           MACHINE DEPENDENCE
                           ------- ----------

The students who use the RESUME program  have  no  way  of  knowing  the
language  in  which  it is written.  All of the logic in the programs in
the student resume system is written in FORTRAN.  Together, the programs
contain  6000  FORTRAN  statements.   Most  of  this  code is completely
machine independent.  However, a few of the things which the programs do
must  be  performed  differently  on  different computers.  In so far as
possible, these machine dependent aspects  of  the  programs  have  been
isolated into routines which perform no other functions.

 1.  The BLOCK DATA  routine  specifies  the  locations  of  the  resume
     storage  account  and  the  printing  service  account.   These are
     specified  as  octal  project  and  programmer   numbers   in   the
     DECsystem10  version and as the account names in characters strings
     in the DECsystem20 version.

 2.  The BLOCK DATA routine specifies the sequence of  characters  which
     must  be  sent  to  the Diablo terminal to move the printhead 1/120
     inch to the right in order to misalign overprinting to get darkened
     letters.   These  characters are specified as several 36-bit values
     which can be written into the output file using a multiple of an A1
     format.   The  sequence  of  characters will have to be changed for
     other terminals.  The bit codes will have to be changed  for  other
     computers.   These  characters  are used only in the RSMPRF routine
     which writes the reformatted resumes into an output file.

 3.  The BLOCK  DATA  routine  specifies  the  relative  widths  of  the
     characters  in  a particular type font for typesetting.  This table
     will have to be redefined if any other type font is  used  instead.
     The  table is not used if the resumes are typed on a letter quality
     typewriter.

 4.  The RSMHLP routine which issues the help messages  has  been  built
     assuming  that  the RESUME program will be run from video terminals
     which can display 24 lines on the screen.  The .PAGE LENGTH command
     in  the  rough  form of these messages specifies a value which is 2
     lines less than the maximum number of lines which can be  shown  on
     the  screen,  so  that  there  is room at the bottom for the "PRESS
     RETURN TO CONTINUE" message.  The .PAGE LENGTH command will have to
     be  changed  correspondingly  if  the program is run from terminals
     which cannot show a full 24 lines on the  screen,  and  the  FORMAT
     program  will  have to be run again to produce a new version of the
     RSMHLP routine.  The RSMHLP routine does not have to be rebuilt  if
     the program is being run from a hardcopy terminal instead.
      Machine Dependence                                                    49


       5.  The GETLIN routine which reads in a line from the terminal discards
           control  characters  on  the DECsystem10 and DECsystem20 computers.
           Any character read by a multiple of an A1 format which has a  value
           between  0 (integer zero, not '0') and ' ' (the space character) is
           discarded.  The 2 statements which perform these tests will have to
           be removed for use on any other computer.

       6.  The OPEN statements in the RSMOPN routine and the CLOSE  statements
           in  the  RSMCLS  routine  will  have to be changed for use on other
           computers.  On  the  DECsystem10  and  DECsystem20  computers,  the
           RSMDIR  routine  also  opens,  reads  from  and closes a file which
           contains a directory of  the  account  in  which  the  resumes  are
           stored.   Other  than  this,  all  opening  and closing of files is
           performed by the RSMOPN and RSMCLS routines.

       7.  A few simple assembly language routines are  used  to  control  the
           manner   in  which  the  computer  system  manages  the  typing  of
           characters onto the terminal, to identify the account being used to
           run the program and to exit gracefully without the usual time usage
           messages.  The following is  a  complete  list  of  these  assembly
           language routines.

           TTYSET sets the characteristics of the controlling  terminal.   The
           most  important  of  these  is  the turning off the pausing after a
           certain number of lines have been displayed  on  the  screen.   The
           RESUME program does its own parcelling out of lines to the screen.

           JOBINF returns information about the account from which the program
           is  being run.  The information which is returned includes the name
           of the account, the  corresponding  project  number  which  on  the
           DECsystem20   always   has  the  value  4,  and  the  corresponding
           programmer number.  The DECsystem10  version  of  this  routine  is
           called PPNU which stands for Project Programmer NUmber.

           LEAVE exits from the program without the time  statistics  produced
           by the FORTRAN STOP statement.

       8.  The RSMWIP routine clears the screen of a video terminal by  typing
           a  form  feed.   This  may  have  to  be  done differently on other
           computer systems.

       9.  The NEWDAT routine returns the current date as the  numeric  month,
           day  and  year.   These are obtained by decoding a double precision
           word containing the date in a form similar to  '10-Oct-83'.   Since
           FORTRAN has no standardized date routine, this also will have to be
           done differently on other computer systems.

      10.  The RSMCUL routine screens out characters which appear on an  ASCII
           keyboard  but  which  do  not  appear  on  an  88  character Diablo
           printwheel.  The list of these characters will have to  be  changed
           if  the  program is used with a different letter quality typewriter
           or if the program is used on a computer in which FORTRAN  does  not
           allow all of these characters to appear in DATA statements.
50                                           RESUME Program Office Guide


11.  The DAVERB routine which is used to identify  words  typed  by  the
     user  contains  an  array  of the lower case alphabetic letters 'A'
     through 'Z' sorted in numerical  order.   On  the  DECsystem10  and
     DECsystem20,  this  order  also  happens  to  be  the  same  as the
     alphabetic sort.  If the numeric values of 'a' through 'z' sort  in
     some  other  order,  then  the  array  containing  the  lower  case
     characters will have to be changed, and the  array  containing  the
     upper case characters will have to be changed to remain parallel to
     the new ordering.

12.  The RSMSRT program  sorts  the  student  names  assuming  that  the
     numerical  sort  of  the  upper case letters 'A' through 'Z' is the
     same as the alphabetic sort of these same characters.  The  sorting
     procedure will have to be changed if this is not the case.

13.  The RSMWHO routine calls the JOBINF routine to obtain the  name  of
     the current account and the programmer number of this account.  The
     RSMWHO routine then converts these into a form which can be used by
     the rest of the program.  This conversion is machine dependent.

14.  The RSMDIR routine returns the student number and class  number  of
     the  next  resume file in the resume storage account.  It does this
     by reading a file produced by the DIRECTORY command.  This  routine
     will have to be changed for use on other computers.

15.  The DAHEFT, DAMISS and DAVERB routines are general  routines  which
     interpret  a  line  of text read from the terminal.  These routines
     all treat a horizontal tabulation or tab character as equivalent to
     a  space.  In order to identify the tab character, a variable named
     ITAB is defined as the octal value "045004020100 in each  of  these
     routines.   This  definition  will  have  to  be  changed  on other
     computers, either to the actual numeric value of 'tab' or 1Htab, or
     else to 'space' or 1Hspace, where the words tab and space are meant
     to represent the nonprinting characters tab and space respectively.

16.  The RSMPSW program contains code for accepting file names from  the
     user,  and OPEN and CLOSE statements.  This FORTRAN code is simple,
     but will have to be changed for use on other computers.

17.  The RSMPSW program contains a call  to  the  SETRAN  routine  which
     initializes  the  RAN  random  number  function.  The corresponding
     routine on other systems may have a different name and may  require
     different calling arguments.


        DIFFERENCES BETWEEN DECSYSTEM10 AND DECSYSTEM20 VERSIONS
        ----------- ------- ----------- --- ----------- --------

The student resume system was developed on a DECsystem20 computer.   The
programs  have  been modified for the DECsystem10.  These computers have
basically the same hardware.  Only the operating systems are  different.
The  main  differences  between  the versions for the 2 computers result
from the differences in the account structures.
      Differences Between DECsystem10 and DECsystem20 Versions              51


      The following is a list of the differences between the  DECsystem10  and
      the DECsystem20 versions.

       1.  In the BLOCK DATA routine in the DECsystem10 version,  the  account
           in  which  files  are  stored  and the account used by the printing
           service are specified by project and programmer numbers.   Each  of
           these  accounts  is specified by an integer array dimensioned at 3.
           The project number is in the first location, the programmer  number
           is  in the second location and a zero is in the third location.  In
           the  DECsystem20  version,  the  locations  of  these  accounts  is
           specified  by  name in character strings which are each dimensioned
           for 40 characters.

       2.  In  the  RSMOPN  routine  in  the  DECsystem10  version,  the  OPEN
           statements  which  open  the files which are to be written into the
           storage account and into the printing  service  account  specify  a
           protection  code  of octal 100.  This allows subsequent versions of
           the same files to replace the current versions.  In the DECsystem20
           version,  the  default  file protection for the accounts into which
           the files are being written can be set so as to  allow  overwriting
           by  subsequent  versions  so  it  is  not  necessary  that the OPEN
           statements specify the protection codes.

       3.  In the RSMDIR routine in the DECsystem10  version,  it  is  assumed
           that  the  file  names  in the file containing the directory of the
           storage account each start in column 1 and  that  there  is  a  tab
           character  between  the  6  character  name  and  the  3  character
           extension.  In the DECsystem20 version, the  file  names  start  in
           column 2 and a period appears between the name and the extension.

       4.  In the RSMWHO routine in the DECsystem10 version, the name  of  the
           account  is  assumed  to  just  be the octal project and programmer
           numbers converted so that these can be written with a 40A1  format.
           The unique number which is returned for the account is actually the
           programmer number so that the programmer can access the same resume
           from  any  project  for  which  the  programmer  has  an account if
           passwords are not being used to gain access to the RESUME  program.
           In the DECsystem20 version, the actual account names are used.  All
           accounts have the same project number.  The  programmer  number  is
           unique to the particular account so only the account which was used
           when the resume was started can modify  it  if  passwords  are  not
           being used.

       5.  In the assembly language routines in the DECsystem10 version, UUO's
           are  used.  The routine which sets terminal characteristics is just
           a dummy entry point.  In the DECsystem20 version, JSYS's  are  used
           instead  of  UUO's.   UUO's  and  JSYS's are the names given to the
           monitor calls for the 2 operating systems.

      When  setting  up  the  accounts  on  the  DECsystem10,  the  user  file
      directories  or UFD's of the accounts into which files are to be written
      from other accounts should  be  given  protection  codes  of  777.   The
      procedure  for  this  would be to log into the accounts, and then to run
      the PIP program to rename the UFD for each disk structure.  For example,
      the  following  dialog  could  be  used  to change the protection of the
52                                           RESUME Program Office Guide


account on the DSKB: structure.

R PIP
/R<777>=DSKB:[123,456].UFD
^C

It must be noted that the UFD for a structure will  disappear  when  the
job  is  logged off unless there is at least one file in the UFD on that
structure.  Therefore, a dummy file, perhaps named A. to force it to  be
first in the sorted directory, should be created on each structure.

The batch control file which is used on the  DECsystem20  both  expunges
the storage account and creates a file containing a list of the files in
this account.  The expunging is the most important part of this process,
since  the  students  could  be  blocked from running the program by old
versions of the resumes if the disk quota  were  to  be  exceeded.   The
directory  file  could be created using a command given manually.  Files
are always expunged immediately on the DECsystem10, so the only function
which  the  batch  control  file  would serve would be the making of the
directory.  A batch control file is not  included  for  the  DECsystem10
version,  so  the  administrator  will  have  to create a directory file
before using the administrative programs  to  process  a  collection  of
resumes.   The  procedure  here  would  be  to log into the file storage
account and issue the command

DIRECT RESUME.DIR=*.*

The RSMCHK routine which determines whether the account  being  used  is
allowed  to  run these programs is able to handle either the DECsystem10
account numbers or the DECsystem20 account names.  The contents  of  the
entries   in   the   RESUME.WHO  file  control  which  type  of  account
specification is matched.  If the file contains numbers enclosed between
square  brackets,  then the DECsystem10 account numbers are matched.  If
the file contains account names enclosed between less than  and  greater
than signs, then the DECsystem20 account names are matched.


                 LIST OF FILES INCLUDED IN THIS PACKAGE
                 ---- -- ----- -------- -- ---- -------

The distributed version  of  the  student  resume  system  contains  the
following  source  files.   Versions  are  included  for use on both the
DECsystem10 computer and the DECsystem20 computer.

ADMLIB.FOR  Routines which are needed only for the RSMADM program.

BLKD10.FOR  BLOCK DATA routine which must be  loaded  with  the  various
            programs on the DECsystem10.

BLKD20.FOR  BLOCK DATA routine which must be  loaded  with  the  various
            programs on the DECsystem20.

FORMAT.FOR  The version of the FORMAT program which is needed to convert
            the  rough  form of the help messages in the RSMHLP.RNO file
            into FORTRAN source code.
      List of Files Included in this Package                                53


      LIBALL.FOR  Routines which are needed by  more  than  just  one  of  the
                  programs   in   this   package,  but  which  are  relatively
                  independent of the particular computer being used.

      LIBD10.FOR  Versions of routines which are specific for the  DECsystem10
                  computer.

      LIBD20.FOR  Versions of routines which are specific for the  DECsystem20
                  computer.

      MACD10.MAC  Assembly language routines for the DECsystem10 computer.

      MACD20.MAC  Assembly language routines for the DECsystem20 computer.

      RESUME.CTL  Batch control file for the DECsystem20 computer.  The  batch
                  job really isn't necessary on the DECsystem10 computer.

      RESUME.FOR  The major portion of the RESUME program.

      RSMADM.FOR  The major portion of the administrative program.

      RSMHLP.FOR  The FORTRAN source code which  produces  the  help  messages
                  which  can  be  typed  by  the RESUME program.  This file is
                  produced by using the FORMAT program to  process  the  rough
                  form of the messages in the RSMHLP.RNO file.  The RSMQUO.FOR
                  file contains the  same  messages  specified  in  apostrophe
                  notation, rather than the H notation in which they appear in
                  the RSMHLP.FOR file.

      RSMHLP.RNO  The rough form of the help messages which can  be  typed  by
                  the  RESUME  program.   This must be processed by the FORMAT
                  program to produce FORTRAN source code which can  be  loaded
                  with  the RESUME program.  The version of the FORMAT program
                  which is used must be from the summer of 1983 or later.

      RSMLIB.FOR  Routines which are needed only for the RESUME program.

      RSMMIX.FOR  The program used to convert resumes which were prepared  for
                  typed final copies to the starting versions of resumes which
                  will be typeset.

      RSMPSW.DAT  A file containing  5000  possible  passwords  which  can  be
                  assigned to the students using the RSMPSW program.

      RSMPSW.FOR  The program which can be used to assign  passwords  selected
                  from  any arbitrary text file.  The program consists only of
                  a main program and does not use any subroutines.

      RSMPSW.RNO  A file which can be processed by the FROFF  word  processor,
                  together  with  one  of  the  files  produced  by the RSMPSW
                  program, to produce form letters which can be given  to  the
                  students  telling  them  what  their passwords will be.  The
                  description in this file of the account to be used will have
                  to be changed.
54                                           RESUME Program Office Guide


RSMQUO.FOR  A version of the FORTRAN source code which produces the help
            messages.    These  messages  are  specified  in  apostrophe
            notation, rather than the H notation in which they appear in
            the  RSMHLP.FOR  file.   The RSMQUO.FOR file was produced by
            inserting a .USE' command into the RSMHLP.RNO file before it
            was processed using the FORMAT program.

RSMSRT.FOR  The program used to sort the student names.

The following files contain the instruction manuals and the  rough  form
of the text from which these manuals were constructed.

OFFICE.DOC  The administrator instruction manual.  This is  produced  by
            using  the FROFF word processor to process the rough form of
            the manual in the OFFICE.RNO file.

OFFICE.RNO  The rough form  of  the  administrator  instruction  manual.
            This is meant to be processed by the FROFF word processor.

USERS.DOC   The student instruction manual.  This is produced  by  using
            the  FROFF  word  processor to process the rough form of the
            manual in the USERS.RNO  file.   To  incorporate  an  actual
            example  of  a resume produced using the RESUME program, the
            first page of the last section in the manual can be replaced
            by  the  combination  of  USERS0.DOC and either of the files
            USERS1.DOC or USERS2.DOC.

USERS.RNO   The rough form of the student instruction manual.   This  is
            meant to be processed by the FROFF word processor.

USERS0.DOC  Top of the first page in the last  section  of  the  student
            instruction  manual.   Either  of  the  files  USERS1.DOC or
            USERS2.DOC can be typed on the rest of this page to  provide
            an  actual  example  of  a  resume produced using the RESUME
            program.

USERS0.RNO  The rough form of the top of the  first  page  in  the  last
            section of the manual which can be used if an actual example
            of a resume produced using  the  RESUME  program  is  to  be
            inserted into the student instruction manual.

USERS1.DOC  An example of a  resume  ready  to  be  typed  on  a  Diablo
            terminal.  Either this resume or that in the USERS2.DOC file
            should be superimposed upon the  first  page  in  the  final
            section  of the student instruction manual in the USERS0.DOC
            file.

USERS2.DOC  An example of a resume ready to be typed on a fast  printer.
            Either  this resume or that in the USERS1.DOC file should be
            superimposed upon the first page in the final section of the
            student instruction manual in the USERS0.DOC file.

The following files can be placed into the resume  storage  account  for
testing  the  programs  in this package.  The account numbers or account
name of the resume storage account must also be inserted into the  BLOCK
      List of Files Included in this Package                                55


      DATA routine before the programs can be tested.

      MESAGE.999  An example of the message file.  This  version  is  for  the
                  demonstration class 999.

      RESUME.WHO  An example of an  account  validation  file.   This  version
                  allows  all  accounts  to be in the demonstration class 999.
                  Of course, the line which does this must be replaced  before
                  the RESUME program is used by the students.

      RESUME.WRD  Data file for the RSMMIX program which specifies a  list  of
                  words which are to be left entirely capitalized.

      SCHOOL.999  An example of the file which describes  the  current  degree
                  program.  This version is for the demonstration class 999.

      090186.999  An example of a file in which a  resume  is  stored  in  the
                  resume storage account.  This file contains the resume which
                  appears as an example at the end of the student  instruction
                  manual.   It  can be referenced using the password SAMPLE in
                  class 999.

      The following command files are included for loading the programs in the
      student resume system on both the DECsystem10 and DECsystem20 computers.
      The versions of these command files for the DECsystem10 and  DECsystem20
      are  identical  except  that  the  letters  "D10"  in  the one have been
      replaced by "D20" in the other.

      ADMD10.CMD  Command file for loading the RSMADM program  on  DECsystem10
                  computer.

      ADMD20.CMD  Same for the DECsystem20 computer.

      MIXD10.CMD  Command file for loading the RSMMIX program  on  DECsystem10
                  computer.

      MIXD20.CMD  Same for the DECsystem20 computer.

      RSMD10.CMD  Command file for loading the RESUME program  on  DECsystem10
                  computer.

      RSMD20.CMD  Same for the DECsystem20 computer.

      SRTD10.CMD  Command file for loading the RSMSRT program  on  DECsystem10
                  computer.

      SRTD20.CMD  Same for the DECsystem20 computer.