SUBSEL will create a file as a subset of an input Case Data file, based on the selection criterion of any specified membership mask in a Task Factor file.
Automatic Process Generation
SUBSEL will generate a follow-on runstream based on information given on the program invocation line. An output Task Factor file will cause the execution of GRPJOB for incumbent data input. If a Task Title file is specified, a PRTJOB will also be run. If the R option is used, a GRPREL will be run instead of the GRPJOB/PRTJOB. Additionally, if a Variable Title file is given, an AUDITD runstream will be created. This entire runstream is started unless the 'X' option is specified.
Program Invocation
The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.
opt: R Generate a GRPREL
X Do not execute generated runstream
ssss: The study number
CDf: Input Case Data file
TFf: Input Task Factor file
CDg: Output Case Data file
TFg: Output Task Factor file
VTf: Input Variable Title file
TTf: Input Task Title file
SUBSEL Control Card
SUBSEL: cc 01-06 The literal 'SUBSEL' study: cc 08-11 The study number for this run gpid: cc 13-18 The group selection mask ID title: cc 20-79 The title for the output Case Data file
@codap subsel - ssss cd100 tf100 cd110 tf110 vt100 tt001 SUBSEL ssss GP0002 New title for the output
Case Data file cd110 will be created. It will contain all cases that make up GP0002 from Task Factor file tf100. A GRPJOB and PRTJOB runstream will be run using tf110 as the Task Factor file. An AUDITD distribution of the background variables will also be generated.