Enhanced Commands › Issuing an Enhanced Command › Enhanced Command Syntax (INQuire)

Enhanced Command Syntax (INQuire)

To make an inquiry on the specified MUFs, URTs, or on the CA Datacom/DB tables within specified URTs across CICS systems, enter an enhanced command in the following format. The command can include a CICS System ID entry (SYSid) to apply the inquiry to a remote CICS system or extend it to all systems in the MRO environment. If not specified, the command applies to the local system only. The command can also include a MUF SID name (SIDname) to apply to and limit the URT or TBL inquiry by MUF.

►►─ transaction-ID ─ INQuire,level-limit ─┬────────────────┬──────────────────►◄
                                          └─ ,SYSid(aaaa) ─┘

Note: The values for SYSid,level-limit, and SIDname parameters can be entered in any order.

►►─┬─┬─ ,URT(nnnn) ─┬─┬─ AUTO ────┬─┬──────────────────────┬─┬────────────────►◄
   │ └─ ,TBL(nnnn) ─┘ ├─ CLOSE ───┤ └─ ,SIDname(xxxxxxxx) ─┘ │
   │                  ├─ CLOSING ─┤                          │
   │                  ├─ DEFer ───┤                          │
   │                  ├─ DYN ─────┤                          │
   │                  ├─ NOCSD ───┤                          │
   │                  ├─ OPEN ────┤                          │
   │                  ├─ OPENING ─┤                          │
   │                  ├─ PLT ─────┤                          │
   │                  └─ SQL ─────┘                          │
   └─┬ ,MUF(nn)    ────────┬─┬─ CONnect ───────┬─────────────┘
     ├  MSIDname(*)        ┤ ├─ CONNECTING ────┤
     └─ MSIDname(xxxxxxx*) ┘ ├─ DISconnect ────┤
                             ├─ DISCONNECTING ─┤
                             ├─ UNConnected ───┤
                             └─ STATS ─────────┘

Note: AUTO, DEFER, and PLT are valid with all objects (MUF, MSIDname, URT, and TBL). NOCSD is not valid with a MUF (MSIDname) or TBL command.

transaction-ID

Specifies the transaction ID defined in the CICS System Definition file (CSD), for invoking CA Datacom CICS Services functions to monitor and control resources in an MRO environment. Default transaction IDs are:

DBEC

Precedes an enhanced command to perform an action or make an inquiry.

DBEX

Precedes an enhanced command to make an inquiry, which invokes a formatted display.

INQuire

Indicates the command is an inquiry. (INQ and I are valid abbreviations.)

,level-limit

Specifies whether the display is at the MUF-level, URT-level, or Table-level, and the MUFs or URTs to display.

Note: The MUF(nn) parameter or the MSIDname(xxxxxxxx) parameter should not be used to qualify the MUF. If both are specified, then the MUF object is used and MSIDname is ignored.

MUF(nn)

Specifies the display is at the MUF-level and show all matching MUFs.

MSIDname(*) or MSIDname(x*) can be used in place of MUF(??)

MSIDname(xxxxxxxx)

Specifies the display is at the MUF level and show all matching MUFs.

URT(nnnn)

Specifies the display is at the URT-level and show all matching URTs.

TBL(nnnn)

Specifies the display is at the Table-level and shows all table information for matching URTs.

The limit specifies how to limit the display in URTs, tables, or MUFs. Specify limits to the display of URTs or tables for the following categories:

Limits to the display of MUFs can be specified for the following categories:

,SIDname(xxxxxxxx)

(Optional) Specify one specific SID name to which the URT inquiry applies by MUF. Alternately, specify any number of leading characters of SID names followed by an asterisk (*) to specify a range of SID names to which the URT inquiry applies by MUFs. If not specified, the command applies to all MUFs. (Omit for commands with MUF(nn).) This option is only available with URT(nnnn) and TBL(nnnn) commands. (SID is a valid abbreviation.)

,SYSid(aaaa)

(Optional; not used for local systems) Specify one remote CICS system ID to which the inquiry applies or * to specify all systems in the MRO environment. (SYS is a valid abbreviation.)