The following paragraphs describe Aion MAES runtime parameters. The parameters are presented in alphabetical order.
CPUTIME=cputime
You can specify the maximum CPU time allowed between terminal interactions before MAES abends or times out a consultation. The value is expressed in base 10 as a 1 to 8-character string of numeric digits, with a decimal point optional.
MAES starts the timer when it receives user input from the transaction driver. MAES stops the timer when the next output screen is sent to the transaction driver. If the timer runs out before MAES sends the next screen to the transaction driver, the consultation ends with a user abend 4000. The default is five (5) seconds. You can change the value using the MODIFY command.
BUSYPCTLVL=nn
Health Checker uses this parameter to measure response threhold. The default is 20, which means a 20% busy response threshold.
DEBUGKB=[YES|NO]
MAESDBUG is to be called when errors occur during MAES processing. MAESDBUG helps you locate and correct errors that occur during the execution of MAES.
For example, if MAES is unable to establish a connection to VTAM, MAESDBUG interprets the error code and offers suggestions about how to resolve the problem. If the value of the MAESLOG runtime parameter is YES, the output of MAESDBUG is written to the MAESLOG data set. (We recommend that you route the information to SYSOUT rather than to a permanent data set.)
DIVLOGDS=dataset.name
This parameter specifies the Z/OS data set name for the MAES log. This parameter is required. DIVLOGDS cannot be allocated to an SMS managed volume. Use DFSMS to force allocation to a non-SMS managed volume.
The data set name can be up to 37 characters, with a final qualifier of six characters or less. MAES adds a two-character numeric suffix to the final qualifier for dataset series and there is an implicit "DATA" that VSAM adds to the end of the dataset. For example:
SYS2.AION.MAES.MLOG
Becomes:
SYS2.AION.MAES.MLOG00 DIVLOGSZ=nnnn
This parameter specifies the size of the MAES log in 4K blocks. This parameter is required.
This number must be a multiple of 16. If you specify a number that is not a multiple of 16, MAES converts it internally (for example, 500 becomes 496).
One 4K block can contain 32 messages. For example, a DIVLOGSZ of 496 holds 15872 messages.
ESTAE=[YES|NO]
You can turn off the ESTAE and SPIE functions that are issued by MAES. This prevents MAES from doing a controlled shutdown if an abend occurs. It is most useful in debugging a program check. If ESTAE=YES (the default) is specified, the actual abend is masked, making debugging more difficult. If ESTAE=NO, then MAXABEND=1.
Note: ESTAE must equal YES when VTAM Generic Resource support is being used in order to ensure that the MAES shutdown routine gets control and is able to delete VTAM affinities. If ESTAE is set to NO, MAES's shutdown routine will be unable to get control during abnormal MAES terminations and VTAM will be unable to reroute connected GR clients to other MAES systems.
GRNAME=vtamgrid
This parameter allows the systems programmer to specify the name of a VTAM Generic Resource (GR) pool that MAES should participate in. The default value is MAESGR. You can override the name for the following reasons:
The value specified for vtamgrid cannot be longer than eight characters. Do not make an entry for vtamgrid in the VTAM tables. VTAM will dynamically provide any required definitions.
IPPORT=nn
This parameter identifies the TCP/IP port number that MAES uses to establish TCP/IP connections. In TCP/IP terms, MAES listens on this port.
IPTASKS=nn
This parameter sets the number of concurrent TCP/IP components that can be started in the MAES region. If not specified, TCP/IP components cannot be run.
IPSTACK=IPV4 | IPV6 | ANY
This parameter identifies whether MAES TCP/IP components will use IPV4 communications protocols only, IPV6 communications protocols only, or both IPV4 and IPV6 communications protocols. The default, when the IPSTACK parameter is omitted, is ANY.
ITRACE=nnn
ITRACE defines the number of internal trace entries MAES maintains per VTAM session. The internal trace is used by CA Aion BRE support for debugging purposes. The default is 10. A value of zero disables the internal trace.
KILLMAES=[YES|NO]
This parameter determines whether a user running the MAES monitor can terminate MAES from there. If set to NO, the KILLMAES parameter takes no effect. The default is YES.
Note: Because Monitor is an application that runs in the MAES region, the MAES monitor subtask abends with a consultation error when you terminate MAES using the KILLMAES parameter. This method of terminating MAES can result in an A03 abend that could prevent other steps in the MAES job from running.
MAESLOG=[YES|NO|(errn-errn,…,errn-errn)|LOG_#S]
A low‑level logging facility is built into MAES to aid in debugging message traffic. The output from this log is written to the MAESLOG data set. (We recommend that you route the information to SYSOUT rather than to a permanent data set.) This log is particularly useful when Aion Support is required to help solve a problem.
Since this log can produce a great deal of information, it is recommended that MAESLOG=YES (the default) be specified for non‑production systems. However, should a problem arise in a production environment, this log can be of value while troubleshooting.
If you want to limit the range of error messages produced, you can define a range of log numbers for the MAES log to show when these specific errors occur. For example, the following command specifies that MAES write only the errors having the codes 1-1000 and 3000-4000 to the MAES log:
MAESLOG=(1-1000,3000-4000)
To return only component messages, specify the following:
MAESLOG=(18000-19000)
If you wish to omit specific message numbers from the set to be printed, you must first specify:
MAESLOG=NO
Specify all the numbers you wish to be printed. Otherwise, all modifications add to the list.
You can change the value using the MODIFY command.
MAXABEND=nn
MAES uses this value to determine the number of MAES abend conditions that can occur before MAES terminates.
Using MAXABEND, you can specify the number of MAES abend conditions that MAES should ignore before it terminates with an error. Consultation abends are not affected by MAXABEND. If the execution parameter ESTAE=NO, then MAXABEND=1.
The default is 10. The MODIFY command allows you to change the value.
MAXTASKS=nn
MAES uses the value you specify to control the number of concurrent consultations allowed at any given time.
This number includes not only active consultations, but suspended consultations. If a consultation start request is made after the maximum number of tasks is reached, the requester is given a status message and the consultation request is rejected.
The default is 10. MAXTASKS cannot be changed using the MODIFY command.
MTAR=[YES|NO]
When the MAESMTAR DD statement is included in the MAES JCL, the MAES parameter can used to activate MAES Timing Analysis. Specify MTAR=YES as a MAES runtime parameter when you activate MAES.
NODENAME=applid
This parameter allows the systems programmer to override the default VTAM application identifier name (applid). You can override the name for the following reasons:
The value specified for applid cannot be longer than eight characters, and must match the entry in the VTAM tables.
PGMSEC=(initpgm,checkpgm)
The PGMSEC keyword is used to identify one program that is called during MAES initialization, and another that is called during knowledge base initialization. The intent of these two programs is to provide a level of security that can prevent certain users from executing one or more programs. The most obvious use would be to restrict use of the MAES monitor to a set of developers.
The checkpgm specification is mandatory; the initpgm specification is optional.
PMEMBER=pds.member.name
You can specify execution parameters without using the EXEC statement or the MODIFY command. Do this by capturing the appropriate (desired) parameters as members of a PDS associated with the MAESPARM DD statement.
For example, you might have a set of MAES log specifications that you want to use for debugging at a certain time of day. At the same time, you want to change the wait time limit for a consultation to allow for longer periods. Assume you have coded the following entry and put it into a member named OVERNITE in the PDS associated with the MAESPARM DD statement:
MAESLOG=(1-3000,5001,6000-9000) TIME=2000
At the appropriate time, the console operator types the following statement:
MODIFYjobname,PMEMBER=OVERNITE
Assuming the MAESPARM DD statement is present in the MAES JCL, the member OVERNITE is read and interpreted, and new values are set. If there is no MAESPARM DD statement, the request fails.
PMEMBER can be embedded within other members. Assume, for example, that you have a member named HOLIDAY, which is coded as follows:
CPUTIME=10.00 PMEMBER=OVERNITE
The CPUTIME is set to 10 seconds and the OVERNITE member is read and interpreted.
You can change the value of PMEMBER using the MODIFY command.
Note: MAES recursively processes all PMEMBERs during startup. In the case where the multiple PMEMBERS parameters are defined, during MAES startup, the parameter values will be set to the values contained in the last PMEMBER processed not the first.
ROUTCDE=nn
Certain actions within MAES produce operating system WRITE TO OPERATOR (WTO) requests. If, for example, the operator modifies the MAES job using the MODIFY command, completion information is presented as a WTO.
Using the ROUTCDE operand, you can direct the output to an appropriate destination. Values can be between 1 and 16, inclusive. ROUTCDE=11 writes the messages to the job log. This is commonly called a WRITE TO PROGRAMMER request.
The format of the operand is:
ROUTCDE=nn
or
ROUTCDE=(nn,nn,...,nn)
The default is 11. You can change the value using the MODIFY command. Consult your systems programmer for specific route codes used for your installation.
SEC=progname
The SEC parameter allows you to specify the name of a program that will be called every time a consultation is initiated. The user‑written program must be re-entrant, and will be loaded at MAES initialization and then called by SAES or SADS (Subtasking Aion Development System).
The intention of this program is to allow a user-written security program to set the security environment so that subsequent data set allocations or OPENs will acquire the security authorizations of the user who is executing the consultation. The user-written program is passed to the user ID as it was retrieved by the ATD in CICS/VS, IMS/VS, or TSO. With this information, the user‑written program can invoke the correct security function to establish that ID as the user‑of‑record for any dynamic data set allocations, or data set OPENs required by the knowledge base.
If remote DB2, remote VSAM, or DL/I is used exclusively, security is managed in the CICS/VS or IMS/VS environment. If nonremote VSAM, QSAM, or DB2 functions are used by the knowledge base, security needs to be established for the user.
Note: If security has not been established, the user ID will be blank.
STATINT=hhmmss.th
The STATINT execution parameter sets the statistics‑gathering time interval. The value is expressed as hhmmss.th, where:
is hours.
is minutes.
is seconds.
is tenths and hundredths of a second.
A zero value disables the statistics gathering function. The default is 00003000. You can change the value using the MODIFY command.
TASKMEM=nnnn[M|K]
TASKMEM sets the upper boundary on the amount of virtual memory a given application can acquire. This memory is not preallocated, and is outside of any user-coded program storage requirements.
The storage requirements of lists of items, records, and other information a knowledge base might specify, will be counted until the next request would exceed the limit specified by the TASKMEM parameter. When the limit is exceeded, the consultation is ended abnormally, and a status message is sent to the session partner.
The purpose of this parameter is to prevent a condition where a consultation will run today, but would fail tomorrow because of the requirements of other concurrent consultations. Use of this runtime parameter allows the systems programmer to better balance the requirements of different knowledge bases that are contending for storage in the same address space.
Approximately 10KB of storage is acquired for each consultation by operating system services. That 10KB is not counted when MAES is monitoring the storage requests.
Valid values for this keyword are nnnn, nnnnM, or nnnnK, where nnnn is a number. K indicates the number of 1024‑byte blocks of memory available to the consultation, and M is the number of 1MB blocks of memory available. The default is 1M.
TIME=nnnn
MAES allows you to set a limit on the amount of time a process waits for the user to respond with the next input. The time is specified as the number of seconds SAES will wait between a message sent to its session partner and a message is returned to SAES. When this time is exhausted, the process is terminated and its resources are returned to MAES. Typically, this parameter would be used if the resources available to MAES are limited and you want to ensure that processes are not idle for extended periods.
If you wish to disable the wait time function altogether, you can specify:
TIME=0
If you specify TIME=0, MAES will not monitor process wait time, allowing a user to begin a process and then perform some other activity before returning to the process. You may find this an appropriate setting if any of your applications use the consultation pause function described in the section on Message Switching.
The default is 900 SECONDS/15 MINUTES.
VERCHK=[YES|NO]
If the VERCHK=YES is specified, MAES will compare the version of MAES against that of the transaction driver (that is, AAES or IAESTD) attempting to initiate a consultation. If the versions do not match, MAES rejects the consultation request.
In some circumstances, an earlier or later version of a transaction driver will function properly with the current version of MAES. However, if an application depends on the presence or absence of certain features in the transaction driver, this switch ensures that the two components are compatible.
The default is VERCHK=YES. You can change the value using the MODIFY command.
WTOR=[YES|NO]
By specifying WTOR=YES, the following message will be displayed on the operator console:
MAES - ENTER 'T' TO TERMINATE MULTI-TASKING AES
By specifying WTOR=NO, the WTOR will not be displayed. The default is YES.
|
More Information: |
| Copyright © 2009 CA. All rights reserved. | Email CA about this topic |