Unicenter SOLVE:Operations MVS Consoles

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

Why Does Unicenter SOLVE:Operations Uses MVS Consoles?

Unicenter SOLVE:Operations uses MVS consoles to issue a command to the operating system and then read the responses to the command, and only the responses to the command issued. The commands may be executed by a Unicenter SOLVE:Operations background userid or by any user logged on to a Unicenter SOLVE:Operations region. Unicenter SOLVE:Operations does not use consoles to read messages issued by the operating system that were not specifically solicited by a command from a Unicenter SOLVE:Operations region.

Issuing a Command from a Unicenter SOLVE:Operations Region

To issue a command from Unicenter SOLVE:Operations to the operating system, you can use one of the following methods:

  • OPSYS

  • SYSCMD

Both methods check to ensure that the user issuing the command has been granted the level of authority to perform the function and then pass the command to the operating system.

The OPSYS method does no further checking and sends the command to the operating system via a console and does not return the response to the command from the operating system to the user.

The SYSCMD method does additional checks to ensure that all the features required to issue operating system commands are included in the Unicenter SOLVE:Operations region. It also checks for the character $ to see if a JES command was attempted, if the command is a JES command then we check to determine if the system is JES2 or JES3 and if the JES character to be used differs from a standard $. In addition, SYSCMD supports the use of keywords to allow a user to pass specific requirements with the command that override default settings. These keywords include WAIT, MIGID, OPT and CON, and can contain values for specific circumstances as required by a user, and are checked by SYSCMD processing prior to issuing the command to the operating system.

After completing these checks Unicenter SOLVE:Operations then issues the command to the operating system and return the responses from the operating system to the user via a console.

What Type of Consoles are Supported by Unicenter SOLVE:Operations

Unicenter SOLVE:Operations supports the following console types:

  • JES consoles

  • Extended MCS consoles (also known as EXTMCS or EMCS consoles)

    Differences between JES and EMCS Consoles

    JES consoles are the 'older' way of defining consoles for software products to use. For a JES console to be available, it must be defined in SYS1.PARMLIB member CONSOLxx and an IPL must be performed for the console to become available. This limits the number of consoles available, and has the disadvantage of requiring an IPL every time a new console is needed.

    JES consoles have the advantage of being dedicated to the software product they are assigned to and can be slightly more efficient than EMCS consoles for performance purposes. JES consoles have a limited number available and only 99 can be defined across a SYSPLEX for all software products to use.

    EMCS consoles are the 'newer' way of defining consoles for software products to use. They are dynamically created by the operating system and require no definition in SYS1.PARMLIB nor is an IPL required for them to be made available. The number of EMCS consoles that can be made available for use by a Unicenter SOLVE:Operations region is 254 per region, this number can be dynamically changed without requiring any operating system changes or an IPL. Unicenter SOLVE:Operations uses a retained pool of EMCS consoles methodology to ensure that a dedicated number of consoles are always available for immediate use. This allows Unicenter SOLVE:Operations to obtain the same performance advantage for EMCS consoles as JES consoles enjoy by having consoles always available for use.

    The Unicenter SOLVE:Operations Technical Support recommends that EMCS consoles be used for Unicenter SOLVE:Operations whenever possible.

    With the latest releases of z/OS, IBM has been discouraging the use of JES consoles. With future releases of z/OS, JES consoles may be unsupported. This is an additional reason for using EMCS consoles.

How Consoles are Defined in a Unicenter SOLVE:Operations Region

In Unicenter SOLVE:Operations, there is a parameter group for the configuration of the console requirements for each region. To access this parameter group, enter the shortcut /PARMS. The parameter group is named $RM CONSOLES.

This parameter group has two panels for defining all the required information about console usage, and many of the parameters have a default value.

The following illustration shows an example of the first panel:

Figure 1

The following fields are required:

CONSOLES - Console Specifications
Type of Consoles to Acquire.................+
Max Consoles to Acquire......................
Max Consoles to Retain.......................

These parameters specify the following:

  • Type of consoles being used-either EXTMCS or JES

  • Maximum number of consoles that Unicenter SOLVE:Operations will acquire at any point

  • Maximum number of consoles that Unicenter SOLVE:Operations will retain in a pool for immediate use

When Unicenter SOLVE:Operations starts, it has no consoles acquired for use. When Unicenter SOLVE:Operations issues its first operating system command, it will acquire a console to issue the command, and when it has completed the process of issuing the command and reading the responses, it will check to determine if the maximum number of consoles currently retain has been reached. If the number of consoles currently retained is less than the defined maximum, then it will retain the console for future use. After a console is retained, it is available for immediate use, so that Unicenter SOLVE:Operations is not required to perform the function of acquiring another console, and hence the performance overhead associated with acquiring and releasing consoles to the operating system is removed. Unicenter SOLVE:Operations will use one of the retained consoles if one is available when it executes a command. Only when more consoles are required than are currently retained will Unicenter SOLVE:Operations acquire a new console.

There is no recommendation by Unicenter SOLVE:Operations Technical Support about the number of consoles that should be set in these parameters. The number of consoles required is dependant of the amount and type of monitoring being performed by each Unicenter SOLVE:Operations region. However, in the help screen for this panel there is some guidance in the number of consoles that should be considered depending on circumstances.

From our experience, it is reasonable to start with the number 20 for consoles to acquire and 6 to retain, and then monitor the actual use at peak times by entering the Unicenter SOLVE:Operations command SHOW CONSOLES. This will allow you to determine the number of consoles actually used and adjust the figure to a higher or lower number as necessary.

One important point to note is that there is no downside to defining a larger number of consoles than is actually required. This number is a maximum that can be acquired, but does not mean it is the number that will be acquired. If 50 consoles are defined as the maximum number to acquire and the Unicenter SOLVE:Operations region only ever needs 10 at its peak workload, we never attempt acquire the other 40 consoles and hence there is no performance loss by over-estimating the number of consoles.

The first panel of the $RM CONSOLES parameter group panel contains additional parameters.

The following parameters only apply if the Console Type is EXTMCS:

Console Name Prefix....................... CS17
Restrict Console Suffix Range............. YES (Yes or No)
Acquire with Migration ID (default)....... NO (Yes or No)
Name of Migration ID Determination Exit... NO
Subsystem Command Prefix Chars (for Exit).

If the console type of EXTMCS then the console name prefix is required, by default it will be the same as the Unicenter SOLVE:Operations Domain ID for the region. The prefix is used to build the console name-using the parameters from the above example will result in a console name of ZCS17 nnn (where nnn is the suffix range from 001 to 255).

In addition, if the console suffix range is specified as YES, (and the maximum number of consoles to use was specified as 10), the consoles acquired will be named ZCS17001 through ZCS17010. This is useful to ensure that a specific set of console names are used when Unicenter SOLVE:Operations is required to issue commands to other software products that must have each valid console defined to it, for example,. CICS.

Migration IDs are a method that enables programs that do not support named consoles to use a console number alias. When Extended MCS consoles first became available some programs were not designed to support this type of naming. However, programs that require migration IDs are now rarely encountered and Unicenter SOLVE:Operations Technical Support recommends that this field be set to NO, unless you have a specific requirement for this type of processing. In the event that migration IDs are required for using consoles with Unicenter SOLVE:Operations, it should be noted that this does limit the number of EMCS consoles that can be used in this way to 150 consoles across the SYSPLEX. The Migration ID Determination Exit and Subsystem Command Prefix Character parameter fields are only used when the Acquire with Migration ID is set to YES, so these parameters should not need to be defined or updated.

Note: With z/OS 1.7 and later, the use of 1-byte console IDs, including migration IDs, is no longer supported. If using these levels of z/OS, you must set the Migration ID option to NO.

On the second panel of parameter group, the following parameters are defined.

Figure 2

The values shown are the defaults that Unicenter SOLVE:Operations will automatically populate these fields with, and they should be sufficient for the vast majority of MVS systems.

There is a very good help section on the purpose of these parameters which will not be repeated in this document It can be accessed by pressing F1 whilst in the parameter group panels.

The parameter named Master Console Lock Duration applies only when using JES consoles. It should be emphasized that this parameter does not affect the MVS master console processing on an LPAR or SYSPLEX. This parameter is only used when a Unicenter SOLVE:Operations command to the operating system is issued with the parameter CON=MASTER. The use of CON=MASTER is not supported if Extended MCS consoles are used by Unicenter SOLVE:Operations-so this parameter is only used if JES consoles are being used. When it is used, it allows Unicenter SOLVE:Operations users to enter a command as though it was issued from a master console and read all messages received by the master console for the time period specified. This option was made available for use with JES consoles for specific requirements with automation processes, and Unicenter SOLVE:Operations continues to support the function for those clients who still use JES consoles and require access to this option (EMCS console authority levels include the ability to issue master console-only commands, thus removing the need for this facility when using EMCS consoles).

Useful Command

The SHOW CONSOLES command is very useful both for determining current console usage and for determining console efficiency by a Unicenter SOLVE:Operations region, for example:

Figure 3

The results of this command show the current parameter settings, and the number and names of the consoles that are in use or have been retained for future use.

In addition, there are statistics that can be used to help determine how efficient the current console definition is.

The following statistics is an example:

    #-LOG-AQ  #-PHY-AQ      104       7 

Here, you can determine that there have been 104 logical requests for a console and 7 physical requests for a console, and 7 consoles have actually been acquired in total to process the requests.

The following statistics is another example:

    %-PL-A   AV-TM-PA      6.73     0.15 

Here, the percentage of commands that required a physical acquisition of a console (Unicenter SOLVE:Operations having to acquire a console from MVS to issue the command) is 6.73%. If this number is a low number it indicates that Unicenter SOLVE:Operations was able to service the need for a console from its current pool rather than the performance overhead of having to perform a call to MVS to acquire the console prior to the command being issued.

The average time it took to perform the physical acquisition of a console is 0.15 seconds. In this example, this time is the additional time required for each command to process when a physical acquire of a console is performed. Because 104 of the console acquisitions were logical (using a console from the retained pool), that means that over 10 seconds of unnecessary processing time were eliminated due to an efficient console definition.

On a busy system, there would also be more data for average time physically released and percentage physically released as well as some of the other fields. By viewing this data, you can determine whether your current console definition is sufficient for your Unicenter SOLVE:Operations requirements or if changes to your console definitions can enhance your region's performance in this area.

A full explanation of all the statistics fields from a SHOW CONSOLES command can be found in the description of message ID N86E21.

Questions and Answers about Consoles and Unicenter SOLVE:Operations

  • Does IBM health check software flag Unicenter SOLVE:Operations use of consoles and its specific settings of ROUTCDE=ALL and MSCOPE=*ALL as bad?

    There have been anecdotal reports of this setting causing system problems. This has been investigated by CA, and no problems or system outages have ever been caused by having these settings on a console. However, these settings can cause an excess of traffic when Unicenter SOLVE:Operations routes commands across LPARs in a SYSPLEX, and we have addressed this scenario with an APAR. For r11.0 of Unicenter SOLVE:Operations, the APAR is NZ13516.

  • Does Unicenter SOLVE:Operations support the IBM console restructure for z/Os (JBB7727 and JBB7728)?

    Yes, Unicenter SOLVE:Operations r11.0 supports the IBM Console restructure. Earlier releases of Unicenter SOLVE:Operations have APARs available to add the required support, which can be obtained from SupportConnect or by contacting Technical Support.

  • Why does the OPDATA TRACKING Utility highlights Unicenter SOLVE:Operations as non-compliant with the z/OS1.6 version of IEAVG700?

    We have resolved this situation with an APAR. For r11.0 of Unicenter SOLVE:Operations, the APAR is NZ18509.

  • Why does the OPDATA TRACKING Utility highlight Unicenter SOLVE:Operations as using 1-byte console-IDs? 1-byte IDs are being phased out from z/OS1.4 (with JBB7727), and it is expected that 1-byte IDs will not be supported after z/OS1.7.

    Unicenter SOLVE:Operations has used 4-byte IDs since 1993, but has retained some settings that appeared to use 1-byte IDs to ensure compatibility with applications incapable of communicating with 4-byte IDs. For Unicenter SOLVE:Operations r11.0, we have applied changes so that we are no longer highlighted by this utility as using 1-byte IDs.