GDDM V3R2 Base Application Programming Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


The structure of a PIF file

GDDM V3R2 Base Application Programming Reference
SC33-0868-02
A PIF file consists of the GDF orders that are listed and described in "GDF order descriptions" in topic 10.0. Also, it can contain specific orders from the workstation. The structure of a PIF file created at a workstation is as follows: 

    ________________________________________________________________________ 
   |                                                                        |
   | File Descriptor order                                                  |
   | Begin Symbol Set Mapping order                                         |
   |       Map Symbol Set Identifier order       One for each identifier    |
   |                 ...                                      ...           |
   | End Symbol Set Mapping order                                           |
   |                                                                        |
   | Begin Line Type Mapping order                                          |
   |       Map Line Type Identifier order                                   |
   | End Line Type Mapping order                                            |
   |                                                                        |
   | Begin Picture Prolog order                                             |
   |       Set Picture Coordinates order                                    |
   |       Set Picture Boundary order                                       |
   |       Set Page Color order                                             |
   |       "picture default" orders                                         |
   | End Picture Prolog order                                               |
   |                                                                        |
   | Begin Segment order                         Repeated for each segment  |
   |       "segment attribute" orders            of the picture             |
   |       End Segment Prolog order                                         |
   |       "drawing" orders                                                 |
   | End Segment order                                                      |
   |                                                                        |
   | Begin Symbol Set Definition order           See Note 2 below           |
   |       Load Symbol Set structured field      Repeated as needed for     |
   |       Continue Symbol Set Definition order  multiplane image symbol    |
   |       Load Symbol Set structured field      sets                       |
   |                  ...                                                   |
   | End Symbol Set Definition order                                        |
   |                                                                        |
   | Begin Line Type Definition order                                       |
   |       Load Line Type structured field                                  |
   | End Line Type Definition order                                         |
   |                                                                        |
   |________________________________________________________________________|
   Figure 19. The structure of a PIF file






   Notes:
1. Where present, the File Descriptor, Symbol Set Mapping, Line Type Mapping, Picture Prolog, Picture Segments, Symbol Set Definition, and Line Type Definition orders must be in the sequence shown.
2. The symbol-set definition orders are repeated for each internal symbol-set definition.
3. COMMENT and NOOP orders can be placed anywhere in the file except between the Begin Symbol Set Definition and End Symbol Set Definition orders, and between the Begin Line Type Definition and End Line Type Definition orders.
4. The GDDM-supplied conversion utility (ADMUPCT/V) removes these orders when the PIF file is converted to GDDM format:
  • The Line Type Mapping and Line Type Definition orders
  • The Symbol-Set Definition orders
  • The Set Page Color order.
The File Descriptor and Line Type Mapping orders, and the Set Page Color order, have no corresponding GDDM GDF orders. The format of these orders is described in the IBM 3270 Personal Computer/G or /GX: Reference Information for Picture Interchange Format manual.

Go to the previous page Go to the next page
Notices | Terms of use | Support | Contact z/OS



Copyright IBM Corporation 1990, 2012