Terminal Autoinstall and z/OS Communications Server report

The Terminal Autoinstall and z/OS® Communications Server Report shows information and statistics about the status of terminal autoinstall - local terminals, and terminal autoinstall - shipped terminals. The report also shows the current status of the connection between CICS® and the z/OS Communications Server, storage usage, generic resource usage and persistent session statistics.

The Terminal Autoinstall and z/OS Communications Server Reports are produced using a combination of the EXEC CICS INQUIRE AUTOINSTALL, INQUIRE VTAM, and the EXEC CICS COLLECT STATISTICS AUTOINSTALL, and Communications Server commands. The statistics data is mapped by the DFHA03DS, and DFHA04DS DSECTs.
Note: VTAM® is a previous name for z/OS Communications Server.
Table 1. Fields in the Terminal Autoinstall report
Field Heading Description
Terminal Autoinstall Status Indicates the current status of terminal autoinstall.

Source field: EXEC CICS INQUIRE AUTOINSTALL ENABLESTATUS(cvda)

Bridge Autoinstall Indicates the current status of autoinstall for bridge facilities.

Source field: EXEC CICS INQUIRE AUTOINSTALL AIBRIDGE(cvda)

Console Autoinstall Indicates the current status of autoinstall for consoles.

Source field: EXEC CICS INQUIRE AUTOINSTALL CONSOLES(cvda)

Autoinstall Program The name of the user-replaceable terminal autoinstall model definition program.

Source field: EXEC CICS INQUIRE AUTOINSTALL PROGRAM()

Current Autoinstall Requests The number of autoinstall requests currently being processed.

Source field: EXEC CICS INQUIRE AUTOINSTALL CURREQS()

Peak Autoinstall Requests The maximum number of autoinstall requests that can be processed concurrently.

Source field: EXEC CICS INQUIRE AUTOINSTALL MAXREQS()

Autoinstalls Attempted The number of terminal autoinstalls attempted.

Source field: A04VADAT

Autoinstalls Rejected The number of terminal autoinstalls rejected.

Source field: A04VADRJ

Autoinstalls Deleted The number of autoinstalled terminals deleted.

Source field: A04VADLO

Peak Concurrent Autoinstalls The peak number of autoinstall requests processed concurrently.

Source field: A04VADPK

Times Peak Concurrent reached The number of times the peak autoinstall requests was reached.

Source field: A04VADPX

Times SETLOGON HOLD issued The number of times the SETLOGON HOLD command was issued to prevent further logon requests.

Source field: A04VADSH

Number of Queued Logons The number of autoinstall attempts that were queued for logon because the delete was in progress for the same terminal.

Source field: A04VADQT

Peak Number of Queued Logons The peak number of autoinstall attempts that were queued for logon.

Source field: A04VADQK

Times Peak Queued Logons reached The number of times the peak number of autoinstall attempts that were queued for logon was reached.

Source field: A04VADQX

Delete shipped definitions interval The current delete redundant shipped terminal definitions interval.

Source field: A04RDINT

Delete shipped definitions Idle time The current minimum time that an inactive shipped terminal definition must remain installed in this region before it becomes eligible for deletion.

Source field: A04RDIDL

Shipped remote terminals built The total number of shipped terminal definitions that have been installed in this region.

Source field: A04SKBLT

Shipped remote terminals installed The number of shipped terminal definitions currently installed in this region.

Source field: A04SKINS

Shipped remote terminals deleted The number of shipped terminal definitions deleted from this region.

Source field: A04SKDEL

Times remote delete interval expired The number of times the remote delete interval has expired.

Source field: A04TIEXP

Remote terminal deletes received The number of remote delete requests received by this region.

Source field: A04RDREC

Remote terminal deletes issued The number of remote delete requests issued by this region.

Source field: A04RDISS

Successful remote terminal deletes The number of shipped terminal definitions deleted in this region by remote delete requests.

Source field: A04RDDEL

Current idle terminals awaiting reuse The current number of remote terminal definitions that are idle and are awaiting reuse.

Source field: A04CIDCT

Current idle time awaiting reuse The total time that the current number of remote terminal definitions that are awaiting reuse have been idle.

Source field: A04CIDLE

Current maximum idle time awaiting reuse The current maximum time that a remote terminal definition that is awaiting reuse has been idle.

Source field: A04CMAXI

Total idle terminal count awaiting reuse The total number of remote terminal definitions that have been idle and awaited reuse.

Source field: A04TIDCT

Total idle time awaiting reuse The total time that the total number of remote terminal definitions that awaited reuse were idle.

Source field: A04TIDLE

Average idle time awaiting reuse The average time that the remote terminal definitions were idle awaiting reuse.

Source field: A04TIDLE / A04TIDCT

Maximum idle time awaiting reuse The maximum time a shipped terminal definition has been idle awaiting reuse.

Source field: A04TMAXI

Table 2. Fields in the z/OS Communications Server report
Field Heading Description
VTAM open status The current status of the connection between CICS and the Communications Server.

Source field: EXEC CICS INQUIRE VTAM OPENSTATUS(cvda)

Dynamic open count The number of times the Communications Server ACB was dynamically opened.

Source field: A03DOC

VTAM Short-on-Storage The number of times that the Communications Server indicated that there was a temporary Communications Server storage problem.

Source field: A03VTSOS

MAX RPLs The maximum number of receive-any request parameter lists (RPLs) that were posted by the Communications Server on any one dispatch of CICS terminal control.

Source field: A03RPLX

Times at MAX RPLs The number of times the maximum number of receive-any request parameter lists (RPLs) was reached.

Source field: A03RPLXT

Current LUs in session The current number of LUs in session.

Source field: A03LUNUM

Peak LUs in session The peak number of LUs in session.

Source field: A03LUHWM

Generic Resource name The name of the generic resource group which this CICS region requested registration to the Communications Server.

Source field: EXEC CICS INQUIRE VTAM GRNAME()

Generic Resource status Indicates the status of generic resource registration.

Source field: EXEC CICS INQUIRE VTAM GRSTATUS(cvda)

Persistent Session Type The setting for Communications Server persistent sessions support in the CICS region, as specified by the system initialization parameter PSTYPE. The settings are as follows:
  • SNPS - single-node persistent sessions
  • MNPS - multinode persistent sessions
  • NOPS - persistent sessions support is not used

Source field: A03PSTYP

Persistent Session Interval The time for which persistent sessions are retained if a failure occurs, as specified by the system initialization parameter PSDINT.

Source field: A03PSDIN

Persistent Session Inquire count The number of times CICS issued VTAM INQUIRE OPTCD=PERSESS to inquire on the number of persistent sessions.

Source field: A03PSIC

Persistent Session NIB count The number of Communications Server sessions that persisted.

Source field: A03PSNC

Persistent Session Opndst count The number of persisting sessions that were successfully restored.

Source field: A03PSOC

Persistent Session Unbind count The number of persisting sessions that were stopped.

Source field: A03PSUC

Persistent Session Error count The number of persisting sessions that were already unbound when CICS tried to restore them.

Source field: A03PSEC