Use the CPORT and CIMPORT
procedures to transport catalogs and catalog entries from one machine
to another machine running in a different operating environment.
In addition to graphics output stored in GRSEG catalog entries,
SAS/GRAPH software produces several
other files that you can transport from host environment to host environment.
These other files include
To transport catalog
entries that contain graphics output (catalog entries of type GRSEG),
follow these steps:
-
Use the CPORT procedure
to create a transport file from the catalog entries in the current
host environment. A transport file is a sequential file that contains
the catalog in SAS transport format. To create a transport file,
you must specify a catalog to be converted and a fileref for the transport
file.
To retain the original
order of the GRSEG entries in the catalog, use SELECT= in the PROC
CPORT statement to export individual graphs in the order in which
they were created. Otherwise, when you use the GREPLAY procedure
to list the graphics entries in the imported catalog, the procedure
will list the entries in alphabetical order, rather than the order
in which they were created.
Note: Only the GREPLAY procedure
can list catalog entries in the order in which they were created.
All other procedures list entries in alphabetical order.
To export a catalog
that contains groups of entries created using the GREPLAY procedure,
you must use SELECT= in the PROC CPORT statement to select the names
of the groups, rather than the names of individual graphs, to be included
in the transport file. If you export the entire catalog without using
SELECT=, the groups are not maintained in the catalog created when
you import the transport file in the new host environment.
When you use the CPORT
procedure, messages in the SAS log identify the catalog entries that
have been placed in the transport file. If the catalog entry was created
by replaying several graphs into a template, the log messages list
the names of all of the entries that contributed to the templated
graph.
-
Move the transport file
to the target machine, if necessary. You must move the transport file
in binary format. If you do not move the transport file in binary
format, the CIMPORT procedure cannot read the file that you create.
-
Once you have moved
the transport file to the target machine, import the transport file
into a catalog in the new host environment using the CIMPORT procedure.
The entries are imported in the order specified in SELECT= in the
PROC CPORT statement used to create the transport file.
The SELECT= option in
the PROC CIMPORT statement does not affect the order of the imported
entries.
Note: You must use the CIMPORT
procedure from the current version of the SAS System. The CIMPORT
procedure in a previous release cannot read a transport file created
by the CPORT procedure in the current version.
For details about using
the CPORT and CIMPORT procedures, see the
Base SAS Procedures Guide.