Multi-System Facility › Display Systems and MSF Sessions

Display Systems and MSF Sessions

You can display the status of the local system and remote sessions by issuing the MSF LIST command.

Note: For detailed descriptions of the keywords for the MSF LIST command, see the Command and Function Reference.

To display systems and MSF sessions

1. Issue the MSF LIST command through either of these methods:
   • From an OPS/REXX program
   • From a console using the OPSMSF command rule in the sample libraries
2. The syntax for the MSF LIST command is as follows:

   ADDRESS OPSCTL "MSF LIST keywords"
   

The following is a sample display of the information returned by the MSF LIST command:

Local     Status   Applid    VTAM   Retry  Max  Current    VTAM
System   VTAM      VTAM   Password Secs  Retry  Retry  Open Error
-------- -------- -------- -------- ----- ----- ------- -----------
SYSA     ACTIVE   OPSMVSA           30          0

---------------------------- Remote System---------------------------------
     System                     Delay   Retry  Max  Current    VTAM
Sel  Name     Status   APPLID   Value   Secs  Retry  Retry  Rtncd Fdbk2 Type
---  -------- -------- -------- -------- ----- ----- ------- ----------- -----
     SYSB     ACTIVE   OPSMVSB     1     30    5     0       X'00' X'00' APPC
     SYSC     INACTIVE OPSMVSC     1     30    5     1       X'00' X'00' APPC
     SYSD     FAILED   OPSMVSD     1        NO RETRY         X'08' X'01' APPC
     SYSE     INACTIVE OPSMVSF     1     30    4     4       X'00' X'00' APPC
     SYSF     FAILED   OPSMVSF     30    30    4     2       X'08' X'01' APPC

In the above display:

• The local system is called SYSA.
• Five remote systems have been defined.
• Only one MSF session from the local system is active (the session to system SYSB).
• The MSF session from SYSA to SYSC has been deactivated using the MSF DEACTIVATE command.
• The MSF session from SYSA to SYSD has not been established because it was activated with the NORETRY keyword and the remote system (SYSD) has not been able to establish the MSF session.
• Both sessions to SYSE and SYSF failed. The session to SYSE was activated in RETRY mode, but has reached the maximum number of RETRYs and must be reestablished by the MSF on the SYSE system.
• The session to SYSF is using RETRY mode, with retries every 30 seconds and a maximum of 4 retries. The MSF is currently retrying for the second time to reestablish the session.

Like any part of the z/OS environment, the MSF can operate with the CA OPS/MVS AOF. Thus, if the NORETRY and RETRY options supported by the MSF cannot establish MSF sessions and keep them up in your environment, you can program more sophisticated procedures using the same AOF facilities with which you control all the other systems in your environment.