The possible function codes that may be returned on the CMSORCV call are listed below: |
In this section: |
Value name |
Value |
Meaning |
Returned Parameters |
IB_DATA |
9 |
Data returned. This is the result of CICSCOMM being invoked in MSO. |
CONNID USERWD INLEN OUTLEN BUFFER |
IB_SUSP |
10 |
Suspend key struck. The users MSO session is dormant until CMSORSM is issued for it. |
CONNID USERWD |
IB_FIN |
11 |
FOCUS session ended. ERRNUM contains return code from the MSO FOCUS session. |
CONNID USERWD ERRNUM |
IB_ERROR |
12 |
API protocol error. ERRNUM contains the value for the error. See the following table for a list of errors and their meanings. |
CONNID USERWD ERRNUM |
IB_NOAPI |
17 |
Program not called by MSO\CICS |
None |
The ERRNUM values that may be associated with a function code of IB_ERROR are:
Error |
Value |
Description |
IBERR_STATE |
1 |
MSO called in invalid state |
IBERR_INVFUNC |
2 |
MSO called w/invalid function |
IBERR_SECURE |
3 |
id verification failed. |
IBERR_NORECON |
4 |
RECON called but not supported |
IBERR_NOTFOUND |
5 |
user not found for connect id |
The following sample members are supplied in FOCEXEC.DATA to aid in developing installation applications to use this feature:
CCDEMO |
A FOCEXEC that implements a sample MSO menu to illustrate the function supplied by the CICSCOMM FUSELIB routine |
CCDEMOAS |
Assembler source of CICS API program |
CCDEMOAJ |
JCL to build CCDEMOA module |
CCMAPS |
Map source for demo program |
CCMAPSAJ |
JCL to build mapset and MAP DSECT |
A CICS connection may be lost by powering off a terminal or closing an emulator session. This feature adds the capability of reconnecting to that session. Previously there was no way to do this and the user would not be allowed to re-logon until the original session had timed out or been canceled by the MSO operator.
A standard MSO session may be reconnected with, by specifying MSO RECON (where MSO is the CICS transaction that invokes the MSOCICS program).
An MSO/CICS cooperative processing session, one that was established via the CMSOLGN call, may be reconnected using the CMSREC call. CMSREC allows the use of conid or userid to be specified. If conid is specified then the userid of the MSO FOCUS session has to match the CICS userid only if the LOGVALID security flag was set to Y in the LOGONBUF. The reconnection is found using the userid associated with the CICS session. UNIQUE=LOGONID must have been specified in the MSO configuration file for this service to be able to reconnect.
If the suspend key is activated in the MSO FOCUS session, it is subject to the MSO configuration setting of IDLELIM. If the session is in the suspended state long enough to set off the IDLELIM limit, the session is terminated. This condition can be avoided by defining a separate service group that has IDLELIM set to a high value and placing the cooperative processing MSO sessions into these service groups by specifying the appropriate LOGSERV parameter.
Information Builders |