SOLVESSI - Its Purpose and What It Does

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

The SOLVESSI region is an important component of all Unicenter NetMaster implementations. This article describes the purpose of the SSI and the services it provides.

The setup and configuration of the SOLVESSI address space is performed by the Unicenter NetMaster installation utility IIA. IIA will specify a number of startup parameters on the SOLVESSI JCL deck which are dependant on the Unicenter NetMaster products that you have installed on your LPAR. The SOLVESSI startup parameters are not something the end user normally needs to tailor. However 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. Packet Analyzer. The SOLVESSI collects TCPIP packet information for Unicenter NetMaster region. It is activated by specifying PKTANALYZER=YES in the SSI JCL deck.

  2. UNIX SHELL access - Used by Unicenter NetMaster to issue ONETSTAT commands to retrieve TCPIP connection information. Activated by specifying UNIX=YES in the SSI startup parameters. Note: The UNIX SHELL service requires the SSI to not run APF authorized.

  3. Loading of SMF exits and the gathering of SMF data through the SMF=YES SSI startup parameter. SMF records are used extensively by Unicenter NetMaster Network Management for TCP/IP. During initialization, the SOLVESSI will invoke CA Common Services to load the SMF exits it requires on its behalf. Verification of SMF recording is discussed in more detail later in the article.

  4. Linking Unicenter NetMaster 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). NetMaster 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 NetMaster INMC can use as a transport mechanism).

  5. Non-SNA terminal support - this allows access to Unicenter NetMaster from terminals via a non-SNA 3270 terminal controller without VTAM involvement.

  6. 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.

  7. 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 NetMaster regions can be linked together.

image 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 NetMaster region by specifying SSI STOP from OCS or Command Entry.

To connect a Unicenter NetMaster 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 NetMaster 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*

Verifying SMF processing

A SOLVESSI region may be nominated to manage NetMaster SMF exits by specifying SMF=YES in the SSI startup parameters. The SMF exits may be loaded during SOLVESSI initialization by the invocation of CA Common Services). SMF processing can also be disabled via the SMF DEREG command, or refreshed dynamically via an SMF REG command.

The status of the SMF exits may be queried at any time via an SMF STATUS command. Here is a sample of the resultant output:

SMF STATUS
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 20061106 15241269 18 991A6530 00000639 00000639
NY3137 Y750 V530 000000 20031103 0711 00000000
NY3124 Y7FU85 DENMSSI 20061106 15241272 18 99105530 000196BA 000196BA
NY3137 Y750 V530 000000 20031103 0711 00000000
NY3124 Y7FU84 DENMSSI 20061106 15241270 18 97FB4570 00006690 00006690
NY3137 Y750 V530 000000 20031103 0711 00000000
NY3124 Y7FU83 DENMSSI 20061106 15241269 98 992D9450 00000639 00000639
NY3137 Y760 V610 000000 20060723 0937 00000000
NY3124 Y7FU85 DENMSSI 20061106 15241272 98 96B525D0 000196BA 000196BA
NY3137 Y760 V610 000000 20060723 0937 00000000
NY3124 Y7FU84 DENMSSI 20061106 15241270 98 998D95D0 00006690 00006690
NY3137 Y760 V610 000000 20060723 0937 00000000
NY3124 NMDSPAXS NMDTCPJ2 20061106 09064903 1F2DEB70
NY3137 V610 000000 20060723 0936
NY3138 COMMON CODE EP=8F2CED28 VER=V610 PTF_LVL=000000 CMP_DATE=20060723 CMP_TIME=0937
NY3129 END OF SMF INFORMATION, LISTED EXITS 6 OUT OF 1188 REQUESTED