GRPJOB computes job descriptions for each requested group. The output job description factors contain the percent time spent (PTS) data and the percent members performing (PMP) data. A PRTJOB can optionally be generated to print job description reports.
Automatic Process Generation
GRPJOB will generate a PRTJOB runstream if a PRT card is encountered and the P option is specified. This runstream will be executed unless the X option is also specified.
Program Invocation
The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.
opt: P Execute generated PRTJOB
X Suppress execution of generated PRTJOB
ssss: The study number
CDf: Input Case Data file
TFf: Input/output Task Factor file
TT: Input Task Title file. Required if a PRTJOB is to be generated.
GRPJOB Control Card
GRPJOB: cc 01-06 The literal 'GRPJOB' study: cc 08-11 The study number for this run title: cc 13-72 Optional report title
Alternative Job Description Request Sets
The control cards in the following two sections describe the information needed for only computing or computing and printing any job descriptions desired. In the following section the method for requesting a job description computation is covered. In the section after that, the method for requesting the computation and printing of a job description is explained. There is no limit on the number of control card sets which can be used or combined in a single run.
Compute Job Descriptions Only (Group ID Card)
This section describes the format for requesting the computation of job descriptions. There is no limit to the number of requests that can be made. Any group requested must have a membership vector on the Task Factor file.
group: cc 01-06 The Group ID for membership (e.g. GP0001) title: cc 08-67 The new title for the group. If blank, the title from the membership vector will be used.
Compute and Print Job Descriptions
The set of control cards described in this section define the requirements for requesting the computation of group job descriptions and then having the computed descriptions printed on the output report.
Begin Group Sets to Compute and Print
This card identifies the beginning of this set of control cards and specifies the parameters to be used in printing the job descriptions in this set.
PRT: cc 01-03 The literal 'PRT' report: cc 05 The type of report to print 'D' - Print a Duty level report 'T' - Print a Task level report ' ' - Print both reports (default) 'W' - print tasks within duty or module sort: cc 07 The sort sequence for printing 'N' - do not sort nor suppress printing of tasks with zero percent time 'M' - sort on percent members performing 'T' - sort on percent time spent (default) time: cc 09-14 The maximum cumulative time spent to print. The default is 100.0 percent. task: cc 16-19 The maximum number of tasks to print. The default is all tasks.
Report Note Cards
This card may be repeated as often as desired. The note cards (even if none are used) MUST be terminated by an '@EOF'.
notes... @EOF
Job Description Request Cards
Use the Group ID Cards as shown above. As many request cards as desired may be submitted at this point. These cards specify the groups which will have their job descriptions computed and printed. These cards are terminated by an '@eof' image.
The control cards are terminated by an end-of-file or an '@eof' image.
Examples
@codap grpjob - ssss cd100 tf100 tt001 GRPJOB ssss This is the GRPJOB report title PRT Sample note cards to be added for the job descriptions in this control card set (GP0003-GP005). The printed reports will be task-level job descriptions. @EOF GP0003 This group will be printed GP0004 This group will be printed GP0005 This group will be printed @EOF
This is an example of the normal use of GRPJOB. This run will compute the job descriptions (percent time spent/PTS and percent members performing/PMP) for the specified groups (e.g., GP0003) which actually represent membership vectors computed in MEMSEL (i.e., GP0003/MBR). Each new group-factor combination (e.g., GP0003/PTS and GP0003/PMP) will be added to Task Factor file TF100.
@codap grpjob - ssss cd100 tf100 tt001 GRPJOB ssss This is the GRPJOB report title GP0001 @EOF
This example will compute the job description for GP0001 and add it to Task Factor file tf100. No PRTJOBs will be generated.
@codap grpjob - ssss cd100 tf100 tt001 GRPJOB ssss GP0001 This group will be computed but not printed GP0002 This group will be computed but not printed PRT Sample note cards to be added for the job descriptions in this control card set (GP0003-GP005). The printed reports will be task-level job descriptions. @EOF GP0003 This group will be printed GP0004 This group will be printed GP0005 This group will be printed @EOF
This example shows a mix of computing job descriptions and computing/printing job descriptions. Only GP0003, GP0004, and GP0005 are passed on to the generated PRTJOB runstream.