Question Definition Menu Help - NUUPJBQS

On Nucleus Question Definition/Menu/Help (NUUPJBQS), the text of questions asked during user dialogue is maintained using the Question tab page. This tab also holds default values when running a job. To change a default value, access the question, using Find/Search in the question field, and enter the desired default text.

Page Header

Question No: Four-characters that uniquely identify the question. It is suggested that the subsystem code to which the question relates be used as the first two-characters of the question number; use the digits 01-99 as the last two characters of the question number.
Text: Up to 76 characters to create the text for the question.

Question Tab

Echo Prefix: Up to 30 characters which summarize the question. When the user requests a job that is to be launched as a batch job, the Echo for each question along with the user-entered response is displayed and confirmation is requested prior to launching the job.
In Mask: A check mark in this field indicates that the user response to this question is to be used in forming the next mask. This specifies whether the response to the question is added to the mask being created. All questions that contribute to formation of the mask need to specify a "Y". All other questions would be treated as incidental, affecting the job's options or selection criteria but not driving the choice of which job to run.
Response Type: An optional two-character code that directs the presentation of the question and the interpretation of the user response. Permissible type codes include:

CM Calendar month; validates as 01 to 12.
DT Response is interpreted as a date which must fall between 1700 and 2199 (9999 indicates infinity).
FM Fiscal month; validates as 01 to 12.
FY Fiscal year.
LN Allows lists of values like LS but validates each as a number (much like NO).
LS The question requests a list of selection criteria values, which may be entered as individual values or ranges, for inclusion or exclusion. Each value and/or range must be separated by commas; ranges are designated by use of the dash ( - ). Included values must be entered first; excluded values must be preceded by ex. For example, an "LS" type question could prompt the user to enter selection values for an employee's gross salary – the user could then enter 500,1000-5000,ex2000,3000-4000. This selection would be for all employees with a gross salary of $500 or between $1000 and $5000 (inclusive), except those employees with a gross salary of $2000 or between $3000 and $4000 (inclusive). For more discussion of how to list extraction criteria, see the Interactive ROOTDB INQUIRY Facility section of the NUCLEUS Guide.
NO Response is edited as an all-numeric digit response.
QT The question is to be a "quiet" question that is not displayed to the user; the response is to be taken from the Default RESPONSE.
SC The question is one that requests the user to enter multiple selection criteria codes (not values) separated by commas (for example: 01,03,04,12). Questions of this type display a menu of codes corresponding to selection criteria that may be used in report extraction functions. After the user has entered a list of codes, RUNJOB will ask the forced questions for each of the entered codes. These forced questions are usually "LS" type questions (see below). "SC" type questions ask the user to enter the manner of selecting entries for a report; "LS" type questions ask the user to enter the values to be used in the application of selection logic. The SC response type does not apply to 7i because the different selection criteria menus are all shown in the tree, rather than having the user enter comma separated lists of question numbers.
SR Used on sort questions to allow the responses to be accepted in the order they are given.
ST This requests the type of selection criteria to be used when asking the type SC questions.
UP Upload file from PC or network drive to BusinessPLUS server – an option for 7i only.
YN Response is YES or Y, NO or N.

Default: Up to 15 characters that are to be used as the response to the question, if the user presses the Enter key without entering a response. The following special codes may be entered, with the result as defined:

CURRENT DATE Replaced with the current date.
EFCHECKNO Replaced with EFT number.
FILE Replaced with file type.
FQB Replaced with Fiscal Quarter begin date.
FQE Replaced with Fiscal Quarter end date.
FY Replaced with current year of the fiscal year.
FYB Replaced with Fiscal Year begin date.
FYE Replaced with Fiscal Year end date.
LFQB Replaced with last Fiscal Year begin date.
LFQE Replaced with last Fiscal Year end date.
LFY Replaced with last Fiscal Year.
LFYB Replaced with last Fiscal Year begin.
LFYE Replaced with last Fiscal Year end.
LMONTH BEGIN Replaced with the month beginning date of the month prior to the current month.
LMONTH END Replaced with the month end date of the month prior to the current month.
LQUARTER BEGIN Replaced with last Quarter begin date.
LQUARTER END Replaced with last Quarter end date.
LYEAR BEGIN Replaced with last year begin date.
LYEAR END Replaced with last year end date.
MONTH BEGIN Replaced with the month beginning date of the current month.
MONTH END Replaced with the month end date of the current month.
NFY Replaced with next Fiscal Year.
PYCHECKNO Replaced with Payroll check number.
QUARTER BEGIN Replaced with current Quarter begin date.
QUARTER END Replaced with current Quarter end date.
YEAR END Replaced with Year end date.

Edit Cd: An optional four-character code that directs the type of verification to be performed upon the user response. The following describes codes that may be entered:

BV Response must be a valid Budget version.
DC The question response is to be edited as a valid MM/DD/YY date that falls within 60 days of the current date. If the date is more than 60 days before or after the current date, the user will be issued an error message and prompted to confirm the date, or enter a new date.
DM The question response is to be edited as a valid MM/DD/YY date. The date is validated against the maximum numbers of days into a month where it is allowed to post to the last day of the previous month. The number of days is held in the NU Common Codes Category of NUDV with the Question Number in the Code Value. In the first Associated Codes field, place the number of days after which posting to the prior month will not be allowed.
DS The question response is to be edited as a valid MM/DD/YY date and validated within a range entered in the NU Common Codes Category of NUDT and a Code Value of the Question Number. The valid range is entered in Associated Code 1 and Associated Code 2 in MM/DD/YY format. If the date is outside of the valid range, the user will be issued an error message, and will be prompted again for a valid date.
DT Response must be any valid date.
FILE The question is one that requests the user to enter a data file name. Use the information in the FILE box to assist in validating the user response.
FILU The question is one that requests the user to enter the name of the file to upload.
FP The question is treated as a question that sets the number of copies and output priority for a Special Forms Line Printer file equation (see JCL Statements).
GL Response must be a valid GL Ledger Code.
GR Response must be any valid Ledger Code.
JL Response must be a valid JL Ledger Code.
LP The question is treated as a question that sets the number of copies and output priority for a Standard Line Printer file equation (see JCL Statements).
PER Response must be a valid Pay Period.
TERM Terminal Type. Verification used for "What type of Terminal do you have" question (e.g., HP UNIX).

Formal Name: Enter the formal name of the file. RUNJOB will generate a file equate in the form: FILE formal=response.
Qualifier: If no file qualification is given, the value in this field will be used to fully qualify the file name. !DATA, !DONE, etc. are supported.
Code: Value is used to verify the file name entered has the valid file code.
RecLen: Use to validate the file name entered has the valid record length.
Exist: Enter a "Y" in this field if the file must already exist; "N" if the file must not exist. You may also choose to enter "Z" if the file may or may not exist and will be purged if it does. However, the user must enter a file name in response to this question if file exists switch is "Y" or "Z."
Show Menu: (This field does not apply to 7i – remains for backward compatibility) The value in this field determines how or when RUNJOB should display the menu associated with the current question. The following are the permitted codes:
1 Only show the menu if this question has been asked once already
FForce display of menu even if it has only one entry
NDo not display menu (for YN questions)
YDisplay menu
From File: This field is reserved for internal use.
Menu Highlight: (This field does not apply to 7i – remains for backward compatibility) The value of this field indicates the type of highlighting to use when displaying menu codes. Default is "S." The following are examples of highlighting codes:
S Alternate half-inverse, full inverse
H Half-bright
U Underline
B Blink
Columns: (This field does not apply to 7i – remains for backward compatibility) Number of columns in which an associated menu should be displayed (default = 2).
Cursor Position: (This field does not apply to 7i – remains for backward compatibility) Enter FH to position cursor at the beginning of the first highlighted field.
Disable Term Echo: (This field does not apply to 7i – remains for backward compatibility) A 'Y' in this field directs RUNJOB to ask this question with the terminal echo off. (The user's response will not be echoed as it is entered.) This is useful when prompting for passwords, etc.
Show Help First: (This field does not apply to 7i – remains for backward compatibility) A check mark in this box directs RUNJOB to display the HELP detail associated with this question before asking the question.
RunReq Quest. No: The value in this field will be placed in RUNREQ as the question number; if this field is empty, RUNJOB will use the question number as specified in the first field on this page (Question No).
Only for Subsystem: Only ask the current question if the subsystem specified in this field is installed.
Response Required: A check mark in this box indicates that some response to this question must be entered.
Optional Question: A check mark in this box will direct RUNJOB to add this question to a special optional menu for later prompting. Optional questions are tabled by RUNJOB as they are encountered; when all non-optional questions have been asked, RUNJOB presents a menu containing all the optional questions previously encountered. The user may elect to answer any or all of the optional questions at that time.
Log as Date1/Date2: A check mark in either the Date 1 or Date 2 box will direct RUNJOB to log the specified date.
Exclude Posted Files: A check mark in this box will prevent the user from entering a file in the "posted" group. If the Allow Posting of Posted Files field on the MISC DEFINITION page of User Security contains a "Y" or is blank, this field has no effect.
Validation Code: Reserved for future use.

Menu Tab
When a question is designed to provide a menu of possible coded responses, these menu entries are entered on the MENU form. The number of questions is not to exceed 100.

Code: A menu code (up to four-characters) may be entered by the user in response to the question. Menu entries are sorted in ascending code sequence.
Menu Code Description: Up to 30 characters that describe the menu code.
File Name: If this field is non-blank, the system will issue a file equate: :FILE RDFFILE=fname!REPT;SHR (where, !REPT might be ".RDF.ADMIN" for example).
Forced Next Question 1-5: Up to five forced questions to ask if the corresponding menu code is selected. There are certain questions that should only be asked if the user selects a particular code from the menu. These questions tend to be incidental in nature and their inclusion in the next question selection entries would be inconvenient. For example, if the question prompted the user to enter the manner of entry selection for some extraction report, the question that prompts the user to enter the selection criteria values would be identified as a "forced question".

Help Tab

When the user is engaged in RUNJOB dialogue, the F1 key is used to obtain help for the currently selected question. RUNJOB will then retrieve and display the HELP text associated with the question asked.

No: A line number precedes each line of free form Help Text; the lines are ordered by this value. When increments of more than one are used, additional lines of text may be easily inserted.
Help Text: Up to 75 characters may be entered in each line of text. Entering (on a separate line) the characters SAME AS xxxx will cause RUNJOB to use the Help Text of Question No. xxxx. This provides a means of avoiding redundant help text entry.