Types of SET Parameters

In this section:

This topic lists the types of tasks that can be accomplished, and the SET parameters that allow you to perform these tasks. If a single parameter applies to more than one activity, it appears in more than one category. For more detailed descriptions, as well as the syntax for each parameter, see SET Parameter Syntax.

The following are the types of tasks performed with SET parameters.

Calculations

Affects the way calculations are performed in FOCUS.

Data and Metadata

Determines the way data is stored and processed.

Date Manipulation Tasks

Controls the way dates are processed and displayed in reports.

Graph Tasks

Controls the processing and display of graphs.

Memory Setup and Optimization Tasks

Affects the memory and optimization of your application.

Report Code, Content, and Processing Tasks

Determines the content and processing of a request.

Report Layout and Display Tasks

Affects the display of a report.

Security Tasks

Controls user access to data sources and procedures.

Terminal Tasks

Specifies the options for display in your terminal.

Calculations

The following parameters control the behavior of calculations in FOCUS.

AGGR[RATIO]

Determines the ratio of aggregation based on retrieved records and the final size of the answer set.

CDN

Specifies the punctuation used in numeric notation.

COMPUTE

Controls the compilation of expressions.

DMPRECISION

Specifies precision of numeric values in Dialogue Manager -SET commands to calculate accurate numeric variable values.

FLOATMAPPING

Takes advantage of decimal-based precision numbers for all numeric processing for floating point numbers.

MISS_ON

Sets a default value, either SOME or ALL for MISSING ON in DEFINE and COMPUTE.

MISSINGTEST

Determines whether the IF expression in IF-THEN-ELSE tests is checked for missing values.

MODCOMPUTE

Controls compilation of MODIFY calculations.

PARTITION_ON

Sets the partition size for statistical functions.

USERFCHK

Controls the level of verification applied to DEFINE FUNCTION arguments and Information Builders-supplied function arguments.

USERFNS

Determines whether an Information Builders-supplied function or a locally-written function with the same name is used.

Data and Metadata

The following parameters determine the way data is stored and processed.

ACCBLN

Accepts blank or zero values for fields with ACCEPT commands in the Master File.

ASNAMES

Controls the FIELDNAME attribute in a HOLD Master File.

BLKCALC

Enables system-determined blocking for HOLD files written to DASD.

COUNTWIDTH

Expands the default format of COUNT fields from a five byte integer to a nine byte integer.

DATEFORMAT

Specifies the order of the date components (month/day/year) when date-time values are entered in a formatted-string or translated-string format.

DEFINES

Compiles virtual fields into machine code to improve performance.

DIRECTHOLD

Controls whether HOLD Files in FOCUS format are created directly.

DTSTRICT

Controls the use of strict processing for date-time fields.

EQTEST

Controls whether the characters $ and $* are treated as wildcard characters or normal characters in selection criteria.

EUROFILE

Activates the data source that contains information for the currency you want to convert.

FIELDNAME

Controls the use of long and qualified field names.

FOCALLOC

Automatically allocates FOCUS files.

HIPERFOCUS

Activates HiperFOCUS.

HIPERINSTALL

Installs or disables HiperFOCUS.

HLDCOM_TRIMANV

Controls whether trailing blanks are retained when the output is held in a delimited format.

HNODATA

Controls missing values propagated to a HOLD file.

HOLDFORMAT

Determines the default format for HOLD files.

HOLDLIST

Determines what fields in a report request are included in the HOLD file.

HOLDMISS

Distinguishes between missing data and default data (zeros or blanks) in a HOLD file.

HOLDSTAT

Determines if comments and DBA information are included in HOLD Master Files.

HTMLARCHIVE

Packages HTML and DHTML reports together with image files into a single web archive document (.mht file).

HTMLENCODE

Encodes data within HTML output.

INDEX

Is the indexing scheme used for indexes.

KEEPDEFINES

Controls whether a virtual field created for a host or joined structure is retained after a JOIN command is run.

MASTER

Enables use of blank delimited (Fusion) Master File syntax, and provides increased enforcement of syntax rules in comma delimited Master File syntax.

MAXDATAEXCPT

Enables you to change the number of data exceptions allowed before the session is terminated.

MAXLRECL

Specifies the maximum length of a record described with the Master File OCCURS attribute.

MDICARDWARN

Displays a warning message when the cardinality of a dimension exceeds a specified value.

MDIENCODING

Enables retrieval of output from an MDI file without reading the data source.

MDIPROGRESS

Displays messages about the progress of an MDI build.

MINIO

Determines whether a block is read more than once when reading or writing to a file.

NULL

Enables creation of a variable-length comma or tab delimited HOLD file that differentiates between a missing value and a blank string or zero value.

OLDSTYRECLEN

Determines whether the record length, LRECL, is set to the current setting of LRECL=0, or the older setting of LRECL=512.

PCOMMA

Enables retrieval of comma delimited files created by a PC application or HOLD FORMAT COM command.

PREFIX

Specifies the prefix of existing data sets automatically allocated by FOCUS.

QUALCHAR

Specifies the qualifying character to be used in qualified field names.

RANK

Determines how rank numbers are assigned in a request when multiple data values fall into the same rank category.

SAVEDMASTERS

Saves a Master File to memory after it has been used in a request.

SHADOW

Activates the Absolute File Integrity feature.

SHIFT

Controls the use of shift strings.

SUSI

See Simultaneous Usage Reference Manual for z/OS .

SUTABSIZE

See Simultaneous Usage Reference Manual for z/OS .

TRACKIO

Gathers more pages to fill a track before reading or writing the pages to disk.

WEBARCHIVE

Packages multiple EXL2K files into a single file.

WEEKFIRST

Specifies what day of the week is the start of the week.

WIDTH

Used for communication between 3270 terminals and the operating system.

WPMINWIDTH

Specifies a minimum width for format WP output files.

XRETRIEVAL

Controls the retrieval of data when previewing a report.

XFOCUSBINS

Defines the number of pages of memory to use as buffers for XFOCUS data sources.

Date Manipulation Tasks

The following parameters control the way dates are processed and displayed in reports.

BUSDAYS

Specifies which days are considered business days and which are not.

DATE_ORDER

Specifies the order of date components.

DATE_SEPARATOR

Specifies the separator for date components.

DATEDISPLAY

Controls the display of a base date

DATEFNS

Activates year 2000-compliant versions of date subroutines.

DATETIME

Sets date and time in reports .

DEFCENT

Defines a default century for your application.

EXL2KTXTDATE

Controls whether translated dates are sent as date values with format masks instead of text values.

HDAY

Specifies the holiday file from which to retrieve dates that are considered holidays.

LEADZERO

Avoids the truncation of leading zeros.

TIME_SEPARATOR

Specifies the separator for time components for the &TOD variable.

TESTDATE

Temporarily alters the system date in order to test a dynamic window.

YRTHRESH

Defines the start of a 100-year window.

Graph Tasks

The following parameters control the processing and display of graphs. For information about these parameters, see the Creating Reports Manual.

AUTOTICK

Sets the tick mark intervals for graphs.

BARNUMB

Places summary numbers at the end of bars on bar charts, or slices on pie charts.

BARSPACE

Specifies the number of lines separating the bars on bar charts.

BARWIDTH

Specifies the number of lines per bar on bar charts.

BSTACK

Specifies whether bar chart bars are stacked or placed side by side.

DEVICE

Specifies the plotting device or terminal to be used.

FRAME

For GDDM graphics, indicates if you want a frame around your graph.

GCOLOR (or GRIBBON)

Depending on device type, determines black and white or color patterns or ribbons used.

GMISSING

Specifies whether variables with the value specified in GMISSVAL are to be ignored.

GMISSVAL

Specifies the variable value that represents missing data.

GPROMPT

Specified whether FOCUS should prompt for graph parameters.

GRIBBON

Same as GCOLOR.

GRID

Draws a grid of parallel horizontal lines at the vertical class marks on the graph.

GTREND

Specifies the use of basic linear regression to alter the X and Y axis values in a SCATTER graph.

HAUTO

Performs automatic scaling of the horizontal axis for the given values.

HAXIS

Specifies the width, in characters, of the horizontal axis.

HCLASS

Specifies the horizontal interval mark when AUTOTICK is OFF.

HISTOGRAM

Draws a histogram instead of a curve when the values on the horizontal axis are not numeric.

HMAX

Sets the maximum value on the horizontal axis when automatic scaling is not used (HAUTO=OFF).

HMIN

Sets the minimum value on the horizontal axis when automatic scaling is not used (HAUTO=OFF).

PAUSE

Specifies whether there is a pause for paper adjustment on the plotter after the request is executed.

PIE

Specifies a pie chart.

PLOT

Specifies the width and height settings for certain devices.

PRINT

Specifes whether the graph is printed or displayed on the terminal.

TERM[INAL]

Specifies the plotting device or terminal to be used.

VAUTO

Performs automatic scaling of the vertical axis for the given values.

VAXIS

Specifies the length of the vertical axis, in lines.

VCLASS

Specifies the vertical interval mark when AUTOTICK is OFF.

VGRID

Draws a grid at the horizontal and vertical class marks of the graph.

VMAX

Sets the maximum value on the vertical axis when automatic scaling is not used (VAUTO=OFF).

VMIN

Sets the minimum value on the vertical axis when automatic scaling is not used (VAUTO=OFF).

VTICK

Sets the vertical axis interval mark when AUTOTICK is OFF.

VZERO

Treats missing values on the vertical axis as zeros.

Memory Setup and Optimization Tasks

The following parameters control the memory and optimization of your application.

AUTOINDEX

Retrieves data faster by automatically taking advantage of indexed fields in a FOCUS data source.

AUTOPATH

Dynamically selects an optimal retrieval path.

AUTOSTRATEGY

Determines when FOCUS stops the search for a key field specified in a WHERE or IF test.

BINS

Specifies the number of pages of memory used for data source buffers.

CACHE

Stores FOCUS data source pages in memory and buffers between the data source and BINS.

COMPUTE

Controls the compilation of expressions.

DEFINES

Compiles virtual fields into machine code to improve performance.

DMH_LOOPLIM

Controls the number of loop iterations allowed in Dialogue Manager.

DMH_STACKLIM

Controls the number of lines allowed in FOCSTACK.

ESTRECORDS

Passes the estimated number of records to be sorted in the request.

FIXRETRIEVE

Enables keyed retrieval from a fixed format sequential file, such as a HOLD file.

FOCSTACK

Specifies the amount of space, in thousands of bytes, used by FOCUS commands waiting for execution.

HLISUTRACE

Records the last 20 events that the FOCUS Database Server performed.

HLISUDUMP

Is used for debugging FOCUS Database Server problems.

IBMLE

This parameter is no longer functional. FOCUS is fully LE compliant, and all FOCUS applications must be LE compliant

IMMEDTYPE

Tells FOCUS where to send line mode output.

SQLTOPTTF

Enables the SQL Translator to generate TABLEF commands instead of TABLE commands.

SUWEDGE

Keeps Master Files on a FOCUS Database Server open between requests.

ZIIP

Enables you to offload specific categories of FOCUS processing to a zIIP specialty engine.

Report Code, Content, and Processing Tasks

The following parameters affect the content or processing of a report.

ALL

Handles missing segment instances in a report.

ALLOWCVTERR

Controls the display of a row of data that contains an invalid date format.

ASNAMES

Controls the FIELDNAME attribute in a HOLD Master File.

AUTOTABLEF

Avoids creating the internal matrix based on the features used in the query.

BUSDAYS

Specifies which days are considered business days.

CARTESIAN

Generates a report containing all combinations of non-related data instances in a multi-path request containing a PRINT or LIST command.

CDN

Specifies punctuation used in numeric notation.

CENT-ZERO

Displays a leading zero in decimal-only numbers.

COLLATION

Controls ordering of alphanumeric values.

COMPMISS

Controls whether the missing attribute is propagated to reformatted fields in a report request.

COMPUTE

Controls the compile of expressions.

DATEDISPLAY

Controls the display of date format fields that contain the value zero.

DATEFNS

Activates year 2000-compliant versions of date subroutines.

DATETIME

Sets date and time in a report .

DBAJOIN

Controls whether DBA restrictions are treated as report filters or are added to the join conditions.

DB_INFILE

Controls whether the expression generated by the DB_INFILE function for use against a relational data source is optimized.

DEFCENT

Defines a default century for your application.

DEFECHO

Defines a default value for the &ECHO variable for your application.

EMPTYREPORT

Controls the output generated when a report request retrieves zero records.

ERROROUT

Terminates a request and returns a message when an error is encountered.

ESTRECORDS

Passes the estimated number of records to be sorted in the request.

EXCELSERVURL

Specifies the application server to be used to zip the file components that comprise an EXCEL 2007 file (.xlsx).

EXL2KLANG

Specifies the language used for Microsoft® Excel requests. This language must be the same as the language of Excel on the browser machine.

EXTAGGR

Enables aggregation in an external sort.

EXTHOLD

Enables you to use an external sort to create HOLD files.

EXTRACT

Activates Structured HOLD Files for a request.

EXTSORT

Activates the external sorting feature.

FIELDNAME

Controls the use of long and qualified field names.

FILENAME

Specifies a file to be used, by default, in commands.

FILTER

Activates declared filters.

FOC144

Suppresses warning message FOC144, which reads Warning Testing in Independent sets of Data .

FORMULTIPLE

Allows you to include the same value of a FOR field in multiple rows of the FML matrix.

HNODATA

Controls missing values propagated to a HOLD file.

HOLDATTR

Includes the TITLE and ACCEPT attributes from the original Master File in the HOLD Master File.

JOINLM

Controls whether strict equality is required or partial key joins are supported for record-oriented adapters. JOINLM is a synonym for JOIN_LENGTH_MODE.

JOINOPT

Ensures proper alignment of report output by correcting for lagging (missing) values. Also enables joins between fields with different numeric data types.

KEEPDEFINES

Controls whether a virtual field created for a host or joined structure is retained after a JOIN command is run.

LANG[UAGE]

The LANG[UAGE] parameter specifies the National Language Support (NLS) environment. It sets the language of FOCUS error messages and can also be used to set the language of report titles if the Master File Description contains alternate language TITLE attributes.

LEADZERO

Avoids the truncation of leading zeros.

MESSAGE

Controls the display of informational messages.

MULTIPATH

Controls whether MATCH requests use grouped or ungrouped processing.

NODATA

Determines the character string that indicates missing data in a report.

ONFIELD

Controls whether ON phrases are ignored for fields not referenced in a request.

PAUSE

Pauses before displaying a FOCUS report on the terminal.

PARTITION_ON

Controls the partition size for statistical functions.

PFnn

Assigns a function to a PF key.

PDFLINETERM

Determines if an extra space is appended to each record of a PDF output file to facilitate proper file transfer between Windows and UNIX.

PHONETIC_ALGORITHM

Sets the phonetic algorithm to use with the PHONETIC function.

PRINTDST

Controls processing of reports that use the PRINT command in conjunction with multiple DST operators.

QUALCHAR

Specifies the qualifying character to be used in qualified field names.

SAVEMATRIX

Saves the matrix from your request to protect it from being overwritten when using Dialogue Manager commands.

SHORTPATH

Controls how tests against missing cross-referenced segment instances are processed in a left outer join.

SORTLIB

Tells FOCUS which sort package is installed at your site.

SORTMATRIX

Controls whether to employ in-memory sorting with decreased use of external memory.

SORTMEMORY

Controls the amount of internal memory available for sorting.

SUMMARYLINES

Permits the combination of fields with and without prefix operators on summary lines in one request.

SUMPREFIX

Allows users to choose the answer set display order when using an external sort to perform aggregation of alphanumeric or smart date formats.

TITLES

Uses predefined column titles in the Master File as column titles in report output.

Report Layout and Display Tasks

The following parameters affect the layout and display of a report.

ACROSSLINE

Controls underlining of column titles on report output. TITLELINE is a synonym.

ACROSSPRT

Reduces the number of report lines within each sort group when a request uses the PRINT command and an ACROSS phrase.

ACROSSTITLE

Controls whether ACROSS titles display above or to the left of ACROSS values.

ACRSVRBTITL

Controls the display of ACROSS column titles when there is only one displayed field for an ACROSS group.

ALTBACKPERLINE

Alternates the background color by line for reports that use positioned drivers, for example PDF, DHTML, PPT, and PPTX.

AUTOFIT

Controls resizing of HTML report output to fit its window.

BASEURL

Specifies a default location where your browser searches for relative URLs referenced in the HTML documents created by FOCUS.

BLANKINDENT

Clarifies relationships within an FML hierarchy by indenting the captions (titles) of values at each level.

BOTTOMMARGIN

Sets the bottom boundary for report contents on a page in a styled report.

BYDISPLAY

Displays a sort field on every row, column, or both in a report.

BYPANEL

Controls the repetition of BY fields on panels.

BYSCROLL

Scrolls report headings and footings along with the report contents.

CENT-ZERO

Displays a leading zero in decimal-only numbers.

COLUMNSCROLL

Enables you to scroll by column within the panels of a report provided that the report is wider than the screen width.

COMPOUND

Enables you to combine multiple reports into a single PDF or PS file to create a compound report.

CSSURL

Links an HTML report to an external cascading style sheet (CSS) file in order to style the report.

CURRENCY_DISPLAY

Defines the position of the currency symbol relative to the monetary number.

CURRENCY_ISO_CODE

Defines the ISO code for the currency symbol to use.

CURRENCY_PRINT_ISO

Defines what will happen when the currency symbol cannot be displayed by the code page in effect.

CURRSYMB

Sets a currency symbol to display on the report output when a numeric format specification uses the M or N display options.

CURSYM_D

Sets the characters to display on the report output when a numeric format specification uses the :D or :d display options.

CURSYM_E

Sets the characters to display on the report output when a numeric format specification uses the :E or :e display options.

CURSYM_F

Sets the characters to display on the report output when a numeric format specification uses the :F display option.

CURSYM_G

Sets the characters to display on the report output when a numeric format specification uses the :G display option.

CURSYM_L

Sets the characters to display on the report output when a numeric format specification uses the :L or :l display options.

CURSYM_Y

Sets the characters to display on the report output when a numeric format specification uses the :Y or :y display options.

CUSTOM-PAGE-LENGTH

Sets the page length for PAGESIZE=CUSTOM.

CUSTOM-PAGE-WIDTH

Sets the page width for PAGESIZE=CUSTOM.

DROPBLNKLINE

Eliminates blank lines from the report output.

DUPLICATECOL

Controls whether columns for multiple display commands are spread out or stacked on top of each other.

EXTENDNUM

Prevents visual overflow on reports.

FOCFIRSTPAGE

Assigns a page number to the first page of output.

HIDENULLACRS

Hides ACROSS columns containing only null values.

HTMLCSS

Creates an inline Cascading Style Sheet command in the HTML page that displays the report output.

HTMLEMBEDIMG

Determines whether to embed images and graphs directly into an HTML or DHTML .htm file.

LAN[GUAGE]

Specifies the National Language Support (NLS) environment. Sets the language of FOCUS error messages. Can also be used to set the language of report titles if the Master File Description contains alternate language TITLE attributes.

LAYOUTGRID

Displays a grid in the report output, which enables you to evaluate the correct placement of data and objects during your report design. This option is applicable only when using the PDF, PS, or DHTML report output.

LEFTMARGIN

Sets the left boundary for report contents on a page in a styled report.

LINES

Sets the maximum number of lines of printed output that appear on a page, from the heading at the top to the footing on the bottom. The OFFLINE-FMT parameter determines the format of printed report output generated from a request.

ORIENTATION

Specifies the page orientation for styled reports.

OVERFLOWCHAR

Changes the character that displays in a numeric report column when the column does not have enough space for the value.

PAGE[-NUM]

Controls the numbering of output pages.

PAGESIZE

Specifies the page size for StyleSheets.

PANEL

Sets the maximum line width of a report panel.

PAPER

Specifies the length of paper for printed output.

PCTFORMAT

Controls whether fields prefixed with PCT., RPCT., and PCT.CNT. display with the format of the original field or with a percent sign.

PRFTITLE

Generates readable and translatable column titles for prefixed fields on reports.

PRINT

Specifies the report output destination.

PRINTPLUS

Specifies enhancements to display alternatives.

PSPAGESETUP

Coordinates the paper source used by a PostScript printer with the PAGESIZE parameter setting.

QUALTITLES

Uses qualified column titles in report output when duplicate field names exist in a Master File.

REBUILDMSG

Allows direct control over the frequency with which REBUILD issues messages.

RECAP-COUNT

Includes lines containing a value created with RECAP when counting the number of lines per page for printed output.

RIGHTMARGIN

Sets the right boundary for report contents on a page.

SHOWBLANKS

Preserves leading and internal blanks in HTML and EXL2K report output.

SPACES

Sets the number of spaces between columns in a report.

SQUEEZE

Determines the column width in report output.

STYLE[SHEET]

Controls the format of report output by accepting or rejecting StyleSheet parameters.

SUBTOTALS

Controls whether summary lines display above or below the data.

TERM[INAL]

Selects the terminal type.

TITLELINE

Controls underlining of column titles. ACROSSLINE is a synonym.

TOPMARGIN

Sets the top boundary on a page for report output.

TRANTERM

Displays extended currency symbols on TSO.

UNITS

Specifies the unit of measure for page margins, column positions, and column widths.

WEBTAB

Encloses CRTFORM display fields in @ signs.

Security Tasks

The following parameters specify user access to data sources and procedures.

DBACSENSITIV

Controls whether password validation is case-sensitive.

DBASOURCE

Controls the source of access restrictions in a multi-file structure.

PASS

Enables user access to a data source or stored procedure protected by Information Builders security.

PERMPASS

The PERMPASS parameter establishes a user password that remains in effect throughout a session or connection.

USER

In FOCUS , enables user access to a data source or stored procedure protected by Information Builders security.

Terminal Tasks

The following parameters specify options for display in your terminal.

DISPLAY

Is the PC display mode selection.

EXTTERM

Enables the use of extended terminal attributes.

HOTMENU

Automatically displays the Hot Screen PF key legend at the bottom of the Hot Screen report.

SBORDER

Generates a solid border on the screen for full-screen mode.

SCREEN

Selects the Hot Screen facility.

TRMOUT

Suppresses all output messages to the terminal.

 


Information Builders