New Line Limit feature for CA Dispatch SAPI tasks
Article ID: 196945
Updated On:
Products
Issue/Introduction
With application of CA Dispatch release 11.7 apar SO14293, you can now limit the number of lines that will be collected from JES by a CA Dispatch/CADDSPLx related SAPI task.
Environment
11.7
CA Dispatch
SAPI
line
limit
slinelim
parameter
Resolution
APAR #: SO14293
Product: DISPAT Release: 11.7 Solution #: 230
OS: OS
Title: SAPI TASK MAXIMUM LINE LIMIT (SLINELIM) FEATURE
PROBLEM DESCRIPTION:
New functionality added to allow clients to exclude reports or MSGCLASS from SAPI task processing if they exceed a maximum number of lines limit.
The new CADDSPL ADD command parameter SLineLim, specifies the maximum number of lines that are selectable by the RPI1-3, MSG and ARCH SAPI tasks. The value must be between 0 and 2,147,483,347. A value of zero means this parameter is not used as a maximum number of records selection limit. The maximum number of lines generated in line mode must not exceed SLineLim, in order for the output report or MSGCLASS to be selected and processed by the RPI1-3, MSG and ARCH SAPI tasks.
Please note that the SLineLim maximum number of lines parameter only applies to SAPI task collection of reports and or MSGCLASS from the JES Spool. It does not apply to reports intercepted at open.
* The CADDSPL CADDUTIL Batch Utility and Operator ADD command has been changed to include the new SLineLim parameter, to be documented as follows:
SLinelim=nnnnnnnnnn
Where nnnnnnnnnn specifies the maximum number of lines that are selectable
by the RPI1-3, MSG and ARCH SAPI tasks. The value must be between 0 and
2,147,483,347. A value of zero means this parameter is not used as a
maximum number of records selection limit. The maximum number of lines
generated in line mode must not exceed SLineLim, in order for the output
report or MSGCLASS to be selected and processed by RPI1-3, MSG and ARCH
SAPI tasks. Please note that the SLineLim maximum number of lines only
applies to SAPI task collection of reports and or MSGCLASS from the JES
Spool. It does not apply to reports intercepted at open.
* The CADDSPLx message CADD026I has been changed to include the new SAPI SLineLim information.
CADD026I
<SPLx> <taskid> <class> <destination> <Intercept> <SAPI> <Initial> <SAPI Linelim>
SPLx is the CADDSPL ID.
taskid is the CADDSPL task ID (RPI1,RPI2,RPI3,MSG,ARCH).
class is the JES output class processed by this task.
destination is the JES output destination processed by this task.
Intercept is the current status of the Intercept.
SAPI is the current status of the SAPI task.
Initial is the status of the Intercept or the SAPI task during the start of CADDSPL.
SAPI LineLim is the maximum number of lines that are selectable by the RPI1-3, MSG and ARCH SAPI tasks.
Reason:
Informational response to the F SPLx,STATUS command that shows the current status and selection criteria of each task.
Action:
None.
* The value for SAPI LineLim indicates the maximum number of lines that are selectable by the associated SAPI task. Please note that the SLineLim maximum number of lines only applies to SAPI task collection of reports and or MSGCLASS from the JES Spool. It does not apply to reports intercepted at open.
Example:
CADD226I SPLx Task Class Dest Intercept SAPI Initial SAPI LineLim
CADD026I SPLx RPI1 R RPI1 Down Down Dynamic 0000000100
CADD026I SPLx RPI2 R RPI2 Down Up Dynamic 0000000200
CADD026I SPLx RPI3 R RPI3 Down Up Dynamic 0000000300
CADD026I SPLx MSG S Not def. Up Dynamic 0000000400
CADD026I SPLx ARCH T Down Up Dynamic 0000000500
IMPLEMENTATION:
In Scenario 1 below, we will be implementing a line limit on the SAPIRPI1 and SAPIMSG tasks, in real time, using CADDSPL Operator ADD commands.
Scenario 1:
- Log onto CA Dispatch and select option 8.1 from the main menu.
- On the VOPMI100 screen, tab down next to the RPI1-3, MSG, ARCH, SAPIRPI1-3, SAPIMSG and SAPIARCH tasks and type an 'E' next to each of them to END the tasks.
- On the VOPMI100 screen, verify that the SAPIRPI1 and SAPIMSG tasks show a status of NOT ACTIVE.
- Exit out of CA Dispatch and go to the MVS Console to issue the following modify commands against the CADDSPLx task.
1. Issue the following STAT X command to display the existing configuration settings for the RPI1-3, MSG and ARCH tasks:
F SPLx,STAT X
* Make a note of the configuration settings for Class, Dest, Action (Intercept), and Initial columns for each task.
Example:
CADD226I SPLx Task Class Dest Intercept SAPI Initial
CADD026I SPLx RPI1 R RPI1 Down Down Dynamic
CADD026I SPLx RPI2 R RPI2 Down Down Dynamic
CADD026I SPLx RPI3 R RPI3 Down Down Dynamic
CADD026I SPLx MSG S Not def. Down Dynamic
CADD026I SPLx ARCH T Down Down Dynamic
2. Issue the following CADDSPL Operator ADD commands to mimic the existing configuration parameter settings and ADD the new SLinelim parameter to that task.
(Note: INITIAL=DYNAMIC is the default setting).
- Command example - Add line limit of 100 to above SAPIRPI1 task:
F SPLx,ADD RPI1,CLASS=R,DEST=RPI1,A=I,SLINELIM=0000000100
- Command example - Add line limit of 400 to above SAPIMSG task:
F SPLx,ADD MSG,CLASS=S,DEST=,A=NOI,SLINELIM=0000000400
IMPACT:
Clients can now exclude reports or MSGCLASS from SAPI task processing if they exceed a maximum number of lines limit.
Additional Information
Attached, please find the following two additional documents also associated to the new SLineLim feature:
- CA Dispatch r11.7 SAPI Task SLineLim Documentation Changes
- CA Dispatch r11.7 SAPI Task SLineLim Training
Which we would encourage you do download and retain for your records.
Attachments
Feedback
