Displaying the Mode Status

Resolving The Problem

The following examples refer to the APPC network (without APPN support) example described in Appendix D of the APPC Programming manual, in which a system at location NEWYORK (with a device description LOSANGEL) is communicating with a system at location LOSANGEL (with device description NEWYORK).

You can type the Display Mode Status (DSPMODSTS) command with the command prompt, or you can type the command with parameters on any command line and press the Enter key. The following is an example of the kind of display that is shown when you run the DSPMODSTS command and specify LOSANGEL for the device and BLANK for the mode:

DSPMODSTS DEV(LOSANGEL) MODE(BLANK)

Press the Enter key.

Display Details of Mode Status                                                                  System:   SYSNAM00       Mode/status . . . . . . . . . . . . . . :   BLANK        Started                     Device/status . . . . . . . . . . . . . :   LOSANGEL     ACTIVE                     Local location/network ID . . . . . . . :   NEWYORK      APPC                       Remote location/network ID  . . . . . . :   LOSANGEL     APPC                                                                                                           Conversations:                          Total    Source    Target   Detached          Configured maximum  . . . . . . . :       8                                         Number for device . . . . . . . . :       1         1         0          0           Number for location . . . . . . . :       1         1         0          0                                                                                             Sessions:                                 Total     Local     Remote                  Configured limits . . . . . . . . :        8         4                               Local maximum . . . . . . . . . . :        8                                         Negotiated limits . . . . . . . . :        8         4          4                   Number for device . . . . . . . . :        1         1                               Number for location . . . . . . . :        1         1                                                                                                                                                                                       Bottom        Press Enter to continue.                                                                                                                                                 F3=Exit   F5=Refresh   F12=Cancel   F14=Display previous mode

This display shows the following information:

Mode/status: Name of the mode description and status of the mode. One of the following may be displayed for the status of the mode:

Ended	Indicates that the mode cannot be used for communications. The local system has issued an ENDMOD command to end the mode. Only the local system can start the mode.
Reset	Indicates that the mode cannot be used for communications. Either the mode is in the initial state (not yet started), or it has been ended by the remote system. Either the local or the remote system may attempt to start the mode.
Started	Indicates that the mode has been started and can be used for communications.
Unknown	Status of mode could not be determined.

Device/status: Name of the APPC device and status of the APPC device. One of the following may be displayed for the status of the device:

Varied off pending	The device is in the process of being varied off.
Varied off	The device is not being used for communications.
Vary on pending	The device is in the process of being varied on.
Varied on	The device is varied on.
Active	The device is ready to handle APPC sessions.
Held	The user or the system held the communications device to prevent it from participating in communications.
RCYPND	Error recovery is pending for the device.
RCYCNL	Error recovery was canceled for the device.
Failed	This status indicates that an error occurred for the device that can only be recovered by varying the device off and on again.
*Damaged	The device object has received hard damage.
*Locked	The status of the device could not be determined because another job had an exclusive lock on the device.
*Unknown	The status indicator of the device cannot be determined.

Local location/network ID: Name of the local location and the network ID associated with the local location. The name and network ID can each have up to 8 characters.

Remote location/network ID: Name of the remote location and the network ID associated with the remote location. The name and network ID can each have up to 8 characters.

Conversations: Configured maximum - How many were configured for this device.

Number for device:

Total	Current number running on this device.
Source	Current number of conversations that are allocated to source programs on this device.
Target	Current number of conversations that are allocated to target programs on this device (started as a result of a received program start request).
Detached	Current number of conversations that are not active on a session but have not been detached from the program on this device.

Number for location:

Total	Current number running for this location.
Source	Current number of conversations that are allocated to source programs for this location.
Target	Current number of conversations that are allocated to target programs for this location (started as a result of a received program start request).
Detached	Current number of conversations that are not active on a session but have not been detached from the program for this location.

Sessions

Configured limits:

Total	How many were configured for this device.
Local	Number of locally controlled sessions configured.

Local maximum: Maximum number of sessions requested by the most current CHGSSNMAX command.

Negotiated limits:

Total	Current maximum number of sessions allowed for this device.
Local	Current minimum number of locally controlled sessions on this device.
Remote	Current minimum number of remotely controlled sessions on this device.

Number for device:

Total	Current active number of sessions on this device.
Local	Current active number of locally controlled sessions on this device.

Number for location:

Total	Current active number of sessions running for this location.
Local	Current active number of locally controlled sessions for this location.

To display all modes for a device, you can type:

DSPMODSTS DEV(LOSANGEL) MODE(*ALL)

Press the Enter key. It will show a screen similar to the following:

Display Mode Status                                                                                                System:   SYSNAM00       Device  . . . . . . . . . :   LOSANGEL                                               Device status . . . . . . :   ACTIVE                                                                                                                                     Type options, press Enter.                                                             5=Display details                                                                                                                                                                    Mode              ---------Conversations---------                    Opt  Mode      Status            Total  Source  Target  Detached                         BLANK     Started              0       0       0        0                            #BATCH    Started              0       0       0        0                            SNASVCMG  Started              0       0       0        0

If you then press F11 (Display sessions), the following display is shown:

Display Mode Status                                                                                                System:   SYSNAM00       Device  . . . . . . . . . :   LOSANGEL                                               Device status . . . . . . :   ACTIVE                                                                                                                                     Type options, press Enter.                                                             5=Display details                                                                                                                                                                    Mode              --Sessions--                                        Opt  Mode      Status            Total  Local                                             BLANK     Started              0      0                                              #BATCH    Started              0      0                                              SNASVCMG  Started              0      0

These displays show the device name and status. Current values are also shown for conversations and sessions. From these displays you may also select Option 5 (Display details) for a selected mode.

The following examples depict how the mode controlling commands (STRMOD, ENDMOD, and CHGSSNMAX) change the affected modes. The DSPMODSTS command is used throughout this example to show the transitions taking place for the modes affected by these commands. This example shows the mode controlling commands being run at system NEWYORK as they relate to the connection with location LOSANGEL.

To show the following display, type:

DSPMODSTS DEV(LOSANGEL) MODE(*ALL)

Press the Enter key. Then press F11 (Display sessions) to display information about the sessions:

Display Mode Status                                                                                                System:   SYSNAM00       Device  . . . . . . . . . :   LOSANGEL                                               Device status . . . . . . :   ACTIVE                                                                                                                                     Type options, press Enter.                                                             5=Display details                                                                                                                                                                    Mode              --Sessions--                                        Opt  Mode      Status            Total  Local                                              BLANK     Started              1      1                                              #BATCH    Started              1      1                                              SNASVCMG  Started              1      1

This shows the modes after the connection between NEWYORK and LOSANGEL has been established. The display shows that the reserved mode SNASVCMG and that the modes #BATCH and BLANK have been started. The SNASVCMG mode is used by the system for negotiating SNA sessions between two locations and alerts between network nodes. In SNA, an alert is a record sent to a focal point to identify a problem or an impending problem.

The following display shows what happens when the local system has started an application that acquires a session. The mode specified on the DSPMODSTS command is #BATCH (note that this is one of the modes specified on the CRTDEVAPPC command when NEWYORK and LOSANGEL were configured).

Display Mode Status                                                                                                System:   SYSNAM00       Device  . . . . . . . . . :   LOSANGEL                                               Device status . . . . . . :   ACTIVE                                                                                                                                     Type options, press Enter.                                                             5=Display details                                                                                                                                                                    Mode              ---------Conversations---------                    Opt  Mode      Status            Total  Source  Target  Detached                         BLANK     Started              0       0       0        0                            #BATCH    Started              1       1       0        0                            SNASVCMG  Started              0       0       0        0

Pressing F11 (Display sessions) gives the previous display showing the display mode status for sessions. The display also shows that there is one session that has been established and one conversation currently in progress between NEWYORK and LOSANGEL using the mode #BATCH.

Because all modes for APPN(*NO) start automatically when the device description is varied on, you must first end a mode using the ENDMOD command before you can issue a STRMOD command to start a mode. You can then start an IBM-supplied mode BLANK to the remote location LOSANGEL by issuing the STRMOD command:

STRMOD RMTLOCNAME(LOSANGEL) MODE(BLANK)

Then press the Enter key to start the mode. Note: The mode BLANK is the other mode specified on the CRTDEVAPPC command during configuration.

By next issuing the following command, you will see that the mode BLANK has been started, and the session limits that have been negotiated between NEWYORK and LOSANGEL.

DSPMODSTS DEV(LOSANGEL) MODE(BLANK)

Press the Enter key.

Display Details of Mode Status                                                                                       System:   SYSNAM00       Mode/status . . . . . . . . . . . . . . :   BLANK        Started                     Device/status . . . . . . . . . . . . . :   LOSANGEL     ACTIVE                     Local location/network ID . . . . . . . :   NEWYORK      APPC                       Remote location/network ID  . . . . . . :   LOSANGEL     APPC                                                                                                           Conversations:                           Total    Source    Target  Detached          Configured maximum  . . . . . . . :       8                                         Number for device . . . . . . . . :       0         0         0          0           Number for location . . . . . . . :       0         0         0          0                                                                                             Sessions:                                 Total     Local     Remote                  Configured limits . . . . . . . . :        8         4                               Local maximum . . . . . . . . . . :        8                                         Negotiated limits . . . . . . . . :        8         4          4                   Number for device . . . . . . . . :        0         0                               Number for location . . . . . . . :        0         0                                                                                                                                                                                       Bottom        Press Enter to continue.                                                                                                                                                   F3=Exit   F5=Refresh   F12=Cancel   F14=Display previous mode

To change the maximum number of sessions allowed between locations NEWYORK and LOSANGEL, you can use the CHGSSNMAX command. For example, if you want to change the maximum number of sessions specified for the mode BLANK from 8 to 6, type:

CHGSSNMAX RMTLOCNAME(LOSANGEL) MODE(BLANK) MAXSSN(6)

Press the Enter key. To show the mode status, type:

DSPMODSTS DEV(LOSANGEL) MODE(*ALL)

Press the Enter key.

Display Mode Status                                                                                                System:   SYSNAM00       Device  . . . . . . . . . :   LOSANGEL                                               Device status . . . . . . :   ACTIVE                                                                                                                                     Type options, press Enter.                                                             5=Display details                                                                                                                                                                    Mode              ---------Conversations---------                    Opt  Mode      Status            Total  Source  Target     Detached                   5   BLANK     Started              0       0       0        0                          #BATCH    Started              1       1       0        0                            SNASVCMG  Started              0       0       0        0

Select Option 5 to display the details of the mode status for the mode BLANK:

Display Details of Mode Status                                                                                          System:   SYSNAM00       Mode/status . . . . . . . . . . . . . . :   BLANK        Started                     Device/status . . . . . . . . . . . . . :   LOSANGEL     ACTIVE                     Local location/network ID . . . . . . . :   NEWYORK      APPC                       Remote location/network ID  . . . . . . :   LOSANGEL     APPC                                                                                                           Conversations:                           Total    Source    Target  Detached          Configured maximum  . . . . . . . :       8                                         Number for device . . . . . . . . :       0         0         0          0           Number for location . . . . . . . :       0         0         0          0                                                                                             Sessions:                                 Total     Local     Remote                  Configured limits . . . . . . . . :        8         4                               Local maximum . . . . . . . . . . :        6                                         Negotiated limits . . . . . . . . :        6         3          3                   Number for device . . . . . . . . :        0         0                               Number for location . . . . . . . :        0         0                                                                                                                                                                                       Bottom        Press Enter to continue.                                                                                                                                                 F3=Exit   F5=Refresh   F12=Cancel   F14=Display previous mode

As this display shows, the configured limits for the mode are not affected by the CHGSSNMAX command. What has changed are the negotiated limits between NEWYORK and LOSANGEL using mode BLANK.

To end all of the user modes between NEWYORK and LOSANGEL, you can use the ENDMOD command. Once this command has been run, no new sessions can be started between the two locations on modes BLANK and #BATCH until another explicit STRMOD command is run. Type:

ENDMOD RMTLOCNAME(LOSANGEL) MODE(*ALL)

Press the Enter key. To display the mode status, type:

DSPMODSTS DEV(LOSANGEL)

Press the Enter key.

Display Mode Status                                                                                                System:   SYSNAM00       Device  . . . . . . . . . :   LOSANGEL                                               Device status . . . . . . :   ACTIVE                                                                                                                                     Type options, press Enter.                                                             5=Display details                                                                                                                                                                    Mode              ---------Conversations---------                    Opt  Mode      Status            Total  Source  Target  Detached                         BLANK     Ended                0       0       0        0                        5   #BATCH    Ended                1       1       0        0                          SNASVCMG  Started              0       0       0        0

Note: Only the user modes #BATCH and BLANK are affected by the ENDMOD command. The reserved mode SNASVCMG is not affected by the ENDMOD command.

Select Option 5 to display the details of the mode status for the mode #BATCH:

Display Details of Mode Status                                                                                          System:   SYSNAM00       Mode/status . . . . . . . . . . . . . . :   #BATCH       Ended                       Device/status . . . . . . . . . . . . . :   LOSANGEL     ACTIVE                     Local location/network ID . . . . . . . :   NEWYORK      APPC                       Remote location/network ID  . . . . . . :   LOSANGEL     APPC                                                                                                           Conversations:                           Total    Source    Target  Detached           Configured maximum  . . . . . . . :       8                                         Number for device . . . . . . . . :       1         1         0          0           Number for location . . . . . . . :       1         1         0          0                                                                                             Sessions:                                 Total     Local     Remote                  Configured limits . . . . . . . . :        8         4                               Local maximum . . . . . . . . . . :        0                                         Negotiated limits . . . . . . . . :        0         0          0                   Number for device . . . . . . . . :        1         1                               Number for location . . . . . . . :        1         1                                                                                                                                                                                       Bottom        Press Enter to continue.                                                                                                                                                 F3=Exit   F5=Refresh   F12=Cancel   F14=Display previous mode

The ENDMOD command causes the mode #BATCH to end, but it does not affect sessions that have already been activated. This is the reason that there is still one active session and one active conversation between NEWYORK and LOSANGEL using mode #BATCH.

To display the mode status, type:

DSPMODSTS DEV(LOSANGEL)

Press the Enter key. The DSPMODSTS command shown here occurred after the application that had acquired a session using mode #BATCH has ended. This caused the session and conversation counts to go to zero.

Display Mode Status                                                                                                System:   SYSNAM00       Device  . . . . . . . . . :   LOSANGEL                                               Device status . . . . . . :   ACTIVE                                                                                                                                     Type options, press Enter.                                                             5=Display details                                                                                                                                                                    Mode              ---------Conversations---------                    Opt  Mode      Status            Total  Source  Target  Detached                         BLANK     Ended                0       0       0        0                            #BATCH    Ended                0       0       0        0                            SNASVCMG  Started              0       0       0        0