Converting GDDM objects and other files

GDDM V3R2 System Customization and Administration

Converting GDDM objects and other files

GDDM V3R2 System Customization and Administration
SC33-0871-02

GDDM supplies several conversion utilities. These support:

Conversions between some object formats.
Conversions between some object formats and Picture Interchange Format (PIF) or Computer Graphics Metafile (CGM) format. Such conversions allow interchange with other, non-GDDM applications.
Conversions from some object formats to formats suitable for page-printer output. Such page-printer formats include PSEG38PP, PSEG3820, PSEG4250, LIST38PP, LIST3820, and LIST4250.

This section identifies GDDM-supported conversions and introduces the GDDM utilities that you use to perform them. For a more comprehensive description of conversions supported by IBM products, see the International Technical Support Centers (ITSC) Printing Library Document Transforms Cookbook, GG24-3530.

Table 2 summarizes which conversions are possible. Not every conversion identified here is accomplished in one step. Figure 12 is a "route map" that shows the steps involved in the conversions identified as possible in Table 2.

Table 2. Summary of GDDM-supported format conversions To ADM- ADM- CGM LIST- LIST- LIST- PIF PSEG- PSEG- PSEG- GDF IMG 38PP 3820 4250 38PP 3820 4250 From ADMCDATA * * * * * * * * * * ADMCFORM * * * * * * * * * * ADMGDF * * * * * * * * * * ADMIMG * * * * * * CGM * * * * * * * * * PIF * * * * * * * * * PSEG3820 * * * * * *


                         ___________              ____________ 
                        |    GIF    |            |            |
                        |           |   _______ |    CGM     |
                        |___________|  |         |            |
      ____________            "        |         |            |
     |            |           |        |         |____________|
    _| ADMCDATA   |           |        |
   | | ADMCFORM   |           |        
   | |            |________ ____________ 
   | |____________|         |            |        ____________ 
   |    |        ___________|  ADMGDF    |_____|            |
   |    |       |           |            |       |    PIF     |
   |    |       |           |            |       |            |
   |    |       |           |____________|       |            |
   |    |       |                      |         |____________|
   |    |       |                      |____________ 
   |                                              
   |  ____________           ____________         ____________ 
   | |            |         |            |       |            |
   | |  LISTxxxx  |________|  ADMIMG    |______|  PSEGxxxx  |
   | |            |         |            |       |            |
   | |            |         |            |       |            |
   | |____________|         |____________|       |____________|
   |                              "                     "
   |                              |                     |
   |                              |                     |
   |                         ____________               |
   |                        |            |              |
   |                        |  PSEG3820  |              |
   |                        |            |              |
   |                        |            |              |
   |                        |____________|              |
   |                                                    |
   |____________________________________________________|

   Figure 12. A route map for GDDM-supported conversions.  LISTxxxx includes
              LIST3820, LIST38PP, and LIST4250.  PSEGxxxx includes PSEG3820,
              PSEG38PP, and PSEG4250.  PSEG3820 is also shown separately: it
              is the only one of the PSEGxxxx formats that can be converted
              to ADMIMG format.

Table 3 identifies the GDDM-supplied utilities that support direct ("one-step") format conversions. In most cases, more than one method is listed. Each of the methods is described briefly following Table 3.


Table 3. GDDM-supplied conversion utilities
Input	Output	Using
ADMCDATA ADMCFORM	ADMGDF	GDDM-PGF ICU
ADMCDATA ADMCFORM	PSEGxxxx LISTxxxx	ADMUCDSO GDDM-PGF ICU
ADMGDF	PSEGxxxx LISTxxxx	ADMUCDSO GDDM-PGF ICU
ADMGDF	CGM	ADMUGC
ADMGDF	PIF	ADMUPCx
ADMIMG	PSEGxxxx LISTxxxx	ADMUIMPx GDDM-IVU
Table 3. GDDM-supplied conversion utilities
Input	Output	Using
CGM	ADMGDF	ADMUCG
PIF	ADMGDF	ADMUPCx
PSEG3820	ADMIMG	GDDM-IVU
ADMGDF	GIF	ADMUGIF

ADMUCDSO

ADMUCDSO, which is supported in the CMS and TSO environments, invokes the GDDM-PGF ICU noninteractively to format ADMCDATA and ADMCFORM or ADMGDF input for output to a page printer. Output can be in LIST3820, LIST38PP, LIST4250, PSEG3820, PSEG38PP, or PSEG4250 format. The output format is determined by parameters passed to ADMUCDSO.

A sample EXEC (ADMUCIMV EXEC) and a sample CLIST (ADMUCIMT CLIST) that invoke ADMUCDSO are supplied with GDDM. ADMUCDSO, ADMUCIMV, and ADMUCIMT are described in the GDDM-PGF Programming Reference book.

ADMUCG

Utility ADMUCG, which is supported in the CMS and TSO environments, converts CGM files to ADMGDF format. For more information about ADMUCG, see the GDDM Base Application Programming Reference book.

ADMUCG can also be invoked from ADMUPCFx, which is described below.

ADMUGC

Utility ADMUGC, which is supported in the CMS and TSO environments, converts ADMGDF files to CGM format. ADMUGC is described in the GDDM Base Application Programming Reference book.

ADMUGC can also be invoked from ADMUPCFx, which is described below.

ADMUGIF

Utility ADMUGIF, which is supported in the CMS and TSO environments, converts ADMGDF files to GIF format. For more information about ADMUGIF, see the GDDM Base Application Programming Reference book.

ADMUIMPx

The image print utility ADMUIMPx (where "x" is V under CMS, T under TSO, and D under VSE) formats ADMIMG data for output to a page printer. Sample code is provided to invoke ADMUIMPx as follows:

ADMUIMP, a REXX-language CMS procedure that invokes ADMUIMPV.
ADMUJT10, sample MVS JCL that invokes ADMUIMPT.
ADMUJD10, sample VSE JCL that invokes ADMUIMPD.

These samples can be amended to suit your requirements. ADMUIMPx is described in "The Image Print Utility, ADMUIMPx" in topic 1.7.

ADMUPCx

ADMUPCx (which is ADMUPCT under TSO and ADMUPCV under CMS) converts PIF files to ADMGDF format, and ADMGDF files to PIF format. ADMUPCx is described in the GDDM Base Application Programming Reference book. In the TSO environment only, a CLIST (ADMUFILE) that invokes ADMUPCT is provided in data set SADMSAM.

ADMUPCx can also be invoked from the ADMUPCFx utility.

ADMUPCFx

ADMUPCFx (which is ADMUPCFT in data set SADMSAM under TSO, and ADMUPCFV under CMS) is a multipurpose utility that performs both file transfer (between workstation and host) and file conversion. (Refer to the information on transferring files in the GDDM User's Guide. It can:

Convert ADMGDF data to PIF or CGM format, and transfer the results to the workstation
Transfer PIF or CGM data to the host and convert it to ADMGDF format

On installation, ADMUPCFV is renamed to IND$FILE EXEC, and ADMUPCFT is renamed to IND$FILE CLIST.

GDDM-PGF ICU

The GDDM-PGF ICU (Interactive Chart Utility) can be used to convert:

ADMCDATA and ADMCFORM objects to ADMGDF format
ADMCDATA, ADMCFORM, or ADMGDF objects to PSEGxxxx or LISTxxxx format.

The ICU is described in the GDDM-PGF Interactive Chart Utility book.

GDDM-IVU

The GDDM Image View Utility (IVU) can be used to convert:

ADMIMG objects to PSEGxxxx or LISTxxxx format
PSEG3820 objects to ADMIMG format

The GDDM-IVU is described in the GDDM Image View Utility book.

Notices | Terms of use | Support | Contact z/OS