Previous Topic: QNAME.SL VariableNext Topic: TAPE Function


QNAME.QNM.n

This set of variables contains detailed conflicts, ENQ, and RESERVE information. A variable set is created for every QNAME entry that matches the selection criteria specified by the QINFO and NAMELIST command options. The trailing element of the stem name is a sequence number starting with 1 and incremented by 1 for each variable created. Internal processing checks for the managed QNAMES first, non-managed QNAMES second. So, when non-managed QNAMES are desired, their sequence numbers will be the highest. If multiple names are specified within the NAMELIST keyword, sequence number incrementing continues across names.

The sequence of individual elements in these variables is as follows:

1

Contains the name of the QNAME entry, which can be up to eight characters.

2

Contains the number of ENQ requests since last reset.

3

Contains the number of ENQ processed since last reset.

4

Contains the number of RESERVE requests since last reset.

5

Contains the number of RESERVE processed since last reset.

6

Contains the number of conflicts since last reset.

7

Contains the number of ENQ requests since last restart.

8

Contains the number of ENQ processed since last restart.

9

Contains the number of RESERVE requests since last restart.

10

Contains the number of RESERVE processed since last restart.

11

Contains the number of conflicts since last restart.

12

QNAME type, valid values are:

Note: Items 2-11 above are all expressed as numeric strings up to 9 characters long, with leading zeroes removed, or 0 if empty.

Example 1: Request information for QNAME SYSABCDE

To requested information for QNAME SYSABCDE only, regardless if it is managed or not, the CA MIM subsystem name is not known so the default MIMD is used, and the desired stem is SYST, enter the following:

ADDRESS MIM “QNAME 'NAMELIST(SYSABCDE)' 'STEM(SYST)'”

If the name SYSABCDE does not exit, return code 11 results. If it does exist, REXX variables SYST.SL and SYST.QNM.1 are created.

Example 2: Request QNAME information for all non-managed entries

To request QNAME information for all non-managed entries, and the default system and stem names are acceptable, enter the following:

ADDRESS MIM QNAME QINFO(NM)

If no non-managed QNAME entry is found, the return code is 10. Otherwise, it is 0, the REXX variable QNAME.SL returns with one each for every QNAME entry found. The names start with QNAME.QNM.1, then progress to QNAME.QNM.2, and so on.

Example 3: Request QNAME information for name ENQTEST

To request QNAME information for name ENQTEST when tracing is activated to display the REXX variables only, and the QNAME ENQTEST is serviced only by the CA MIM subsystem MIMT, enter the following:

ADDRESS MIM “QNAME 'NAMELIST(ENQTEST)' 'DEBUG(YES)' 'DISPLAY(VAR)'
'SYSTEM(MIMT)'”

Return code 10 may result if the CA MIM system MIMT is not active.

Example 4: Request SYS* managed entries

To request information on all managed entries with names starting with SYS*, and the specific entries SVTS and KEESPIN, enter the following:

ADDRESS MIM QNAME NAMELIST(SYS*,SVTS,KEESPIN)

If at least one entry matches the selection criteria, the return code is 0, along with the appropriate REXX variables. If no QNAME entry is found, the return code is 11.

Example 5: Request header information

To request only the header information in the REXX variable STEM.SL, with the default stem name QNAME, enter the following:

ADDRESS MIM QINFO(NONE)