ASCHDATA SUMMARY subcommand output
The ASCHDATA SUMMARY report displays information about a specific
scheduler class or about all scheduler classes. For each scheduler
class, the ASCHDATA summary report displays the following topics:
- Status of Scheduler
- Subsystem Name
- Default Class
- Generic Initiators
- Class
- Status of Class
- Maximum Number of Initiators
- Minimum Number of Initiators
- Expected Response Time
- Message Limit
- Jobs Waiting for Execution
- Total Active Initiators
- Total Active Waiting MULTI_TRANS Initiators
- Total Idle Initiators
- Status of Scheduler
- The status of the APPC/MVS transaction scheduler address space,
ASCH, at the time of the dump was one of the following:
- STARTUP
- The ASCH address space was being initialized at the time of the dump.
- ACTIVE
- At the time of the dump, the ASCH address space was fully initialized and capable of processing transactions.
- NOT ACTIVE
- At the time of the dump, the ASCH address space was unable to process transactions.
- TERMINATION/RESTART
- The system ended the ASCH address space because of a critical error. At the time of the dump, the ASCH address space was in the process of restarting itself.
- TERMINATION/NORESTART
- The system ended the ASCH address space in response to one of
the following:
- The operator entered a CANCEL command
- The operator entered a FORCE command
- A critical error
- UNKNOWN
- At the time of the dump, the status of the ASCH address space could not be determined.
- Subsystem Name
- The subsystem to which all newly created APPC transaction initiators are assigned. If neither JES2 nor JES3 is required to run APPC transaction initiators, the subsystem name is either MSTR or the contents of parmlib member IEFSSNxx.
- Default Class
- The default class is the scheduling class assigned to TPs when no class is specified in the TP profile. The default class is named in the OPTIONS statement of an ASCHPMxx parmlib member.
- Generic Initiators
- Generic initiators are APPC initiators that temporarily are not associated with any class because there is a lack of APPC work requests. This field appears only when generic initiators exist.
- Class
- The scheduler class. A scheduler class determines the processing characteristics for a job. Processing characteristics include the expected response time and the number of initiators for the class. Classes are defined in the ASCHPMxx parmlib member. Each class has a class name, maximum number of initiators, minimum number of initiators, and expected response time goal. The class in which a job will run is specified in the TP profile. The class name from the TP profile must match a class name defined in an ASCHPMxx parmlib member.
- Status of Class
- The status of an APPC/MVS transaction scheduler class at the time
of a dump is one of the following:
- Active
- The scheduler class was processing jobs.
- In termination
- The scheduler class was ending.
- Unknown
- The status of the scheduler class could not be determined.
- Maximum Number of Initiators
- The maximum number of initiators is the highest number of initiators allowed to process jobs in a particular class. The number of initiators available to process jobs, together with the expected response time, determines how quickly work is processed. The minimum number of initiators is the number that must be available at all times for the class. If the maximum and minimum numbers of initiators are too high for the amount of processing required, initiators stand idle. If the numbers of initiators are too low for the amount of processing required, excessive paging results and work is delayed. The maximum number of initiators for a class is specified in the ASCHPMxx parmlib member.
- Minimum Number of Initiators
- The number of initiators available to process jobs together with the expected response time, determines how quickly work is processed. The maximum number of initiators is the highest number of initiators allowed to process jobs in a particular class. The minimum number of initiators is the number that must be available at all times for the class. If the maximum and minimum numbers of initiators are too high for the amount of processing required, initiators stand idle. If the numbers of initiators are too low for the amount of processing required, excessive paging results and work is delayed. The minimum number of initiators for a class is specified in the ASCHPMxx parmlib member.
- Expected Response Time
- The expected response time for a class is the maximum amount of time it should take to process each job. The response time, in addition to the maximum and minimum number of initiators, determines how quickly jobs are processed. Response time appears in hours:minutes:seconds.microseconds format. The expected response time for a class is specified in the ASCHPMxx parmlib member.
- Message Limit
- Message limit is the maximum size of the job log for TPs in a particular class of initiators. The size is displayed as the number of 133-byte messages the job log can contain for this class. The message limit for a class is specified in the ASCHPMxx parmlib member.
- Total Number of Jobs Waiting for Execution
- The total number of jobs waiting for execution is the number of jobs on the APPC/MVS transaction scheduler queue waiting for a free initiator.
- Total Number of Active Initiators
- Active initiators are the initiators processing jobs. The total number of active initiators cannot exceed the maximum number of initiators specified for the class in the ASCHPMxx parmlib member.
- Total Number of Active Waiting MULTI_TRANS Initiators
- Active waiting MULTI_TRANS initiators are initiators that are waiting for multi_trans work for this class. When a TP is scheduled as MULTI_TRANS, an environment is created to obtain multiple calls for the TP. Resources remain available and the TP remains initialized for all requests. If there are no requests to run the TP, the MULTI_TRANS initiator will wait for a period of time. Eventually if no work comes in, resources are cleaned up and the TP ends. The initiator then becomes available to run any type of work for this class.
- Total Number of Idle Initiators
- Idle initiators are the initiators available to process any type of work for this class. If initiators for a class remain idle, eventually the total number of initiators for the class will decrease, but the total number of initiators will never drop below the minimum number of initiators specified for the class.