ASMLIB | NOASMLIB

Pragma equivalent

None.

Purpose

Specifies assembler macro libraries to be used when assembling the assembler source code.

Syntax

Default

NOASMLIB

Parameters

The specified macro library can be either a PDS[E] data set or a z/OS® UNIX System Services file system directory. If the suboption starts with double slashes (//), it will be treated as a data set, otherwise it will be treated as a z/OS UNIX System Services file system directory.

Usage

PDS[E] data sets must be specified using fully qualified data set names. z/OS UNIX System Services file system directories must be specified using full path names.

Libraries specified with the ASMLIB option or asmlib xlc configuration file attribute are dynamically allocated in the order in which they were specified.

Multiple specifications of ASMLIB result in macro libraries being appended to the macro library concatenation in the order in which they were specified. For example,

-qasmlib=A
-qasmlib=B

will result in the following ASMLIB DD allocation:

//ASMLIB DD DISP=SHR,DSN=A
//       DD DISP=SHR,DSN=B

ASMLIB can be allocated in JCL under the ASMLIB DD name. If the compiler is invoked by a program that also requires ASMLIB DD name, an alternate DD name can be provided using the alternative DD name list described in Calling the z/OS XL C/C++ compiler from assembler.

If there is no JCL allocation, all libraries are concatenated under the ASMLIB DD name or the alternate DD name. If there is a JCL allocation, all libraries are concatenated under the system generated DD name, and JCL allocation follows all other libraries.

Specify sys1.maclib with ASMLIB if system macros are used.

NOASMLIB clears the macro library concatenation.

IPA effects

The ASMLIB option needs to be specified again in the IPA link step.

Related information

For more information about enabling assembler code processing, see ASM | NOASM.