PRMOD (Printer Output Module Definition) Macro

The macro defines a logic module for a printer file.

For printers of the type PRT1, 3800, and 4248 in native mode, the PRMOD macro is not needed. A logic module that is supplied for a printer of these types is ignored. OPEN always provides linkage to an IBM-supplied logic module. PRMOD is required for a 1403 and a 3525 printer.

Format

Read syntax diagramSkip visual syntax diagramnamePRMODCONTROL=YES,CTLCHR=YESASA,DEVICE= xxxxx,ERROPT=YES,FUNC= xxx,IOAREA2=YES,PRINTOV=YES,RDONLY=YES,RECFORM=FIXUNB,RECFORM=VARUNBUNDEF,SEPASMB=YES,STLIST=YES,TRC=YES,WORKA=YES

Requirements for the caller

AMODE:
24
RMODE:
24
ASC Mode:
Primary

Parameters

CONTROL=YES
Include this operand if CNTRL macros are used with the associated DTFs. The module also processes files that do not use the CNTRL macro. If CONTROL is specified, the CTLCHR operand must not be specified.
CTLCHR=YES | ASA
Include this operand if first-character carriage control is used. Any DTF used with the module must have the same operand. If CTLCHR is specified, CONTROL must not be specified.

If CTLCHR=ASA is specified for a file on the IBM® 3525, the + character is not allowed. For a 3525 print (not associated) file, you must issue either a space 1 command or skip to channel 1 command to print on the first line of a card. For 3525 print associated files, you must issue a space 1 command to print on the first line of a card.

Overprinting might occur if several DTFPRs of different tasks address the same device and at least one DTF specifies CTLCHR=ASA. Therefore, while a DTFPR (with CTLCHR=ASA) is doing an I/O operation, no other DTFPR should be allowed to do I/O on the same device.

DEVICE=xxxxx
This operand specifies which device is used for the file. For xxxxx, you can specify one of the following IBM device-type codes: 
  1403
  3203
  3211
  3525

A device code of 3800 and PRT1 is accepted for compatibility reasons. The logic module is generated, but ignored if the DTF is opened.

Any DTF to be used with this module must have the same operand.

ERROPT=YES
The operand is valid only together with DEVICE=PRT1 and if the DTFPR macro for the file includes ERROPT=name. The operand is accepted for compatibility reasons.
FUNC=W | WT | RW | RWT | RPW | RPWT | PW | PWT
This operand specifies the type of file to be processed on your IBM 3525. Any DTF used with the module must include the same operand. W indicates print, R indicates read, P indicates punch, and T (for the IBM 3525 only) indicates an optional 2-line printer.

RW | RWT, RPW| RPWT, and PW | PWT are used to specify associated files. When one of these specifications is used for a printer file, this specification must be used also for the associated files.

If a 2-line printer is not specified for a file on the IBM 3525, multiline print is assumed. T is ignored if CONTROL or CTLCHR is specified.

IOAREA2=YES
Include this operand if a second I/O area is used. Any DTF used with the module must also include the IOAREA2 operand.
PRINTOV=YES
Include this operand if PRTOV macros are used with the associated DTFs. The module also processes any files that do not use the PRTOV macro.
RDONLY=YES:
This operand causes a read-only module to be generated. Whenever this operand is specified, any DTF used with the module must have the same operand.
RECFORM=FIXUNB | VARUNB | UNDEF
This operand causes a module to be generated that processes the specified record format: fixed-length, variable-length, or undefined. Any DTF used with the module must include the same operand.
SEPASMB=YES
Include this operand only if the module is to be assembled separately. This produces an object module ready to be cataloged into a suitable sublibrary, either by the standard name or a name that is specified by you. The module name is used also as the module entry-point. If you omit this operand, the assembler assumes that the module is assembled with the DTF in your program.
STLIST=YES
Include this operand if the selective tape listing feature (IBM 1403 only) is used. If this entry is specified, the CONTROL, CTLCHR, and PRINTOV entries are not valid, and are ignored if supplied. If this operand is specified, RECFORM must specify FIXUNB.
TRC=YES
Include this operand to specify whether the module is to test the TRC bit in the DTFPR or ignore that bit. If TRC=YES is specified, the generated module can process output files with table reference characters and those without.
WORKA=YES
Include this operand if records are processed in work areas instead of in I/O areas. Any DTF used with the module must have the same operand.