Attributes of Physical Printers

This section describes the attributes of a physical printer definition:


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.

  • SYSPRBS2 - System printer in BS2000.

  • SYSPRJES - System printer in JES (z/OS).

  • SYSPRPWR - System printer in POWER (z/VSE).

  • TAPEMVS - Print data on tape (z/OS).

  • TAPEVSE - Print data on tape (z/VSE) .

  • VTAM - VTAM printer.

  • WRTSPOOL - Output directly to spool (z/OS and z/VSE).

  • UNIXLP - Direct TCP Printing.

  • NATUNIX - Print on Natural for UNIX.

  • DISKUNIX - Output to UNIX or Windows file.

Under Natural for UNIX, 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.

Press PF10 (Edit) to edit this job skeleton.

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 windows from/to

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:

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.

SYSPRBS2

Attribute Explanation
Orig. attributes Should original print attributes be used? Enter YES/NO.
Chars-modification Should all character set characteristics be used or only certain ones? Enter YES/NO.
Chars Enter one or several character sets to be used for printing.
Class Enter the job class to be used for the SPOOLOUT job.
Control Determines whether control characters specific to laser printers will be used.
Destination Determines logical printer to be used.
Dia Enter the Formulardia to be used.
Document-format Specifies the type of the document contents.
Fob Enter the Forms Overlay Buffer (FOB) for overlaying printed pages with text and pictures.
Form Enter the type of form to be used.
Header Determines whether a header line will be printed on each page.
Image Enter the name of a parameter file containing LOOP-, FOB- and CHARS-POOL sets.
Lines Enter the number of lines to be printed on a page.
Loop Enter the name of the LOOP set to be loaded in the carriage information buffer of the printer.
Pagecc Determines whether control characters will be evaluated.
Pname The job name for the SPOOLOUT job.
Rotation Allows page rotation for output on laser printers.
Rotation-loop Enter the name of loop for output in landscape format.
Shift Enter the number of columns by which the output text is to be indented.
Space Determines the number of line feeds or the type of carriage control characters contained.
Text This is stored in the SPOOL Control Block (SCB) for the processing of system exits.
Transl.Table Enter the code translation table to be activated.
Tray Enter the number of the tray from which to extract paper for printing.

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.

SYSPRPWR

Attribute Explanation
Burst This corresponds to the JCS parameter BURST.
Chars Enter one or more 4-byte character set names as in the JCS.
Class Enter a one-character POWER output class for the printout.
Cmpact This corresponds to the JCS parameter CMPACT.
Destination Enter the POWER destination parameter.
Delt This corresponds to the JCS parameter DELT.
Disp This corresponds to the JCS parameter DISP.
Fcb This corresponds to the JCS parameter FCB (Forms Control Buffer).
Flash This corresponds to the JCS parameter FLASH.
Form Enter the name of the form on which the report or bundle is to be printed. This corresponds to the JCS parameter FORM.
Jsep These correspond to the JCS parameters of the same names.
Modify
Password
Rbc
Rbm
Rbs
Remote
Sysid
Ucs
User

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.

TAPEVSE

Attribute Explanation
Dataset Enter the file name to be used.
Volser Enter the volser where the file is located.
Unit Enter the Unit type.
Disp Enter the Disposition parameter.
Recfm This corresponds to the JCL parameter RECFM.
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.

Blksize Enter the block size to be used.
Carriage control Enter YES, if printing is to be done with carriage control. Enter NO, if not.
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
Burst The BURST option. Possible values: NO (default) and YES. (Used only for z/VSE.)
Chars Four groups of 4-byte character-set names taken from the JCL. (Used only for z/OS.)
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.
Compact The name of the compaction table. (Used only for z/VSE.)
Copies The number of SYSOUT copies.
CopyModModule The module name for copy modification. (Used only for z/VSE.)
CopyModTable The character arrangement table for copy modification. (Used only for z/VSE.)
Destination The remote destination of the file.
Disposition The disposition to be assigned to the spool output. (Used only for z/VSE.)
Fcb The name of the Forms Control Buffer.
Flash The Flash parameter for device type 3800.
Flash Count The Flash count. (Used only for z/VSE.)
Form Enter the SYSOUT form.
Hold Determines whether the SYSOUT file is to be held (YES/NO). (Used only for z/OS.)
Job name The name of the job under which the output is to be printed.(Used only for z/VSE.)
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.
Password The password of the job. (Used only for z/VSE.)
Program The name of the writer program to process this file.
Segment size The size (in lines) of each segment. (Used only for z/VSE.)
Sep pages copies Determines whether the required separators are copied. Possible values: YES or NO (default). (Used only for z/VSE.)
Sep pages count The number of separator pages. (Used only for z/VSE.)
Target node The name of target node. (Used only for z/VSE.)
Ucs The UCB name. (Used only for z/VSE.)
Ucs options The UCB options. Possible values: B = block data check option; F = fold option. (Used only for z/VSE.)
User info User information. (Used only for z/VSE.)

Attribute Symbols

For the printer types EMAIL, UNIXLP, NATUNIX and DISKUNIX, 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

For general attributes of active reports, which apply to all of the four printer types, 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:

Spool Attribute Symbols

For spool attributes of the active report, which apply to all of the four printer types, 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.
Power:
NODE Entire System Server node number &PNODE.
JOB-NAME Name of the job &PJOB.
JOB-NUMBER Job number &PJOBN.
TYPE TYPE parameter &PTYPE.
SEGMENTS Number of segments &PSEGM.
FLASH FLASH parameter &PFLASH.
FORM FORM parameter &PFORM.
COPIES Number of copies &PCOP.
DESTINATION Printout destination device &PDEST.
CHARS Printout destination device &PCHARS.
USER-INFORMATION User information &PUINF.
SPOOLED-PAGES Spooled pages &PPAG.
TRIGGER-DSNAME Trigger data set name &PTDSN.
TRIGGER-VOLSER Trigger volser &PTVOL.
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.
BS2000:
NODE BS2000 node &BNODE.
JOB-NAME Name of the job &BJOB.
USER-ID User ID of the job &BUSER.
JOB-ID BS2000 job ID &BJID.
ORIGINATOR-JOB-ID Job ID of the originator &BORIG.
COPIES Copies to be printed &BCOP.
FORM FORM parameter &BFORM.
CHARS CHARS parameter &BCHARS.
DSNAME Name of the BS2000 file &BDSN.
CONTROL-OPTION Control Option parameter &BCTRL.
DESTINATION Printout destination &BDEST.
DEVICE Device parameter &BDEV.
ROTATION Rotation parameter &BROT.
DIA Dia parameter &BDIA.
SIZE Size of the report &BSIZE.
RECFM Recfm parameter &BRECFM.
RECSIZE Recsize parameter &BRECS.
BLKSIZE Block size parameter &BBLKS.
SECONDARY Secondary parameter &BSEC.
ORIG-DSNAME Original BS2000 file name &BORDS.
CLASS Class parameter &BCLASS.
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.