The SOLVESSI

Document ID : KB000055611
Last Modified Date : 14/02/2018
Show Technical Document Details

The SOLVESSI - Its Purpose and What It Does

The SOLVESSI region is a critical component of Unicenter SOLVE:Operations Automation. This article describes the purpose of the SSI and the services it provides. The SOLVESSI may also be shared by the NetMaster family of products and provides additional functions such as TCP/IP Packet Analyzer feeds, Unix Shell access, and loading of SMF exits for TCP/IP information gathering.

The setup and configuration of the SOLVESSI address space is performed by the Unicenter SOLVE:Operations installation utility IIA. IIA will specify a number of startup parameters on the SOLVESSI JCL deck, however SOLVESSI startup parameters are not something the end user normally needs to tailor. The major parameters are listed here to provide a greater understanding of the services the SOLVESSI provides.

The services that the SOLVESSI address space provides are:

  1. Linking Unicenter SOLVE:Operations Regions via XCF. Connectivity between SOLVESSI regions happens as a result of the regions belonging to the same XCF group (specified by the XCFGROUP parameter in the SSI startup). SOLVE:Operations regions can then be linked via XCF by specifying AM=EPS on the INMC link start commands. Note, EPS is an access method provided by the SOLVESSI region(s) that SOLVE:Operations INMC can use as a transport mechanism).

  2. Non-SNA terminal support - this allows access to Unicenter SOLVE:Operations from terminals via a non-SNA 3270 terminal controller without VTAM involvement.

  3. DD SUBSYS support - A facility (provided by the operation system) that allows an authorized subsystem to provide access methods to existing programs. In effect, the subsystem appears to these programs as if it is a set of files, and in this way is able to provide data to, or receive data from, the programs.

  4. PPI support - PPI provides a general-purpose facility for programs, written in any language, to exchange data. It also provides a facility for any program to forward a generic alert to NetView or a region. The SOLVE SSI implementation closely follows the IBM implementation. Therefore, programs written to run with the IBM implementation will work with the SOLVE SSI implementation with no changes. No special authorization is required to use the PPI, and it does not depend on having NetView or a SOLVE SSI running .

The following diagram illustrates the services that can be provided in the SSI and how SSIs and SOLVE:Operations regions can be linked together.

Figure 1

Startup and Shutdown

One SOLVESSI region is required per LPAR. The address space is started by a simple MVS start command. To shutdown a SOLVESSI, use the "SSI STOP" modify command, or a "STOP" command against the address space. The SOLVESSI can also be started from its connected Unicenter SOLVE:Operations region by specifying SSI STOP from OCS or Command Entry.

To connect a Unicenter SOLVE:Operations region to a SOLVESSI, the subsystem ID of the SOLVESSI task is specified in the Customizer parameter group SSI.

SOLVESSI debugging

Two SSI commands are useful for debugging:

SHOW SSISTATS provides some useful tuning statistics collected by the SOLVESSI itself, as well as applications running under its control. Here is some sample output from this command:

NS6051 
SSI STATISTICS FOLLOW...                                    
NS1Z01 1 $ETM BLOCKS ALLOCATED.                                      
NS1Z02 3686 M/T GETMAINS, 3315 M/T FREEMAINS, 2212K M/T STG (SP0-127)
NS1Z03 177475 XM CALLS TO SUP-STATE PC MANAGER.                      
NS1Z04 0 XM CALLS TO ANY-STATE PC MANAGER.                           
NS1Z05 0 SRB CALLS TO ANY-STATE SRB MANAGER.                         
NS1Z06 174938 OF ABOVE CALLS DID NOT WAIT FOR LOCAL LOCK.            
NS1Z07 0 OF ABOVE CALLS WAITED FOR LOCAL LOCK, BUT NOT TIMED.        
NS1Z08 2537 OF ABOVE CALLS WAITED FOR LOCAL LOCK, TIMED...           
NS1Z09 ... TOTAL WAIT 0.332644 SECONDS, AVG WAIT 0.000131 SECONDS.   
NS1X01 150928 CALLS TO EXM SWITCH STACKING PC ROUTINE                
NS1X05 16 ENTRIES IN EXM $PCA POOL, 0 GETMAINS DONE                  
NS1X10 EXM STORAGE POOL STATISTICS...                                
NS1X11    LENGTH   ENTRIES      GETS      PUTS  GETMAINS             
NS1X12       56       64        0        0        0                  
NS1X12      120       32        0        0        0                  
NS1X12      248       16        0        0        0                  
NS1X12      504       16        0        0        0                  
NS1X12     1016        8        0        0        0                  
NS1X12     2040        8        0        0        0                  
NS1X12     4088        8        0        0        0                  
NF3010 PACKET ANALYZER DECOUPLER STATISTICS FOLLOW...                
NF3011 I/P:  10680860 Q/D:  10680860 LST:         0 D/Q:  10680729   
NF3011 PST:       340 WAT:       286 SWP:    102624 TWT:     97899   
NF3011 F/A:  10678445 S/A:      2415                                 
NF5010 PACKET ANALYZER DYNAM DATABASE PAGE STATISTICS FOLLOW...      
NF5011 TOT:     16383 AVL:     15088 CUS:      1295 CPC:         8   
NF5011 HUS:      1325 HPC:         9                                 
NF5011 GET:      4483 FRE:      3188 FGT:         0                  
NF5010 PACKET ANALYZER SYNCH DATABASE PAGE STATISTICS FOLLOW...      
NF5011 TOT:      3071 AVL:      3064 CUS:         7 CPC:         1   
NF5011 HUS:         7 HPC:         1                                 
NF5011 GET:         6 FRE:         0 FGT:         0                  
NF5010 PACKET ANALYZER TRACE DATABASE PAGE STATISTICS FOLLOW...      
NF5011 TOT:     16383 AVL:     16382 CUS:         1 CPC:         1   
NF5011 HUS:         1 HPC:         1                                 
NF5011 GET:         1 FRE:         0 FGT:         0                  
NF5020 PACKET ANALYZER TRACE DATABASE BUFFER STATISTICS...           
NF5021 SIZE  B/P    PAGES    U-BUFF    F-BUFF                        
NF5022 76     50        0         0         0                        
NF5022 96     40        0         0         0                        
NF5022 128    30        0         0         0                        
NF5022 196    20        0         0         0                        
NF5022 248    16        0         0         0                        
NF5022 672     6        0         0         0                        
NF5022 1012    4        0         0         0                        
NF5022 1352    3        0         0         0                        
NF5022 2032    2        0         0         0             

SSI STATUS provides the names of connected SOLVE:Operations regions, which applications are active in the SOLVESSI region and some other statistics not provided by the SHOW SSISTATS command. Here is some sample output from this command:

NS2030 SOLVE SUBSYSTEM INTERFACE (NMSSI) STATUS...     
                               
NS2031 VERSION: V6.1 GEN LEVEL: NONE STATUS: ACTIVE MSLEVEL: 060100                   
NS2032 SSID: DENM JOB: DENMSSI OPSYS: Z/OS 01.07.01 SYSNAME: CA11                     
NS2034 CONNECTED TO SOLVE, NMID: DENM13 JOB: DENM13 DOMAIN: DE13                      
NS2034 CONNECTED TO SOLVE, NMID: DENM1011 JOB: DENM10 DOMAIN: DE10                    
NS2035 CROSS MEMORY SERVICES IN USE, LX: 00184200                                     
NS2037 DD SUBSYS SUPPORT IS ACTIVE                                                    
NS2038 IOS ATTENTION EXIT INSTALLED. INDEX: 120                                       
NS2039 DATE: 2006/11/08 TIME: 19:51:00.10 TIMEZONE OFFSET: -0500                      
NSD201 SSIDB STATUS: OPEN                                                             
NFST01 PACKET ANALYZER FEATURE IS ACTIVE                                              
NFST02 CTOKEN=BFACAA6E64635EE6 RTOKEN=1F22800013672E40                                
NF1018 ANALYZER SUBTASK EXECUTION MODE IS ZIIP                                        
NF1001 NUMBER OF STACKS: CURR=10  HIST=2     ENABLED=10  REQUESTS=154                 
NF4001 PACKET ANALYZER DEFAULT SMF WRITE ACTION IS NO                                 
NF7001 API EPS REGISTERED, NAME=$SYS.$FA.CA11                                         
NF7003 0 ACTIVE API REQUEST(S)                                                        
NS4X01 ENF FACILITY IS ACTIVE                                                         
NS4X02 CODES: 38                                                                      
NY3201 CA COMMON SERVICES QUERY SERVICE ACTIVE, NAME=$SYS.TNGFW.QUERY.CA11            
NY3120 SMF INFORMATION                                                                
NY3121 SMF PROCESSING ENABLED                                                         
NY3116 CA COMMON SERVICES LEVEL DETECTED=000107                                       
NY3123 SMF EXIT INFORMATION                                                           
NY3127 EXIT_NME REG_JOB  REG_DATE REG_TIME AT EP       RECV_REC WRTN_REC              
NY3128 CSVER    VERSION  PTF_LVL  CMP_DATE CMP_TIME    REJT_REC                       
NY3124 Y7FU83   DENMSSI  20061108 15533336 18 96B51570 00005C2B 00005C2B              
NY3137 Y750     V530     000000   20031103 0711        00000000                       
NY3124 Y7FU85   DENMSSI  20061108 15533339 18 97FB5570 0006177D 000617DE              
NY3137 Y750     V530     000000   20031103 0711        00000000                       
NY3124 Y7FU84   DENMSSI  20061108 15533338 18 992D43A0 00020A7C 00020A7C              
NY3137 Y750     V530     000000   20031103 0711        00000000                       
NY3124 Y7FU83   DENMSSI  20061108 15533336 98 9ACB2258 00005C2B 00005C2B              
NY3137 Y760     V610     000000   20060723 0937        00000000                       
NY3124 Y7FU85   DENMSSI  20061108 15533339 98 9ABD45D0 0006177D 000617DE              
NY3137 Y760     V610     000000   20060723 0937        00000000                       
NY3124 Y7FU84   DENMSSI  20061108 15533338 98 97FB25D0 00020A7C 00020A7C              
NY3137 Y760     V610     000000   20060723 0937        00000000                       
NY3138 COMMON CODE EP=966C3D28 VER=V610 PTF_LVL=000000 CMP_DATE=20060723 CMP_TIME=0937
NY3129 END OF SMF INFORMATION, LISTED EXITS 6 OUT OF 4 REQUESTED                      
NS6H01 ATTACHED TERMINAL SUPPORT IS ACTIVE.                                           
NXSB01 XCF ACTIVE, G=ZSOLVE11 M=CA11DENM T=0100082E006D0004                           
N11907 *END*