CMS liacros Section 6. eMS Macro I nstructi ons se=tion describes the formats of the assembler language macros,
which you can use when you write assembler language programs to execute
in the CMS environment. To assemble a program using any of these
macros, you must issue the GLOBAL command specifying CMSLIB MACLIB,
which is the macro library (located on the system disk) which contains CMS macros. For functional descriptions and usage examples of the eMS macros, see
the Coding conventions for
assembler language macros.
operands in the format:
[,operandl CMS macros are the same as
The macro format descriptions
th.ose for all
show optional
indicating that if you are going to use this operand, it must be
preceded by a comma (unless it is the first operand coded). If a macro
statement overflows to a second line, you must use a continuation
character in column 72. No blanks may appear between operands.
Incorrect coding of any macro results in assembler errors and MNOTEs. Where applicable, the end of a macro description contains a list of
the possible error conditions that may occur during the execution of the
macro, and the associated return codes. Th.ese return codes are always
placed in register 15. The macros that produce these return codes have ERROR= operands, that allow you to specify the address of an error
handling routine, so that you can check for particular errors during
macro processing. If an error occurs during macro processing and no
error address is provided, execution continues at the next sequential
instruction following the macro.
Section 6. CMS Macro Instructions 303

COMPSWT, FSCB Macros COMPSWT Use the COMPSWT macro instruction to turn the compiler switch (COKPSWT) flag on or off. The COMPSWT flag is in the byte of the nucleus
constant area (NUCON). The format of the COMPSWT macro instruction is: r I [label] COMPSWT I L- label ON FSCB
________________ . _______ -J is an optional statement label.
turns the COMPSWT flag on. When this flag is on, any program
called by a LINK, LOAD, XCTL, or ATTACH macro instruction must
be a nonrelocatable module in a file with a filetype of MODULE; it is loaded via the CMS command.
turns the COMPSWT flag off. When this flag is off, any program
called by a LINK, XCTL, or ATTACH macro instruction must
be a relocatable object module residing in a file with a
filetype of TEXT or TXTLIB; it is loaded via the CMS INCLUDE command. Use the FSCB macro instruction to create a file system control block (FSCB) for a CMS input or output disk file. The format of the FSCB macro instruction is: r I [label]
! L- label
fileid
RECFM=format FSCB [fileid] [,BECFM=format] [,BUFFER=buffer] f,BSIZE=size] [,RECNO=number] [,NJREC=numrec] , _____________________________________________________ -J is an optional statement label.
specifies the CMS file identifier, which must be enclosed
in single quotation marks and separated by blanks
('filename filetype filemode'). If is omitted, is assumed.
indicates whether the records are fixed-(F) or variable­ (V) length format. The default is F. BUFFER=buffer specifies the address of an IIO buffer, from which
records are to be read or written. BSIZE=size RECNO=number
specifies the number of bytes to be read or written for
each read or write request.
specifies che record number of the next record to be
accessed, relative to the beginning of the file, record
1. default is 0, which indicates that records are to
be accessed sequentially. 30U eMS Command and Macro Reference