PSF for z/OS: User's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Using multiple copy groups or page formats

PSF for z/OS: User's Guide
S550-0435-04

Using multiple copy groups or page formats

If your print job requires you to change copy group options, such as medium overlays or paper source, for different pages in the data set, do these steps:

  1. Create a form definition that contains multiple copy groups, with the options you want for different pages coded in different copy groups.
  2. Identify that form definition in the JCL of your print job by the method described in Specifying a form definition.
  3. In your print data, include an Invoke Medium Map (IMM) structured field in front of any page on which you want to change the copy groups.
  4. Alternatively, you might be able to use conditional processing in a page definition to trigger the use of a new copy group determined by the content of data fields in the application. This conditional processing eliminates the need to code IMM structured fields in the data.
Note:
Instead of defining a copy group in a form definition, you can define a copy group in the print data set. See Internal copy groups for more information.

Similarly, if your job requires different page definition options for different pages in the data set, such as lines per inch spacing or print direction, do these steps:

  1. Create a page definition that contains multiple page formats, with the options you want for different pages coded in different page formats.
  2. Identify that page definition in the JCL of your print job, as described in Specifying a page definition.
  3. In your print data, include an Invoke Data Map (IDM) structured field in front of any page on which you want to change the page formats.
  4. Alternatively, you might be able to use conditional processing in a page definition to use a new page formats base on data fields in the application. This conditional processing eliminates the need to code IDM structured fields in the data.

You can include the IMM and IDM structured fields yourself, or you can call them by using the Conditional Processing function of the page definition. For more information, see Conditional processing and AFP structured fields included in line data.

Example:
In the following example, pages 1, 2, and 4 are printed at a line spacing of six lines per inch (lpi) on paper from the main paper source. Page three is printed at a spacing of 8 lpi on blue paper from the alternate paper source.

Form definition F1MUCG is created containing two copy groups:

  • Page format F2MUMAIN prints on paper from the main paper source.
  • Page format F2MUALTB prints on paper from the alternate paper source.

Page definition P1MUFMT is created containing two page formats:

  • Page format P2MU6LPI prints pages at six lpi.
  • Page format P2MU8LPI prints pages at 8 lpi.

This example shows the IMM and IDM structured fields coded in the traditional line data print data set. The IMM and IDM structured fields contain unprintable hexadecimal fields, which are represented as periods in the coding shown above. The format of these records is described in Mixed Object Document Content Architecture Reference, AFPC-0004.

For this example, the print records are included as part of the print job, and the system IEBGENER utility is used to send them to the printer. Because the data set contains structured fields, the record format must be defined with carriage control (RECFM=FBA). 

//AFPIDM JOB ...
//STEP1     EXEC  PGM=IEBGENER
//SYSPRINT  DD  SYSOUT=*
//OUT1   OUTPUT FORMDEF=MUCG,PAGEDEF=MUFMT
//SYSIN     DD  DUMMY
//SYSUT2    DD  SYSOUT=A,DCB=(RECFM=FBA,BLKSIZE=80),OUTPUT=*.OUT1
//SYSUT1    DD  *
   !........F2MUMAIN
   !........P2MU6LPI
   1This is print record 1 of page 1.
    This is print record 2 of page 1.
    This is print record 3 of page 1.
   1This is print record 1 of page 2.
    This is print record 2 of page 2.
    This is print record 3 of page 2.
!........F2MUALTB
   !........P2MU8LPI
   1This is print record 1 of page 3.
    This is print record 2 of page 3.
    This is print record 3 of page 3.
   !........F2MUMAIN
   !........P2MU6LPI
   1This is print record 1 of page 4.
    This is print record 2 of page 4.
    This is print record 3 of page 4.

If the IMM and IDM structured fields are omitted before page one of the data set, PSF begins printing with the first copy group in the form definition and with the first page format in the page definition.

If conditional processing were used for this application, IMM and IDM structured fields would not be required in the print data. For more information about using conditional processing, see Conditional processing.

Go to the previous page Go to the next page

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



Copyright IBM Corporation 1990, 2014