Last updated 19 Nov 97
PRTCAS computes and prints individual job descriptions for each member of a specified group. A duty and/or task level job description may be produced. An optional column may be printed on each job description which contains the performance emphasis value for the corresponding task or duty.
An additional feature of PRTCAS is the ability to add a table of up to 500 background and/or computed variables. The value for each variable will be printed on the report for each case. If desired, a Code Values file may be specified which contains codes which will be substituted for the value for a given variable. This capability allows text strings to replace numeric or alphabetic values (e.g. a value for grade of 3 can be replaced by 'SrA' or 'Senior Airman'). All Code Values files must be created by the user.
Program Invocation
The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.
opt: P Print a column of performance emphasis values
V Print requested variables only, do not print task/duty reports
ssss: The study number
CDf: Input Case Data file
TFf: Input Task Factor file
TT: Input Task Title file, required if V option not used
VTf: Input Variable Title file, required if any computed and/or
background variables are to be reported
CVf: Input Code Values file, required only if coded values are to be
substituted for any of the computed or background variables
PRTCAS Control Card
PRTCAS: cc 01-06 The literal 'PRTCAS' study: cc 08-11 The study number for this run group: cc 13-18 The membership selection mask of the group of individual job descriptions desired report: cc 20 The type of report to print 'D' - Print a Duty level report 'T' - Print a Task level report ' ' - Print both reports (default) sort: cc 22 The sort sequence for printing N - do not sort nor suppress printing of unperformed tasks M - sort on percent members performing T - sort on average percent time spent (default) time: cc 24-29 Maximum cumulative time spent to print (default=100.0) task: cc 31-34 Maximum number of tasks to print (default= all tasks)
Variable Selection Set (optional)
This set of cards is used to specify the computed and background variables which are to be listed on each report. If this set of control cards is included, the Variable Titles file must be included on the program invocation line. As many as 500 variables may be selected.
Variables Card
VAR: cc 01-03 The literal 'VAR'
Variable Selection Cards
This section describes the format for requesting the variables to be reported. Any blank field on these cards will be ignored. As many cards as required may be used until a maximum of 500 variables has been selected. These cards are terminated by an '@EOF'.
var1: cc 01-05 The Variable ID to report (e.g. V0004) d1: cc 06 The literal '-' or blank var2: cc 07-11 The next Variable ID to report d2: cc 12 The literal '-' or blank var3: cc 13-17 The next Variable ID to report d3: cc 18 The literal '-' or blank var4: cc 19-23 The next Variable ID to report d4: cc 24 The literal '-' or blank var5: cc 25-29 The next Variable ID to report d5: cc 30 The literal '-' or blank var6: cc 31-35 The next Variable ID to report d6: cc 36 The literal '-' or blank var7: cc 37-41 The next Variable ID to report d7: cc 42 The literal '-' or blank var8: cc 43-47 The next Variable ID to report d8: cc 48 The literal '-' or blank var9: cc 49-53 The next Variable ID to report d9: cc 54 The literal '-' or blank var10: cc 55-59 The next Variable ID to report d10: cc 60 The literal '-' or blank var11: cc 61-65 The next Variable ID to report d11: cc 66 The literal '-' or blank var12: cc 67-71 The next Variable ID to report d12: cc 72 The literal '-' or blank var13: cc 73-77 The next Variable ID to report
By including a '-' character between any two fields on the card above, a complete range of variables may be selected. For example, if var1 had the value V0003, var2 had the value V0010, and d1 was blank, the variables V0003 and V0010 only would be reported. If the d1 field contained a '-', the variables V0003 through V0010 inclusive would be reported. When using this feature the variables specified on either side of the dash must be of the same type (both background or both computed variables) or the dash will be ignored.
Report Note Cards (optional)
The cards in this section are textual notes that are to be printed on the report. There is no limit on the number of note cards which may be used. All cards found between the 'NOTE' card and the '@EOF' card will be treated as notes.
NOTE . notes . @EOF
@codap prtcas p ssss cd100 tf100 tt001 vt100 codes PRTCAS ssss GP0007 VARIABLES C0002 C0008 V0002-V0007 V0009 V0012 V0017 V0019-V0025 @EOF @EOF
This example would produce one report for each member of GP0007. The computed and background variables would be reported for each case as the first table in each report. The use of the P option would cause the performance emphasis values to be printed.
@codap prtcas - ssss cd100 tf100 tt001 vt100 codes PRTCAS ssss ST0033 @EOF
This example would print the job description for each member of stage 33. No computed variables or background variables would be reported.