STGJOB computes job descriptions and membership vectors for any stage in a cluster solution. The new job description is given a name of 'STxxxx', where xxxx is the stage number. The new job description vectors contain the percent time spent (PTS) data and the percent members performing (PMP) data for each task of the requested group. The job descriptions which are computed may be printed at any time using the PRTJOB program. Additionally, if the proper control cards are added to a STGJOB run, a PRTJOB runstream will be generated and performed which will print job description reports for the new job descriptions.
Automatic Process Generation
STGJOB 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 specified on the program invocation line.
Program Invocation
The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.
opt: N NOGO option, scan control cards for errors
P Execute generated PRTJOB
X Suppress execution of generated PRTJOB
ssss: The study number
CDf: Input Case Data file
CSf: Input Cluster Solution file
TFf: Output Task Factor file
TT: Input Task Title file. Required if a PRTJOB is to be generated.
STGJOB Control Card
STGJOB: cc 01-06 The literal 'STGJOB' study: cc 08-11 The study number pseq: cc 13-18 The presentation sequence ID title: cc 20-79 Optional report title
Alternative Job Description Request Sets
The control cards in the following two sections describe the information needed for computing, or computing and printing job descriptions for any stage desired. 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
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 valid stage in the cluster solution. The new job description vectors produced will be added to the Task Factor file. Any blank fields on the following card will be ignored.
STG: cc 01-03 The literal 'STG' stg1: cc 05-08 The next stage to compute d1: cc 09 The literal '-' or blank stg2: cc 10-13 The next stage to compute d2: cc 14 The literal '-' or blank stg3: cc 15-18 The next stage to compute d3: cc 19 The literal '-' or blank stg4: cc 20-23 The next stage to compute d4: cc 24 The literal '-' or blank stg5: cc 25-28 The next stage to compute d5: cc 29 The literal '-' or blank stg6: cc 30-33 The next stage to compute d6: cc 34 The literal '-' or blank stg7: cc 35-38 The next stage to compute d7: cc 39 The literal '-' or blank stg8: cc 40-43 The next stage to compute d8: cc 44 The literal '-' or blank stg9: cc 45-48 The next stage to compute d9: cc 49 The literal '-' or blank stg10: cc 50-53 The next stage to compute d10: cc 54 The literal '-' or blank stg11: cc 55-58 The next stage to compute d11: cc 59 The literal '-' or blank stg12: cc 60-63 The next stage to compute d12: cc 64 The literal '-' or blank stg13: cc 65-68 The next stage to compute d13: cc 69 The literal '-' or blank stg14: cc 70-73 The next stage to compute d14: cc 74 The literal '-' or blank stg15: cc 75-78 The next stage to compute
It is recommended that all stage job descriptions desired from a specific cluster solution be computed in one run of STGJOB because the program computes the job descriptions very efficiently, but the overhead involved in setting up the computations is about the same as that of GRPJOB. GRPJOB can compute stage job descriptions, but STGJOB is much better adapted for this purpose. By including a '-' character between any two fields on the card above, a complete range of job descriptions may be computed. For example, if stg1 had the value 3, stg2 had the value 10, and d1 was blank the job descriptions for stages 3 and 10 would be computed. If the d1 field contained a '-', the job descriptions for each stage 3 through 10 inclusive would be computed.
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 set to Compute and Print
Click here to see documentation for the PRTJOB 'PRT' card.
Report Note Cards
There is no limit on the number of note cards. Notes may be changed between groups sets by issuing another PRT and note card set. An @EOF card MUST be used following a PRT card to close-off the notes section.
Job Description Request Cards
These cards are identical to the previously defined request cards. As many request cards as desired may be submitted. These cards specify the groups which will have their job descriptions computed and printed.
These cards are terminated by an end-of-file or an '@eof' image.
@codap stgjob - ssss cd100 cs100 tf100 tt001 STGJOB ssss PS0002 PRT Stages selected from the enhanced case cluster solution (PS0002) @EOF STG 0233-0235 0250-0253 0278 0297 STG 0099 STG 0122 @EOF
This is the normal use of STGJOB. Job descriptions are computed and printed for stages 233-235, 250-253, 278, 297, 99, and 122 under enhanced presentation sequence PS0002.
@codap stgjob - ssss cd100 cs100 tf100 STGJOB ssss PS0001 Sample title for the stgjob report STG 0001-0008 0121 0012 0148-0150 @EOF
This example computes the complete job descriptions for stages 1-8, 121, 12, and 148-150 and adds them to Task Factor file TF100 (stages based on presentation sequence PS0001). Since no job descriptions will be printed in this example, it was not necessary to specify a Task Title file on the processor call card.
@codap stgjob - ssss cd100 cs100 tf100 tt001 STGJOB ssss PS0002 STG 0001-0008 0121 0012 0148-0150 PRT T 1 50 This set of note cards will be added to the reports which are printed for the job descriptions computed in this control card set. The printed reports would be only task level job descriptions and a maximum of fifty tasks would be printed for each report. The printing of the reports is accomplished by PRTJOB. The specifications for printing have no effect on the computation of the job description. The complete description (task and duty) is always computed. @EOF STG 0010-0030 0050-0055 0078 0098 STG 0099 NOPRT STG 0061 0065 @EOF
This example computes the complete job descriptions for all stages mentioned using PS0002. Additionally, a PRTJOB run will be generated which will print the job descriptions for stages 10-30, 50-55, 78, 98, and 99.
The "NOPRT" card is rarely used, but is available as a convenience if desired.