New Line Limit feature for CA Dispatch SAPI tasks

book

Article ID: 196945

calendar_today

Updated On:

Products

CA Dispatch Output Mgmt

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

1597079854281__SAPI Task SLineLim Training Client Version.pptx get_app
1597079819841__SAPI Task SLinelim Documentation.pdf get_app