Implementing Print Services › Send Print Requests to a Data Set

Send Print Requests to a Data Set

Two printer exit procedures are distributed with your product. Each writes the output for a print request to a data set. The procedure $PSDS81X can be customized to specific site requirements. The procedure $PSDS81Z offers the same functionality with improved performance, but cannot be customized. The target data sets for both procedures can be sequential or partitioned.

Parameters that control the operation of the exit are defined in the Exit Data portion of the printer definition. Procedures that pass data to PSM for printing have the ability to override the exit data specified in the PSM printer definition.

The procedures use the parameters contained in the exit data to do the following:

• Determine the target data set
• Determine how to process a data line with a skip amount of zero
• Set the length of the lines print

How the Procedures Process a Print Request

The procedures read each line of print data and write it directly to the nominated data set. Each print line is analyzed according to skip control before processing. This continues until all lines of data for the print request have been received from PSM and written to the nominated data set.

$PSDS81X and $PSDS81Z Parameters

The $PSDS81X and $PSDS81Z parameters, which are coded as keyword parameters, are as follows:

  DSN=datasetname
[ DISP={ SHR | OLD | NEW | MOD } ]
[ LRECL={ n | 80 } ]
[ SKIP0={ NEWLINE | DISCARD | DESTRUCTIVE | 
          NONDESTRUCTIVE } ]
[ CYL= pri [,sec] [,dir] ]
[ TRK= { pri [,sec ] [,dir] | 15,5 } ]
[ BLKSZ = n ]
[ STORC= storclas ]
[ MGMTC= mgmtclas ]
[ DATAC= dataclas ]
[ VOL= volser ]
[ UNIT= { unit | SYSALLDA} ]
[ RECFM= { F | FB | V | VB } ]

• DSN=datasetname

  Specifies the target data set name. If the data set is partitioned, the member name must be included or the data set is corrupted.

  You can use the following symbolics in the datasetname parameter:

  • &USERID—Requesting user ID
  • &DAY—Day of week (such as MON)
  • &YYYY—Year
  • &YY—Year
  • &MM—Month
  • &MON—Month (such as JAN,FEB)
  • &DD—Day
  • &HHMMSS—Time
  • &HH—Hour
  • &MIN—Minute
  • &SYSID—System ID
  • &SYSNAME—System name
  • &JOBNAME—Job name
  • &JOBID—Job ID
  • &NMID—Region ID
  • &NMDID—Region domain ID (DID)
  • &GRPNAME—Sysplex name

    Symbolics are delimited by a period (.) or another symbolic (that is, &YY&MM. is the same as &YY.&MM.). Symbolics are also allowed in a member name.

    For example,

    DSN=NM.&SYSID..&USERID..D&YY&MM&DD..T&HHMMSS..DATA
    

    is converted to

    DSN=NM.SYSA.MYUSER.D040915.T144505.DATA
    

• DISP={ SHR | OLD | NEW | MOD }

  Specifies the disposition of the output data set.

  • SHR specifies shared use of the data set.
  • OLD specifies exclusive use of the data set.
  • NEW allocates a new data set.
  • MOD appends the output in the file.

    Default: SHR.

• LRECL={ n | 80 }

  Specifies the output record length.

  Limits: 1 to 250

  Default: 80.

• SKIP0={ NEWLINE | DISCARD | DESTRUCTIVE | NONDESTRUCTIVE }

  Specifies how to process a data line with a skip amount of zero.

  • NEWLINE creates a new line of data.
  • DISCARD discards the line of data.
  • DESTRUCTIVE causes the data to replace the existing data line.
  • NONDESTRUCTIVE overlays the data on the existing data line, but only where blanks were present on the existing data line. No existing non-blank characters are modified.

    Note: The PSM print options NEWPAGE and USCORE are ignored by the procedures

    Default: NEWLINE.

The following additional parameters are applicable when DISP=NEW is specified:

• CYL=pri,sec,dir

  Primary and secondary space allocation values are in cylinders. If a partitioned data set is used, specifies the number of directory blocks.

• TRK=pri,sec,dir

  Primary and secondary space allocation values are in tracks. Number of directory blocks if partitioned data set.

  Default: TRK=15,5.

• BLKSZ=blocksize

  Specifies the block size.

• STORC=storclas

  Specifies the storage class.

• MGMTC=mgmtclas

  Specifies the management class.

• DATAC=dataclas

  Specifies the data class.

• VOL=volser

  Specifies the volume serial number.

• UNIT= { unit | SYSALLDA }

  Specifies the unit.

  Default: SYSALLDA if volser is specified.

• RECFM= { F | FB | V | VB }

  Record format.

  Default: FB.

Example: Printer Exit Definition

This example directs the output for a PSM print request, assigned to the printer named DSEXIT, to the member TEST1 in the data set PROD.PSM.DATA. The record length of this data set is 80. Overlay lines in the data are removed.

Note: Previous references to parameters WKVOL, CYL, and LIST in the Exit data are no longer required. You must remove them from the printer definition prior to using $PSDS81Z or $PSDS81X, or the print request fails.