JES Report Broker 2.3 Release Notes
Released On: 02/07/2007
- All maintenance available for 2.2 has been applied to 2.3.
JRB 2.2.01 - JRB 2.2.46 have been applied.
- You now have control of the number of route entries delivering simultaneously. New keywords for $INIT:
- 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)
- DELIVERY_TCLASS_DEFAULT -
- New keywords for route entries:
DELIVERY_TCLASS - sets TCLASS for a specific route entry.
- The above keywords implements a maximum active number of tasks in each of five classes. To implement:
- Decide how many route entries you want to allow for each TCLASS.
- 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. - Drastic reduction in resource usage.
- Changes have been made to the internal task dispatcher. Previous versions maintained an internal JRB task for each route entry started. This version will require an internal JRB task ONLY when a particular route entry is actually delivering. This will result in a drastic reduction in the numbers of internal tasks, and their buffers, required for a given throughput. The bottom line will be a much leaner JRB. The real storage needed for a given amount of throughput will drop dramatically. This will show up in the following:
- Smaller real storage demands for JRB
- Smaller value for MAX_NUMBER_INTERNAL_TASKS
- Smaller value for 2K_BUFFERS
- Smaller numbers of transmit buffers allocated.
- Smaller number of JES read buffers
- These changes will show up on your z/OS monitor (or SDSF) and the values reported by the SHOW command. Also it will show up in the tasks reported by the DISPLAYTASK command (compared to previous versions).
The following changes were implemented by maintenance items in JRB 2.3 and carried forward to JRB 2.4
===========
MAINT 2.3.26
===========
- Provides the ability to specify a codepage to be used when converting a document from EBCDIC to
ASCII.
New (required) keyword:
ASCII_CODEPAGE_DEFAULT - Provides a new, optional, customizable message issued at delivery time.
New keyword:
DELIVERY_MSG_E422_DEFAULT
DELIVERY_MSG_E422
===========
MAINT 2.3.26
===========
Provides an extension to the INLINECNTL feature added in maint 2.3.24. You now have control of the processing that occurs if the value of the substitution variable &IC is NOT captured from an INLINECNTL record imbedded in the document to be delivered.
New keywords:
INLINECNTL_FIELD_DEFAULT_VALUE
INLINECNTL_FIELD_FAIL
The keyword REPORT_SEPARATOR_USERID can now include any of the supported substitution variables.
===========
MAINT 2.3.24
===========
Provides the ability to specify a 'control' record that is imbedded in the report to be delivered. These control
records can specify delivery parameters and influence the way the report is delivered and split up.
New keywords:
INLINECNTL_FIELD_COLUMN
INLINECNTL_FIELD_LENGTH
INLINECNTL_FIELD_TYPE
INLINECNTL_NAME
INLINECNTL_SEARCH_COLUMN
INLINECNTL_TEXT
===========
MAINT 2.3.21
===========
Adds a new FUNCTION called FIND_STRANDED_GROUPS to the JRBMUTIL batch utility program.
===========
MAINT 2.3.20
===========
Added support for mixed-case passwords on the web signon page with a new required keyword,
WEBPAGE_PASSWORD_CASE_SENSITIVE.
===========
MAINT 2.3.19
===========
Added the capability to select reports from the Held queue via the following new keywords:
JES_REPORT_SELECT_QUEUE=HELD;
JES_REPORT_SELECT_QUEUE_DEFAULT=HELD;
When these keyword(s) are not present then reports will be selected from the Output queue, which is the
default when neither HELD nor OUTPUT is specified.
===========
MAINT 2.3.18
===========
Added a new possible value to following keywords:
ARCHIVE_DYNAM_GROUP_DISPLAY=BOTH_NAME_FIRST;
REPORT_GROUP_TREE_DISPLAY=BOTH_NAME_FIRST;
REPORT_GROUP_TREE_DISPLAY_DEFAULT=BOTH_NAME_FIRST;
This provides the ability to customize the report group tree web page to display the name of the group first, followed
by the description... separated by a dash ('-').
=========
MAINT 2.3.13
=========
Provides support for new substitution variable &SP. A single space will be substituted in its place. The
substitution will take place AFTER the normal blank compression. It can be used to place a space in keywords
whose values have all spaces normally compressed such as:
FTP_WORKING_DIRECTORY
FTP_CREATE_DIRECTORY
=========
MAINT 2.3.10
=========
Added support for the ROOM parameter from the OUTPUT JCL statement.
- WEBPAGE_REPORTDIR_COLUMN_NAME now accepts the value OUTPUT_ROOM. It adds a column to the report directory web page.
- WEBPAGE_REPORTFILT_FILTER_NAME now accepts the value OUTPUT_ROOM. It adds an option to use this value to filter the report directory web page.
- Support for the ROOM parameter was extended into the 'Send Report to JES' function from the report directory web page.
- New required keyword in the $WEB member. WEBPAGE_REPORTDIR_OUTPUT_ROOM_LEN
=========
MAINT 2.3.06
=========
- Added ability to specify a variable in these keywords:
EMAIL_FROM
EMAIL_FROM_DEFAULT - Changed message JRBE089. No provides a description of a delivery failure. Provides a short description of the return code in event of a delivery failure. Previously only a return code was provided.
- Fixed a problem with EMAIL_TO when a variable was used. The variable was effective to the extent that the email was sent to the correct address however the REPLY address still contained the raw variable (it had not been substituted with the value of the variable).
- New message JRBE409 that indicates the completion of a delivery.
=========
MAINT 2.3.02
=========
Added new substitution variable &ACCT(n).
Accounting Information fields from JOB card. n is the relative position of the parameter desired.
For an example of its use see FTP_FILENAME