mailstreamplus version v8.3.7 release notes€¦ · alg pl. updated column 34 description. note:...

MailStream Plus™

8.3.7

Release Notes This release is required. You must install this release to take advantage of software enhancements and fixes. This release includes updates to meet new USPS presort requirements that go into effect on January 27 2019.

Contents:

Release 8.3.7 highlights 2 Required documentation and documentation updates 3 Updated parameters 4 xx INF sub keyword changes 16 Product fixes and enhancements 18 Mail.dat® Support Changes 21 Record layout changes 22 Platform-specific information 23

About this release

Release 8.3.7 highlights

MailStream Plus™ documentation is available at this site. This document contains release information about MailStream Plus™ Release 8.3.7, which includes:

• Resolutions for customer-reported issues • Mail.dat™ Support changes for the 19-1 specification • Change related to January 2019 price update

Where applicable, this document includes a change request or enhancement number with an item description. We provide Domestic Mail Manual™ (DMM™), Postal Bulletin, and Federal Register Notice references when necessary. We recommend that you review these publications to fully understand the scope of these issues. Review this document to determine whether any of the product changes affect your company.

Use of MailStream Plus release 8.3.7

MailStream Plus Release 8.3.7 may be used for Mailing submitted prior to the January 27th, 2019, for all except the following types of Presorts:

1. 1st Class Parcels 2. Priority Mail where the Balloon Rate is requested.

MailStream Plus 837;

• defaults to the new January 2019 Prices; to obtain Postage reports with the previous price:

• Place “P” in column 7 of the HEADER parameter

• will only generate the new January 2019 Postage Statement. • we recommend that it is only used for Mailings entered after January 27th 2019.

PostalOne Mail.dat Support

• The USPS is planning on Deploying Release 48 of PostalOne! on January 13th, 2019. • This release will have support for the January 27th, 2019 Price change. • Release 48 of PostalOne! will drop support for Mail.Dat version 17-1. • For detail about PostalOne! support for Mail.Dat 17-1, 17-2, 18-1 and 19-1 please refer to the PostalOne Release 48 overview at the following link https://postalpro.usps.com/releases/jan2019Release/overview

MailStream Plus™ 8.3.7 Release Notes 2

https://www.pitneybowes.com/us/support/products/software/mailstream-plus-support.html

https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fpostalpro.usps.com%2Freleases%2Fjan2019Release%2Foverview&data=02%7C01%7Cmichael.rajah2%40pb.com%7Ca97815dfab384df2ff8b08d659e95c6f%7C8a4925a9fd8e4866b31cf719fb05dce6%7C1%7C0%7C636795256140542373&sdata=xbIeLinoPgkWTCm3sl%2BAaN6zox58ZqfI50%2FOB%2BZfjCM%3D&reserved=0

About this release

If you are currently using release 8.3.5 and generation Mail.dat file in the 17-1 format you will need to:

• Make changes to your jobs to create the Mail.dat file in the 17-2 format, for all mailing being entered between January 13th and January 27th, 2019.

• In order to Generate Mail.dat file in the 17-2 format in release 8.3.5 you will need to ensure:

• The REPORT MAILDAT parameter has the Value of “C” or Space in column 72.

Required documentation and documentation updates

At general release time, documentation will be available at our support site.

• MailStream Plus™ Guide for All Platforms • MailStream Plus™ Installation Guide for All Platforms • License Management Guide for all products

The MailStream Plus Guide for All Platforms contains information that was previously available in the now-retired IBM i® User's Guide.


https://www.pitneybowes.com/us/support/products/software/mailstream-plus-support.html/

About this release

Updated parameters

ADDNAM

Two new fields have been added to this parameter record.

Use ADDNAM to add name/address records to your mailing to increase the number of pieces that will qualify for Carrier Route level presort. To add a name from the "bank file":

Note: To use add a name, the INPUT file and the Bank file must be sorted in ascending order by Batch Code, Entry Point Code, Zip Code, Carrier Route. When using SCF PT NDC PT or ADC PT do not include the Entry point in the sort .

Positions Field Name Description

8 How to DO add A Name B - Add from a Bank of Names (Must be in same format as MSSTIN)

D - Duplicating the Last record In the group

X - Both Try to add from Bank if not a record in the bank add by Duplicating the Last reord

Default is D

10-11 Max Record to add per HDP Default 00 Carrier Valid Values 1-25

13-14 Max Record to add per HD Default 00 Carrier Valid Values 1-25

16-17 Max records to add per Default 00 Carrier Valid Values 1-10

22-30 Max Records to add in all Default to no max


About this release

Positions Field Name Description

32 Verify Sort Seq E - Error and Stop run

W - Issue a Warning

N - Do not Check

Default E


About this release

ZIP IN

Update column 44 default and description

Use ZIP IN to define the location and format of the input ZIP Codes. If you are sorting your mail into Walk-Sequence order prior to MailStream Plus, you must sort only by the ZIP Code, Carrier Route, and Walk-Sequence fields. MailStream Plus will sort the batch and entry point fields as required.

Position Field Name Description

44 Carrier Route Disposition when Walk Seq/Line of Travel is Blank

If the data pointed to by Position 36-38 is blank, (and if appropriate, positions 40-42 are blank), then do you want to process the record for ECR, or clear out the Carrier Route information and process it only for basic presort.

P Process the record for ECR even if the WS/LOT data is blank

C Ignore the Carrier Route information on this record if the WS/LOT information is blank or is a unmatched address WS/LOT code of all zeros.

I Ignore the Carrier Route information on this record if the WS/LOT information is blank.

blank Default is I


About this release

SFIMPB

Updated column 8 - 10 desciption

Defines the input location of a 34-byte IM® package barcode and defines IM® package barcode fees for use with letters and flats. This definition will be placed in the Mail.dat® special barcode record (SFB).


8-10 IM® package barcode Location Location of the 34-byte IMpB to use for Letters and Flats to claim Special Fees. Required for Letters and Flats. Optional for Parcels.


About this release

POSTLB

Updated column 30 - 32 description


30-32 Location to Post the Priority Mail Markings

The starting position in the output file for posting Priority Mail Markings/additional First-Class Parcel markings. If defined, the specified location contain the following components (the markings) of the Priority Mail/First-Class Parcels indicator (34-bytes total).

• Priority Mail

• bytes 1-12 - Spaces/blanks, or if the P ATTR Rate Type (position 60) is either U or V post the Commercial Base price indicator or the Commercial Plus price indicator (including the period):

• ComBasPrice.. • ComPlsPrice.

• byte 13 - Space/blank

• bytes 14-22 - Spaces/blanks, or if the P ATTR Rate Type Footnote (position 61) is U or V post the Cubic pricing indicator (including space and period):

• Cubic .10

• Cubic .20

• Cubic .30

• Cubic .40

• Cubic .50

• byte 23 - Space/blank

• bytes 24-34 - Spaces/blanks, or if P ATTR Rate Type Footnote (position 61) is a V post the mailpiece Length and Width in inches in this 11-byte format:

• LL.LL WW.WW

• First-Class Parcels

• bytes 1-13 - Spaces/blanks, or if the P ATTR Rate Type (position 60) is U post the Commercial Base price indicator (including the period):

• ComBasePrice.

• bytes 14-34 - Spaces/blanks


About this release

ALG PL

Updated column 34 description

Note: This parameter only works if the Palletization Plus option has been licensed and the license for it installed. You must obtain permission from the USPS to commingle mail. Use IBM® i screens UPCPPD20 and UPCPPD25 to define the ALG PL parameter.

Optional: The palletization algorithm parameter, ALG PL, allows you to override the defaults for palletizing your mail. MailStream Plus does not place unqualified mail on pallets with one exception. First-Class unqualified mail with valid ZIP Codes can be palletized.


34 Put mixed containers on Place mixed containers on ASF/NDC pallets? ASF/NDC pallets, or local Y Place mixed container on ASF/NDC pallets, or on local pallets for First-Class CSA pallets for Frst-Class CSA palletization. palletization

N Do not place mixed containers on ASF/NDC pallets, or on local pallets for First-Class CSA palletization.

blank Default is N.

Palletization Plus reads values on the XXX PT parameters, to determine the entry point facility type. Also, the USPS Drop Ship file is checked to see if the locale code is a joint facility, such as both an NDC and SCF location. In such a case, you may see undersized pallets for NDC and SCF to the one entry point. Palletization Plus does this before allowing undersized pallets for any of the "Allow Undersized Entry..." fields on this parameter.


About this release

P ATTR

Added new field in position 63

Use P ATTR to associate a name/address record with a set of mailing piece characteristics.


63 Parcel Nonrectangular Indicator. Used for Priority

Y The Piece is Nonrectangular

Mail N The Piece is rectangular

blank Default is N.

Removed the Value of "B" for Balloon from Rate Type Footnote, Position 61.


About this release

POSTBG

Added New note to Location to post the bag/tray destination information position 8 -10 that defines the Structure of the Firm ID.

Use POSTBG to define the output/posting location of the 13-byte bag or tray information.


About this release


8 - 10 Location to post the bag/tray destination information

13-bytes in total:

• 1-2 bytes Bag/Tray Level:

• 00 - UNKNOWN

• 01 - CARRIER ROUTE

• 02 - MERGED 5-DIGIT SCHEME (L001) • 03 - 5-DIGIT SCHEME CARRIER ROUTES (L001) • 04 - DIGIT SCHEME (L001) • 05 - MERGED 5-DIGIT

• 06 - 5-DIGIT CARRIER ROUTES


• 08 - 5-DIGIT SCHEME (L007) • 09 - 5-DIGIT

• 10 - 5-DIGIT SCHEME (AUTOMATION) • 11 - 5-digit FSS-scheme

• 12 - FSS Facility

• 13 - 3-DIGIT SCHEME (L008) (TURN ON) final sort is 3DGSCHM LEVEL 15

• 14 - 3-DIGIT

• 15 - 3-DIGIT SCHEME (only) • 16 - MERGED 3-DIGIT (for sequencing use only) • 17 - SCF/FSS (Do not document) • 18 - SCF

• 19 - AADC

• 20 - ADC

• 21 - ASF

• 22 - NDC

• 23 - NOT USED (Do not document) • 24 - ORIGIN MIXED ADC

• 25 - MIXED AADC

• 26 - MIXED ADC

• 27 - ORIGIN NDC

• 28 - RESIDUAL

• 3-7 bag/tray destination zip

• 8-8 bag/tray zip suffix

• 9-12 bag/tray Carrier Route/firm ID

Note: the Firm ID is made up of the following:

• Position 1 = F

• Position 2 - 4 is a 3 byte packed data field

• 13-13 bag/tray unique indicator


About this release

POSTFM

Added New note to Location to post the Firm ID position 8 -10 that defines the Structure of the Firm ID.

Use POSTFM to post firm ID to the Name/Address file.


8 - 10 Location to post the Firm ID 4-bytes in total. Note: the Firm ID is made up of the following:

• Position 1 = F



About this release

POSTBL

Added New note to Location to post the Location to post the Bundle Destination Information position 8 -10 that defines the Structure of the Firm ID.

Use the POSTBL parameter to define the output location for the 13-byte bundling information.


About this release


8 - 10 Location to post the Bundle Destination Information, 13-bytes in total:

• Package Level, 2-bytes:

• 00 - UNKNOWN

• 01 - CARRIER ROUTE

• 02 - MERGED 5-DIGIT SCHEME (L001) • 03 - 5-DIGIT SCHEME CARRIER ROUTES (L001) • 04 - DIGIT SCHEME (L001) • 05 - MERGED 5-DIGIT



• 08 - 5-DIGIT SCHEME (L007) • 09 - 5-DIGIT

• 10 - 5-DIGIT SCHEME (AUTOMATION) • 11 - 5-digit FSS-scheme

• 12 - FSS Facility

• 13 - 3-DIGIT SCHEME (L008) (TURN ON) final sort is 3DGSCHM LEVEL 15

• 14 - 3-DIGIT

• 15 - 3-DIGIT SCHEME

• 16 - MERGED 3-DIGIT (for sequencing use only) • 17 - SCF/FSS (Do not document) • 18 - SCF

• 19 - AADC

• 20 - ADC

• 21 - ASF

• 22 - NDC

• 23 - NOT USED (Do not document) • 24 - ORIGIN MIXED ADC

• 25 - MIXED AADC

• 26 - MIXED ADC

• 27 - ORIGIN NDC

• 28 - RESIDUAL

• Bundle Destination Zip, 5-bytes

• Bundle ZIP Suffix, 1-byte

• Bundle Carrier route/Firm ID, 4-bytes

Note: the Firm ID is made up of the following:

• Position 1 = F


• Bundle Unique Indicator, 1-byte

• U = Unique


About this release

xx INF sub keyword changes

Sub keywords are described in Chapter 2 of the MailStream Plus™ Guide.

Sub keyword Len File Description PA EP RP BAT MAIL.DAT name INF INF INF INF and field code (if any)

PMTATP

New

1 MPA-1111 ✓Permit Type for Additional Postage

✓ ✓

P = Permit

M = Meter

MDPMTA 20 MPA-1127 Mail.dat Additional ✓ ✓ ✓

New payment account number.

The Additional payment account number is different from the permit number and is initially used in addition to the permit number. In the future, this field may replace the Permit Information. Used when PMTPMA permit number is used (additional postage for metered or precanceled stamps).

IDCMCP 38 RMS-1004 Informed Delivery Campaign ✓

New Code. Use this to specify the Informed Delivery Campaign Code for a Campaign that was created using the Mailer Campaign Porthole (MCP) when claiming the Informed Delivery Promotion.


About this release

Sub keyword Len File Description PA EP RP BAT MAIL.DAT name INF INF INF INF and field code (if any)

MDAPDI

New

9 CPT-1157 CPT-1158

Approved Piece Design information

✓ ✓

This is a two-part sub keyword with the following format: X YYYYYYY, with one space between each component.

1 CPT-1157 1 bytes, 1 through 1, CPT-1157 – X

Indicator for CSR or PCSC ruling type

Valid values:

C = CSR Customer support ruling

P = PCSC Pricing Classification Service Center

7 CPT-1158 7 bytes, 3 through 9, CPT-1158 – YYYYYYY

The CSR or PCSC ruling number approving the mailing of a specific style/design of mail piece. These new designs could include but not limited to automation, non-rectangular, non-paper mail pieces.


About this release

Product fixes and enhancements

Some changes apply to existing parameters, so we recommend that you review Chapter 1 of the MailStream Plus™ Guide for details.

Enhancement or Fix Description Number

MSPLUS-9984 Updated ALG PL position 34 to allow a way to place mixed containers on Local pallets in a CSA parallelization.

MSPLUS-9987 Updated description of the POSTLB, positions 30 - 32.

MSPLUS-9998 Updated the CSFDBIND jcl to correct lrecl for the MSRFCD in STEP04.

MSPLUS-9999 Marketing mail parcels presort error

MSPLUS-10000 Improved the error logging when a sort fails.

MSPLUS-10003 Updated DMM references used on the Qual report for Bound Printed Matter parcels.

MSPLUS-9713 Validation added to ensure that enclosure max weight must be less then 16 oz added.

MSPLUS-9711 Corrected MSP UI Job Submit issue with Mail360 Manager.

MSPLUS-9687 Updated the error message from: One or more package number errors detected in name record file to use the word bundle instead of package.

MSPLUS-9501 Updated the ZIP IN parameter logic for position 44 and changed the default from C to I.

MSPLUS-9504 Added ability to pay additional postage for meter mailings by adding the subkeyword PMTATP.

MSPLUS-9787 Update applied on how the Mailing Statement Agent CRID and information on 3602, 3605 and 3600 is displayed.

MSPLUS-9802 Increased the size of file allocation for the Zone Matrix (USPSRFZM) file in the MSPDBINS JCL for z/OS to install the Postal Reference files.


About this release


MSPLUS-9811 Added new STID's for Ballot Mail.

MSPLUS-9820 RMS Generation now correctly mark Campaign Serial Grouping (RMS-1005).

MSPLUS-9819 Added support for a different Payment Account Number (MPA-1127) for additional permit MPA records.

MSPLUS-9815 Updated 3600-F, 3600-P, 3602-R and 3602-N to mark the Ballot and Political mail Boxes on Page 1.

MSPLUS-9807 Will now use the locale key from the CSA files for the CSM-1167 and CSM-1168 field codes.

MSPLUS-9809 Updated SFR file generation for IMpB mail type to use SFIMPB.

MSPLUS-8067 ESG1PIOMGR, exiting when error occurs; now corrected.

MSPLUS-9866 Corrected Postage Affixed calculation for USPS Marketing Mail Flats carrier pallet piece/pound rate.

MSPLUS-9864 Now correctly setting max used PID table size when there are multiple default PA INF types.

MSPLUS-9860 Correct FSS Bundle max weight/thickness Bound Printed Matter flats.

MSPLUS-9857 Removed JCL for z/OS tape loads.

MSPLUS-9900 Fixed Workflow interface API abend.

MSPLUS-9899 Added A mailpiece weight is over the limit for this class of mail to the Error/Warning Messages table in the MailStream Plus Guide.

MSPLUS-9855 The z/OS Loadlib was updated to enable delivery as a PDSE instead of a PDS.

MSPLUS-9902 Corrected issue with FRM BL and CPYCNT causing conflicts and duplicating the wrong record at times.

MSPLUS-9938 Adjustments were made to avoid split firm bundles across sacks when placing package on pallets.

MSPLUS-9937 Updated documentation - ALG BL Split Bundles Between Sacks (Column 20).


About this release


MSPLUS-9935 Corrected Firm bundle overflow issues when there were more than 999 firms in the ZIP code.

MSPLUS-9931 The Qualification report is now calculatin the correct number of left side columns when placing USPS Marketing Mail flats in trays.

MSPLUS-9067 CSA updated to work with multi locale key and entry points.

MSPLUS-9988 New PA INF sub keyword "MDAPDI" added to specify the approved piece design information.


About this release

Mail.dat®

Support Changes

Review the current Mail.dat® Specification at idealliance.org/specifications/maildat.

DD Name File name 19-1 Length 18-1 Change Structural Changes Length (bytes) (previous)

MSMDCCR uuuuffff.CCR 21 21

MSMDCPT uuuuffff.CPT 264 256 8

MSMDCQT uuuuffff.CQT 90 90

MSMDCSM uuuuffff.CSM 780 780

MSMDEPD uuuuffff.EPD 45 45

MSMDHDR uuuuffff.HDR 2000 2000

MSMDICR uuuuffff.ICR 82 82

MSMDMCR uuuuffff.MCR 100 100

MSMDMPA uuuuffff.MPA 258 258

MSMDMPU uuuuffff.MPU 192 192

MSMDPBC uuuuffff.PBC 70 70

MSMDPDR uuuuffff.PDR 138 138

MSMDPQT uuuuffff.PQT 70 70

MSMDRMR uuuuffff.RMR 301 301

MSMDRMS uuuudddd.RMS 165 165


http://www.idealliance.org/specifications/maildat

About this release

DD Name File name 19-1 Length 18-1 Change Structural Changes Length (bytes) (previous)

MSMDSEG uuuuffff.SEG 268 268

MSMDSFB uuuuffff.SFB 67 67

MSMDSFR uuuuffff.SFR 92 92

MSMDSNR uuuuffff.SNR 160 160

MSMDUPA uuuuffff.UPA 88 88

MSMDWSR uuuuffff.WSR 50 50

Record layout changes

No changes in this release.


About this release

Platform-specific information

Release 8.3.7 of MailStream Plus™ is supported on the following platforms:

Platforms Version

IBM® i 7.2

7.3

Linux RED HAT 6

RED HAT 7.X

SuSE 11

SuSE 12

UNIX AIX 7.1

AIX 7.2

SOLARIS 5.10

SOLARIS 5.11

HP-UX 11.31I

Windows® 2008-R2

2012-R2

2016

z/OS 2.1

2.2

2.3


About this release

Windows NT

Script Changes

MSDR00_UI.BAT

:: Mail360 Manager FilesSET DD_G1IMBXRF=%MSPFOLDER%\%PBJOB%\%PBJOB%-IMB.XRF

MVS (z/OS)

JCL Changes

MSPALOCF

//USPSRFZM DD DSN=yourhlq.MSP.PSTEMP.USPSRFZM,DISP=(NEW,CATLG),// UNIT=SYSDA,VOL=SER=volume,// DCB=(RECFM=FB,LRECL=2014,BLKSIZE=22154,DSORG=PS),// SPACE=(CYL,(80,8))

MSPDBIND

DEFINE CLUSTER -(NAME (yourhlq.MSP.USPSRFZM) -RECORDSIZE (2014 2014) -BUFFERSPACE (81920) -SPEED -KEYS (14 0) -UNIQUE -SPANNED -INDEXED -) -

DATA -(NAME (yourhlq.MSP.USPSRFZM.DATA) -VOL (volume) -CYLINDERS (80 8) -CONTROLINTERVALSIZE (6144) -) -

INDEX -(NAME (yourhlq.MSP.USPSRFZM.INDEX) -VOL (volume) -CYLINDERS (25 2) -CONTROLINTERVALSIZE (1024) -)


About this release

IDSINSTL

Removed all references to LOADLIB

Increased the Space allocation for the PDSE loadlib

//LOADLIBP DD DSN=yourhlq1.MSPrl#.LOAD.PDSE,DISP=(,CATLG,DELETE),// UNIT=SYSDA,VOL=SER=volume,// DCB=(RECFM=FB,LRECL=80,BLKSIZE=1600,DSORG=PS),// SPACE=(TRK,(230,65))

IVPFLE

Removed all references to LOADLIB

LMDBIND

Changed all references of LOADLIB to LOADLIB.PDSE

LMDBINS


LNKBATCH


MSPLICEN


RUNLMRPT


MSPDBINS

Removed From JCL Library since support for Media has been dropped

UNLOAD

Removed From JCL Library since support for Media has been dropped

CSFDBIND

//STEP04 EXEC PGM=SORT//SYSOUT DD SYSOUT=*//SYSPRINT DD SYSOUT=*//SORTIN DD DSN=yourhlq.CSA.CSATEMP.MSRFCD,DISP=SHR//SORTOUT DD DSN=&&SORTCD,DISP=(,PASS,DELETE),// SPACE=(CYL,(72,10),RLSE),UNIT=SYSDA,// DCB=(RECFM=FB,LRECL=150,BLKSIZE=27900)//SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,5)//SORTWK02 DD UNIT=SYSDA,SPACE=(CYL,5)//SORTWK03 DD UNIT=SYSDA,SPACE=(CYL,5)//SORTWK04 DD UNIT=SYSDA,SPACE=(CYL,5)


About this release

//SYSIN DD * SORT FIELDS=(1,14,CH,A)

Installation Changes

Cobol Programs are no longer delivered in a PDS they are now released in a PDSE.


mailstreamplus version v8.3.7 release notes€¦ · alg pl. updated column 34 description. note:...

Documents