Attributes of Physical Printers

#### Search Results

Search

# Attributes of Physical Printers

This section describes the attributes of a physical printer definition:

- General Attributes

- Special Attributes

- Attribute Symbols

## General Attributes

Field | Explanation
--- | ---
Printer ID | Enter the ID of the physical printer.
Printer type | The following printer types are supported by Entire Output Management: CASPOOL - Print to CA Spool. DISKMVS - Print data to disk (z/OS). EMAIL - Physical printer representing one or more email addresses. NAF - Print on Natural Advanced Facilities logical printer. SYSPRJES - System printer in JES (z/OS). TAPEMVS - Print data on tape (z/OS). VTAM - VTAM printer. WRTSPOOL - Output directly to spool (z/OS). UNIXLP - Direct TCP Printing. NATUNIX - Print on Natural on a UNIX system. DISKUNIX - Output to UNIX or Windows file. Under Natural on a UNIX system, only the printers types NATUNIX and DISKUNIX are supported. Enter an asterisk (*) to display a selection list of all printer types.
Location | Enter the location of the physical printer. For example: 2nd floor, room 262.
Print program | The name of the program which does the actual printing.
Job skeleton | The name of the job skeleton in the SYSNOMU library, that is used when printing in batch mode.
Escape character | The special character used to identify substitution variables.
Maximum lines | Enter the maximum number of lines allowed to be printed on this printer.
Time slots when printing is allowed | Printing is allowed only during the specified time intervals.

## Special Attributes

Depending on the type of physical printer, there are different sets of special printer-type-specific attributes. The following physical printer types are supported and their special attributes explained below:

- CASPOOL

- DISKMVS

- EMAIL

- NAF

- SYSPRJES

- TAPEMVS

- VTAM

- WRTSPOOL

The value specified for a special attribute will be used if there is no corresponding specification is made in the logical printer definition.

### CASPOOL

Attribute | Explanation
--- | ---
Account | Enter the account number to be used.
Chars | Enter the character table to be used.
Class | Enter the output class to be used for system printers.
System ID | Enter system affinity.
Fcb | Enter the FCB image that describes the length (and, optionally, the width) of a page.
Formdef | Enter the name of the FORMDEF to be used.
Form | Enter the name of the form to be used.
Hold | Should the printout be held by CA Spool? Enter YES/NO.
Linect | Enter the maximum number of lines to be printed on a page.
Limit | Enter the maximum number of lines allowed.
Filename | Enter the name of the output file.
Pagedef | Enter the name of the PAGEDEF to be used.
Programmer | Enter the programmer's name.
Prmode | Enter PAGE to use page mode as PRMODE.
Retention | How long should the print file be retained after printing? Enter the retention period (in hours).
Room number | Enter the room number.
Trc | TRC (table reference characters). Enter YES/NO.
Writer | Enter the name of the NJE writer.

### DISKMVS

Attribute | Explanation
--- | ---
Dataset | The file name to be used.
Member | The member name to be used.
Dataclas | This corresponds to the JCL parameter `DATACLAS`.
Dcb | This corresponds to the JCL parameter `DCB`.
Disp | The Disposition parameter.
Expdt | This corresponds to the JCL parameter `EXPDT`.
Like | This corresponds to the JCL parameter `LIKE`.
Lrecl | The record length to be used (for records of variable length, this is the maximum record length + record length field).
Mgmtclas | This corresponds to the JCL parameter `MGMTCLAS`.
Msvgp | This corresponds to the JCL parameter `MSVGP`.
Recfm | The record format to be used. In addition, this entry determines whether the data are printed with ASA/machine code or without carriage control characters.
Retpd | This corresponds to the JCL parameter `RETPD`.
Space | This corresponds to the JCL parameter `SPACE`.
Storclas | This corresponds to the JCL parameter `STORCLAS`.
Unit | The unit type.
Volser | The volser where the file is located.
Work file | This entry is made automatically according to the record format (`RECFM`) used. If `RECFM` is set to "V", work file number 01 will be used (this is the default); otherwise, work file number 02 will be used.

### EMAIL

Attribute | Explanation | Symbol
--- | --- | ---
Recipient | You can enter up to 9 e-mail addresses to which to send the report. Enter the at sign `@` as `(a)`. | `&REC1.` to `&REC9.`
Recipient-CC | You can enter up to 9 e-mail addresses to which to send the report as "CC" (carbon copy). Enter the at sign `@` as `(a)`. | `&REC1-CC.` to `&REC9-CC.`
From | This is the name which will appear as the sender of the e-mail. | `&REPLY.`
Node | This Entire System Server node will be used to send the mail. It can be different from the node the Entire Output Manager monitor uses. If this field is left blank, the node number of the monitor will be used. If this is the case, the monitor user ID (usually NOMMON) must be enabled for "UNIX Services" in your security system (like RACF or ACF2). If the node number is different from the monitor's number, any user ID who sends an e-mail is used for sending and must be enabled accordingly. | `&EMAILNODE.`
Encrypt | Enter "Y" to encrypt the e-mail message. (This function is not yet available.) | `&ENCR.`
Subject | The subject of the e-mail to be sent. | `&SUBJ.`
Text Member | For binary reports only: You can specify the name of a Natural text member whose contents is to be used as the actual text of the message. | `&EMAIL-MEM.`
Text Library | The library which contains the Text Member. | `&EMAIL-LIB.`

A printer of type EMAIL is available on mainframes only and uses the Entire System Server to send the mails. If the active report is of type "text", it will be sent line by line. If the active report is of type "binary", the binary file will be attached to the mail sent; and, if a Text Member is specified (see above), its contents will be used as the text of the mail.

### NAF

Attribute | Explanation
--- | ---
Printer Profile | Enter the name of a Natural Advanced Facilities logical printer profile (LPF). The LPF determines which printer is used. For further information, see the Natural Advanced Facilities documentation.
CC Table | Enter the PROFILE parameter. For further information, see the Natural Advanced Facilities documentation.
Forms | Enter the FORMS parameter. For further information, see the description of the DEFINE PRINTER statement in the Natural documentation.
Listname | Enter the NAME parameter. For further information, see the description of the DEFINE PRINTER statement in the Natural documentation.
Disposition | Enter the DISP parameter (DEL/HOLD/KEEP). For further information, see the description of the DEFINE PRINTER statement in the Natural documentation.

### SYSPRJES

Attribute | Explanation
--- | ---
Burst | This corresponds to theJCL parameter `BURST`.
Chars | Enter one or more 4-byte character set names as in JCL.
Ckptline | Enter the maximum lines in a logical page. This corresponds to the JCL parameter `CKPTLINE`.
Ckptpage | Enter the number of logical pages to be printed before JES takes a checkpoint. This corresponds to the JCL parameter `CKPTPAGE`.
Ckptsec | Specify how many seconds of printing are to elapse between each checkpoint for the SYSOUT file. This corresponds to the JCL parameter `CKPTSEC`.
Class | Enter a one-character JES output class for the printout.
Compact | This corresponds to the JCL parameter `COMPACT`.
Datack | This corresponds to the JCL parameter `DATACK`.
Dcb | This corresponds to the JCL parameter `DCB`.
Destination | Enter the JES destination parameter.
Fcb | This corresponds to the JCL parameter `FCB` (Forms Control Buffer).
Flash | This corresponds to the J CL parameter `FLASH`.
Formdef | Enter the name of the library member that PSF uses in printing on a page-mode printer.
Forms | Enter the name of the form. This corresponds to the JCL parameter `FORMS`.
Index | This corresponds to the JCL parameter `INDEX`.
Lindex | This corresponds to the JCL parameter `LINDEX`.
Lrecl | This corresponds to the JCL parameter `LRECL`.
Modify | This corresponds to the JCL parameter `MODIFY`.
Pagedef | Enter the name of the library member that PSF uses in printing on a page-mode printer.
Prmode | This corresponds to the JCL parameter `PRMODE`.
Recfm | This corresponds to the JCL parameter `RECFM`.
Trc | This corresponds to the JCL parameter `TRC`.
Ucs | This corresponds to the JCL parameter `UCS`.
Work file | This entry is made automatically according to the record format (`RECFM`) used. If `RECFM` is set to "V", work file number 01 will be used (this is the default); otherwise, work file number 02 will be used.

### TAPEMVS

Attribute | Explanation
--- | ---
Dataset | The file name to be used.
Disp | The Disposition parameter.
Blksize | The block size to be used.
Recfm | This corresponds to the JCL parameter `RECFM`.
Lrecl | The record length to be used.
Dcb | This corresponds to the JCL parameter `DCB`.
Label | This corresponds to the JCL parameter `LABEL`.
Unit | The unit type.
Volser | The volser where the file is located.
Work file | This entry is made automatically according to the record format (`RECFM`) used. If `RECFM` is set to "V", work file number 01 will be used (this is the default); otherwise, work file number 02 will be used.
Expiration | Enter the retention period for the file.

### VTAM

Attribute | Explanation
--- | ---
Carriage control | Enter YES, if printing is to be done with carriage control. Enter NO, if not.
Form feed before | Enter the number of form feeds to be performed at the beginning of a printout.
Form feed after | Enter the number of form feeds to be performed at the end of a printout.
Trace | Enter YES, if you want a trace to be written by Entire System Server.
Logmode | Enter a special log mode, if desired.

### WRTSPOOL

Attribute | Explanation
--- | ---
Chars | Four groups of 4-byte character-set names taken from the JCL.
Class | A one-character output class for the printout. If this field is left blank, the print class of the monitor defaults will be used.
Copies | The number of SYSOUT copies.
Destination | The remote destination of the file. For this attribute, attribute symbols can be used.
Fcb | The name of the Forms Control Buffer.
Flash | The Flash parameter for device type 3800.
Form | Enter the SYSOUT form.
Hold | Determines whether the SYSOUT file is to be held (YES/NO).
Node | The Entire System Server node which will be used to write to spool. If this field is left blank, the node number of the monitor will be used.
Program | The name of the writer program to process this file.

## Attribute Symbols

For the printer types EMAIL, UNIXLP, NATUNIX and DISKUNIX, as well as the attribute Destination of printer type WRTSPOOL, you can specify attribute symbols in their special attributes. At the time of printing, each of these will then be replaced by the value of the corresponding attribute.

Every attribute symbol begins with an ampersand (&) and ends with a period (.). Both characters are part of the symbol.

Three groups of attribute symbols are available:

- Common Attribute Symbols

- Printer-Type-Specific Attribute Symbols

- Spool Attribute Symbols

For the WRTSPOOL attribute Destination, only the Spool Attribute Symbols are available.

### Common Attribute Symbols

For general attributes of active reports, which apply to all four printer types (EMAIL, UNIXLP, NATUNIX, DISKUNIX), the following attribute symbols are available:

Attribute | Symbol
--- | ---
Printout ID | `&PO.`
Program controlling the printout | `&PROG.`
Number of copies | `&COP.`
Printer exit program | `&MEM.`
Printer exit library | `&LIB.`
Report name | `&REP.`
Bundle name | `&BUN.`
Description | `&DESC.`
Record length | `&REC.`
CC type | `&CC.`
Number of lines | `&LIN.`
Printer type | `&PT.`
Type "AL" (Y/N) | `&TAL.`
Run number of the report | `&RRNB.`
Run number of the bundle | `&BRNB.`
4-digit random number | `&RND.`
Current date (in format yy-mm-dd) | `&DAT.`
Current time (in format hhmmss) | `&TIM.`
Current internal timestamp | `&TMST.`
Current process ID | `&PID.`

### Printer-Type-Specific Attribute Symbols

The printer-type-specific attribute symbols are shown next to the corresponding printer attributes for these printer types:

- EMAIL

- UNIXLP

- NATUNIX

- DISKUNIX

### Spool Attribute Symbols

For spool attributes of the active report, which apply to all four printer types (EMAIL, UNIXLP, NATUNIX, DISKUNIX) and the Destination attribute of printer type WRTSPOOL, the following attribute symbols are available:

Spool Attribute | Explanation | Symbol
--- | --- | ---
SPOOL-TYPE | Spool type of the report to be printed | `&SPTYP.`
CA Spool:
EQNO | EQNO parameter | `&CSEQNO.`
OWNNM | OWNNM parameter | `&COWNNM.`
WTRNM | WTRNM parameter | `&CWTRNM.`
DSTNM | DSTNM parameter | `&CDSTNM.`
CLASS | CLASS parameter | `&CCLASS.`
COPYS | COPYS parameter | `&CCOPYS.`
PRIO | PRIO parameter | `&CPRIO.`
LINCT | LINCT parameter | `&CLINCT.`
RETAN | RETAN parameter | `&CRETAN.`
FORMS | FORMS parameter | `&CFORMS.`
FCB | FCB parameter | `&CFCB.`
PRMOD | PRMOD parameter | `&CPRMOD.`
FORMD | FORMD parameter | `&CFORMD.`
PAGED | PAGED parameter | `&CPAGED.`
CHARS | CHARS parameter | `&CCHARS.`
USRID | CA Spool user ID | `&CUSRID.`
ACTNO | ACTNO parameter | `&CACTNO.`
ROOM | ROOM parameter | `&CROOM.`
LNCNT | Linecount parameter | `&CLNCNT.`
PGCNT | Pagecount parameter | `&CPGCNT.`
SID | SID parameter | `&CSID.`
PGMNM | PGMNM parameter | `&CPGMNM.`
TRC | Trace (Y/N) | `&CTRC.`
CMP | CMP parameter | `&CCMP.`
FNAM | FNAM parameter | `&CFNAM.`
JES:
NODE | NPR node number | `&JNODE.`
JOB-NAME | Name of the job which created the output | `&JJOB.`
JOB-NUMBER | Job number | `&JJOBN.`
DSTYPE | Type of the spool file | `&JTYP.`
DSNO-OLD | Old DS number | `&JDSNO.`
DATASET-KEY | Data set key | `&JKEY.`
GROUP-ID | Group ID | `&JGRP.`
PROCNAME | Name of the procedure | `&JPROC.`
STEPNAME | Name of the step | `&JSTEP.`
DDNAME | Name of the SYSOUT file | `&JDD.`
CHARS | CHARS parameter | `&JCHARS.`
FCB | FCB parameter | `&JFCB.`
FLASH | FLASH parameter | `&JFLASH.`
FORM | FORM parameter | `&JFORM.`
FORMDEF | FORMDEF parameter | `&JFDEF.`
PAGEDEF | PAGEDED parameter | `&JPDEF.`
TRC | Trace (Y/N) | `&JTRC.`
RECFM | RECFM parameter | `&JRECFM.`
COPIES | Number of copies | `&JCOP.`
UCS | UCS parameter | `&JUCS.`
BURST | BURST parameter | `&JBURST.`
COMPACT | COMPACT parameter | `&JCOMP.`
LINECT | Linecount parameter | `&JLIN.`
DESTINATION | Printout destination device | `&JDEST.`
TRIGGER-DSNAME | Trigger data set name | `&JTRIG.`
DSNO | DS number | `&JDSNO.`
Natural:
USER-ID | Natural user ID who created the report | `&NUSER.`
PNR | Logical printer name | `&NPNR.`
TIME | Natural report creation time | `&NTIME.`
NATPGM | Natural program which created the report | `&NPGM.`
NATLIB | Natural library in which the program was executed | `&NLIB.`
FORM | FORM parameter | `&NFORM.`
PROFILE | PROFILE parameter | `&NPROF.`
COPIES | Number of copies | `&NCOP.`
NAME | NAME parameter | `&NNAME.`
DISP | Disposition | `&NDISP.`
ST-ID | Internal file number of the container file | `&NID.`
DBID | Database ID of the container file | `&NDBID.`
FNR | File number of the container file | `&NFNR.`
DEST | Destination | `&NDEST.`
OUTPUT | Output | `&NOUT.`
UNIX:
NODE-NAME | Entire System Server UNIX node name of the source machine | `&UNODE.`
USERID | User of the source machine | `&UUSER.`
CIPHER-PASSWORD | Ciphered password of the user | `&UPW.`
GROUP | UNIX group or Windows domain | `&UGROUP.`
PATH | Path of the source file | `&UPATH.`
FILE-NAME | File name and file type of the source file | `&UFNAM.`
CONTAINER-DBID | Database ID of the container used | `&UDBID.`
CONTAINER-FNR | File number of the container used | `&UFNR.`
SIZE | Size of the report | `&USIZE.`
Direct Input:
ST-ID | Internal number of the file in the container | `&DID.`
RPC-SERVER | Name of the RPC server for transmission | `&DRPC.`
USERID | User who has initiated the report | `&DUSER.`
PATH | Path of the source file | `&DPATH.`
FILENAME | File name of the source file | `&DFNAM.`
FILETYPE | File type of the source file | `&DFTYP.`
CONTAINER-DBID | Database ID of the container used | `&DDBID.`
CONTAINER-FNR | File number of the container used | `&DFNR.`
SIZE | Size of the report | `&DSIZE.`

### On this page

- General Attributes
- Special Attributes
- Attribute Symbols