New Features

Describes the new features for this release including post release enhancements and updates.
casp14
This article summarizes GA and post-GA enhancements and updates in
Spool
Version 14.0.
2
Version 14.0 Post-GA Enhancements and Updates
This section describes the post-GA enhancements and updates.
Updated Installing Section
The Installing the Transformers section has been removed. The content from that section has been merged with the Installing section for consistency across mainframe product documentation. Procedures in the Installing section apply to the installation of
Spool
and Java transformers. The SMP/E installation section contains job names for
Spool
and Java transformers. Topics about configuring, deploying, and customizing Java transformers can be viewed only by users who are logged into
Broadcom Support
.
Installation and Configuration Using z/OSMF
You can now install and configure
Spool
using the IBM z/OSMF web browser-based user interface to automate and streamline many of the required tasks. This feature benefits experienced systems programmers and those with less expertise. For more information, see the following articles:
New Level Set PTF (LU02067)
New Level Set PTF LU02067 is available for
Spool
. This PTF includes the following new features:
  • CSSMTP Print Driver
  • ICSF Secure Encryption Keys Support
  • MENUOPT=18 - Disable TCPHOST Updates in the Menu
  • GROUP NNNN,LOCATION='GROUP DESCRIPTION' Statement
  • Spool
    Web Interface modernization
  • HTTPS Support In WEBHOST
After you apply this Level Set PTF and its prerequisites, all previously published maintenance in the release is applied. This Level Set PTF includes all features and fixes up to the specific modification level.
CSSMTP Print Driver (LU01741)
The new CSSMTP print driver lets you automatically send
Spool
print files, including PDF, HTML, and RTF wrapped text files, by email using the Communication Server SMTP (CSSMTP) application. This print driver supports print file attachments, automatic conversion of text files to other formats, control over recipients, and more. For more information about this print driver, see CSSMTP Print Driver.
Support for ICSF Secure Encryption Keys (LU01741)
The SPOOLENC initialization parameter now supports SPOOLENC=ICSFSEC to indicate the use of ICSF secure keys, also referred to as protected keys or encrypted keys. When SPOOLENC=ICSFSEC is specified, ICSF keys are stored in the ICSF CKDS data set in an encrypted form that is known only to ICSF and the cryptographic hardware. For more information, see Data Encryption.
Web Interface Modernization (LU00823 and LU01013)
The
Spool
Web Interface provides all the Menu System functionality in a web browser. The Web Interface enables administrators, managers, and end users to manage the
Spool
environment without using the ISPF interface. The Web Interface has been updated as follows:
  • The new Groups index lists the printer groups that are defined in
    Spool
    . Select the group of interest to display the details for all the printers in the group.
  • The new Subsys index lists the subsystems on which the printers reside. Select the subsystem of interest to view details about files on the subsystem that are waiting to print. You can select the other tabs to view printers and metrics, and configure printers on the selected subsystem.
  • The Actions drop-down menus have been replaced with a selection box for the file or printer, and icons for the available actions. This enhancement lets you perform an action on multiple files or printers.
  • The Options panel has been renamed Settings. The Settings panel lets individual users customize the Web Interface to meet their requirements and preferences.
  • The following user interface elements have been replaced with icons:
    • Go, Reset, and Scroll buttons
    • User and copyright information
    • Options, Help, and About links
For sample use cases, see Using the Web Interface.
The following updates are also included:
  • GROUP is a new option in the ESFPARM initialization parameter file. This option lets you assign a symbolic name to a network group number.
  • The Web Interface ini file has three new settings: ESF_M2PD, ESF_MPRM, and ESF_LLIM. These settings and other settings updates are shown in the example in Web Interface Customization.
  • The TRANSFRM parameter lets you specify the text wrapping option for DEFNODE definitions. Examples are in data set member CAI.CBQ4PARM(CAIQPARM).
New Level Set 14.0.02 for the
Spool
Java Transformers (LU01076)
New Level Set PTF LU01076 is now available for the
Spool
Java transformers. This PTF includes the following new features:
  • OpenText Output Transformation Engine upgrade to V20.4.00
  • OpenText Output Transformation Designer upgrade to V20.4.00
After you apply this Level Set PTF and its prerequisites, all previously published maintenance in the release will have been applied. This Level Set PTF includes all features and fixes up to the specific modification level.
New Level Set 14.0.02 for
Spool
(SO15520)
New Level Set PTF SO15520 is available for
Spool
. This PTF includes the following new features:
  • DB2 OAM Print Driver
  • ESFMGRW Utility
  • Display DEFNODE Definitions Command
  • Purge Done Command Enhancement
  • New Replacement Variable
After you apply this Level Set PTF and its prerequisites, all previously published maintenance in the release will have been applied. This Level Set PTF includes all features and fixes up to the specific modification level.
New DB2 OAM Print Driver (SO14520)
The new DB2 OAM print driver automatically stores all types of files, including PDF/HTML/RTF wrapped text files, as Binary Large Objects (BLOBs) in IBM DB2 for z/OS databases using the OAM – Object Access Method. The DB2 OAM Print Driver supports:
  • Automatic conversion of text files into PDF files while being stored in IBM DB2 for z/OS databases.
  • Automatic conversion of AFP, Metacode, PCL, PDF, and TIFF reports to PDF files before they are stored in IBM DB2 for z/OS databases.
For more information, see DB2 OAM Print Driver.
New ESFMGRW Utility (SO14520)
The ESFMGRW Utility extracts printer or file information from an active
Spool
region and creates a report. The output can be a comma- or semicolon-delimited file, or a text file without delimiters. For more information, see ESFMGRW Utility.
New Display DEFNODE Definitions Command (SO14520)
The Display DEFNODE Definitions (DDN) command lets you display all printer DEFNODE definitions or the printer DEFNODE definitions based on the prefix. For more information, see DDN Command - Display DEFNODE Definitions.
Purge Done Command Enhancement (SO14520)
The Purge Done (PD) command now has optional parameters to specify the target node and the age of the files in E status that should be purged. For more information, see PD Command - Purge Done.
New Replacement Variable (SO14520)
The &FCB replacement variable has been added to the following print drivers: Data Set, Email, SAR, JES, ESF, FTP, SFTP, XCOM, Connect Direct, SharePoint, CMIS, MQM, and DB2 OAM. The file's FCB name is prefixed with FCB2 when the variable is resolved. For more information, see the specific print driver topic in the TCP/IP PrintDirect section.
Level Set 14.0.01 PTFs (SO14048 and SO14049)
Level Set 14.0.01 PTF SO14048 is available for
Spool
Transformers. Level Set PTF SO14049 is available for
Spool
that includes the following features:
  • Online Printer Configuration
  • Unused Printer Cleanup
After you apply these Level Set PTFs, all
previously
published maintenance in the release will have been applied. The PTFs include features and fixes up to the specific modification level.
After you apply PTF SO14048, the CE0CLOAD target library must be added to the LINKLST or to the
Spool
Java Transformers FSS task in the STEPLIB concatenation.
Online Printer Configuration (SO13495 and SO13859)
The new Online Printer Configuration feature adds support for adding, deleting, and modifying printers online using native
Spool
commands, the
Spool
Menu system, or the
Spool
Web Interface.
For more information about Online Printer Configuration support, see Online Printer Configuration and Online Printer Configuration Panel.
Unused Printer Cleanup (SO13495 and SO13859)
The new Unused Printer Cleanup feature adds a new printer node parameter, LASTUSED, that helps you identify unused printers. After this feature is configured, the year, month, and day that the printer was last used is displayed on the Printer and Printer Configuration panels in the
Spool
Menu system, and in the
Spool
Web Interface. This information helps you determine whether to remove a printer from
Spool
.
For more information about Unused Printer Cleanup support, see Unused Printer Cleanup.
Spool
Plug-in for Zowe CLI 1.0.0 (SO12826)
This new plug-in lets you issue
Spool
native commands from your computer using the Zowe CLI. You can also set up automated administration of the
Spool
environment and create scripts to automate processes that you currently perform manually. For more information about this plug-in, see Integrating with Zowe CLI, and the
Spool
Plug-in for Zowe CLI topic in the
Brightside
documentation
.
To use this plug-in, you must apply PTF SO12826, which includes the Zowe/ESF Command Interface Program ESFZOWE.
ESFZOWE - Zowe/ESF Command Interface Program (SO12826)
PTF SO12826 adds a new program, ESFZOWE, to the CAI.CBQ4LOAD library. This program enables communication between
Spool
and the Zowe CLI.
SMF Metrics Utility (SO12826 and SO12579)
The SMF Metrics Utility, ESFSMFRP, reads SMF records and produces a delimited file which can be imported into spreadsheet applications. This utility can process standard
Spool
SMF record subtypes 11 and 12, and Type 6 records produced by
Spool
. For more information, see SMF Metrics Utility (ESFSMFRP).
New Job to Create Optional Java Transformer USS Directories (SO12579)
Some sites require separate USS directories for installation and production. Job E0CMKDIR creates a read/write set of the apps, input, output, and reports directories for use by Java Transformers projects. E0CMKDIR is a new member of data set CE0CJCL.
For more information about running E0CMKDIR, see Start the Java Transformers.
New MENU Option (SO12826)
A new option has been added to the MENUOPT parameter for the MENU initialization option. Option 16 disables the modifiable attribute for the fields on header line 2 in the menu system.
For more information about the new menu option, see MENU.
New PCL Generator Customization Parameter (SO12210)
The AvoidLogicalPageOffsets parameter has been added to the Java Transformers PCL Generator. This parameter specifies that the page contents is shifted to fit on the printed page instead of using logical page offsets. For more information, see PCL Generator Parameters.
Updated IPP Print Driver (SO11269 and SO11270)
Most printers support IPP (Internet Printing Protocol). The IPP print driver that was added with PTFs SO09823 and SO09824 may be used to send print requests to remote IPP printers, remote IPP print servers, and remote CUPS IPP print servers over the Internet. PTFs SO11269 and SO11270 add support for remote Windows IPP servers. The IPP print driver supports FCB-controlled formatting of ASA and machine carriage control print files, and print data translation. This driver supplies translation tables for many EBCDIC code pages to Microsoft Windows 3.1, and Latin 1.
For more information about the new IPP print driver, see Basic IPP Print Driver.
Updated LPD/IPP Print Server Interface (SO11269 and SO11270)
PTFs SO09823 and SO09824 added basic IPP server support to the LPD Interface in
Spool
to receive IPP print requests from remote IPP clients, remote IPP print servers, and remote CUPS IPP print servers. PTFs SO11269 and SO11270 add support for remote Windows IPP print servers.
Basic IPP server support includes all the existing LPD Interface functions and facilities that are supported for LPR/LPD print requests.
The LPD Interface in
Spool
is now referred to as the LPD/IPP Print Server Interface.
For more information about the new LPD/IPP Print Server Interface, see TCP/IP LPD/IPP Print Server Interface.
Updated Error Messages (SO11269 and SO11270)
Error message ESF018 now includes the node, defnode, or NJE definition name and the initialization parameter that caused the error.
Error message ESF005 now includes the location of the statement that caused the error.
MQM Print Driver (SO09823 and SO09824)
The new MQM print driver automatically transfers all types of files, including PDF/HTML/RTF wrapped text files directly to IBM MQ for z/OS for further processing. Text files can be converted to PDF/HTML/RTF reports while they are being sent. The MQM Print Driver supports:
  • Text reports stored in EBCDIC without translation and with preservation of carriage control information.
  • Text reports converted to ASCII using the translate table specified on the TRANS parameter of the NODE statement.
  • Automatic conversion of text files into PDF, HTML, or RTF files while being transferred to IBM MQ for z/OS.
For more information about the new MQM Print Driver, see MQM Print Driver.
OpenText Output Transformation Designer (SO07981)
OpenText Output Transformation Designer is a third-party Windows application that is now included with the
Spool
Java Transformers package. Developers can use this application to easily create and modify project files and font correlation tables for use with
Spool
Java Transformers.
For more information about Output Transformation Designer, see Install Output Transformation Designer and Using Output Transformation Designer.
New SharePoint Print Driver (SO06713)
The new SharePoint print driver automatically transfers all types of files, including PDF, HTML, and RTF-wrapped text files directly to remote SharePoint servers running on Windows Servers for further processing. Text files can be converted to PDF, HTML, or RTF reports while they are being sent. The SharePoint print driver supports:
  • Text reports stored in EBCDIC without translation and with preservation of carriage control information.
  • Text reports converted to ASCII using the translate table specified on the TRANS parameter of the NODE statement.
  • Automatic conversion of text files into PDF, HTML, or RTF files while being sent to a remote CMIS-enabled ECM system.
For more information about the new SHRP print driver, see SharePoint Print Driver.
CMIS Print Driver (SO06713)
Content Management Interoperability Services (CMIS) is an open standard that lets different content management systems inter-operate over the Internet. Specifically, CMIS defines an abstraction layer for controlling diverse document management systems and repositories using web protocols. The new CMIS print drivers automatically transfer all types of files, including PDF/HTML/RTF wrapped text files directly to remote CMIS-enabled ECM systems for further processing. Text files can be converted to PDF/HTML/RTF reports while they are being sent.
The CMIS print driver supports:
  • Text reports stored in EBCDIC without translation and with preservation of carriage control information.
  • Text reports converted to ASCII using the translate table specified on the TRANS parameter of the NODE statement.
  • Automatic conversion of text files into PDF, HTML, or RTF files while being sent to a remote SharePoint server.
For more information about the new CMIS print driver, see CMIS Print Driver.
New Modifiable Menu Fields: TCPPRT, TRANSFRM, and TCPDRIV (SO06713)
The TCP/IP Printer Name, Transform, and TCP Driver fields on the Printer Menu can now be modified by users who are authorized to issue the LSYS command. Access to the LSYS command is normally assigned to administrator roles.
This change enables faster and easier debugging because it eliminates the need for a REINIT command when adjusting options that are passed to the
Spool
Java Transformers. If a TCPTRACE file is needed to debug a printing problem or a different formatting option is required, TCPDRIV can be updated, bypassing the need for a REINIT. If a print queue must be updated to a new name, that is now possible on the Printer Menu.
Because these fields can now be modified, the rules that govern how the REINIT command works with them have also changed. TCPPRT, TRANSFRM, and TCPDRIV are unaffected by REINIT unless XEQOPT=17 or XEQOPT=24 have been specified at initialization time. For more information, see XEQOPT.
New MENUOPT Parameter Value (SO06713)
MENUOPT=15 has been added to allow the TCPPRT, TRANSRM, and TCPDRIV menu fields to be modified by ordinary users who have authority to change a specific printer’s attributes.
For more information, see MENUOPT in the MENU topic.
New PING, LPQ, and LPR Command Support in the ISPF Printer Menu (SO06713)
You can now use the printer action field in the ISPF menu to issue PING, LPQ, and LPR commands. The PING command requires a NODE TCPHOST parameter be defined for the printer. The LPQ and LPR commands require a NODE TCPPRT parameter be defined for the printer. These fields are not validated. The LPR command sends SYS1.HELP(LPR) to the target printer. If a different input file is desired, modify CBQ4CLS0(EHCTCPC) to supply a different file name.
SFTP Print Driver (SO06328)
The new SFTP print driver automatically sends all types of files, including PDF/HTML/RTF wrapped text files directly to remote SFTP servers running on various platforms for further processing. Text files can be converted to PDF/HTML/RTF reports while they are being sent. The SFTP Print Driver supports:
  • Text reports stored in EBCDIC without translation and with preservation of carriage control information.
  • Text reports converted to ASCII using the translate table specified on the TRANS parameter of the NODE statement.
  • Automatic conversion of text files into PDF, HTML, or RTF files while being sent to a remote FTP server.
For more information about the new SFTP Print Driver, see SFTP Print Driver.
TCP/IP Email Notification Support (SO06328)
You can use the new email notification support to inform printer administrators and end users about print completion or print failure using email. This feature works in the same way as the existing SMTP email print driver MAILSTAT support only supported by email printers. The new email notification support works for all
Spool
TCP/IP print drivers. Specify email notification support at the printer level or at the file level.
For more information about the TCP/IP Email Notification support, see TCP/IP Email Notification.
Version 14.0 Enhancements and Updates
This section describes the enhancements and updates in the GA release of Version 14.0.
Portfolio Simplification
Spool
™ Print Management now includes the following features and capabilities, which were optional features in earlier versions of
Spool
:
  • Interface for HP Laser printers: Supports printing of DCF files that are generated by IBM 3800-1 printers by HP-LaserJet printers and Xerox 4045 laser printers.
  • Interface for MAS: Allows up to 32
    Spool
    systems (on the same or different CPUs) to share the same set of spool data sets. MAS also allows all
    Spool
    facilities to be used on all z/OS systems running
    Spool
    , which provides a single image view of all the
    Spool
    systems in the complex.
  • Interface for Natural: Places reports under
    Spool
    control without having to change a statement in NATURAL batch or online (CICS, IMS, TSO, and COMPLETE). Supports standard NATURAL DISPLAY/WRITE statements and use of the NATURAL menu system to control the print environment.
  • Interface for NJE: Supports communication between dissimilar job networking products through the NJE protocol. Multiple output files and jobs can be sent and received at the same time while preserving file processing options and attributes. Logs header and data information in case debugging is needed. One
    Spool
    system can have numerous connections to other NJE nodes.
  • Print Management Package: Provides all the following interfaces in addition to the
    Spool
    base product: interface for HP Laser, interface for MAS, interface for Natural, interface for NJE, interface for PSF, and interface for VPI.
  • Interface for PSF: Supports the printing of both line and AFP files on IPDS printers through PSF/MVS, HP-LaserJet printers through the MPI Tech PSS, and Xerox printers through the Xerox XPAF.
  • Option for VPI: Collects data that is sent by a TP-monitor (such as CICS or IMS) to a VTAM-attached printer and stores the collected data as a
    Spool
    file.
Web Interface
The web interface now supports a screen size resolution of 1900 x 1200.
Static Work Area for Standalone Versions of User Exit 9
A static 4-k work area is now passed to standalone versions of user exit 9. This work area is passed to every exit call.
Menu System Customization
The
Spool
menu interfaces are now delivered with all languages included. A new ESFPARM MENU statement has been added to select the global default language, default format, global find limit, and optional menu functionality. The optional menu functionality is implemented using the MENUOPT parameter. The options for the MENUOPT parameter are based on the ESFHPARM/ESFHOPT
n
settings that required an SMP/E usermod in previous releases.
For more information, see MENUOPT in the MENU topic.
Data Set Print Driver – Pervasive Encryption Support
You can now use Pervasive Encryption to encrypt output that is written to a sequential extended format data set. Encrypt output using one of the following methods:
  • Specify the DSKEYLBL print driver parameter.
  • Specify the DATACLAS print driver parameter with an SMS data class that has a Data Set Key Label defined.
New TCPOPT Parameter
This new NODE parameter specifies special TCPIP printer processing. TCPOPT values remove the need to apply usermods to set conditional assembly variables to 1 in ESFU009X.
For more information, see TCPOPT.
New TRANADD and TRANUPD Parameters
These parameters replace the need to apply a USERMOD against ESFTRAN to add to or modify the translate tables that are delivered by
Spool
.
For more information, see TRANADD and TRANUPD.
Updated XEQOPT Parameter
31 – Sets FORMDEF and PAGEDEF attributes on qualifying files based on the FORM attribute of the file at file creation time. The values are assigned based on a table with ESFPRIOX. This option removes the need to apply a usermod to set conditional assembly variable &AFPFORM to 1 in ESFPRIOX.
For more information, see XEQOPT.
Updated PRTOPT Parameter
21 -- Activate code in ESFU006X to choose the FORM attribute when selecting a PCL formatting member from STEPLIB. Remote destination and writer names are not used. This replaces the need to apply a usermod against ESFU006X to activate &SKP3WTR.
For more information, see PRTOPT.
Large Screen Size Support for TSO, ISPF, and Web Menu Interfaces
The application now supports TSO and ISPF screen sizes up to 76 x 160 in the TSO and ISPF menu interfaces. The new screen resolution 1920 x 1200 has been added to the Web Interface. The command line in the ISPF menu is now at the top of the screen. 
SAMPJCL Changes for Manual ESD Installation
The UNZIPJCL job now uploads only the SMP/E SAMPJCL data set. The following members are no longer uploaded:
  • SMPMCS
  • RELFILEs
Member names in SAMPJCL have been changed to reflect the order in which the jobs run.
Updated SMP/E RECEIVE job SAMPJCL(SPL20RCB) reads the SMPMCS and RELFILEs from the unpaxed USS directory using the following JCL and SMP/E parameter changes:
  • //SMPMTS DD PATHDISP=KEEP,PATH=/unpaxed/user/directory
  • RECEIVE SYSMODS FROMNTS(SPLE0B0)