FLAG

Edit online

Read syntax diagramSkip visual syntax diagramFLAG(,0integerALIGNNOALIGNCONTNOCONTNOIMPLENIMPLENNOLONGERLONGERNOPAGE0PAGE0PUSHNOPUSHRECORDNORECORDRENTNORENTNOSIGNEDSIGNEDNOSUBSTRSUBSTRNOTRUNCTRUNCUSING0NOUSING0EXLITWNOEXLITW1)
Notes:
  • 1 Choose at least one option.
Default
FLAG(0, ALIGN, CONT, EXLITW, NOIMPLEN, NOLONGER, NOPAGE0, PUSH, RECORD, RENT, NOSIGNED, NOSUBSTR, NOTRUNC, USING0)
Abbreviations
AL, NOAL, IMP, NOIMP, LONG, NOLONG, PG0, NOPG0, PU, NOPU, RC, NORC, SI, NOSI, SUB, NOSUB, TR, NOTR, US0, NOUS0
Parameter of ACONTROL statement
You can specify the FLAG option as a parameter of the ACONTROL statement. For further details, refer to the ACONTROL instruction in the HLASM Language Reference.
integer
Specifies that error diagnostic messages with this or a higher severity code are printed in the source and object section of the assembly listing. Error diagnostic messages with a severity code lower than integer do not appear in the source and object section, and the severity code associated with those messages is not used to set the return code issued by the assembler. Any severity code from 0 through 255 can be specified. 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.

When specified with the TERM assembler option, FLAG controls which messages are displayed in the terminal output.

ALIGN
Instructs the assembler to issue diagnostic message ASMA033I when an inconsistency is detected between the operation code type and the alignment of addresses in machine instructions. Assembler option ALIGN describes when the assembler detects an inconsistency.
NOALIGN
Instructs the assembler not to issue diagnostic messages ASMA033I, ASMA212W, and ASMA213W when an inconsistency is detected between the operation code type and the alignment of addresses in machine instructions.
CONT
Specifies that the assembler is to issue diagnostic messages ASMA430W through ASMA433W when one of the following situations occurs in a macro call instruction:
  • The operand on the continued record ends with a comma, and a continuation statement is present but continuation does not start in the continue column (normally column 16).
  • A list of one or more operands ends with a comma, but the continuation indicator field (normally column 72) is a space.
  • The continuation record starts in the continue column (normally column 16) but there is no comma present following the operands on the previous record.
  • The continued record is full but the continuation record does not start in the continue column (normally column 16).
Note: FLAG(CONT) checks only apply to statements that appear in the output listing.
NOCONT
Specifies that the assembler is not to issue diagnostic messages ASMA430W through ASMA433W when an inconsistent continuation is encountered.
EXLITW
Instructs the assembler to issue diagnostic warning ASMA016W when a literal is used as the object of an EX instruction.
NOEXLITW
Instructs the assembler to suppress diagnostic warning message ASMA016W when a literal is used as the object of an EX instruction.
IMPLEN
Instructs the assembler to issue diagnostic message ASMA169I when an explicit length subfield is omitted from an SS-format machine instruction.
NOIMPLEN
Instructs the assembler not to issue diagnostic message ASMA169I when an explicit length subfield is omitted from an SS-format machine instruction.
LONGER
Instructs the assembler to issue diagnostic warning message ASMA226W if the implicit length of the value for a string constant (type B, C, CU, G, P or Z) is greater than the explicit length of the field. For a hexadecimal field with a length specified in bits, it only issues the warning if the implicit length is at least 4 bits longer than the explicit length because hexadecimal digits cannot represent less than 4 bits. If FLAG(TRUNC) is also in effect, the truncation warning takes precedence, so this message will only appear if the truncated part of the string value consists of leading zeros for a numeric value or trailing spaces for a character or graphics value.
Note: Warnings produced by FLAG(LONGER) are likely to be harmless and do not necessarily indicate a coding error, as existing code (including macro instructions supplied with IBM products) may simply be relying on truncation as a way of simplifying source code. This option can be used temporarily to check for possible errors, but if existing code triggers unnecessary warnings the option should be turned off again.
NOLONGER
Instructs the assembler not to issue diagnostic warning message ASMA226W.
PAGE0
Instructs the assembler to issue diagnostic message ASMA309W when an operand is resolved to a baseless address and a base and displacement is expected. This message is only issued for instructions that reference storage. For example, a LOAD instruction generates the message but a LOAD ADDRESS instruction does not generate the message.
NOPAGE0
Instructs the assembler not to issue diagnostic message ASMA309W when an operand is resolved to a baseless address and a base and displacement is expected.
PUSH
Instructs the assembler to issue diagnostic warning message ASMA138W when a PUSH/POP stack is not empty at the completion of a compile.
NOPUSH
Instructs the assembler to suppress diagnostic warning message ASMA138W when a PUSH/POP stack is not empty at the completion of a compile.
RECORD
Instructs the assembler to do the following:
  1. Issue diagnostic message ASMA435I immediately after the last diagnostic message for each statement in error. The message text describes the record number and input data set name of the statement in error.
  2. Include the member name (if applicable), the record number and the input data set concatenation value with the statement number in the list of flagged statements in the Diagnostic Cross Reference and Assembler Summary section of the assembler listing.
NORECORD
Instructs the assembler to do the following:
  • Not issue diagnostic message ASMA435I for statements in error.
  • Only show the statement number in the list of flagged statements in the Diagnostic Cross Reference and Assembler Summary section of the assembler listing.
RENT
Instructs the assembler to issue diagnostic warning message ASMA036W if reentrant checks as specified by the RENT option detect a potential error.
NORENT
Instructs the assembler not to issue diagnostic warning message ASMA036W.
SIGNED
Instructs the assembler to issue diagnostic warning message ASMA227W if a negative value has been specified for an address constant (type A, AD or Y) with an explicit length less than the full length, which expects an unsigned value. If FLAG(TRUNC) is in effect, any truncation warning takes precedence.
Note: Warnings produced by FLAG(SIGNED) are likely to be harmless and do not necessarily indicate a coding error, as existing code (including macro instructions supplied with IBM products) may simply be relying on truncation as a way of simplifying source code. This option can be used temporarily to check for possible errors, but if existing code triggers unnecessary warnings the option should be turned off again.
NOSIGNED
Instructs the assembler not to issue diagnostic warning message ASMA227W.
SUBSTR
Instructs the assembler to issue warning diagnostic message ASMA094I when the second subscript value of the substring notation indexes past the end of the character expression.
NOSUBSTR
Instructs the assembler not to issue warning diagnostic message ASMA094I when the second subscript value of the substring notation indexes past the end of the character expression.
TRUNC
Instructs the assembler to issue diagnostic warning message ASMA225W if the stored value of a constant has been changed from the specified value by being truncated to fit the specified length. A numeric string value (type B, P, X or Z) is not considered changed if only leading zeros were removed. A character or graphics string value (type C, CU or G) is not considered changed if only trailing spaces were removed. For an address constant (type A, AD or Y), the value is not considered changed if all truncated leading bits are zero, or (to tolerate signed values being used in unsigned contexts) if the value is negative and all truncated leading bits and the first bit of the truncated value are one.
Note: Warnings produced by FLAG(TRUNC) could indicate potentially harmful coding errors, so it is recommended that this option should be used where possible. The standard default is NOTRUNC in order to avoid triggering new warnings for existing programs.
NOTRUNC
Instructs the assembler not to issue diagnostic warning message ASMA225W.
USING0
Instructs the assembler to issue diagnostic warning message ASMA306W for a USING that is coincident with or overlaps an implied USING 0,0, when the USING(WARN) suboption includes the condition numbers 1 and 4.
Note: Message ASMA302W is issued when R0 is specified as a base register with a nonzero base address, and message ASMA306W is issued when any register other than R0 is specified as a base register with an absolute base address whose range overlaps the assembler's default (0,4095).
NOUSING0
Instructs the assembler to suppress diagnostic warning message ASMA306W.
Note: Message ASMA302W is issued when R0 is specified as a base register with a non-zero base address, and message ASMA306W is issued when any register other than R0 is specified as a base register with an absolute base address whose range overlaps the assembler's default (0,4095).

The FLAG suboptions ALIGN, CONT, IMPLEN, LONGER, PAGE0, PUSH, RECORD, RENT, SIGNED, SUBSTR, TRUNC, USING0, and EXLITW are specified in the installation default options as ALIGNWARN, CONTWARN, IMPLENWARN, LONGERWARN, PAGE0WARN, PUSHWARN, RECORDINFO, RENTWARN, SIGNEDWARN, SUBSTRWARN, TRUNCWARN, USING0WARN, and EXLITW.

For information about installation default options, refer to the HLASM Installation and Customization Guide.