External Product Interface › Display Virtual Terminal and EPI Session Information › EPI LIST Command

EPI LIST Command

The following is a sample display of the information returned by the EPI LIST ALL command:

                              VTAM      VTAM   === RETRY ===     VTAM
TERMINAL USERNAME  STATUS   APPLNAME  LOGMODE  SECS MAX  NOW  RTNCD FDBK2
-------- --------  ------   --------  -------- ---  ---  ---  ----- -----
OMTERM1            ACTIVE   OMVTAM    T3278M2   30   30   0   X'00' X'00'
OMTERM2            ENABLED  OMCICS    T3278M3   30   30   0   X'10' X'01'
CA7TERM            RETRYING CA7       T3278M4   30    4   2   X'10' X'00'
OPS00001           ACTIVE   TSOTULD   T3278M3   NO RETRY      X'00' X'00'
OPS00002           ACTIVE   TSOIPD0   T3278M2   NO RETRY      X'00' X'00'

This display shows the following information:

• Five virtual terminals have been defined.
• The first virtual terminal (OMTERM1) is enabled and in session with an external product whose VTAM application name is OMVTAM.
• The second virtual terminal (OMTERM2) is enabled but not in session with any external product.
• An EPI LOGON command at this point would attempt to establish a session with an external product whose VTAM application name is OMCICS.
• The third virtual terminal (CA7TERM) is enabled and has a problem establishing a session to an external product whose VTAM name is CA7.
• This virtual terminal was defined with RETRY mode for a maximum of four retries. The EPI is retrying to establish the session. So far the EPI has retried twice to establish the session.
• An attempt to establish a session failed with a VTAM RTNCD of 10 and FDBK code of 0. For a detailed explanation of these codes, see your VTAM Programming guide.

Note: Like any part of the z/OS environment, you can operate the EPI with the AOF. If the NORETRY and RETRY options supported by the EPI are not sufficient to establish EPI sessions and keep them active in your environment, you can program more sophisticated procedures using the same AOF environment control facilities.

Following is sample output from the EPI LIST OMTERM1 command:

                              VTAM      VTAM   === RETRY ===     VTAM
TERMINAL USERNAME  STATUS   APPLNAME  LOGMODE  SECS MAX  NOW  RTNCD FDBK2
-------- --------  ------   --------  -------- ---  ---  ---  ----- -----
OMTERM1            ACTIVE   OMVTAM    T3278M2   30   30   0   X'00' X'00'
LOGONPARM =
ROWS = 24
COLUMNS = 80
VTAM SENSE = 00000000
MAX RCVE RU SIZE = 512
MAX SEND RU SIZE = 512
ACCEPT
NORETRY
TRACE&=&OFF
ENQ USER=TSOUSER1 ASCB=X'00F31C00' TCB=X'007E83C0'
ENQ USER=TSOUSER2 ASCB=X'00F32C00' TCB=X'008E8440'