Next Question Prompting and JCL - NUUPJBNQ
Nucleus (NU) Next Question Prompting and JCL (NUUPJBNQ) page entries provide the information necessary for RUNJOB to select the appropriate set of questions to be asked of the user in preparation for running a job. Next Question information is maintained using the Next Question Prompting tab shown below.
Next Question Prompting
Job Type: One of the following two-character codes:
- NO - No job is associated with the current mask.
- IN - The job associated with the current mask is interactively activated. 7i will omit all interactive jobs from the menu (Job Type "IN"), with the exception of 7i pages.
- JB - The job associated with the current mask is to be launched interactively (or Batch Job).
- JO - The job must be launched Batch Job only.
Questions: Up to 12 four-character question numbers that are to be asked before the next mask is formed (or before the job is to be run, in the case of a terminal node).
Job Name: Batch jobs associated with the mask being defined will be run under the name of the mask, unless another name is specified in this field.
Event: Reserved for future use.
Run Mask: The last entry in the RUNREQ file is the word "MASK" followed by the system mask (i.e., the last mask formed). Optionally, a different mask (as specified in this field) may be written as the last RUNREQ record.
Pre JCL Mask: A previously defined generic JCL mask that may be used to run a group of jobs prior to an actual job being run.
Post JCL Mask: Same as Pre JCL Mask with the job running after an actual job is run.
Log Mask: If this box is checked, a log entry will be created each time the particular mask is executed.
Log JCL: If this box is checked, log entries will be created after each line of JCL is processed for the particular mask, thus being able to tell if a process completed successfully or not.
Force Job Type: If a rootroll changes the job type on a page, the default is to leave the job type alone when QT935 runs. You can override this by placing a "Y" in the second half of nq_misc_flags02 using direct SQL.
BatchCK: A "Y" in this field directs the system to verify that a distribution for this batch file is not underway when this mask is run. Usually set only for masks that distribute data to the database. This feature may be deactivated globally by setting the NU Common Codes Category/Value of NUSL/BTCHLOCK to "OFF" in the short description.
Stdlist: A "Y" in this field instructs the system to produce a stdlist (tail sheet) if a STDLIST entry exists in the NU Common Codes Category of NULP. An "N" directs the system not to produce a STDLIST. A "D" indicates deferred that instructs the system to produce a STDLIST but to give it a priority of "1" so that it will not print immediately.
Check DB: A "Y" in this field directs the system to check the user's DB access capabilities before launching this mask. The system will abort the job if the user does not have the required capabilities.
Job Card: The first line (the "Job Card") of a stream file is comprised of the word "!JOB" followed by job name, Logon, and system options. This field is for other system options that may be desired for this particular stream job. Example: INPRI=9 or TIME=99999.
Schedule: This field is for options to be used when RUNJOB (NU010) issues the STREAM command. Example: AT=22:00 or IN=0,0,5.
Override: If the options entered in either the Job Card or Schedule field are to be used, check the box using your mouse-click.
Line Printer, Pri., Copies: The line printer name, priority for printed output and number of copies from the job associated with this mask.
Form Printer, Pri., Copies: The form printer name, priority for printed output and number of copies from the job associated with this mask.
Type: A "D" in these fields indicates that the previously defined printer specifications are to be the default values for the job associated with the current mask. An "O" (for "Override") in these fields indicates that the previously defined specifications are to be used in all cases.
Mask Summary Information
YYMM: Year and month of job statistics.
TTLJob: Total number of times job associated with mask was run in given YYMM.
TTLElps: Total elapsed time of job associated with mask for given YYMM.
TTLCpu: Total CPU time of job associated with mask for given YYMM.
TTLPrint: Total number of pages printed by job in given YYMM.
JCL Tab
JCL statements used to initiate jobs are associated with the terminal node mask value. JCL statements are maintained on the JCL form.
No: A two-digit number from 01-99, which designates the order in which the given JCL statement is to be processed. It is suggested that increments of 10 be used initially to allow later insertions, should they be required.
Command or reserved word: Up to 70 characters representing a system command (preceded by !) or one of the following listed
Special Codes:
LP This causes RUNJOB to generate the following file equation: FILE LP; DEV=xx, where xx is the user's Standard Line Printer device number, as determined by NU001. This may optionally be followed by a message that will be added to the command as a FORMS message. For example, if LP Mount standard paper were entered, RUNJOB would create the following command: !FILE LP; DEV=xx; FORMS=Mount standard paper.
^LPNAME=nn Causes the spool file to assume an FNAME of "nn".
^LPNAME Reset
^FPNAME=nn Same as above but applied to forms printer spool files. RUNJOB dialogue frequently asks the user how many copies of a particular report are to be printed. If multiple form copies are requested and the LP command is given without a message, RUNJOB will insert a multiple part forms mount message.
FP This causes RUNJOB to generate the following file equation: !FILE FP; DEV=xx, where xx is the user's Special Forms Printer device number as determined by NU001. This may optionally be followed by a message that will be added to the command as a FORMS message. For example, if FP Mount Check Stock were entered, RUNJOB would create the following:command: !FILE FP; DEV=xx; FORMS=Mount Check Stock.
UPDATE Selected questions will prompt the user for a file name. Entering the word UPDATE in the JCL command will cause RUNJOB to generate the following command: !FILE UPDATE=fname, where fname is the file name entered by the user. Thus, programs can be written to access a file named "UPDATE" and RUNJOB will make the appropriate file equation.
RENAME For some applications, particular files are to be used only once for some permanent posting function. Using the "RENAME" JCL command causes RUNJOB to rename the "UPDATE" file name entered by the user into the client's POSTED group. This helps to prevent accidental reuse of the file; it also places files that are no longer needed into a group where they can be selectively purged.
SAME AS xxx Will execute "xxx" JCL instead.
!QSnn Will be replaced by the user response to the given question number. For example, entering ! PY03 will cause the system to replace "! PY03" with the user response to question number PY03.
!PERM Will be replaced by the PERM group name in the SYSPARM file.
!DATA Will be replaced by the DATA group name in the SYSPARM file.
!DONE Will be replaced by the DONE group name in the SYSPARM file.
!DRVR Will be replaced by the DRVR group name in the SYSPARM file.
!REPT Will be replaced by the REPT group name in the SYSPARM file.
!LPPRI nn Will cause RUNJOB to reissue the LP file equate with the priority parameter set to "nn". If "nn" is omitted, the original LP file equate will be reissued.
!LPCOPIES nn Will cause RUNJOB to reissue the file equate with the copies parameter set to "nn". If "nn" is omitted, the original file equate will be reissued. If "nn" is 00, the following file equate will be issued: FILE LP=$NULL. When this file equate is issued, no copies are printed.
!LPNAME xxxx Will cause RUNJOB to reissue the file equate with the name parameter set to "xxxx". If "xxxx" is omitted, the original file equate will be reissued.
!FPPRI nn Will cause RUNJOB to reissue the FP file equate with the priority parameter set to "nn". If "nn" is omitted, the original FP file equate will be reissued.
!FPCOPIES nn Will cause RUNJOB to reissue the file equate with the copies parameter set to "nn". If "nn" is omitted, the original file equate will be reissued. If "nn" is 00, The following file equate will be issued: FILE FP=$NULL. When this file equate is issued, no copies are printed.
!FPNAME xxxx Will cause RUNJOB to reissue the file equate with the name parameter set to "xxxx". If "xxxx" is omitted, the original file equate will be reissued.
!RUN (prog) Will invoke the entered program (prog) with all of the options specified. e.g.! RUN EN500
All system options are supported (e.g., STACK=, LIB=, INFO=, STDLIST=, etc.). In addition, if the key word NOSUSPEND is entered as a parameter, RUNJOB will not suspend and will continue to execute the JCL.