Last updated 18 Nov 97
INPSTD reads the good output file produced by AUDITR and creates a Case Data file. The program integrates the data with the Task Within Duty Table, background variable definitions, and task titles to create the fundamental CODAP data base, the Case Data file. INPSTD accepts as input rater data such as training emphasis or task difficulty ratings, as well as primary and secondary incumbent data. INPSTD creates the Case Data file which contains computed (floating point), background (character), and task (partial word integer) variables for every case. Rater task data is left in its raw form. Incumbent task data responses are converted into relative time spent values.
In addition, two methods exist to weight the task responses. The first method applies a factor from 1-9 specified by the user to each task response. This means that the task responses on the Case Data file will be the product of the raw response and the specified factor. For more complicated weighting schemes a second, more general (albeit more difficult to use) method has been provided. By providing a 1-9 value for the 'wopt' field on the INPSTD control card below, the user tells INPSTD that a weight substitution deck will be submitted for processing. This deck must contain 1 card for each scale point (i.e. a 1-9 rating scale would require 9 cards) with a maximum scale substitution of 100 points allowed. This method will not work for larger rating scales. Each value read from a scale substitution card will be substituted for the respective scale point for all task responses with that rating (e.g. the value from card 1 will replace all responses which equal 1, etc.).
INPSTD creates the first ten computed (floating point) variables automatically recording input sequence of case within file (C0001), number of tasks performed (C0007), number of tasks performed squared (C0010), etc. In addition this program also computes and adds the three sets of duty variables - percent time spent in each duty, number of tasks performed in each duty, and percentage of tasks performed in each duty. These variables are added to the computed variables.
Automatic Process Generation
INPSTD will generate a follow-on runstream based on information given on the program invocation line. If an output Variable Titles file is given, a MAKDFL, DICTXX, and AUDITD will be run. If a Task Title file is specified that does not already exist, MAKTFL and TASKXX will be run. If a Task Factor file is also specified, INPSTD causes the execution of GRPJOB and PRTJOB for incumbent data or GRPREL for rater data input. This created runstream will always be executed and cannot be suppressed.
Program Invocation
The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.
opt: I Incumbent data, convert raw ratings to relative time spent (default)
N NOGO, scan control cards for errors
R Rater data input, do NOT convert to relative time spent.
E Use 'E' option on generated GRPREL
A Adjust and standardize ratings in the generated GRPREL
L Limit generated GRPREL to one iteration
ssss: The study number
RDf: Input raw data file from AUDITR
CDf: Output Case Data file
VTf: Output Variable Titles file
TT: Output Task Title file
TFf: Output Task Factor file
The input file used by this program must be the file produced as the good output file by the AUDITR program.
INPSTD Control Card
INPSTD: cc 01-06 The literal 'INPSTD' ncase: cc 08-12 Number of cases on the input file nduty: cc 14-15 The number of duties wopt: cc 17 Weight substitution flag. The default response blank or zero implies a weight deck will not be added. Any response 1-9 will cause this deck to be read. This deck follows the Task Within Duty Table. factor: cc 19 This field will accept a 1-9 response. Valid task responses for all cases will be multiplied by the value received in this field. This can be used as a means of weighting the responses. Default = 1.0 title: cc 21-80 The title of the output file.
Task Within Duty Cards
The Task Within Duty cards that were generated by AUDITT may be submitted to INPSTD in the following way:
filespec: The Task Within Duty cards
The standard form for the Task Within Duty cards can be found in the Common Cards document.
Weight Substitution Cards (Optional)
The weight substitution cards may be added to the INPSTD run if the 'wopt' field of the INPSTD control card is not blank or zero. One card must be submitted for each point on the rating scale. The rating scale must consist of less then 100 unique scale points.
value: cc 01-10 The substitution value
Background Variable Definitions
The background variable definitions that have been verified by AUDITV may be submitted to INPSTD in the following way:
filespec: The background variable definitions.
The standard format for background variable definitions can be found in the Common Cards document.
Task/Duty Titles
The task/duty titles that have been verified by AUDITT may be submitted to INPSTD in the following way:
filespec: The Task/Duty Titles
The standard form for the Task/Duty Titles can be found in the Common Cards document. Examples
@codap inpstd - ssss rd100 cd100 vt100 tt001 INPSTD 200 12 This is the title field @add twdt @add variable.ids @add task.duty.titles @eof
Case Data file cd100 will be created. Because a Variable Title (vt100) file has been specified, INPSTD will generate a MAKDFL, DICTXX, and AUDITD for that file. Likewise, a MAKTFL and TASKXX will be generated for Task Title file tt001.
@codap inpstd r ssss rd200 cd200 - tt001 tf200 INPSTD 55 12 1 Rater data example @add twdt @add variable.ids.td @add task.duty.titles @eof
In this example, the output is a Task Learning Difficulty Case Data file (cd200). This INPSTD run also creates a Task Title file. Since the 'R' option has been used, an interrater reliability report (GRPREL) will be produced (otherwise a job description for all cases would be printed).