Virtual terminals possess certain unique qualities not covered by standard IMS commands. Therefore, DELTA IMS VIRTUAL TERMINAL has expanded the IMS /DISPLAY command to include several new keywords that augment those listed in the IMS Operator’s Reference Manual.
The /DISPLAY command has the following additional DELTA IMS VIRTUAL TERMINAL keywords:
Note
These keywords become reserved words for all command processing purposes, including non-display and non-virtual terminal command formats. If these keywords conflict with previously named resources at your site, consider renaming your resources since the alternative is to SUPERZAP the keyword in CSECT VTFXKWT0 of load module VTFXVCDn.
You can generate DSECTS for AOI programs that can enter these commands. Code the $VTFMAP macro instruction as follows to generate DSECTS for all DELTA IMS VIRTUAL TERMINAL /DISPLAY output formats.
| Provides a report on signons and is used with either the STATUS or ALLOWED parameter. | Provides a one-line report that identifies whether user signons are enabled or disabled. |
|---|
| Provides a multi-line report listing all /SECURE ALLOWED userids. The report lists seven userids per line. |
|---|
| Specify one or more userids after the ALLOWED keyword to generate a multi-line report listing each specified userid signon. If a userid is not /SECURE ALLOWED, the message IS NOT ALLOWED appears after the userid. |
|---|
| Provides a listing of all /SECURE ALLOWED userids. |
|---|
|
|---|
| The Virtual Printer Override parameter provides a report on overridden virtual printer LTERMs. | Specify one or more LTERM names after the VPO parameter to generate a multi-line report listing each specified LTERM, the override printer node name and the override model name. If the LTERM is not overridden, then N/O follows the LTERM name. |
|---|
| Provides a listing of all overridden virtual printer LTERM names. |
|---|
|
|---|
| The Virtual Terminal parameter provides a report on current virtual terminals. | Specify one or more node names after the VT parameter to generate a multi-line report listing each specified virtual terminal name on a separate line. Each line contains the following information: - Terminal’s VTAM node name
- Virtual device type: T (terminal) or P (printer)
- Model’s node name
- IMS device type and model (if available)
- Status with respect to automatic logoff or block delete
Period of inactivity for purposes of time-out and block delete listed in hours, minutes, and seconds. Note If the terminal has not been active since IMS restart, an ] will appear.
|
|---|
| Provides a listing of all current virtual terminals. This command does not affect the virtual terminal Timer facility time stamp used for purposes of idle terminal logoff and/or control block deletion. |
|---|
| Use the STATUS keyword with the VT parameter to generate a multi-line summary of the virtual terminal network. The summary consists of four sections: Current, Activity, Terminal Timeout Status Summary, and Pool Usage. | |
|---|
| Shows how many virtual devices are currently connected and disconnected Virtual devices include virtual terminals and printers. Connected means currently logged on. Disconnected means not currently logged on. | | Shows statistics from the last IMS restart and within approximately the last 10 minutes on the following: - LOGONS—connections made between IMS and VTAM that require a VTAM LOGON exit to be scheduled and the successful establishment of a virtual terminal session as a result
- SIGNONS--/SIGNON commands successfully processed at a virtual terminal. This requires that an option other than option 0 be specified as the Virtual Terminal Signon option
- VIRTUAL PRINTER /OPNDSTS ISSUED—the number of /OPN NODE commands issued to logon a virtual printer because output was available to be sent
- VPRINTER CONNECTIONS MADE—the number of connections made between IMS and VTAM for a virtual printer device that require the VTAM logon exit to be scheduled and the successful establishment of a virtual printer session
- TERMINALS AUTOMATICALLY LOGGED OFF—the number of virtual terminals and printers automatically logged off by DELTA IMS VIRTUAL TERMINAL because they had exceeded the installation specified period of inactivity
| Terminal Timeout Status Summary | Provides the number of virtual terminals and printers in each timeout status. The timeout status categories and descriptions are as follows: - NO TIMEOUT—virtual terminal is connected, but it is not eligible for any type of automatic logoff due to inactivity
- STANDARD—standard idle terminal logoff interval
- ALTERNATE—alternate idle terminal logoff interval
- CONVERSATIONAL—the idle conversation logoff and exit interval
- CONV-ALT—the alternate idle conversation logoff and exit interval
- VPRINTER—the virtual printer idle printer logoff interval
- TEMPORARY—the terminal has been logged off or the control block is a temporary block used to save significant status information locally. The control block may be deleted by IMS at a checkpoint.
- ITASK—the virtual terminal control blocks are in use by the IMS ITASK, preventing consideration for deletion
- QMGR—an IMS queue buffer is allocated to the virtual terminal, preventing consideration for deletion
- CONV-PEND—the virtual terminal is associated with a conversation in pending (CCB1PEND) status preventing consideration for deletion
- CONV-SCHD—the virtual terminal is associated with a conversation in scheduled status, preventing consideration for deletion
- CONV-ACT—the virtual terminal is associated with an active conversation, preventing consideration for deletion. This is usually transient and can be cleared by an imminent /HOLD or /EXIT command issued internally by DELTA IMS
- CINIT PEND—a pending request to VTAM exists for the device
| | Provides current percent of capacity and usage; maximum percent of capacity and usage; and capacity for the USB, VPO, and VTE pools. To minimize the performance impact of information gathering for this report, the statistics presented are not gathered by the command itself, but are gathered during normal control block scan by the virtual terminal Timer facility approximately every 20 seconds. Since the Timer facility runs under an asynchronous TCB, it may execute while the command is processing. Therefore, it is possible that the end of the report may be more current than the beginning. Do not attempt to balance the report. IMS checkpoints interrupt or delay the virtual terminal Timer facility operation. To obtain the most up-to-date information, do not use the /DISPLAY command during system checkpoints or for approximately 30 seconds after checkpoint completion. |
|
|---|
| Provides a multi-line report of the current contents of the Virtual Terminal Trace table. Entries are listed from the most recent to the oldest. | |
|---|
| Permits user specification of the number of entries to be listed The default is 10. | | Specify one or more LTERM names after the LTERM keyword to selectively list only those trace entries appropriate to the specified LTERMS Use spaces to separate multiple LTERM names. | | Specify one or more node names after the NODE keyword to selectively list only those trace entries appropriate to the specified nodes | | Specify one or more user names after the USER keyword to selectively list only those trace entries appropriate to the specified users Use spaces to separate multiple user names. |
Trace entries are listed in dump format with no interpretation or significance made as to the content of any entry. It is up to you to assign any significance or lack thereof to the contents of trace entries. Because each entry requires five segments to display and the COUNT field may be meaningfully specified as high as 3200, displaying a large number of entries may have a significant negative impact on the IMS message queue. A count as great as 99999 is permitted; however, the internal trace table only contains 3200 entries and the command will not list the same entry twice. |
|---|
| Displays in hexadecimal and character format the VLB, ECB, CLB, CTB, CRB, and CIB control blocks for the node name you specified. |
|---|
| Displays in hexadecimal and character format the VCN, CNT, and USR control blocks for the LTERM name you specified. |
|---|
| Provides a multi-line report of the current DELTA IMS VIRTUAL TERMINAL IMSID options specified for the specified IMS system. |
|---|
|
|---|
| The Virtual Terminal Pending Elements parameter provides a report on virtual terminal pending elements. | This keyword is optional. Specify one or more node names to generate a multi-line display that lists the node status and user/SPQB status on a separate line for each specified node name. |
|---|
| Provides a listing of all current virtual terminal pending Trace elements. |
|---|
|
|---|
| Provides an online display of which virtual terminal exits are link-edited into VTFEXITn. It also provides the assembly date of the exit, and based on current IMSID options, indicates whether the exit is active. |
|---|
| Provides an online display of all TSS tables that reside in the currently allocated TSS table data set. It also provides information about each table. The returned information includes argument length, function length, masking yes/no, and the name of the Table Translation Assist Exit, if present. |
|---|
| Provides an online display of the information detailed in the previous three field names for a specified table name. |
|---|
| Provides an online display of a TSS table. All entries in the table are displayed. If you want to prevent an entire table from being inadvertently displayed, you may require users to enter the ALLROWS keyword with this command. Activate the requirement to use the ALLROWS keyword by selecting the Require 'ALLROWS' keyword on /DIS TSSTABLE tablename command field on screen number 5 of the IMSID Basic Options panel. |
|---|
TSSTABLE tablename argument | Provides an online display of one or more TSS table entries that match the provided argument. |
|---|
TSSTABLE tablename ALLROWS | Provides an online display of all entries in a TSS table. |
|---|
