Chapter Contents |
Previous |
Next |
SAS/C Cross-Platform Compiler and C++ Development System User's Guide, Release 6.50 |
ar2updte
is a utility program that converts an
ar370
archive to an IEBUPDTE input format data file.
ar2updte
reads in the archive and creates a new file of IEBUPDTE input format data. The
ar2updte
output file can be used as input to the IBM IEBUPDTE utility to build an MVS partitioned data set that approximates the
ar370
archive provided as input to
ar2updte
. Together,
ar2updte
and IEBUPDTE can be used to copy every member of an
ar370
format archive into a corresponding member of a partitioned data set.
Archives built on a non-MVS system may have member names which are not acceptable as member names to
IEBUPDTE.
ar2updte
offers a translation feature which permits the user to specify how archive member names should be translated to PDS member names. Default translation rules are always applied unless the user
specifies that no translation should be performed.
ar370
archives are created and maintained only by
ar370
and
updte2ar
. The internal structures and the data these files contain are in EBCDIC format.
ar370
archives
should never be modified or accessed in any way, other than through
ar370
. Similarly, IEBUPDTE input format data files are created only by IEBUPDTE and
ar2updte
. The internal structures and the data these files contain are also in EBCDIC. ar2updte Syntax |
The
ar2updte
utility is invoked with the following command:
ar2updte [options...] infile outfile
The options portion of the command line specifies one or more options, each of which is a single character preceded by a hyphen (
-
). Some options (for example,
-t
) must be followed by an option argument. The argument can be separated from the option by white space, but need not be.
Note: The case of option characters is not significant, but case is significant for most option arguments.
The following options are recognized by the
ar2updte
utility:
Option | Description |
---|---|
-t
c:s |
specifies a translation rule to be used by
ar2updte
when deriving a PDS member name from an archive member name. More than one
-t
option can be specified. The option argument c:s indicates that if the string `c' (which can be longer than a single character) occurs in an archive
member name, it is to be replaced by the string `s' in the output PDS member name. |
-x
|
specifies that no character translations will be applied to the member names during the archive to IEBUPDTE conversion.
The
-x
option can be used to preserve the original input archive's member names, even if they do not conform to the IEBUPDTE rules for acceptable PDS member names. The resulting output may not be usable as
input to IEBUPDTE, but it can be used as input to
updte2ar
to build a copy of the input archive. |
|
Unless
-x
is specified, default member translation rules are used. See the section Default Member Translation Rules
for
details. |
Examples |
The following examples show typical
ar2updte
command lines.
ar2updte testlib.a test.iebupdte
Create a new IEBUPDTE input format file named
test.iebupdte
from the archive
testlib.a
.
ar2updte -x testlib.a test2.iebupdte
Create a new IEBUPDTE input format file named
test2.iebupdte
from the archive
testlib.a
without performing any translations on the names of object members in the archive.
ar2updte -t ?:QU -t x:$ testlib.a test3.iebupdte
Create a new IEBUPDTE input format file named
test3.iebupdte
from the archive
testlib.a
. Convert all question marks to the letters QU, and then convert all x's to the dollar sign.
Default Member Translation Rules |
Unless the
-x
option is specified, some translations are automatically performed by the
ar2updte
utility:
Note:
Translations specified by the user occur prior to the default translations. Interactions between the user specified translations and the default translations may cause unexpected behavior. For
example, if the
-t
option is invoked with .
:per
, then the default translation which converts
a leading
period (.) to the at sign (@) will not occur. The leading period (.) will be converted to "per". Also, if the
-t
option is invoked with
b:_
, then the
b
s will be converted to underscores (_) first and then to the pound sign (#),
by default.
ar2updte Diagnostics |
The following diagnostic messages are generated by the
ar2updte
utility. Diagnostic messages from the run-time library that further describe the problem may appear in conjunction with the
ar2updte
diagnostics.
001 Error opening input file, "[filename]".
002 Error opening output file, "[filename]".
003 Error reading file, "[filename]".
ar370
or
updte2ar
, but any file system problem or failure that might cause a read to fail could also cause this
message. Check
all input files for validity and integrity.004 Error writing file, "[filename]".
006 Wrong number of command line arguments.
Correct usage: ar2updte [-x | -t c1:s1 [-t c2:s2...]] filein fileout
The command line requires a minimum of two arguments, an input archive and an output filename.
007 Error loading list of translate characters.
Correct usage: ar2updte [-x | -t c1:s1 [-t c2:s2...]] filein fileout
009 Option -"option" needs to be followed by an argument.
Correct usage: ar2updte [-x | -t c1:s1 [-t c2:s2...]] filein fileout
010 Unrecognized option -"option".
Correct usage: ar2updte [-x | -t c1:s1 [ -t c2:s2...]] filein fileout
The only valid options in
ar2updte
are:
-x
and
-t
c:s.
011 The argument "argument" that follows the -t option must be in the form c:s where c is the string to be translated and s is the resulting string.
Correct usage: ar2updte [-x | -t c1:s1 [-t c2:s2...]] filein fileout
The
-t
option must be followed immediately with an argument in the form c:s. All strings `c' in the member names of the archive will then be translated to the string
`s' in the resulting IEBUPDTE input file.
012 Unable to identify ar370 archive, "[filename]".
ar370
archive can not be located from the filename specified in the command line. The input file in the command line must be a valid archive
file.013 Error reading ar370 archive members in "[filename]".
ar370
or
updte2ar
, but any file system problem or failure that might cause a read to fail could also cause
this message. Check
all input files for validity and integrity.014 "[filename]" is not an ar370 archive.
ar2updte
must be an archive created by
ar370
or
udpte2ar
.015 File is not recognized as an archive. Can not process file"[filename]".
ar370
or
updte2ar
data could be lost or corrupted.016 Archive format unrecognized. Cannot process file "[filename]".
ar370
or
updte2ar
, data could be lost or corrupted.017 Archive format unrecognized. Cannot process file "[filename]".
ar370
or
updte2ar
data could be lost or corrupted.018 Error writing to output file, "[filename]".
028 The number of aliases for the member "[member name]" exceeds 16.
029 Duplicate member name "[member name]" has been generated in output.
ar370
so that all members
have unique names.030 Symbol "[symbol name]" was previously defined and has been omitted from output.
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 1998 by SAS Institute Inc., Cary, NC, USA. All rights reserved.