Version 3.2.1	SEARCH   CONTENTS   |   PDF PAGE   PDF BOOKS   |   HOME   UP   PREV   NEXT

A physical printer is a VTAM printer, a system printer or a dataset, when printing to disk, to tape or to Con-nect.

This section covers the following topics:

• Listing Physical Printers

• Adding a Physical Printer

• Defining Special Attributes for a Physical Printer

• Defining Substitute Variable Values

• Displaying Special Attributes in Detail

• Printer Attributes

• XML Printers

• UNIXLP – Direct TCP/IP Printing

• NATUNIX

• DISKUNIX

• Deleting a Physical Printer

• Modifying a Physical Printer

Listing Physical Printers

To define a physical printer:

1. Enter 5 in the command line of the System Administration Menu.

   The Physical Printer Maintenance screen is displayed:

   12:34:15 **** ENTIRE OUTPUT MANAGEMENT **** 2008-04-17 User ID XYZ - Physical Printer Maintenance - Cmd Printer Type Location S Program Skeleton Monitor ___ ________ ________ ___________________________ _ ________ ________ ________ __ BDE-PXML XML RMPRWKF DISKMVS MAIN __ CMASPOOL CMASPOOL RMPRCMA MAIN __ CON-NECT CON-NECT RMPRCNT MAIN __ CSG4100S VTAM SagUK Development RMPRVTM MAIN __ DAECOP09 VTAM Real printer in U12, Room 2 RMPRVTM MAIN __ DAEDC611 VTAM Raum 117 on WK desk RMPRVTM MAIN __ DAEFPR09 VTAM VKA host printer RMPRVTM MAIN __ DAEPRTCA VTAM Printer in RM116 RMPRVTM MAIN __ DAUPRTED VTAM RMPRVTM MAIN __ DAU063 UNIXLP RMPRTCP MAIN __ DISKGGR DISKMVS S RMPRWKF GGDISK MAIN __ DISKMVS DISKMVS RMPRWKF DISKMVS MAIN __ DISKSJU DISKMVS RMPRWKF DISKSJU MAIN __ DISKUNIX DISKUNIX RMPRSRV MAIN __ DY1S0BF VTAM UKSJU RMPRVTM MAIN Top Of Data Command => ___________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add Exit Flip - + Menu

   This screen lists all defined physical printers which can be used in the system.

Special PF Keys

Line Commands

Fields

Adding a Physical Printer

To add a physical printer:

1. Press PF2 (Add) on the Physical Printer Maintenance screen.

   The "Physical Printer > General Attributes" screen is displayed:

   Physical Printer > General Attributes

   14:10:27 **** Entire Output Management **** 12/04/2008 User ID XYZ - Physical Printer >General Attributes Printer ID ........... ________ Location ............. ______________________________ Monitor .............. Printer type ......... ________ Print program ........ ________ Job skeleton ......... ________ Escape character ..... _ Maximum lines ........ __________ Time windows From .............. _____ _____ _____ _____ _____ _____ _____ _____ To ................ _____ _____ _____ _____ _____ _____ _____ _____ Command => ___________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add Exit Flip Do Undo Attrb Edit Menu

Special PF Keys

Fields

Defining Special Attributes for a Physical Printer

To define special attributes for a physical printer:

1. Press PF9 (Attrb) on the "Physical Printer > General Attributes" screen.

   The "Physical Printer > Special Attributes" screen is displayed:

   14:30:48 **** Entire Output Management **** 12/04/2008 User ID XYZ - Physical Printer >Special Attributes - Attributes Field Prompt Default Value Burst Chars Class Cmpact Destination Delt Disp Fcb Flash Form Jsep Modify Password Rbc Top Of Data Command => ___________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add Exit Flip Do Undo - + Zoom Promp Var Menu

Fields

Special PF Keys

Defining Substitute Variable Values

This screen is displayed when you press PF11 on the "Physical Printer > Special Attributes" screen.

Physical Printer > Special Attributes - Subst. Variable Screen

   14:51:57             **** Entire Output Management ****            12/04/2008
  User ID XYZ       - Physical Printer >Special Attributes -

  Attributes
    Subst. Variable Default Value
    BURST___________
    CHARS___________
    CLASS___________
    CMPACT__________
    DEST____________
    DELT____________
    DISP____________
    FCB_____________
    FLASH___________
    FNO_____________
    JSEP____________
    MODIFY__________
    PWD_____________
    RBC_____________

 Top Of Data
  Command => ___________________________________________________________________
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help  Add   Exit  Flip  Do    Undo   -     +    Zoom  Promp Var   Menu

Instead of the Field Prompts, the substitution variables that can be used in job skeletons are displayed.

Fields

Special PF Keys

Displaying Special Attributes in Detail

The following window is displayed when you press PF9 on the "Physical Printer > Special Attributes" screen. All parameters of a physical printer's Special Attribute are displayed.

Physical Printer > Special Attributes - Detail Screen

   13:37:47             **** Entire Output Management ****            13/04/2008
  User ID XYZ       - Physical Printer >Special Attributes -

  Attributes

    Field Prompt     Default Value
    Burst
  +--------------------------------------------------------------More:       >+
  !                                                                           !
  !                                                                           !
  ! Attributes                                                                !
  !                                                                           !
  !   Subst. Variable .. BURST___________                                     !
  !   No. .............. 5028                                                 !
  !   Field Prompt ..... Burst                                                !
  !   Field Length ..... 1_                                                   !
  !   Default Value .... _                                                    !
  !                                                                           !
  !                                                                           !
  +---------------------------------------------------------------------------+

  Command => ___________________________________________________________________
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help        Exit  Flip                                            Menu

Fields

Printer Attributes

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

• CMA-SPOOL

• Con-nect

• DISKMVS

• ECL 2.1.1

• E-MAIL

• NAF

• SYSPRBS2

• SYSPRJES

• SYSPRPWR

• TAPEMVS

• TAPEVSE

• VTAM

CMA-SPOOL

Con-nect

DISKMVS

ECL 2.1.1

E-MAIL

NAF

SYSPRBS2

SYSPRJES

SYSPRPWR

TAPEMVS

TAPEVSE

VTAM

XML Printers

Physical (and logical) printers of type XML allow XML stylesheets to be merged with XML documents at print time. The output of an XML printer is always a dataset. On z/OS and compatible systems it is a disk file; on z/VSE it is a tape file; on BS2000/OSD it is a print file. An XML printer has the same attributes as its equivalent dataset printer (DISKMVS, TAPEVSE or SYSPRBS2).

Stylesheet in Report Definition

The stylesheet is resolved at print time as follows. If the document contains:

<?xml-stylesheet href="[file://EOM/*]">

the default stylesheet is taken from the definition of the report being printed. For example, if the report is defined with a stylesheet of

HTTP://SERVER1/MYSTYLE.XLS

the document is adjusted at print time to contain:

<?xml-stylesheet href="[HTTP://SERVER1/MYSTYLE.XLS]">

Stylesheet in SYSNOMU

Stylesheets may also be stored as text objects in SYSNOMU. In this case the document (or report definition) may specify something like:

<?xml-stylesheet href="[file://EOM/SYSNOMU/MYSTYLE]">

This print line is suppressed and the contents of MYSTYLE from library SYSNOMU are inserted in its place. This implies that, for this method of inserting a stylesheet, the <?xml-stylesheet…> must be on a line of its own.

Combined Method

The two methods can be combined, so that the document itself refers to file://EOM/*, which instructs the print task to take the stylesheet URL from the report definition. The report definition then specifies FILE://EOM/SYSNOMU/MYSTYLE, which instructs the print task to suppress the <?xml-stylesheet…> and insert the contents of MYSTYLE.

Additionally, a printer exit can specify the stylesheet by inserting a record containing the URL of the stylesheet to be used. The printer exit must not specify file://EOM/* but it can specify FILE://EOM/SYSNOMU/MYSTYLE. The contents of any inserted stylesheet are not passed to the printer exit. No stylesheet interpretation is performed.

UNIXLP – Direct TCP/IP Printing

• What is Direct Printing?

• Prerequisites

• Installation of Direct Printing

• Usage of Translation Tables

What is Direct Printing?

SeeTCP/IP Direct Printing in the Concepts and Facilities documentation.

Prerequisites

The following prerequisite is required for using TCP/IP Direct Printing:

• A print service according to RFC1179 which "speaks" the LPD/LPR protocol. This can be a printer server that processes printer queues (field 'Dest') or a printer or a conversion box that is directly attached to TCP/IP "speaking" LPR/LPD.

Installation of Direct Printing

Note:
for z/VSE installations: You have to position the TCP/IP library in front of the LE/VSE library in the phase search path. Otherwise, error message EDCV001I will be generated. Sample LIBDEF statement to run TCP/IP programs: // LIBDEF PHASE,SEARCH=(PRD1.BASE,PRD2.SCEEBASE)

1. Assemble the Natural batch driver with LE/370 option set to YES. This enables Entire Output Management to access POSIX functions.

   Note:
   Avoid slashes in your Natural parameters. The slash "/" is the escape character which passes the complete parameter block to LE/370 and Natural will not process any of these parameters.

2. Make module ESMLPR available to your ESY server. In z/OS, the dataset in which it is contained (usually NOM.LOAD) must be APF-authorized and a PDSE dataset.

3. Define a DD dataset "SYSOUT" in your ESY startup job. This will be used for tracing and error messages of ESMLPR.

4. Start the monitor and printer tasks with profile parameter RCA=(ESMLPR) (entered in the corresponding SATPxxx member in library SYSSATU) to ensure ESMLPR will be loaded dynamically.

5. Define physical printers of type UNIXLP and logical printers pointing to them.

   When you add a physical printer of type UNIXLP, a logical printer with the name DEFAULTx (x = A to Z) is added automatically. DEFAULT printers contains default values for UNIXLP printer parameters. If the monitor detects an empty parameter value of a logical printer pointing to a physical UNIXLP printer, the corresponding value from the appropriate DEFAULT printer is taken. When you delete a physical UNIXLP printer, the corresponding logical DEFAULT printer is also deleted. DEFAULT printers can be modified like any other logical printer, but they cannot be renamed, deleted or copied.

   The following fields are available (besides the field Copies of the general print attributes):

   Field	Explanation
   Destination	Name of the printer queue of the printer server.
   Escape-before-1, -2, -3	Hexadecimal digits, sent as control bytes to printer before printing.
   Escape-after-1	Same after printing.
   Listname	The name of the listing (passed to the server).
   Port	Server port to be talked to; D default: port 515.
   Server	IP address or name of the printer server or the printer (if the printer has got an own IP address), IP address in format nnn.nnn.nnn.nnn (IPv4). Note that if you enter a name, it has to be fully qualified, i.e. including the DNS name.
   User	User ID that can be passed to the destination spooling system. If empty, the Entire Output Management user ID will be used.
   Formfeed	BEFORE - Entire Output Management performs no form feed, and Natural's form feed at the beginning is processed. AFTER - Natural's form feed at the beginning is suppressed, and Entire Output Management generates a form feed after the document. NONE - Natural's form feed at the beginning is suppressed, no form feed is generated after the document. BOTH - Natural's form feed at the beginning is left untouched, and Entire Output Management generates an extra form feed after the document.
   Spoolhost	Identifies the Entire Output Management source host.
   Spoolnumber	Unique number for "dest.spool". Random if empty.
   Table	Name of table in SYSNOMU for conversion.
   Trace	0 or blank = no, 1 = yes.

6. Print your reports on these logical printers. Entire Output Management will convert ASA or machine-code formatted reports into ASCII (where a skip to the next page is represented by form feed and carriage return, a line feed is done using line feed and carriage return, regarding the given ASA- or machine code control characters)

7. Send it to the desired printer as usual. The printer task will use low-level TCP communication and create entries such like print time and spool attributes.

Usage of Translation Tables

Entire Output Management itself performs EBCDIC-ASCII conversion using the Natural built-in conversion method, i.e the EBCDIC-ASCII table which can be altered using Natural profile parameter TABA1. This ensures that the conversion can be adapted to the country-specific code page desired.

Additionally the name of a translation table can be entered in the special attributes of a printer of type UNIXLP. This translation table is used subsequently, that is, its translation will be performed after the default translation has taken place.

The lines will be translated using Natural's internal EBCDIC-ASCII table, which can be altered with the Natural TABA1 profile parameter. However, if some more characters are to be altered depending on a printer, you can specify the name of a text object in the TABLE field; this will cause the printer task to read this text object from the library SYSNOMU. The text object has the following format:

aaxx
bbyy
...

where aa and bb are the characters that are to be converted (in hexadecimal representation), and xx and yy are the characters which are to replace them.

These values will be converted after the conversion of the default table has been done. This means, aa and bb are already ASCII values that are to be altered.

Example of a text object:

4145
4246
434A

This will translate the whole document into ASCII using the Natural table, then convert the following characters:

A to E
B to F
C to J

Do not use any comments in such an text object.

NATUNIX

A printer of type NATUNIX works only if Entire Output Management runs under Natural for UNIX.

Natural for UNIX provides a print method which is stored in a NATPARM file. NATUNIX overrides these definitions and gives the opportunity to address files or subsequent UNIX programs that receive the print data.

For example, if NATUNIX calls the print utility LPR, you can reach all destinations LPR can do.

NATUNIX uses the Natural application programming interface (API) USR1069, which changes the printout parameters. For further information, see the API description in the library SYSEXT, if the active report to be printed is a text report.

Binary reports are not printed using the print system of Natural. Instead, a temporary file will be written to directory $EOM_WORK and then printed using the command provided in the parameter Printer-Name. If Output-Target "2" is specified, the NATUNIX printer expects a file name according to the rules below. The resulting temporary file is then moved to the target file.

Attributes

DISKUNIX

A printer of type DISKUNIX works if Entire Output Management runs under Natural for UNIX or Natural for mainframes. This printer type is designed to write the print output to a file in a UNIX or Windows file system.

The target system can be local or remote and must run a Entire System Server for UNIX node which is defined in the Entire Output Management UNIX defaults (menu 8.1, menu item 13). If this node is not intended to serve as input node it can be deactivated. DISKUNIX printouts will reach this node regardless of the node status.

After writing the printout file, a command can be executed on the target node that controls further processing. This feature can be used for printing on real printers, routing to other machines, converting the data, etc.

The command line will be concatenated in the format:

<Command><Opt1><Opt2><Path>/<Filename>.<Filetype><Parm1><Parm2><Parm3>

The resulting output of this command will be written to the file <Logpath>/<Filename>.log.

Attributes

Deleting a Physical Printer

To delete a physical printer:

1. On the Physical Printer Maintenance screen, enter the line command DE next to the physical printer you want to delete.

   If CONFIRM is set to ON, a window opens asking you to confirm the deletion.

2. To do so, enter the printer name in the input field provided.

   A message confirms the deletion.

Modifying a Physical Printer

To modify a physical printer:

1. On the Physical Printer Maintenance screen, enter the line command MO next to the physical printer you want to modify.

   The Physical Printer Definition screen appears for the physical printer you have selected.

2. You can modify the data displayed by simply entering new data in the input fields.

   When you have finished modifying the physical printer definition, press ENTER to save your modifications.

   A message confirms the modification.

www.softwareag.com

Copyright © Software AG 1990-2008. All rights reserved.

SEARCH   CONTENTS   |   PDF PAGE   PDF BOOKS   |   HOME   UP   PREV   NEXT