Autoinstall statistics

This is the DFHSTUP listing for terminals that are connected, while the system is running, by means of the autoinstall facility. These statistics are obtained as interval, end-of-day, or requested statistics. CICS® also records unsolicited autoinstall statistics, which DFHSTUP prints in a separate report; see Types of statistics data.

This section contains the following statistics:

Autoinstall: Global statistics - Local definition

These statistics are available online using the EXEC CICS COLLECT STATISTICS AUTOINSTALL command, and are mapped by the DFHA04DS DSECT.

Table 18. Autoinstall: Global statistics - Local definition
DFHSTUP name Field name Description
Autoinstall attempts A04VADAT is the number of eligible autoinstall attempts made during the current session of CICS to create terminal entries as users logged on. For an attempt to be considered eligible, CICS and VTAM® must not be terminating, autoinstall must be enabled, and the terminal type must be valid for autoinstall (not pipeline, LU6.1, or LU6.2 parallel sessions).

Reset characteristic: reset to zero

 

Rejected attempts A04VADRJ is the number of eligible autoinstall attempts that were subsequently rejected during the current session of CICS. Reasons for rejection can be maximum concurrency value exceeded, invalid bind, the user program has rejected the logon, and so on. If this number is unduly high, check the reasons for rejection.

Reset characteristic: reset to zero

 

Deleted attempts A04VADLO is the number of deletions of terminal entries as users logged off during the current session.

Reset characteristic: reset to zero

 

Peak concurrent attempts A04VADPK is the highest number of attempts made during the current session to create terminal entries as users logged on at the same time.

Reset characteristic: reset to current value

 

Times the peak was reached A04VADPX is the number of times when the highest number of attempts were made during the current session to create terminal entries as users logged on at the same time.

Reset characteristic: reset to 1

 

Times SETLOGON HOLD issued A04VADSH is the number of times that the SETLOGON HOLD command was issued during this run of CICS. CICS issues the VTAM SETLOGON HOLD command when the maximum number of concurrent autoinstall requests allowed (the AIQMAX= system initialization parameter) is exceeded.

Reset characteristic: reset to zero

 

Queued logons A04VADQT is the number of attempts that were queued for logon due to delete in progress of the TCTTE for the previous session with the same LU.

Reset characteristic: reset to zero

 

Peak of queued logons A04VADQK is the highest number of logons that were queued waiting for TCTTE deletion at any one time. If this is unduly high, consider increasing the delete delay interval parameter of the AILDELAY system initialization parameter.

Reset characteristic: reset to current value

 

Times queued peak reached A04VADQX is the number of times this peak was reached.

Reset characteristic: reset to 1

 

Autoinstall: Global statistics - Remote definitions - shipped terminal statistics

Table 19. Autoinstall: Global statistics - Remote definitions - shipped terminal statistics
DFHSTUP name Field name Description
Delete shipped interval A04RDINT is the currently-specified time delay, in the form hhmmss, between invocations of the timeout delete transaction that removes redundant shipped terminal definitions. The value is set either by the DSHIPINT system initialization parameter, or by a subsequent SET DELETSHIPPED command.

Reset characteristic: not reset

 

Delete shipped idle time A04RDIDL is the currently-specified minimum time, in the form hhmmss, that an inactive shipped terminal definition must remain installed in this region, before it becomes eligible for removal by the CICS timeout delete transaction. The value is set either by the DSHIPIDL system initialization parameter, or by a subsequent SET DELETSHIPPED command.

Reset characteristic: not reset

 

Shipped terminals built A04SKBLT is the number of shipped remote terminal definitions installed at the start of the recording period, plus the number built during the recording period. (which equates to the sum of "Shipped terminals installed" and "Shipped terminals timed out").

Reset characteristic: reset to number of skeletons installed

 

Shipped terminals installed A04SKINS is the number of shipped remote terminal definitions currently installed in this region.

Reset characteristic: not reset

 

Shipped terminals timed out A04SKDEL is the number of shipped remote terminal definitions deleted during the recording period by the TIMEOUT transaction.

Reset characteristic: reset to zero

 

Times interval expired A04TIEXP is the number of times the delete shipped interval (A04RDINT) expired since the start of the recording period.

Reset characteristic: reset to zero

 

Remote deletes received A04RDREC is the number of old-style (pre-CICS/ESA 4.1) remote delete instructions received by this region since the start of the recording period.

Reset characteristic: reset to zero

 

Remote deletes issued A04RDISS is the number of old-style (pre-CICS/ESA 4.1) remote delete instructions issued by this region since the start of the recording period.

Reset characteristic: reset to zero

 

Successful remote deletes A04RDDEL is the number of shipped terminal definitions deleted from this region because of old-style remote delete instructions, since the start of the recording period.

Reset characteristic: reset to zero

 

Total idle count A04TIDCT is the total number of times that all previously used remote terminal definitions (whether deleted from the system or currently in the system) had been idle awaiting reuse.

This number does not include the remote terminal definitions currently idle awaiting reuse (see A04CIDCT).

Reset characteristic: reset to zero

 

NOT IN THE DFHSTUP REPORT A04TIDLE is the total time (expressed in STCK units) that all previously used remote terminal definitions (whether deleted from the system or currently in the system) had been idle awaiting reuse.

This number does not include the remote terminal definitions currently idle awaiting reuse (see A04CIDLE).

Reset characteristic: reset to zero

 

Average idle time is the average idle time (expressed in STCK units) that all previously used remote terminal definitions (whether deleted from the system or currently in the system) had been idle awaiting reuse.

This number does not include the remote terminal definitions currently idle awaiting reuse.

This value is calculated offline by DFHSTUP and is, therefore, not accessible through the EXEC CICS COLLECT STATISTICS command.

Reset characteristic: not reset

 

Maximum idle time A04TMAXI is the maximum time (expressed in STCK units) for which a previously idle shipped terminal definition had been idle during the recording period.

This number does not include the remote terminal definitions currently idle awaiting reuse (A04CMAXI).

Reset characteristic: reset to current value

 

NOT IN THE DFHSTUP REPORT A04CIDCT is the current number of remote terminal definitions that are idle and are awaiting reuse.

Reset characteristic: Not reset

 

NOT IN THE DFHSTUP REPORT A04CIDLE is the total time that the current number of remote terminal definitions that are awaiting reuse have been idle.

Reset characteristic: Not reset

 

NOT IN THE DFHSTUP REPORT A04CMAXI is the current maximum time that a remote terminal definition that is awaiting reuse has been idle.

Reset characteristic: Not reset

 

Autoinstall: Summary global statistics

Summary statistics are not available online.

Table 20. Autoinstall: Summary global statistics
DFHSTUP name Description
Autoinstall attempts is the total number of eligible autoinstall attempts made during the entire CICS session to create terminal entries as users logged on. For an attempt to be considered eligible, CICS and VTAM must not be terminating, autoinstall must be enabled, and the terminal type must be valid for autoinstall (not pipeline, LU6.1, or LU6.2 parallel sessions).
Rejected attempts is the total number of eligible autoinstall attempts that were subsequently rejected during the entire CICS session. Reasons for rejection can be maximum concurrency value exceeded, invalid bind, the user program has rejected the logon, and so on. If this number is unduly high, check the reasons for rejection.
Deleted attempts is the total number of deletions of terminal entries as users logged off during the entire session.
Peak concurrent attempts is the highest number of attempts made during the entire CICS session to create terminal entries as users logged on at the same time.
Times the peak was reached is the number of times that the "peak concurrent attempts" value was reached during the entire CICS session.
Times SETLOGON HOLD issued is the number of times that the SETLOGON HOLD command was issued during the entire run of CICS. CICS issues the VTAM SETLOGON HOLD command when the maximum number of concurrent autoinstall requests allowed (the AIQMAX= system initialization parameter) is exceeded.
Queued logons is the total number of attempts that were queued for logon due to delete in progress of the TCTTE for the previous session with the same LU.
Peak of queued logons is the highest number of logons that were queued waiting for TCTTE deletion at any one time. If this is unduly high, consider increasing the delete delay interval parameter of the AILDELAY system initialization parameter.
Times queued peak reached is the number of times that the "peak of queued logons" value was reached.
Delete shipped interval is the currently-specified time delay, in the form hhmmss, between invocations of the timeout delete transaction that removes redundant shipped terminal definitions. The value is set either by the DSHIPINT system initialization parameter, or by a subsequent SET DELETSHIPPED command.
Delete shipped idle time is the currently-specified minimum time, in the form hhmmss, that an inactive shipped terminal definition must remain installed in this region, before it becomes eligible for removal by the CICS timeout delete transaction. The value is set either by the DSHIPIDL system initialization parameter, or by a subsequent SET DELETSHIPPED command.
Shipped terminals built is the number of shipped remote terminal definitions installed at the start of the recording period, plus the number built during the recording period (which equates to the sum of "Shipped terminals installed", a statistic not shown in the summary report, and "Shipped terminals timed out").
Shipped terminals timed out is the number of shipped remote terminal definitions deleted during the recording period by the TIMEOUT transaction.
Times interval expired is the number of times the delete shipped interval expired during the recording period.

 

Remote deletes received is the number of old-style (pre-CICS/ESA 4.1) remote delete instructions received by this region during the recording period.
Remote deletes issued is the number of old-style (pre-CICS/ESA 4.1) remote delete instructions issued by this region during the recording period.
Successful remote deletes is the number of shipped terminal definitions deleted from this region because of old-style remote delete instructions, during the recording period.
Total idle count is the total number of times that all previously used remote terminal definitions (whether deleted from the system or currently in the system) had been idle awaiting reuse.

This number does not include the remote terminal definitions currently idle awaiting reuse (see A04CIDCT).

Average idle time is the average idle time (expressed in STCK units) that all previously used remote terminal definitions (whether deleted from the system or currently in the system) had been idle awaiting reuse.

This number does not include the remote terminal definitions currently idle awaiting reuse.

Maximum idle time is the maximum time (expressed in STCK units) for which a previously idle shipped terminal definition had been idle during the recording period.

This number does not include the remote terminal definitions currently idle awaiting reuse (A04CMAXI).

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
not available
DFH0STAT reports for these statistics
Autoinstall and VTAM Report
[[ Contents Previous Page | Next Page Index ]]