Download JES Report Broker 2.4 upgrade

1. All maintenance available for 2.2 has been applied to 2.3. 
JRB 2.2.01 - JRB 2.2.46 have been applied.

• DELIVERY_TCLASS_DEFAULT –
  default TCLASS for deliveries.  (required keyword)

• DELIVERY_TCLASS_MAXACT_CLASS1 – 
  concurrent deliveries for this class.  (required)

• DELIVERY_TCLASS_MAXACT_CLASS2 – 
  concurrent deliveries for this class.  (required)

• DELIVERY_TCLASS_MAXACT_CLASS3 – 
  concurrent deliveries for this class.  (required)

• DELIVERY_TCLASS_MAXACT_CLASS4 – 
  concurrent deliveries for this class.  (required)

• DELIVERY_TCLASS_MAXACT_CLASS5 – 
  concurrent deliveries for this class.  (required)

1. Decide how many route entries you want to allow for each TCLASS.

2. Specify the TCLASS for each route entry. 
You can use a combination of.
DELIVERY_TCLASS_DEFAULT
DELIVERY_TCLASS          
TCLASS has no effect on priority…. There are other keywords for that.  It simply controls the maximum number of concurrently delivering route entries in a given TCLASS.

3. Drastic reduction in resource usage.

1. Smaller real storage demands for JRB
2. Smaller value for MAX_NUMBER_INTERNAL_TASKS
3. Smaller value for 2K_BUFFERS
4. Smaller numbers of transmit buffers allocated.
5. Smaller number of JES read buffers

1. Provides ability to optionally add a line (maximum 130 characters) to the separator page.
   New keywords:
   REPORT_SEPARATOR_TEXT_DEFAULT
   REPORT_SEPARATOR_TEXT
2. Provides ability to specify email addresses via JCL.
   New keywords:
   EMAIL_OBTAIN_ADDRESS_FROM_JCL
   EMAIL_OBTAIN_ADDRESS_FROM_JCL_DEFAULT
3. Provides ability to specify what IP address the web server listens to connects on.
   New keyword: WEB_IP@
4. Archive Group Dynamic Creation
   Provides ability for JRB to dynamically create new archive groups dynamically without
   manually defining them in the $GROUPS member.
   New keywords:
   ARCHIVE_DYNAM_GROUP_CAPABLE
   ARCHIVE_DYNAM_GROUP
   ARCHIVE_DYNAM_MOTHER_GROUP
5. Ability to split up reports using CONTROLBREAKS
   Define the location within a report that contains a field. Each time that field changes from one page to another a CONTROLBREAK will occur. The previous report segment will end and other will begin. This feature is especially powerful when used with Archive Group
   Dynamic Creation.
   New keywords:
   CONTROLBREAK_NAME
   CONTROLBREAK_BOUNDARY
   CONTROLBREAK_TEXT_COLUMN
   CONTROLBREAK_TEXT_LENGTH
   CONTROLBREAK_TEXT_LINE
6. Can use segmentation in conjunction with CONTROLBREAKS
   In order to select the section of a report that is applicable to a CONTROLBREAK, segmentation can be used in conjunction.
7. NEW variable &CB(n).
   Will be replaced with the report text value associated with CONTROLBREAK in relative position n within the route entry. It can be used in conjunction with CONTROLBREAKS and Archive Group Dynamic Creation to build the name of the new group being created. Can also be used in REPORT_NAME or any other field that supports variables.
8. NEW function for the JRB utility.
   FUNCTION=UPGRADE_OBSOLETE_KEYWORDS
   If JRB detects the use of an obsolete keyword upon startup it will issue the message JRBE381 and terminate. You can use this new function of the JRB utility to automatically upgrade your
   keywords to the correct format.
9. Restructured the manual. Split sections previously in section IV into their own sections.
   New keywords: SSL_FTP_CERTIFICATE_LABEL
   SSL_FTP_CERTIFICATE_LABEL_DEFAULT
10. Provides SSL Client authentication for FTP deliveries
    Optionally, FTP servers and require that clients provide a digital certificate.
    This change supports that requirement.
    New keywords: SSL_FTP_CERTIFICATE_LABEL
    SSL_FTP_CERTIFICATE_LABEL_DEFAULT
11. Manual sections dealing with SSL support have been re-organized and clarified.
12. Re-structured the Archive and History in HFS.
    As a result documents will now be shown on the web pages from newest to oldest.
    = I M P O R T A N T N O T E =
    BEFORE YOU BRING UP JRB you MUST run the batch utility using the new utility keyword FUNCTION=UPGRADE_ARCHIVE; Failure to do so will cause the archive to become unusable until the UPGRADE_ARCHIVE is run.
13. Change to ARCHIVE to JES.
    The confirmation pop-up window now provides the ability to specify the following characteristics of the report placed on JES:
    o OUTPUT CLASS
    o FORMID
    o DESTINATION
14. Change to keywords
    JESDELIVERY_FORM
    JESDELIVERY_FORM_DEFAULT
    SEGMENT_OVERRIDE_JESDELIVERY_FORM
15. NEW DELIVERYTYPE=REQUE;
    This new deliverytype does not actually deliver a report, is simply changes the JEScharacteristics of a report. It does not create a new JES output like DELIVERTYPE=JES does, it just changes the characteristics of the original report.
    New keywords: JES_REPORT_REQUE_NODE_DESTID
    JES_REPORT_REQUE_NODE_DESTID_DEFAULT
16. DIRECTORY WEB PAGE FILTER WINDOW CHANGES:
    1. With multiple report directory windows open each one of them may now have a filter window associated with it. Previously only the first directory window could have a filter window.
    2. Removed the alert window that popped up when the ‘FILTER OFF” button was pressed.
    3. The ‘FILTER OFF” button is now ‘grayed out’ and disabled unless there is actually a filter window open.
    4. All filter fields now translate all input into upper case except for the ‘PROGRAMMER NAME’ field.
    5. The ‘CREATION DATE TO/FROM’ fields initial values have changed:
    • The ‘TO DATE’ is now the date obtained from JRB, previously it was the date obtained from the workstation.
    • The ‘FROM DATE’ is now calculated from the ‘TO DATE’.
    A number of days are subtracted from the ‘TO DATE’ to obtain the ‘FROM DATE’. The number of days subtracted are obtained from:
    New keyword:
    WEBPAGE_REPORT_FILTER_FROM_DATE_OFFSET
17. New keywords:
    FTP_TCPIP_READ_TIMEOUT
    FTP_TCPIP_READ_TIMEOUT_DEFAULT
18. New option for keyword FTP_MODE and FTP_MODE_DEFAULT.
    You can now specify
    FTP_MODE=PASSIVE_POSTCONNECT
19. Changed the FTP protocol associated with FTP_MODE=PASSIVE;
    Some FTP servers were causing deliveries to hang up. Tracing revealed JRB waiting upon a TCP/READ attempting to receive the response of a ‘STOR’ FTP command.
    
    Previously JRB would: Issue ‘PASV’, Issue ‘STOR’, then connects to the server. (PASV,STOR,CONNECT)
    Now JRB will: Issue ‘PASV’, connect to the server, then Issue ‘STOR’.(PASV,CONNECT,STOR)
    
    In order to preserve previous functionality that might be required from some servers FTP_MODE=PASSIVE_POSTCONNECT now will use the old protocol. (PASV,STOR,CONNECT)

1) The minimum OS/390 release is now 2.10

2) Contains all the maintenance items from version 2.0  (2.0.1 through 2.0.36)

3) Provides ability to choose ‘OUTPUT’ or ‘HELD’ JES queues when archived reports are sent back to the JES output queue.         

4) Provides ability to send archived reports back to the JES output queue.

New required keyword for use in $WEB member:
WEBPAGE_ARCH2JES_CLASS                                         

5) Provides ability to use wildcards ‘*’ with the keyword:

JES_REPORT_SELECT_PROGRAMMER_NAME JES_REPORT_SELECT_PROGRAMMER_NAME_DEFAULT

6) Provides ability to submit JCL from the ‘History Directory’ web page to restore a document from backup.

New keywords:
ARCHIVE_RESTORE_JCL_JOBCARD1 – Required keyword.
3.3.27 ARCHIVE_RESTORE_JCL_JOBCARD1
ARCHIVE_RESTORE_JCL_JOBCARD2 – Required keyword.
3.3.28 ARCHIVE_RESTORE_JCL_JOBCARD2
ARCHIVE_RESTORE_JCL_TAPE_UNIT – Optional keyword.
3.3.29 ARCHIVE_RESTORE_JCL_TAPE_UNIT
ARCHIVE_RESTORE_JCL_DASD_UNIT – Optional keyword
3.3.26 ARCHIVE_RESTORE_JCL_DASD_UNIT

7) Provides control over report separator pages within a report segment.

New keywords:
SEGMENT_OVERRIDE_REPORT_SEPARATOR_PAGE SEGMENT_OVERRIDE_REPORT_SEPARATOR_USERID

8) Removes JES LRECL restriction of 4060. 

a) There will no longer be any restriction on JES LRECL.   
b) Improved use of buffering will also improve performance on document deliveries.                 

9) New keyword (REQUIRED):                                            

JES_READ_BUFFER_SIZE

10) Changed keywords:                                       

TRANSMIT_BUFFER_SIZE -
changed maximum value from 32736 to 32767.
JES_REPORT_SIGNIFICANT_LRECL -
changed maximum value from 4060 to 32760.    

11) Batch Utility Changes.                                 

Adds ability to COPY or MOVE reports from one archive group to another. 
Adds ability to specify any archive report group as a ‘target’ for a restore from backup. Previously there was no control, it restored to the original archive group.
Adds new valid value:
FUNCTION=COPY_TO_GROUP.
Adds new valid value:
FUNCTION=MOVE_TO_GROUP.
New keyword:
OVERLAY_DUPLICATE_REPORT.
New keyword:
SELECT_ONLY_BEGINING_GROUP
New keyword:
TARGET_REPORT_GROUP

12) Added new JES report selection criteria.

Adds keyword: JES_REPORT_SELECT_ACCOUNTING_FIELD 
Adds keyword: JES_REPORT_SELECT_ACCOUNTING_FIELD_DEFAULT 
Adds keyword:
JES_REPORT_SELECT_ORIGIN_NODE
Adds keyword: JES_REPORT_SELECT_ORIGIN_NODE_DEFAULT
Adds keyword:
JES_REPORT_SELECT_PRIORITY
Adds keyword:
JES_REPORT_SELECT_PRIORITY_DEFAULT
Adds keyword: JES_REPORT_SELECT_PROGRAMMER_NAME
Adds keyword: JES_REPORT_SELECT_PROGRAMMER_NAME_DEFAULT

13) Increases the maximum value of MAX_NUMBER_INTERNAL_TASKS from 512 to 1024.

14) Provides ablity to reque a report to a NULL WRITER id.

You can now specify JES_REPORT_REQUE_WRITER=****; which will set the WRITER id to NULL.

15) Added ability to control the format of the FTP server command PORT.

Added new keywords:
FTP_PORT_COMMAND_FORMAT
FTP_PORT_COMMAND_FORMAT_DEFAULT   (REQUIRED)

16) Added ability to specify a ‘COPIES=’ type parameter for DELIVERYTYPE=JES deliveries.

Adds new keyword:
JESDELIVERY_COPIES

a)  WEBPAGE_PREVIOUS_TREE_ICON – New optional keyword to specify a graphics file name to be used as an ICON.  It will be used as a link to a previous tree.  b)  WEBPAGE_PREVIOUS_TREE_TEXT – New Required keyword to specify the text associated with a link to a previous tree. 
c)  WEBPAGE_TOP_TREE_ICON – New optional keyword to specify a graphics file name to be used as an ICON.  It will be associated with the ‘top tree’ (the first tree defined in $GROUPS). 
d)  WEBPAGE_TOP_TREE_TEXT – New required keyword to specify the text associated with the ‘top tree’ (the first tree defined in $GROUPS
e)  REPORT_GROUP_ICON – New optional keyword to specify the name of a graphics file that will be associated with a report group. 

a)  WEBPAGE_SIGNON_POPUP_HEADING – Provide text for the heading of the pop-up. 
b)  WEBPAGE_SIGNON_POPUP_MSG – Provide text, html or graphics for the body of the pop-up. 

a)  REPORT_SEPARATOR_PAGE – Request separator page and position.
b)  REPORT_SEPARATOR_USERID – Userid to be optinally included on the separator page. 
c)  REPORT_SEPARATOR_PAGE_DEFAULT -  Request separator page and position
d)  REPORT_SEPARATOR_USERID_DEFAULT - Userid to be optionally included on the separator page.

a)  &LJBRUNDATE - LOCAL Date the report was created in the format mm-dd-yyyy
b)  &LJULJDAT -  LOCAL current date in julian format: yyyy.ddd
c)  &LJM - LOCAL Month the report was created.  Format: mm.
d)  &LJD - LOCAL Day the report was created.  Format: dd.
e)  &LJYR - LOCAL Year the report was created.  Format: yyyy.
f)  &LJOBTIME - LOCAL Time the report was created in the format hh.mm.ss
g)  &LJH - LOCAL Hour the report was created in the format hh.
h)  &LHN - LOCAL Minutes the report was created in the format mm.
i)  &LHS - LOCAL Seconds the report was created in the format ss

“Left click to view report. Right click to download/save report”. Also added a mouse over function that pops up a small title "Left click to view report. Right click to download/save report" when the mouse is pointed at a document.

a)  Forces top-of-page at the beginning of each JES output dataset
b)  Adds carriage control (top-of-page) to output datasets that do not have carriage control.  Controlled by the keyword DELIVERY_MAX_LINES_PER_PAGE

Previously all the DSID's in a report group would be delivered together unless split up with segmentation or selected by JES_REPORT_SELCT_DDNAME.
With JES_REPORT_SELECT_BOUNDARY=DSID JRB will
deliver each DSID as a separate file.

• EMAIL_ATTACHED_FILENAME

• EMAIL_BODY_TEXT

• EMAIL_SUBJECT

• FTP_FILENAME

• FTP_WORKING_DIRECTORY

• SEGMENT_OVERRIDE_EMAIL_BODY_TEXT

• SEGMENT_OVERRIDE_EMAIL_ATTACHED_FILENAME

• SEGMENT_OVERRIDE_EMAIL_BODY_TEXT

• SEGMENT_OVERRIDE_EMAIL_SUBJECT

• SEGMENT_OVERRIDE_FTP_FILENAME

• SEGMENT_OVERRIDE_FTP_WORKING_DIRECTORY

Adds the ability to control what filter criteria fields are available
on the Report Filter web page.  

Add the ability to specify a user-friendly, meaningful report name during DELIVERYTYPE=ARCHIVE.
SEGMENT_OVERRIDE_REPORT_NAME
The report name can be shown on the Report Directory page.  

Made reports “clickable”
Added the ability to view a single report from the Report Directory with a left click.Added the ability to download a single report from the Report Directory with a right click.   

The Navagation Main Menu is no longer presented unless the
userid in use is an administrator.
All other userid’s are sent directly to the Report Group Tree. 

Added the ability to disable the FILTER button from the Report Diretory page.
WEBPAGE_REPORTDIR_FILTER_BUTTON. 

Made all the drop down menus function consistently.
They all require the ‘go’ button to be pressed to actuate the selection.·  

‘Next Page’ ‘Prev Page’ ‘Bottom Page’ ‘Top Page’ buttons on
the report directory tree are now sensitive to screen contents.
For example, if the directory is already showing the first page the ‘Top Page’ and ‘Prev Page’ buttons are grayed out and cannot be pressed.

Streamlined “Navigation…” drop downs.
Removed the “Navigation…” default selection. With the “Navigation…” shown as the default the user always had to drop down the menu to select the page.  It is now replaced with a realistic default.
All you have to do now is press ‘go’ if you want the default selection.·

Streamlined the “Choose function…” drop down on the report directory and history directory.
Removed the “Choose function…” default selection.
With the “Choose function…” shown as the default the user
always had to drop down the menu to select the function.
It is now replaced with “View Report” as the default.
All you have to do now is press ‘go’ if you want the default selection.

Adds control of time zone for creation date/time on archived reports.

Adds new parameter value to SEGMENT_STOP_BOUNDARY.
You can now specify SEGMENT_STOP_BOUNDARY=PREVLINE.

Adds ability to purge reports and history using web page.
You can now purge report from the Report Directory page and
history from the History directory page.

Adds new keyword  WEBPAGE_TREE_PERSISTANCE
You can now ‘preserve’ the status of the Report Group Tree
instead of it being displayed ‘collapsed’ each time.

Sign-on page change: password change now implies sign-on
Previously JRB required the user to sign on using the new password after a password change request.  This change simultaneously  signs the user on when a password is changed.

Segmentation change. 
Adds a new parameter value to keyword SEGMENT_STOP_BOUNDARY=PREVPAGE will end the segment at the bottom of the previous page. No part of the page that contains the SEGMENT_STOP_TEXT will appear in the segment.

Provides control over conversion table during FTP and ARCHIVE.  You can now choose if a report will be delivered in ASCII or EBCDIC.
Adds new keywords: 
FTP_CONVERSION_TABLE_DEFAULT  (REQUIRED KEYWORD)
ARCHIVE_CONVERSION_TABLE_DEFAULT (REQUIRED KEYWORD)
CONVERSION TABLE
SEGMENT_OVERRIDE_CONVERSION_TABLE

Provides ability to convert Machine Carriage Control to ASA during delivery.
Adds a new value for the keywords DELIVERY_CC_EMULATION                                                        DELIVERY_CC_EMULATION_DEFAULT
You can now specify the value “TRANSLATE_TO_ASA”. 
Machine Carriage Control will be converted to ASA for any DELIVERYTYPE. 
       
Provides ability to specify Machine Carriage Control to ASA in a segment override.
Extends the features provided in 1.1.47.
Adds a new value Adds a new value to:
DELIVERY_ CC_EMULATION                                          DELIVERY_CC_EMULATION_DEFAULT
You can now specify STRIP_DEVICE_CODES.
It strips off the unneeded impact printer machine control codes such as x'03' x'73' x'7b x'04'  but leaves the carriage control intact.
Also adds new values to:                                                         SEGMENT_OVERRIDE_DELIVERY_CC_EMULATION     
You can now specify STRIP_DEVICE CODES STRIP_DEVICE_CODES                                                TRANSLATE_TO_ASA        
 

Includes ability to view and download the PDF documents using a web browser.