z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

ar
Operands
Examples
archive
Specifies the pathname of the archive file.
member
Specifies the pathname of the file that is to be acted upon (placed, deleted,
searched for, and so on) in the archive library.
1. To add a member fioacc.o to the archive file /u/turner/bin/cliserpgm.a, specify:
ar –rc /u/turner/bin/cliserpgm.a fioacc.o
2. To display the members of the archive file /u/turner/bin/cliserpgm.a, specify:
ar –tv /u/turner/bin/cliserpgm.a
3. To delete the member repgen.o from the archive file /u/turner/bin/cliserpgm.a
and regenerate the external symbol table for the archive, specify:
ar –ds /u/turner/bin/cliserpgm.a repgen.o
Environment variables
ar uses the following environment variable:
Localization
Files
Usage note
TMPDIR
The pathname of the directory being used for temporary files. If it is not set,
z/OS UNIX uses /tmp.
ar uses the following localization environment variables:
v LANG
v LC_ALL
v LC_CTYPE
v LC_MESSAGES
v LC_TIME
v NLSPATH
See Appendix F, “Localization” for more information.
ar creates temporary files in the archive file’s directory and in the directory named
by the TMPDIR environment variable. These files are intermediate versions of the
archive file being created or updated. Consequently, they require approximately the
same file size as the archive file being manipulated.
ar may be used to store multiple versions of the same object file within one archive
library. This is useful if you are providing an archive library which may be used to
resolve references from code compiled with various compiler options. These options
cause differences in the object files which must be matched with the archive library
member attributes. Attributes for ar are: AMODE, XPLINK, and IPA.
ar will store the attribute information for every entry in the symbol table. The linkage
editor will use the attribute information to resolve external references with the
appropriate archive library member. Because archive library member names are
only the final component of the pathname, these member names must be unique
for the different object file versions.
16 z/OS V1R9.0 UNIX System Services Command Reference