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:
These statistics are available online using the EXEC CICS COLLECT STATISTICS AUTOINSTALL command, and are mapped by the DFHA04DS DSECT.
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
|
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
|
Summary statistics are not available online.
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). |