DISPLAY
Format

.------------------------------.
V |
>>-DISPLAY----+-DIRECTORY--| A |---------+-+-------------------><
| .------. |
| V | |
+-ENTITY--(---name-+-)-----+
+-STATUS-------------------+
+-ILS--+-----------------+-+
| | .---------. | |
| | V | | |
| '-(---gsgname-+-)-' |
| .------. |
| V | |
'-SYSTEM--(---name-+-)-----'
A:
|--+--------------------------------------------+---------------|
'-(-+-gsgname-+-,-+-sgname-+-,-+-sysname-+-)-'
'-*-------' '-*------' '-*-------'
Usage
The DISPLAY command is used to provide information about the definition
and status of resources related to transport manager. Transport
manager only provides communication services for the active and
tracking site IMSs; it has no knowledge of the activities at either
site.
To see information related to active site IMS or tracking site
IMS use the IMS /DISPLAY command.
- DIRECTORY
- Displays current entity (IMS subsystem or ILS task) information
from the transport manager directory. If no entity (or list of entities)
is specified, all information in the directory is displayed. The
directory information includes information on the global service
group (GSG) name, the service group (SG) name, the system name,
the instance name, and the component name.
If you specify *, then ALL information for the entity is displayed.
- ENTITY
- Displays entities (IMS subsystems and ILS tasks) currently
identified to this transport manager. If no list of entity names
is provided, all are displayed. Entity information is displayed
for the following:
- MSGNAME
- The IMS ID or job name of the entity. This is included in
various TMS messages (prefix ELX) to identify the entity.
- GSGname
- The global service group name.
- SGname
- The service group name.
- INSTANCEname
- The TMS instance name.
- COMPONENTname
- The TMS component name.
- APPLID
- The VTAM APPLID assigned to the entity.
- STATUS
- The relationship between the entity and the transport manager.
The status of the entity can be any of the following:
- IDEN0
- APPLID resource name is allocated for the entity during the
IDENTIFY processing.
- IDEN1
- APPLID resource name is committed for the entity during the
IDENTIFY processing.
- ACT
- The entity is active.
- FAIL
- The entity has failed during the IDENTIFY processing.
- STATUS
- Displays the status information of this transport manager
as the following:
- TRANSPORT MANAGER
- The version number of the transport manager.
- STATUS
- The status of the entity can be any of the following:
- STARTING
- Transport manager start requested.
- STARTED
- Transport manager started.
- STOPPING
- Transport manager stop requested.
- STOPPED
- Transport manager stopped.
- INSTANCE
- The instance name of the transport manager.
- APPLID/SYSTEM
- The system name of the transport manager.
- ENTITIES
- The number of the active entities (including the TMS itself).
- SYSTEMS
- The number of the active systems.
- ILS
- Displays information on all or on specific global service
groups for which ILS is currently started in a transport manager
subsystem address space. A DISPLAY ILS command will not complete while a volume mount is outstanding
for other than the first volume of a multivolume log data set.
- GSG.SG SUMMARY
- Summary information for each tracking subsystem being supported.
- GSG
- Global service group name (from the START ILS command).
- SG
- Service group name of the tracking subsystem for which this
group of display information applies.
- MODE
- VTAM mode name used for conversations (from the START ILS command).
- MAXCONV
- The maximum number of conversations allowed (from the START ILS command).
- CONV
- The number of conversations currently allocated between this
ILS and the tracking subsystem.
- Q-REQ
- The number of query requests received
from the tracking subsystem since communication began with the tracking
subsystem. Query requests are sent periodically
by the tracking subsystem to determine if active service group IMS
subsystems have run without communicating with the tracking subsystem.
- G-REQ
- The number of gap requests received
from the tracking subsystem since communication began with the tracking
subsystem.
- DS-SENT
- The number of log data sets successfully sent to the tracking
subsystem since communication began with the tracking subsystem.
ILS actually sends contiguous portions of log data sets based on
the gaps in log data at the tracking site. When all of one of these
contiguous portions is sent, the value of this display field is
incremented.
- DATASETS
- If any log data sets are currently under consideration for
transport to the tracking subsystem as described previously, they
are listed below a separator line. If there is no data set activity,
there will be no separator.
- STATUS
- Indicates the current state of processing for a particular
data set.
- ACTIVE
- The data set is currently being transported, no delays other
than waits for data set read have been detected.
- W-CONV
- The data set may be selected for transmission as soon as a conversation
is available.
- ALLOC-IP
- The data set is queued for or in the process of allocation
or deallocation. This involves z/OS ENQ/DEQ (for OLDS data sets), z/OS DYNALLOC, z/OS OPEN/CLOSE
functions. Only one data set is processed through this function
at a time, so a delay of one may delay others. The most likely cause
of a delay in this state would be an unsatisfied tape mount.
- DBRC-IP
- ILS logic is awaiting completion of a DBRC request related
to this data set. The most likely cause of a delay in this state
would be contention for the RECON data sets.
- W-SEND
- The data set is currently being transported, but VTAM is not
accepting data as fast as ILS is attempting to send it; send is
currently waiting for completion of a previous VTAM send. This state
generally reflects the results of VTAM pacing controls that limit
the ILS to tracking subsystem data rate.
- W-TRKPAC
- The data set is currently being transported, but the tracking subsystem
is not accepting data as fast as ILS is attempting to send it. This
state generally reflects the tracking subsystem's inability to write
log data as fast as ILS can send it.
- W-TRKOK1
- The data set is part of a gap; the tracking subsystem has
not yet approved actual transport of data sets to fill the gap.
- W-TRKOK2
- ILS is waiting for the tracking subsystem to approve transport
of this specific data set.
- RECORDS-SENT
- The number of records, in decimal, that have been sent. The
number is of the form nnnK, where K represents 1024 records. The number is rounded off to the
nearest K.
- NAME
- The IMSID of the active system that created the log data set
or the job name of the BATCH or BBO job that created the log data
set.
- VOLSER
- The volume serial number, if any, used in allocation of the
data set. If this field is blank, the data set is (expected to be)
cataloged.
- DSNAME
- The data set name that is or will be read for transport. This
may be a primary or secondary copy of an OLDS or SLDS data set.
- SYSTEM
- Displays status information about the specified systems. The
system name is specified by the DEFINE command and status are displayed. If no list is provided, all
are displayed. The status of the system can be any of the following:
- RALOC
- Allocation requested for the system.
- ALOC
- The system is actually allocated.
- RSTA
- Start requested for the system.
- STA
- The system is actually started.
- RSTO
- Stop requested for the system.
- STO
- The system is actually stopped.
Examples
The following are examples of output from the DISPLAY command.
Example 1 for DISPLAY Command
Entry ET:
DISPLAY DIRECTORY
Response ET:
ELX0170I TRANSPORT MANAGER DISPLAY: 92.078 13.48.29.0
GSG SG SYSTEM INSTANCE COMPONENT
* * TMP2 * TMANAGER
FUNDS SITEA TMP2 IMSA LOGGER
FUNDS SITET TMP4 IMSC LOGROUTR
FUNDS SITEA TMP2 IMSB LOGGER
FUNDS SITEA TMP2 * ILSEND
Explanation: When the DIRECTORY object keyword is completely processed, this message is issued
for current entity information from the transport manager directory.
Example 2 for DISPLAY Command
Entry ET:
DISPLAY DIRECTORY
Response ET:
ELX0170I TRANSPORT MANAGER DISPLAY: 92.078 13.58.39.0
*** NO DIRECTORY TO DISPLAY ***
Explanation: The DIRECTORY has no entities to display. This
message is issued when transport manager has not started by the
time the DISPLAY command is processed.
Example 3 for DISPLAY Command
Entry ET:
DISPLAY ENTITY
Response ET:
ELX0170I TRANSPORT MANAGER DISPLAY: 92.090 13.48.29.0
MSGNAME GSG SG INSTANCE COMP APPLID STATUS
TMP * * * TMANAGER TMP2001 IDEN1,ACT
TMPA FUNDS SITEA IMSA LOGGER * IDEN0
Explanation: When the ENTITY object keyword is completely processed, this message is issued
to display entities currently identified to this transport manager.
Example 4 for DISPLAY Command
Entry ET:
DISPLAY SYSTEM
Response ET:
ELX0170I TRANSPORT MANAGER DISPLAY: 92.078 13.54.51.1
SYSTEM STATUS
TMP4 ALOC,STA
TMP3 ALOC,STA
TMP5 ALOC,STA
Explanation: When the SYSTEM object keyword is completely processed, this message is issued
to display status information for the specified systems.
Example 5 for DISPLAY Command
Entry ET:
DISPLAY ILS
Response ET:
ELX0170I TRANSPORT MANAGER DISPLAY: 91.105 12.07.24.7
GSG: IMSGSG1 SG: STLSITE1 MODE: ILSMODE MAXCONV: 2
CONV: 2 Q-REQ: 92 G-REQ: 3 DS-SENT: 5
**** DATASETS *****************************************************************
STATUS RECORDS-SENT NAME VOLSER DSNAME
W-SEND 12K IMSA L00813 BURKES.PAYROLL.SLDSP1
ACTIVE 72K IMSA KENTT.PAYROLL.DFSOLP03
W-CONV 0K IMSA L00803 BURKES.PAYROLL.SLDSP2
Explanation: When the ILS object keyword is completely processed, this message is issued
to display isolated log sender status for the specified GSG name.
Example 6 for DISPLAY Command
Entry ET:
DISPLAY STATUS
Response ET:
ELX0170I TRANSPORT MANAGER DISPLAY: 90.078 13.56.59.5
TRANSPORT MANAGER V5 R0 STATUS: STARTING,STARTED
INSTANCE: ELX APPLID/SYSTEM: TMP2
ENTITIES: 1 SYSTEMS: 3
Explanation: When the /DISPLAY command is entered with the STATUS object keyword, this message is issued to display the status
of resources related to transport manager.

IBM Confidential