CA MII Statements and Commands › (MII) ALTER Command-Modify QNAME Attributes

(MII) ALTER Command-Modify QNAME Attributes

The ALTER command lets you modify certain attributes of a QNAME in your QNAME list, which provides GDIF, ECMF, or both with information on how to handle ENQ and RESERVE requests for classes of resources. This command is available only when you are running the GDIF or the ECMF of the CA MII component.

The ALTER command affects only the system on which it is issued. You cannot add or delete QNAMEs from the list by using this command.

Scope: Local

This command has the following format:

ALTER QNAME=qname [ECMF={NO|YES}]
                  [REPORTAFTER=seconds]
                  [REPORTCYCLE=seconds]
                  [TRACE={ALL | CONFLICT | NONE}]

ECMF

Indicates whether ECMF should issue messages when a conflict occurs for one of these resources. Specify NO or YES.

QNAME

Identifies the QNAME statement that you are modifying. The statement must appear in your QNAME list already. Specify the QNAME for this statement in place of qname.

You can specify this QNAME in either character or hexadecimal format. For example, you can specify QNAME=A123 or QNAME=X'C1F1F2F3'. If you use character format and the QNAME contains embedded blanks, then enclose that QNAME in single quotation marks.

REPORTAFTER

Indicates how many seconds ECMF should wait before issuing the first conflict message when an ENQ conflict occurs. Specify a value from 0 to 999 (integers only) in place of seconds.

You can use the abbreviation RPTAFTER for this operand.

REPORTCYCLE

Indicates how many seconds ECMF should wait before reissuing conflict messages when an ENQ conflict occurs. Specify an integer from 0 to 600 in place of seconds. A value of zero results in a single conflict message being issued. You can use the abbreviation RPTCYCLE for this operand.

TRACE

Indicates what type of trace information should be collected by GDIF for these resources. Specify one of these values on the TRACE operand:

ALL

Collects information about ENQ requests, RESERVE requests, and conflicts for these resources.

CA MII tracing must be active in order to collect this information. You can activate this feature through the SETTRACE operand on the SETOPTION command.

CONFLICT

Collects information about conflicts for these resources.

CA MII tracing must be active to collect this information. You can activate this feature through the SETTRACE operand on the SETOPTION command.

NONE

Indicates that you do not want trace information.

Usage Notes: ALTER Command

• The ALTER command usually is issued from a console, rather than from the MIMPARMS data set.
• You must be authorized to issue system control commands to issue the ALTER command. TSO users generally are not authorized to issue system control commands.
• You can specify any combination of the ECMF, REPORTAFTER, REPORTCYCLE, and TRACE operands on the same ALTER command.
• For more information, see the descriptions of the ADDQNAME command and the DELQNAME command.

Examples: ALTER Command

• To receive conflict messages every 20 seconds for resources when the QNAME SYSDSN is specified on the ENQ or RESERVE request, issue this command:

  ALTER QNAME=SYSDSN ECMF=YES REPORTAFTER=20 REPORTCYCLE=20
  

• To collect information about conflicts and requests on which the QNAME SYSZ TSS is specified, issue the following command:

  ALTER QNAME='SYSZ TSS' TRACE=ALL