OSI/MHS Management Programming Manual

Communicating with the OSI/MHS Processes
OSI/MHS Management Programming Manual—424824-001
2-2
Segmented Responses
Figure 2-1 shows these steps.
Usually the MHS manager remains open, once opened by SCP, even if SCP is closed by
the application. The MHS manager will break the link with SCP if SCP is stopped or if
any file-system error occurs. It will be reopened when SCP issues the next request
directed to the process.
Segmented Responses
Some commands—STATUS PROCESS, for example—can generate a response record
that will not fit into a single response buffer. When this occurs, OSI/MHS can, if you
allow it, segment the response record and return it in multiple response messages.
OSI/MHS can segment LISTOPENS MON, STATUS ENTRY, and STATUS PROCESS
(MRP and RTS) responses. Segmentation is based on a standard SPI list type called the
segment list.
In a segmented response, each response record is divided into one or more segments.
Each segment is an SPI data list that starts with ZSPI-TKN-DATALIST and ends with
ZSPI-TKN-ENDLIST. Each segment also contains ZSPI-TKN-RETCODE.
Tokens in the response are divided into a base group, which appears once, and one or
more repeating groups, which can appear more than once. A token is included in the
base group if it appears in the response record a predefined number of times. A token is
included in the repeating group if there is no way to know before the response is
generated how many times the token will appear.
Figure 2-1. Communicating Through SCP
008CDT .CDD
Management
Application
SCP
MHS Manager
OPEN
command
OPEN
command
security
check
Management
Application
SCP
MHS Manager
response
response
CLOSE
Command Sequence
Response Sequence
1
2
3
4
5
6
7
8