The SETOPTION MIM command lets you set operating values for general-purpose CA MIM functions.
This command has the following format:
SETOPTION MIM [AUTHCHECK=hours]
[CELLTRACE={NO|YES}]
[CFSIZEWARN=percent]
[CMDPREFIX={cmdprefix}NONE}]
[CMDRESPMAX={nnnnn|NONE}]
[CMDTIMEOUT={time|NONE}]
[CONSOLE={(userid1,userid2,…)|*NONE}]
[CTCVERIFY={minutes|NONE}]
[CYCLES=intervals]
[EXIT=(name [FAILURE=] {DISABLE|ENABLE}
{DUMP|NODUMP}
[LOAD [modulename]]
[PROTECT={NO|YES}]
[STATUS={ACTIVE|INACTIVE}] )]
[HIBERNATE={minutes|NONE}]
[INTERVAL=seconds]
[LOCALSTOP={ABEND|NOABEND}]
[LOCKOUT=seconds]
[LOGOFF={NO|YES}]
[MARGIN=seconds] <<add MAXQUEUED??>>
[MIHINTERVAL={seconds|NONE}]
[RESETPRINT=(options)]
[RESETTRACE=(options)]
[SETPRINT=(options)]
[SETTRACE=(options)]
[SHUTDOWN={DUMP|FREE|GLOBAL|LOCAL}]
[TRACE[=(ALLOCATE[CLASS=class])
{OFF|ON}
(SPIN [CLASS=class])]]
[VCDEBUG={OFF|ON}]
[VCFFORCE={minutes|NONE}]
[VCFMAXDELAY=seconds]
[VCFMINDORM=milliseconds]
[VCFRECOVERY={seconds|NONE}]
(Optional) Specifies the number of hours for CA MIM to wait before rechecking its authorization statements. CA MIM checks the LMP product license keys at startup to see if any of its licenses are about to expire. CA MIM also performs periodic license key checks. Specify a value from 1 to 23 (integers only) in place of the hours variable.
When you issue a SETOPTION AUTHCHECK command, CA MIM automatically checks its authorization statements and issues the appropriate authorization messages.
Note: For information on how to specify LMP license keys for CA MIM, see the Installation Guide.
Default: AUTHCHECK=23
Note: If you would like to use the one hour checking interval that is implemented in the CA VM:Manager Management Suite of products, set this parameter to a value of 1.
(Optional) Controls the CA MIM cell pool internal trace. It should always be set to NO, unless CA Technical Support tells you to set this parameter to YES.
Default: CELLTRACE=NO
(Optional) Defines the control file space usage threshold percentage above which CA MIM is to issue a warning message. Specify a value from 1 to 100 (integers only) in place of the percent variable.
Note: For more information, see the chapter “Advanced Topics” in the CA MIM Programming Guide.
Default: CFSIZEWARN=50
Determines what command prefix is used. You can specify a one- to eight- character prefix in place of the MI prefix in the command text when you direct a CA MIM command to a z/VM system through the CA MIC component. This cannot be used locally to issue CA MIM commands. Specify a prefix in either character or hexadecimal format, or specify NONE.
Note: For details about the content of the command prefix character string, see the appendix, “Valid Characters for CMDPREFIX.”
Default: CMDPREFIX=@
(Optional) Specifies the threshold limit of command responses to any given CA MIM command response. The value will either be the character string NONE or a number between 20 and 32767.
If a given command generates responses over the CMDRESPMAX threshold, then the command response will be truncated and message MIM0640W is issued as the final data line of the truncated command response.
Default: 2048
(Optional) Controls the number of seconds any CA MIM command is permitted to execute before it is canceled. This helps prevent a command from permanently hanging the CA MIM command task. Valid values are the character string NONE or the number of seconds between 10 and 300.
Default: CMDTIMEOUT=60
Allows you to specify as many as eight alternative user IDs to receive operational messages when the virtual console of CA MIM is disconnected. Each time you issue the SETOPTION CONSOLE command, the new list of users replaces the old list. To disable this feature, specify a user ID of *NONE.
Default: CONSOLE=*NONE
(Optional) Determines how often CA MIM checks device status after a soft error occurs. If you do not want CA MIM to check the CTC paths for errors, then specify NONE. However, we recommend that you do specify a value for this operand.
To have CA MIM check CTC paths for error-free status, indicate the number of minutes for the checking interval. The minimum is 1 minute and the maximum interval is 1440 minutes (24 hours).
The CTC path marked in error cannot be used again until a CTC RESET command is issued or CA MIM determines that the path is error-free.
Note: Use the MIHINTERVAL operand to eliminate IOS071I messages that occur due to device verification. The MIHINTERVAL value should always be less than the CTCVERIFY value. Keep in mind that the CTCVERIFY value is set in minutes, while the MIHINTERVAL value is set in seconds.
Default: CTCVERIFY=2
(Optional) Determines how many service intervals are in a service cycle. CA MIM uses service cycles to determine how often to access control files if none of its global facilities have transactions for other systems. Specify a value from 1 to 100 (integers only) in place of the intervals variable.
Note that this operand uses service intervals as a unit of measurement. The number of seconds per service interval is set through the INTERVAL operand. Therefore, it is the product of the CYCLES and INTERVAL operands that determines how many seconds pass before CA MIM accesses the control files.
Note: For more information, see the description of the MODE operand. For more information on CA MIM performance considerations, see the chapter “Advanced Topics” in the CA MIM Programming Guide.
Default: CYCLES=1
|
Copyright © 2014 CA.
All rights reserved.
|
|