DISPGW

Purpose

DISPGW displays gateway definitions, statuses, and connectivity information.

Syntax

Read syntax diagramSkip visual syntax diagramDISPGWTARGET=system_namedomain_IDsaplex_nameOUTDSN= dsnameOUTMODE=LINEAUTONETLOG

Parameters

TARGET
For information on the TARGET parameter, see TARGET Parameter.
OUTMODE
For information on the OUTMODE parameter, see OUTMODE Parameter.
OUTDSN
For information on the OUTDSN parameter, see OUTDSN Parameter.

Restrictions and Limitations

The DISPGW command can only be used when SA z/OS® is initialized.

Usage

There are related panels that display gateway information. Use PF11 and PF10 to scroll through them.

Examples

If you enter dispgw you see a panel similar to Figure 1.

Figure 1. DISPGW Command Dialog Panel 1
 AOFK2GL                   SA z/OS - Command Dialogs        Line 1     of 9    
 Domain Id . : IPUND   ------------ DISPGW   ------------   Date . . : 07/17/19 
 Operator Id : NETOP1         System = AOCD                 Time . . : 14:51:49 
                         Focal Point = IPZNA                                    
                                                                                
 Domain   SDF Root Status      Comm  Release level In Status   Out Status       
 -------- -------- ----------- ----- ------------- ----------- -----------      
 IPUNA    AOCA     ACTIVE      *XCF* SA z/OS 4.2.0 ACTIVE      ACTIVE  
 IPUNB    AOCB     ACTIVE      *XCF* SA z/OS 4.2.0 ACTIVE      ACTIVE 
 IPUNC    AOCC     ACTIVE      *XCF* SA z/OS 4.2.0 ACTIVE      ACTIVE 
 IPUNJ             INACTIVE                        INACTIVE    SESSFAIL
 IPUNM             INACTIVE                        INACTIVE    SESSFAIL
 IPZNA    SAT1     ACTIVE      *IP * SA z/OS 4.2.0 ACTIVE      ACTIVE 
 IPZNB    SAT2     ACTIVE      *IP * SA z/OS 4.2.0 ACTIVE      ACTIVE 
 IPZNC    SAT3     ACTIVE      *IP * SA z/OS 4.2.0 ACTIVE      ACTIVE 
 IPZND             INACTIVE                        INACTIVE    SESSFAIL 
               
                                                                                             
 Command ===>                                                                   
 F1=Help     F2=End      F3=Return                                 F6=Roll

The amount of data depends on the screen size. Press PF10/11 to scroll horizontally.

  • The Domain field shows the domain ID of the system that a gateway has been defined to, known as the gateway domain.
  • The SDF Root field shows the system name of the gateway domain.
  • The Status field shows the current status of the gateway.

    The following are statuses that may occur for gateways:

    ACTIVE
    The connection was established.
    BAD DOMAIN
    The specified domain is unknown. Message: DSI031I.
    INACTIVE
    The connection cannot be established. One of the following messages was issued: DSI008I, DSI015A, DSI027I.
    INV OPID
    The specified operator ID is invalid. Messages: DSI021A, DSI077A, DSI400A.
    NOT STARTD
    The domain has not been started by gateway initialization.
    SESSFAIL
    The attempt to start a session with the domain ended with a VTAM® request failure. See DSI046I in the netlog for details.
  • The Comm field shows the communication method that is used for the outbound connection with the gateway domain:
    *XCF*
    XCF is used as the transport mechanism. This is the case when the gateway domain resides in the same logical sysplex.
    *IP *
    The transport mechanism is via RMTCMD using IP.
    *SNA*
    The transport mechanism is via RMTCMD using SNA.
    *RPC*
    The remote procedure call technique is used as the transport mechanism.
    Note: The RMTCMD method is derived from the RMTSYN entries found in CNMSTYLE. If you use RMTALIAS to describe more than one transport method, then you can influence which is selected as the RMTSYN entries are sorted in ascending order.
  • The Release level field shows the SA z/OS release level of the gateway domain.
  • The In/Out Status field shows the status of the inbound and outbound NetView sessions from this domain to the gateway domain. If this domain communicates with the gateway through another domain, the status is NO DIRECT.
  • The In/Out Req field shows the first 8 bytes of the last gateway request from the gateway domain to this domain, and the last gateway request from this domain to the gateway domain. It can be any of the following: CHECK, CONNECT, DISCONN, or FPRESET.
  • The System field shows the name of the system.
  • The SMF ID field shows the SMF ID assigned to the system.
  • The SAPlex field shows the SA z/OS SYSPLEX name. In most cases the name is identical to the physical SYSPLEX name
  • The XCF Group field shows XCF group name the system belongs to.
  • The Net Id field shows the Networking ID.
  • The SYSPLEX field shows the physical sysplex name.
  • The PrimaryFP field shows the name of the primary focal point defined for the domain.
  • The BackupFP field shows the name of the backup focal point defined for the domain.
  • The Description field shows a description of the gateway domain, obtained from the automation control file.