MACRO[/qualifier[s]] filespec[/qualifier[s][,filespec[,s]] Command Qualifiers /[NO]CROSS_REFERENCE /[NO]LIST[:filespec] /[NO]OBJECT[:filespec] /[NO]WIDE /DISABLE:(argument[,s]) /ENABLE:(argument[,s]) /[NO]SHOW:(argument[,s]) File Qualifiers /LIBRARY /PASS:n MACRO invokes the MACRO-11 Relocatable Assembler, which assembles one or more MACRO-11 source files into a single relocatable object module suitable for processing by the Task Builder. 2 CROSS_REFERENCE MACRO/CROSS_REFERENCE filespec[,s] The /CROSS_REFERENCE qualifier causes the MACRO-11 Assembler to invoke the CREF system utility program to produce a listing that includes cross-references to symbosl that appear in the source program. The cross-reference listing is appended to the assembly listing. Such cross-references are helpful in debugging and in reading long programs. /CROSS_REFERENCE as a command qualifier causes the listing to be printed on the line printer and placed in your UFD. /CROSS_REFERENCE as a filespec qualifier places the file in your directory, but it is not passed to the line printer; also, the listing file takes its name from the name of the file to which it is attached. All the listing-related qualifiers work in this way. All the listing-related qualifiers also imply /LIST. If you use any of them, you do not need /LIST unless you wish to give the listing file a name different from the names of any of the files in the command. 2 LIBRARY MACRO filespec/LIBRARY,filespec[,s] The /LIBRARY qualifier specifies that the file is a macro library containing source macro definitions. The default extension for this file is .MLB. 2 NOLIST #LIST 2 LIST MACRO/LIST[:filespec] filespec[,s] MACRO filespec[,s]/LIST MACRO/NOLIST filespec[,s] The /LIST qualifier specifies that a listing file of the assembly be generated. If a filespec is not given, the listing file will have the same name as the last source file, with a type of .LST. /NOLIST is the default and inhibits a listing file from being created. /LIST as a command qualifier causes the listing to be printed on the line printer and placed in your UFD. /LIST as a filespec qualifier places the file in your directory, but it is not passed to the line printer; also, the listing file takes its name from the name of the file to which it is attached. All the listing-related qualifiers work in this way. All the listing-related qualifiers also imply /LIST. If you use any of them, you do not need /LIST unless you wish to give the listing file a name different from the names of any of the files in the command. See also HELP MACRO WIDE, HELP MACRO CROSS_REFERENCE, HELP MACRO SHOW. 2 NOWIDE #WIDE 2 WIDE MACRO/WIDE filespec[,s] MACRO filespec[,s]/WIDE The /WIDE qualifier specifies that you wish the assembly listing in wide format, sometimes called line-printer format. This is the default. The /NOWIDE qualifier specifies that you wish the assembly listing in narrow format, sometimes called teleprinter format. This qualifier overrides any .LIST TTM or .NLIST TTM directives in the source code. /[NO]WIDE as a command qualifier causes the listing to be printed on the line printer and placed in your UFD. /[NO]WIDE as a filespec qualifier places the file in your directory, but it is not passed to the line printer; also, the listing file takes its name from the name of the file to which it is attached. All the listing-related qualifiers work in this way. All the listing-related qualifiers also imply /LIST. If you use any of them, you do not need /LIST unless you wish to give the listing file a name different from the names of any of the files in the command. 2 NOOBJECT #OBJECT 2 OBJECT MACRO/OBJECT[:filespec] filespec[,s] MACRO/NOOBJECT filespec[,s] The /OBJECT qualifier specifies that an object file be generated. If a filespec is not specified, the object file will have the same name as the last source file, with a type of .OBJ. This is the default. The /NOOBJECT qualifier inhibits generation of an object file. 2 PASS MACRO filespec/PASS:n The /PASS qualifier specifies that the file is only to be used during pass 'n' of the assembly process. Valid values for 'n' are 1 or 2. 2 DISABLE #ENABLE 2 ENABLE MACRO/DISABLE:(arg[,s]) filespec[,s] MACRO/ENABLE:(arg[,s]) filespec[,s] The /DISABLE and /ENABLE qualifiers accept arguments which override various .DSABL and .ENABL directives specified in the source program. These qualifiers override the arguments and remain in effect for the entire assembly process. If you specify more than one argument, the arguments must be enclosed in parentheses and separated by commas. You can include /ENABLE and /DISABLE on the same command line. The following arguments (directive equivalent in parentheses) are disabled by default: ABSOLUTE (AMA) BINARY (ABS) LOCAL (LSB) LOWERCASE (LC) TRUNCATION (FPT) CARD_FORMAT (CDR) The following arguments (directive equivalent in parentheses) are enabled by default: REGISTER_DEFINITIONS (REG) GLOBAL (GBL) See also HELP MACRO SHOW and HELP MACRO WIDE for more information on overriding assembler directives. 2 NOSHOW #SHOW 2 SHOW MACRO/SHOW:(arg[,s]) filespec[,s] MACRO/NOSHOW:(arg[,s]) filespec[,s] The /SHOW and /NOWSHOW qualifiers accept arguments which override various .LIST and .NLIST directives specified in the source program. These qualifiers override the arguments and remain in effect for the entire assembly process. If you specify more than one argument, the arguments must be enclosed in parentheses and separated by commas. You can include /SHOW and /NOSHOW on the same command line. See also HELP MACRO ENABLE and HELP MACRO WIDE for information on overriding other assembler directives. The following arguments (directive equivalent in parentheses) are listed by default: SEQUENCE_NUMBERS (SEQ) LOCATION_COUNTER (LC) OBJECT_BINARY (BIN) EXTENSIONS (BEX) SOURCE (SRC) COMMENTS (COM) CALLS (MC) DEFINITIONS (MD) CONDITIONSALS (CND) CONTENTS (TOC) SYMBOLS (SYM) The following arguments (directive equivalents in parentheses) are not listed by default: EXPANSIONS (ME) BINARY (MEB) LISTING_DIRECTIVES (LD) /[NO]SHOW as a command qualifier causes the listing to be printed on the line printer and placed in your UFD. /[NO]SHOW as a filespec qualifier places the file in your directory, but it is not passed to the line printer; also, the listing file takes its name from the name of the file to which it is attached. All the listing-related qualifiers work in this way. All the listing-related qualifiers also imply /LIST. If you use any of them, you do not need /LIST unless you wish to give the listing file a name different from the names of any of the files in the command. 2 USING MACRO/USING:userassembler filespec[,s] The /USING qualifier allows you to invoke an assembler other than the DIGITAL MACRO-11 Assembler. See your system manager about the avail- ability of other assemblers.