CONSPROF command

Use the CONSPROF command to establish, change, or display your console profile. You must have CONSOLE command authority to use CONSPROF.

The information in your console profile is used to control message processing during a console session. You can:

Specify whether solicited messages that are routed to your console are to be displayed at the terminal. A solicited message is a direct response to an MVS™ system or subsystem command.
Specify whether unsolicited messages that are routed to your console are to be displayed at the terminal. An unsolicited message is any system message that is not a direct response to an MVS system or subsystem command (for example, a message sent to you by another user).
Assign a value for the maximum number of solicited or unsolicited messages that are to be held for later retrieval with GETMSG.

If you want to receive messages in a language other than U.S. English (specified either by your installation or by using the PROFILE command), you must specify on the CONSPROF command that messages are to be displayed at the terminal. For information about specifying languages with the PROFILE command, see z/OS TSO/E Command Reference.

Your installation may have set up a default console profile for you using the logon exit IKJEFLD1. If this has not been done, or if the settings in the profile are not appropriate, you can use the CONSPROF command to change the profile for your console sessions.

If you activate a console session and a profile has not been established (either by your installation or by using the CONSPROF command) both solicited and unsolicited messages that are routed to your console are displayed at the terminal.

To change your console profile, issue the CONSPROF command with the appropriate keywords. Only the keywords specified are updated. If you have RACF® installed and you have a TSO segment defined in the RACF data base, the settings defined on the CONSPROF command are maintained from session to session.

To display the current profile settings, issue the CONSPROF command with no operands.

You can use the CONSPROF command during a console session if values need to be changed. If you are in CONSOLE conversational mode, you can use the TSO subcommand of CONSOLE to issue the CONSPROF command.

If you specify that solicited and/or unsolicited messages are not to be displayed at the terminal, applications can use the GETMSG service to retrieve those messages. GETMSG is provided as both a programming service and a REXX function. For more information about using GETMSG, see z/OS TSO/E Programming Services or z/OS TSO/E REXX Reference.

The syntax of the CONSPROF command is:

CONSPROF is an authorized command.
You require CONSOLE command authority to use CONSPROF.

SOLDISPLAY(YES | NO)

specifies whether solicited messages that are routed to your console are to be displayed at the terminal.

YES: Solicited messages are displayed at the terminal. This is the default.
NO: Solicited messages are not displayed at the terminal. If NO is specified, solicited messages are stored in a message table where you can retrieve them using GETMSG.

SOLNUM(nnnnn)

The maximum number of solicited messages that are to be held in a message table. When the limit is approached, installation exits (IKJCNX50 or IKJCNX64) may be invoked to resolve the situation. For a description of what these exits can do, see z/OS TSO/E Customization.

If you do not specify this keyword, the system uses either the value that your installation specified in logon exit IKJEFLD1 or the initial value specified in the IKJTSOxx member of SYS1.PARMLIB.

nnnnn is the maximum number of solicited messages; it is an integer in the range of 0 to the maximum value set by your installation in the IKJTSOxx member of SYS1.PARMLIB.

UNSOLDISPLAY(YES | NO)

specifies whether unsolicited messages that are routed to your console are to be displayed at the terminal.

YES: Unsolicited messages are displayed at the terminal. This is the default.
NO: Unsolicited messages are not displayed at the terminal. If NO is specified, unsolicited messages are stored in a message table where you can retrieve them using GETMSG.

UNSOLNUM(nnnnn)

The maximum number of unsolicited messages that are to be held in a message table. When the limit is approached, installation exits (IKJCNX50 or IKJCNX64) may be invoked to resolve the situation. For a description of what these exits can do, see z/OS TSO/E Customization.

If you do not specify this keyword, the system uses either the value that your installation specified in logon exit IKJEFLD1 or the initial value specified in the IKJTSOxx member of SYS1.PARMLIB.

nnnnn is the maximum number of unsolicited messages; it is an integer in the range of 0 to the maximum value set by your installation in the IKJTSOxx member of SYS1.PARMLIB.