IMS Version 9

DISPLAY

Format

Read syntax diagramSkip visual syntax diagram            .------------------------------.
            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.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004