(MIC) DISPLAY GCMF Command-Display GCMF Information

CA MIC Statements and Commands › (MIC) DISPLAY GCMF Command-Display GCMF Information

(MIC) DISPLAY GCMF Command-Display GCMF Information

The DISPLAY GCMF command lets you display information about the status of the GCMF.

Scope: Local

This command has the following format:

DISPLAY GCMF [ALL]         
             [COLLECT {ALL | 
                       CONSOLE=name | 
                       DMONITOR | 
                       DROUTCDE |
                       PRODUCT=ssname | 
                       SOURCE |   
                       TSOUSER={ALL | userid}]       [DETAIL|SUMMARY] 
             [DOM     {ALL | 
                       ASID=asid| 
                       MSGID=msgid | 
                       JOBNAME=jobid}]               [DETAIL|SUMMARY]
             [INIT] 
             [LINK    {ALL| 
                       CONSOLE=name |
                       INSTREAM|
                       INTERNAL|  
                       PRODUCT=ssname | 
                       SOURCE | 
                       TSOUSER={ALL|userid}}]]
             [OPTIONS=([ACTIONPREFIX]
                       [ALL]
                       [BROADCAST]
                       [EXCLUDEJOB]
                       [EXCLUDEPREFIX]
                       [SAFSYSTEMS]
                       [SYSLOG]
                       [VALUES])]
            [POOLCONSOLES]

ALL

(Optional) Displays one of these types of information:

The GCMF initialization values (in message MIM3031) and operating values (in message MIM3030), collection set information (in message MIM3054), linkage information (in message MIM3016), console pool information (in message MIM3065), and DOM information (in message MIM3061), if you specify DISPLAY GCMF ALL
Information about all local consoles, products, and TSO users (if specified with the COLLECT or LINK operands)
Information about outstanding messages (if specified with the DOM operand)

Specify the ALL operand only once per command, even when it qualifies two or more operands. For example, you can specify DISPLAY DOM ALL to see the GCMF initialization and operating values and to see information about all outstanding messages. Note that ALL is a default value when you specify DISPLAY DOM.

ASID: Displays information about messages that have a designated address space ID. Specify the ID in place of the asid variable.

COLLECT

(Optional) Displays information about collection sets for the console, product, or TSO user you have specified. This information is displayed in message MIM3055 (if you specify DISPLAY COLLECT DETAIL) or in message MIM3054 (if you specify DISPLAY COLLECT SUMMARY). Possible values are:

ALL: Displays collection set information for all destinations.
CONSOLE: Displays collection set information for a designated console. Specify a console name.
DMONITOR: Displays collection set information for all consoles receiving messages by monitor type.
DROUTCDE: Displays collection set information for all consoles receiving messages by routing code.
PRODUCT: Displays collection set information for a designated product. Specify the subsystem name of the product.
SOURCE: Displays collection set information for the console from which you issue the DISPLAY COLLECT command.
TSOUSER: Displays collection sets for one or more TSO users on the local system. Specify TSOUSER=ALL to display collection sets for all local TSO users or specify a user ID to display collection sets for one TSO user.

CONSOLE: Displays information for a designated console. Specify the name of this console.

DETAIL: Displays detailed information about a collection set or about outstanding messages. Note that DETAIL is a default value under certain conditions.

DMONITOR: Displays information for all consoles receiving messages by monitor type.

DOM: (Optional) Displays information about outstanding action messages. This information is displayed in message MIM3061 (if you specify DISPLAY DOM DETAIL) or in message MIM3062 (if you specify DISPLAY DOM SUMMARY).

DROUTCDE: Displays information for all consoles receiving messages by routing code.

GCMF

Tells CA MIM to display information about GCMF rather than any other facility. Specify this operand before the ALL, INIT, or OPTIONS operands. You also should specify the GCMF operand before any other operand that is truncated in such a way that it may be ambiguous with operands for other facilities.

Because GCMF is a positional operand, you must specify it before any other operand on the DISPLAY command.

INIT: (Optional) Displays information about the GCMF initialization values that are set through the GCMINIT statement. This information is shown in message MIM3031.

INSTREAM: Displays information about the link for instream sources.

INTERNAL: Displays information about the link for internal sources.

JOBNAME: Displays information about outstanding messages that have been issued by a designated job. Specify a job name in place of the jobid variable.

LINK

Displays information about linkages for the console, instream source, internal source, product, or TSO user you have specified. This information is shown in message MIM3016.

ALL

Displays linkages that enable local consoles, TSO users, and products to issue cross-system commands.

CONSOLE

Displays linkages that enable a designated console to issue cross-system commands. Specify a console name.

INSTREAM

Displays information about the link for instream sources.

INTERNAL

Displays information about the link for internal sources.

PRODUCT

Displays linkages that enable a designated product to issue cross-system commands. Specify the subsystem name of the product.

SOURCE

Displays linkage information for the console on which the DISPLAY LINK command was issued.

TSOUSER

Displays linkages that enable one or more TSO users on the local system to issue cross-system commands. Specify ALL or a TSO user ID.

Default: TSOUSER=ALL

MSGID: Displays information about outstanding messages that have a designated message ID. Specify the ID in place of the msgid variable.

OPTIONS

Displays information about the GCMF operating values set by the SETOPTION command. The GCMF OPTIONS information is shown in message MIM3030.

You can enter one or more of the following values for GCMF OPTIONS:

ACTIONPREFIX (ACTP): Displays the list of additional highlighted messages, in addition to the standard display.
ALL: Displays all GCMF operating values.
BROADCAST: Displays the value you entered on the SETOPTION command for routing broadcast messages to a defined list of systems.
EXCLUDEJOB (EXJ): Displays the list of job names used to unconditionally exclude messages from cross-system message routing, in addition to the standard display.
EXCLUDEPREFIX (EXP): Displays the list of message IDs used to unconditionally exclude messages from cross-system message routing, in addition to the standard display.
SAFSYSTEMS: Displays the systems supporting the system authorization facility.
SYSLOG: Displays the list of systems from which imported messages are being written to the system log, in addition to the standard display.
VALUES: Displays the GCMF operating values listed in the standard display.

Default: OPTIONS=VALUES

POOLCONSOLES: Displays information about the target consoles that are being used to execute cross-system commands. This information is shown in message MIM3065.

PRODUCT

Displays information for a designated product. Specify the subsystem name of that product in place of the ssname variable. For example, if RCS is the subsystem name for CA Remote Console, then you can display this information for CA Remote Console by specifying PRODUCT=RCS.

The default subsystem name for CA Remote Console is RCS, and the default subsystem name for CA OPS/MVS is OPSS.

SOURCE: Displays information for the console, product, or TSO user that issued this DISPLAY command. Note that SOURCE is a default value if you specify DISPLAY COLLECT from a TSO session or from a console.

SUMMARY

Displays summarized information about collection sets (when used with the COLLECT command), or about outstanding action messages (when used with the DOM command). Specify the SUMMARY operand only once per command, even when it qualifies two or more operands. For example, you can specify DISPLAY COLLECT LINK SUMMARY to display summary information about collection sets and linkages. You cannot specify the SUMMARY and DETAIL operands on the same command.

SUMMARY is a default value if you specify DISPLAY COLLECT ALL or DISPLAY DOM ALL.

TSOUSER

Displays information for one or more TSO users.

To display information for a single TSO user, specify the TSO user ID of that user in place of the userid variable. To display information for all TSO users, specify TSOUSER=ALL.

Usage Notes: DISPLAY GCMF Command

The DISPLAY command can be specified in the MIMCMNDS or MIMSYNCH member of the MIMPARMS data set. When you specify this command in the MIMCMNDS member and the TRACE feature is active, the output is sent to the MIM trace data set. When you specify this command in the MIMSYNCH member, the output is sent to the system log.
You also can issue the DISPLAY command from any console or TSO session.
You can specify several operands for GCMF on the same DISPLAY command (for example, DISPLAY LINK COLLECT). GCMF operands cannot be mixed with operands from other facilities, such as ICMF, on a single DISPLAY command.
The default for this command is OPTIONS=VALUES. However, the following values are defaults under certain circumstances:
- SOURCE is a default value when you specify DISPLAY COLLECT or DISPLAY LINK from a console or TSO session.
- VALUES is a default value when you specify DISPLAY OPTIONS.
- ALL is a default value when you specify DISPLAY DOM.
- SUMMARY is a default value when you specify DISPLAY COLLECT ALL or DISPLAY DOM ALL. Otherwise, DETAIL is a default value when you display COLLECT or DOM.

Example: DISPLAY GCMF Command

To display collection set information for the console named TAPE1, issue this command:

DISPLAY COLLECT CONSOLE=TAPE1