.option pseudo-op

Purpose

Specifies options that are used while assembling a program.

Syntax

.option StringConstant

Description

The .option pseudo-op specifies options to be used while assembling a program. The .option pseudo-op overrides the options that are specified with the -a flag when you invoke the assembler.

The .option pseudo-op can be called in the source program multiple times. The new options that are specified in the call remain valid until the .option pseudo-op is called again.

Parameters

Item	Description
StringConstant	Specifies one or more options. If you do not specify this parameter, or if you specify an empty string, all options are restored to their corresponding default values. You can specify the following values for this parameter: push Saves the current options on a stack. pop Restores the option values that were saved by the most recent call of the .option "push" pseudo-op. Note: The intended use of the push and the pop parameters is inside the included files and these parameters alter options. Use the .option "push" pseudo op in an included file, before changing any options. Use the .option "pop" pseudo op at the end of the included file to restore the options. Each occurrence of the .option "push" pseudo-op must have a paired .option "pop" pseudo-op. align-prefixed-csect=<yes/no> Specifies whether the alignment of a control section (csect) that contains prefixed instructions will be increased to at least a 64-byte boundary, if necessary. 64-byte is the minimum alignment which ensures that the prefixed instructions are aligned properly when assembled programs are linked. If you specify yes for the align-prefixed-csect option, the alignment of csects that contain the prefixed instructions is increased, if necessary. If you specify no for the align-prefixed-csect option and the -w flag is used on the command line, a warning message is displayed if a prefixed instruction is part of a csect with an alignment which is not strict enough. For more information, see the .align pseudo-op. align-prefixed-op=<yes/no> Specifies whether a prefixed instruction is aligned by preceding the instruction with a no-op instruction when the prefixed instruction would cross a 64-byte boundary. If you specify yes for the align-prefixed-op option, prefixed instructions are aligned, if required. If you specify no for the align-prefixed-op option and the -w flag is used on the command line, a warning message is displayed if a prefixed instruction crosses a 64-byte boundary. For more information, see the .align pseudo-op.

Item

Description

StringConstant

Specifies one or more options. If you do not specify this parameter, or if you specify an empty string, all options are restored to their corresponding default values. You can specify the following values for this parameter:

push: Saves the current options on a stack.
pop: Restores the option values that were saved by the most recent call of the .option "push" pseudo-op.
Note: The intended use of the push and the pop parameters is inside the included files and these parameters alter options. Use the .option "push" pseudo op in an included file, before changing any options. Use the .option "pop" pseudo op at the end of the included file to restore the options. Each occurrence of the .option "push" pseudo-op must have a paired .option "pop" pseudo-op.
align-prefixed-csect=<yes/no>: Specifies whether the alignment of a control section (csect) that contains prefixed instructions will be increased to at least a 64-byte boundary, if necessary. 64-byte is the minimum alignment which ensures that the prefixed instructions are aligned properly when assembled programs are linked. If you specify yes for the align-prefixed-csect option, the alignment of csects that contain the prefixed instructions is increased, if necessary. If you specify no for the align-prefixed-csect option and the -w flag is used on the command line, a warning message is displayed if a prefixed instruction is part of a csect with an alignment which is not strict enough. For more information, see the .align pseudo-op.
align-prefixed-op=<yes/no>: Specifies whether a prefixed instruction is aligned by preceding the instruction with a no-op instruction when the prefixed instruction would cross a 64-byte boundary. If you specify yes for the align-prefixed-op option, prefixed instructions are aligned, if required. If you specify no for the align-prefixed-op option and the -w flag is used on the command line, a warning message is displayed if a prefixed instruction crosses a 64-byte boundary. For more information, see the .align pseudo-op.