These tables summarize the options that may be specified for the language compilers, linkage editor, loader and sort/merge utility. The options are specified by including them in the parameter field on the execute statement, for example:
EXEC PGM=IKFCBL00,PARM='option,option,...option'
In all tables, options that are shown underlined are those which are usually set as installation defaults. However, the defaults may be changed during System Generation.
Option |
Description |
---|---|
DECK NODECK |
Specifies that a program object deck is [DECK] or is not [NODECK] to be written to the SYSPUNCH DDname dataset. |
LOAD NOLOAD |
Specifies that a program object module is [LOAD] or is not [NOLOAD] to be written to the SYSLIN DDname dataset. |
PROGRAM PROCEDURE |
Specifies that the source program being compiled is an executable program [PROGRAM] or is a procedure that is being separately compiled in order to be combined with other programs or procedures [PROCEDURE]. |
LONG SHORT |
Specifies that the internal representation of real values is in full words [SHORT] or double words [LONG]. |
SIZE=nnnnn | Specifies the main storage size, in bytes, that is available to the compiler. 45056 is the minimum which can be specified, and is the default. |
SOURCE NOSOURCE |
Specifies that the source program and identifier tables listings are either to be printed [SOURCE] or not printed [NOSOURCE]. |
EBCDIC ISO |
Specifies that the character set used to represent the source program is either a 53 character set in EBCDIC or the 46 character set in BCD which has been established as standard for ALGOL by ISO and DIN. |
TEST NOTEST |
Specifies that the generated object module is [TEST] or is not [NOTEST] to include information which is normally used only for testing. The information consists of instructions to produce the semicolon count, and instructions checking the values of subscript expressions against array bounds. |
The assemblers included with MVT and MVS are not identical. The assembler installed with MVT is IEUASM (Assembler F), whereas IFOX00 (which may also be referred to as Assembler F, but is more correctly referred to as Assembler XF) is installed with MVS 3.8j. The load module for IFOX00 is invoked under MVS if you EXEC PGM=IEUASM, since the IEUASM alias to the IFOX00 load module is created in SYS1.LINKLIB when MVS is installed. Later versions of assembler were program products, and were only available for purchase and may not be distributed without an authorized license. The IFOX00 assembler will run unchanged under MVT, and can be utilized to assemble some programs that would be difficult (or impossible) to assemble with IEUASM, most notably HASP.
The table of options for the assembler below has been assembled from several sources contemporary with MFT, MVT, and MVS. However, in light of the differences in assemblers noted above, not all options will be applicable with any assembler invoked. Specifically, IEUASM does not recognize ESD/NOESD, FLAG(n), LIBMAC/NOLIBMAC, MCALL/NOMCALL, SYSPARM(x), XREF(FULL)/XREF(SHORT). A side-by-side comparison of the options for the two assemblers is available on the page Installing the IFOX00 Assembler (from MVS) Under MVT.
Option |
Description |
---|---|
ALGN NOALGN |
Specifies that the alignment error diagnostic message should [ALGN] or should not [NOALGN] be produced. |
DECK NODECK |
Specifies that a program object deck is [DECK] or is not [NODECK] to be written to the SYSPUNCH DDname dataset. |
ESD NOESD |
Specifies that an External Symbol Dictionary is [ESD] or is not [NOESD] to be produced in the assembler listing. |
FLAG(n) | Specifies that error diagnostic messages with a severity code equal to or higher than the value of n specified are to be printed in the assembly listing. Error diagnostic messages with a severity code lower than the value of n specified are not printed and are not used to set the return code issued by the assembler. Error diagnostic messages have a severity code of 0, 2, 4, 8, 12, 16, or 20. MNOTES can have a severity code of 0 through 255. Default is FLAG(0). |
LIBMAC NOLIBMAC |
Specfies that, for each macro, macro definition statements read from a macro library are [LIBMAC] or are not [NOLIBMAC] to be embedded in the input source program immediately preceding the first invocation of that macro. The assembler assigns statement numbers to the macro definition statements as though they were included in the input source program. |
LINECNT=nn | Specifies the number of print lines per page. Default is LINECNT=55. |
LIST NOLIST |
Specifies that a source program listing is [LIST] or is not [NOLIST] to be produced. |
MCALL NOMCALL |
Specifies that inner macro calls are [MCALL] or are not [NOMCALL] to be shown in the source listing. |
NUM NONUM |
Intended for Time Sharing Option (TSO) - Specfies that program line numbers should [NUM] or should not [NONUM] be written to the DDname SYSTERM dataset. |
OBJECT NOOBJECT |
Specifies that a program object module is [OBJECT] or is not [NOOBJECT] to be written to the SYSGO DDname dataset. |
RENT NORENT |
Specifies that additional edit checks should [RENT] or should not [NORENT] be made for re-enterable program code errors. |
RLD NORLD |
Specifies that the Relocation Dictionary is [RLD] or is not [NORLD] to be produced in the assembler listing. |
STMT NOSTMT |
Intended for Time Sharing Option (TSO) - Specifies that diagnostic messages written to the DDname SYSTERM dataset are [STMT] or are not [NOSTMT] to contain source statement numbers. |
SYSPARM(x) | Specifies the character string the assembler assigns to the &SYSPARM system variable symbol. The character string is up to 255 characters in length. |
TERM NOTERM |
Intended for Time Sharing Option (TSO) - Specifies that progress messages and diagnostics are [TERM] or are not [NOTERM] to be written to the DDname SYSTERM dataset. |
TEST NOTEST |
Specifies that the program object module is [TEST] or is not [NOTEST] to contain the special source symbol table (SYM records) required for the TSO TEST command. |
XREF XREF(FULL) XREF(SHORT) NOXREF |
Specifies that a Cross Reference Table is [XREF, XREF(FULL), XREF(SHORT)] or is not [NOXREF] to be produced. XREF(FULL) includes all ordinary symbols and literals defined, whether referenced or not, whilc XREF(SHORT) only includes symbols and literals that are referred to. |
Option |
Description |
---|---|
APOST QUOTE |
Specifies that either the apostrophe (') or quote (") is valid as a constant delimiter. |
BUF=nnnnnn | Specifies the amount of main storage to be allocated for input/output buffers during compilation. Default is BUF=81920. |
CLIST NOCLIST |
Specifies that a Condensed Listing of the source program's assembly language representation is [CLIST] or is not [NOCLIST] to be produced. |
DECK NODECK |
Specifies that a program object deck is [DECK] or is not [NODECK] to be written to the SYSPUNCH DDname dataset. |
DMAP NODMAP |
Specifies that a Data Division Map listing of program variables is [DMAP] or is not [NODMAP] to be produced. |
FLAGW FLAGE |
Specifies that Warning (W) or Error (E) level messages are to be printed. |
LIB NOLIB |
Specifies that the Copy Library (SYSLIB DDname dataset) is [LIB] or is not [NOLIB] to be opened for compiler access. |
LINECNT=nn | Specifies the number of print lines per page. Default is LINECNT=57. |
LOAD NOLOAD |
Specifies that a program object module is [LOAD] or is not [NOLOAD] to be written to the SYSLIN DDname dataset. |
PMAP NOPMAP |
Specifies that a Procedure Division Map listing of program assignments, tables, and an assembly language representation of the source program are [PMAP] or are not [NOPMAP] to be produced. |
SEQ NOSEQ |
Specifies that source statement numbers are [SEQ] or are not [NOSEQ] to be checked for proper sequence. |
SIZE=nnnnnn | Specifies the main storage allocation for the compiler. Default is SIZE=2768. |
SOURCE NOSOURCE |
Specifies that a source program listing is [SOURCE] or is not [NOSOURCE] to be produced. |
SPACE1 SPACE2 SPACE3 |
Specifies that the source program listing is to be single, double, or triple spaced, respectively |
SUPMAP NOSUPMAP |
Specifies that creation of the object module should be suppressed [SUPMAP] upon occurrence of compiler discovered source program errors. |
TRUNC NOTRUNC |
Specfies that truncation is [TRUNC] or is not [NOTRUNC] to be allowed when moving data to variable names defined as USAGE COMPUTATIONAL (binary). |
VERB NOVERB |
Specifies that procedure verbs are [VERB] or are not [NOVERB] to be listed in the Procedure Division Map or Condensed Listing. |
XREF NOXREF |
Specifies that an unsorted Cross Reference Table is [XREF] or is not [NOXREF] to be produced. |
ZWB NOZWB |
Specifies that the compiler should [ZWB] or should not [NOZWB] drop the sign from signed external decimal fields if they are to be compared with alphanumeric fields. |
Option |
Description |
---|---|
DECK NODECK |
Specifies that a program object deck is [DECK] or is not [NODECK] to be written to the SYSPUNCH DDname dataset. |
EBCDIC BCD |
Specifies that the source program is written in Binary Coded Decimal [BCD] or the Extended Binary Coded Decimal Interchange Code [EBCDIC]. |
EDIT NOEDIT |
H Level Only - Specifies that a structured source program listing depicting program loop and logical conditions should [EDIT] or should not [NOEDIT] be produced. |
ID NOID |
Specifies that internal source statement numbers for external call instructions should [ID] or should not [NOID] be printed in the trace tables. |
LINECNT=nn | Specifies the number of print lines per page. |
LIST NOLIST |
Specifies that an assembly language representation of the source program is [LIST] or is not [NOLIST] to be produced. |
LOAD NOLOAD |
Specifies that a program object module is [LOAD] or is not [NOLOAD] to be written to the SYSLIN DDname dataset. |
MAP NOMAP |
Specifies that a location map of program variable names, subprograms, and format statements is [MAP] or is not [NOMAP] to be produced. |
NAME=MAIN NAME=name |
Specifies a name for the program object module. |
OPT=0 OPT=1 OPT=2 |
H Level Only - Specifies that no optimizing (0), single-loop optimizing (1), or multiple-loop optimizing (2) techniques are to be utilized when creating the program object module. |
SIZE=nnnnK | H Level Only - Specifies the main storage allocation for the compiler. |
SOURCE NOSOURCE |
Specifies that a source program listing is [SOURCE] or is not [NOSOURCE] to be produced. |
XREF NOXREF |
H Level Only - Specifies that a Cross Reference Table is [XREF] or is not [NOXREF] to be produced. |
Option |
Description |
---|---|
DC | Downward Compatible - Must be specified if program load modules created by the Level F linkage editor are to later be processed by the Level E linkage editor. |
DCBS | Data Control Block Size - Allows block size to be specified via JCL to the Data Control Block area for the DDname SYSLMOD dataset. |
HIAR | Hierarchy - Assigns the hierarchy format attribute. Used when main storage hierarchy is supported by the Operating System. |
LET | Program load module will be marked executable even if one or more error conditions which may make execution impossible are encountered. |
LIST | Produce a list of Linkage Editor control statements utilized. |
MAP | Produce a map listing of the relative location and length of each program and subprogram module. |
NCAL | No Call - Automatic calls to SYSLIB DDname libraries will not be made to resolve external references. The LIBRARY statement also cannot be used. The program load module is marked as executable, however. |
NE | Not Editable - The output load module will not contain an External Symbol Dictionary. This saves space but the resulting load module cannot be reprocessed by the linkage editor. |
OL | Only Loadable - The program module can be placed in main storage by a LOAD macro only. This saves space but the LINK, XCTL, and ATTACH macros cannot be used. |
OVLY | Overlay - Must be specified if the program overlay processing feature is to be utilized. |
REFR | Refreshable - Refreshable program modules can be replaced by a new copy during execution. |
RENT REUS |
Program Reusability Attributes - Re-enterable [RENT] and Serially Reusable [REUS]. Re-enterable modules can be executed by more than one task at the same time. Serially reusable modules can be executed by only one task at the same time. Non-reusable modules must request a new copy for each task to be executed. |
SCTR | Scatter - Program load modules with Scatter Format need not be loaded in one contiguous area of main storage. |
SIZE=(xxxxxx,yyyyyy) SIZE=(xxxK,yyyK) |
Main storage allocation, where xxxxxx and xxxK = maximum number of bytes to be allocated for the linkage editor program including buffers, while yyyyyy and yyyK = maximum number of bytes to be allocated for buffer area only. K = 1024 bytes. |
TERM | Intended for Time Sharing Option (TSO) - Specifies that progress messages and diagnostics are to be written to the DDname SYSTERM dataset. |
TEST | Program load module is to be tested using the Operating System's test translator (TESTRAN) or the Time Sharing Option's (TSO) test command. |
XCAL | Exclusive Call - Program load module will be marked as executable though a warning message will be given for all valid exclusive references made between overlay segments. |
XREF | Produce a Cross Reference Table of the output load module in addition to a map listing. |
Option |
Description |
---|---|
CALL NCAL NOCALL |
No Call - Automatic calls to SYSLIB DDname libraries will [CALL] or will not [NCAL or NOCALL] be made to resolve external references. |
EP=name | Entry Point - Specifies that execution is to begin at the external name indicated. |
NAME=**GO NAME=name |
Specifies the name to be used to identify the load module to be executed. |
FLOW FLOW=yy NOFLOW |
Specifies that error facility procedure name trace messages are [FLOW or FLOW=yy] or are not [NOFLOW] to be written to the SYSDBOUT DDname dataset. The default (for FLOW) is generally 99 procedures. If this program option is coded here rather than at compile time, a slash (/) must be coded prior to the specification. This option must also be positioned last among the options coded - PARM.GO='NOCALL,NORES,/FLOW'. |
LET NOLET |
Executable program module will be allowed [LET] to continue even if one or more errors occur during the loader processing. |
MAP NOMAP |
Specifies that a map listing the relative location and length of each program and subprogram module is [MAP] or is not [NOMAP] to be produced. |
TERM NOTERM |
Intended for Time Sharing Option (TSO) - Specifies that progress messages and diagnostics are [TERM] or are not [NOTERM] to be written to the DDname SYSTERM dataset. |
PRINT NOPRINT |
Indicates that diagnostic messages are [PRINT] or are not [NOPRINT] to be written to the DDname SYSLOUT dataset. |
RES NORES |
No Resident Search - Automatic calls to the link pack queue area will [RES] or will not [NORES] be made. |
SIZE=yyyK | Specifies the main storage allocation for the loader, where yyyK = maximum number of bytes to be allocated for loader use, including buffers. K=1024 bytes. |
Option |
Description |
---|---|
CHARSET(60 EBCDIC) CHARSET(48) CHARSET(60) CHARSET(48 BCD) CHARSET(48 EBCDIC) CHARSET(60 BCD) |
Specifies whether the 48 or 60 character set is to be utilized, and if the Binary Coded Decimal (BCD) or Extended Binary Coded Decimal Interchange Code (EBCDIC) form of data representation is to be used. |
CONTROL('password') | Specifies that compiler options deleted at this installation are to be available for this compile, where password is the installation's control password. |
FLAG(I) FLAG(W) FLAG(E) FLAG(S) |
Specifies at what error level appropriate messages should be provided, where I = all, W = warning, E = standard error, S = severe error. |
INSOURCE NOINSOURCE |
When the preprocessor is used, specifies that a source program listing including preprocessor statements is [INSOURCE] or is not [NOINSOURCE] to be produced. |
LINECNT=nn | Specifies the number of print lines per page. |
LMESSAGE SMESSAGE |
Specifies that compiler messages are to be provided in long (L) or short (S) form. |
MARGINS(x,y,z) | Specifies the location of PL/1 source program statements, where x = left-hand column, y = right-hand column, and z = ANS control character column (or zero for its absence). The defaults are MARGINS(2,72,0) for fixed length records and MARGINS(10,100,0) for variable length records. |
NAME('name') | Specifies that a Linkage Editor NAME statement should be created where name = the user supplied program name. |
AGGREGATE NOAGGREGATE |
Specifies that an aggregate length table is [AGGREGATE] or is not [NOAGGREGATE] to be produced. |
ATTRIBUTES NOATTRIBUTES |
Specifies that an identifier attributes table is [ATTRIBUTES] or is not [NOATTRIBUTES] to be produced. |
COMPILE NOCOMPILE(S) NOCOMPILE(W) NOCOMPILE(E) NOCOMPILE |
Specifies at what error level compilation should be discontinued, where W = warning, E = standard error, E = severe error, NOCOMPILE = stop after syntax check, and COMPILE = do not discontinue compilation, if possible. |
COUNT NOCOUNT |
Specifies that a count of each source statement's execution is [COUNT] or is not [NOCOUNT] to be maintained when the program is executed. |
DECK NODECK |
Specifies that a program object deck is [DECK] or is not [NODECK] to be written to the SYSPUNCH DDname dataset. |
DUMP NODUMP |
Specifies that a main storage dump should [DUMP] or should not [NODUMP] be written to the DDname SYSPRINT dataset if the compile step abnormally terminates. |
ESD NOESD |
Specifies that an External Symbol Dictionary is [ESD] or is not [NOESD] to be produced. |
FLOW FLOW(x,y) NOFLOW |
Specifies that a flow of program control is [FLOW or FLOW(x,y)] or is not [NOFLOW] to be produced. The default (for FLOW) is a maximum of 25 entries and 10 procedures. |
GONUMBER NOGONUMBER |
Specifies that upon abnormal termination, the program source statement number being executed should [GONUMBER] or should not [NOGONUMBER] be printed, using additional line number information for analysis. |
GOSTMT NOGOSTMT |
Specifies that upon abnormal termination, the program source statement number being executed should [GOSTMT] or should not [NOGOSTMT] be printed. |
IMPRECISE NOIMPRECISE |
Specifies that the program object module should be modified to improve upon identification of specific System 360 Model 91 or 195 interrupts. |
INCLUDE NOINCLUDE |
Specifies that the compiler is to use PL/1 preprocessor %INCLUDE statements [INCLUDE] rather than calling the preprocessor itself [NOINCLUDE]. |
LIST LIST(x) LIST(x,y) NOLIST |
Specifies that an assembly language representation of the source program in lieu of a Table of Offsets should [LIST] or should not [NOLIST] be provided. The listing produced may also be limited to a portion of the source program, where x = the number of the first source statement desired, and y = the number of the last source statement desired. |
MACRO NOMACRO |
Specifies that the PL/1 preprocessor is [MACRO] or is not [NOMACRO] to process the source program. |
MAP NOMAP |
Specifies that a location map of the program is [MAP] or is not [NOMAP] to be produced. |
MARGINI('x') NOMARGINI |
Specifies that a left and right hand margin indicator should [MARGINI(x)] or should not [NOMARGINI] be printed, where x = the character to be used. |
MDECK NOMDECK |
Specifies that a macro program deck from the PL/1 preprocessor is [MDECK] or is not [NOMDECK] to be created in the SYSPUNCH DDname dataset. |
NEST NONEST |
Specifies that nested program loops should [NEST] or should not [NONEST] be fully identified in the source listing. |
NUMBER NONUMBER |
Specifies that source program sequence numbers should [NUMBER] or should not [NONUMBER] be used for compiler program listings. |
OFFSET NOOFFSET |
Specifies that a statement and line number table of offsets should [OFFSET] or should not [NOOFFSET] be produced. |
OPTIMIZE(TIME) OPTIMIZE(2) OPTIMIZE(0) NOOPTIMIZE |
Generates a non-optimized [NOOPTIMIZE or OPTIMIZE(0)] or optimized [OPTIMIZE(TIME) or OPTIMIZE(2)] program object module. |
SEQUENCE(x,y) NOSEQUENCE |
Specifies the absence [NOSEQUENCE] or presence [SEQUENCE] of PL/1 statement sequence numbers, where x = left-hand column and y = right-hand column where number occurs in the source statements.. |
STORAGE NOSTORAGE |
Specifies that a report of main storage requirements for the program object module should [STORAGE] or should not [NOSTORAGE] be produced. |
SYNTAX NOSYNTAX(S) NOSYNTAX(W) NOSYNTAX(E) |
Specifies at what error level syntax checking should stop [NOSYNTAX], where W = warning, E = standard unrecoverable error, S = severe error, and SYNTAX = do not stop, if possible. |
TERMINAL(options) NOTERMINAL |
Intended for Time Sharing Option (TSO) - Specifies which components of compiler output are to be routed to the terminal, where options = various compiler options in this table. |
XREF NOXREF |
Specifies that a Cross Reference Table is [XREF] or is not [NOXREF] to be produced. |
OBJECT NOOBJECT |
Specifies that the program object module is [OBJECT] or is not [NOOBJECT] to be created in the SYSLIN DDname dataset. |
OPTIONS NOOPTIONS |
Specifies that a listing of compiler defaults and options in effect should [OPTIONS] or should not [NOOPTIONS] be produced. |
SIZE(MAX) SIZE(yyyyyyyy) SIZE(yyyyyK) SIZE=(-yyyyy) SIZE=(-yyyK) |
Limits the amount of main storage to be used by the compiler, where y's = bytes of main storage, K = 1024 bytes of main storage, MAX directs compiler to obtain as much main storage as possible, and the '-' specifies MAX with a release of the number of bytes indicated. |
SOURCE NOSOURCE |
Specifies that a source program listing, including preprocessor statements, is [SOURCE] or is not [NOSOURCE] to be produced. |
STMT NOSTMT |
Specifies that each source statement is [STMT] or is not [NOSTMT] to be counted and that this number is to be used to identify statements in various compiler outputs. |
Option |
Description |
---|---|
DECK NODECK |
Specifies that a program object deck is [DECK] or is not [NODECK] to be written to the SYSPUNCH DDname dataset. |
LIST NOLIST |
Specifies that a source program listing is [LIST] or is not [NOLIST] to be produced. |
LOAD NOLOAD |
Specifies that a program object module is [LOAD] or is not [NOLOAD] to be written to the SYSGO DDname dataset. |
SEQN NOSEQN |
Specifies that source statement numbers are [SEQN] or are not [NOSEQN] to be checked for proper sequence. |
Option |
Description |
---|---|
BALN | Specifies that the Balanced Tape or Direct Access Technique is to be used for sort work distribution. |
CORE=yyyyyy | Specifies the main storage allocation, where yyyyyy = number of bytes to be allocated for the sort/merge program, including buffers. |
CRCX | Specifies that the Criss Cross Direct Access Technique is to be used for sort work distribution. |
DIAG | Specifies that detailed diagnostic messages are to be produced for use in solving severe sort/merge problems. |
MSG=AC MSG=AP MSG=CC MSG=CP MSG=NO |
Specifies the quantity and destination of messages, where AC=all messages to console, AP=all messages to printer, CC=critical messages to console, CP=critical messages to printer, and NO=no messages. |
OSCL | Specifies that the Oscillating Tape Technique is to be used for sort work distribution. |
POLY | Specifies that the Polyphase Tape Technique is to be used for sort work distribution. |
Although I do not regularly use all of the MVT language transation and utilities for which these parameters are specified, if you have questions about any of these parameters I will be glad to try and answer them for you. Also, if you find errors or omissions in the parameters I have included here, please don't hesitate to let me know.