(SYSLIB) Programming Reference Manual - Public Support Login ...

Appendix A
Using SYSLIB
This appendix contains suggestions for using SYSLIB.
A.1. Efficient Collections
Under certain conditions, the efficiency of the Collector can be improved when using
SYSLIB relocatable elements. These conditions are:
• SYSLIB has been installed with COMUS level 4R2 or higher.
• The Exec level is 40R1 or higher.
• The Collector level is 31R2 or higher.
• The SYSLIB elements are not explicitly included with the “IN file-name.elementname”
directive.
If these conditions are met, programs that call SYSLIB routines should use the MASM
INFO 12 directive. This directive instructs the Collector to search the library file
SYS$LIB$*SYSLIB before searching other library files. The format of the INFO 12
directive is
$INFO 12 'SYSLIB'
where ‘SYSLIB’ is the keyword for the SYS$LIB$*SYSLIB file. For details, see the
MASM Programming Reference Manual.
A.2. PLUS Routines
When any SYSLIB routines written in PLUS are used, the PLUS library must be available
when collecting programs. SAR$ is the only SYSLIB routine that is currently written in
PLUS. If PLUS is installed with COMUS or is included in the SYS$RLIB$ file, the
Collector will automatically include referenced PLUS elements. IF PLUS is installed in a
different file, it may be necessary to use the Collector LIB directive of MAP$PF use
name. See the Collector Programming Reference Manual for more information on the
Collector LIB.
A.3. Compilations
Attach MASM$PF or PLS$PF to file SYS$LIB$*SYSLIB, or the file containing SYSLIB,
and assign it to the run. This will decrease the assembly and compilation time. Use the
M option with PLS.
7833 1733–004 A–1