INGPLEX

Purpose

The INGPLEX command comprises all the sysplex-related functions of SA z/OS. It can be called in full mode and in line mode.

Syntax

Read syntax diagramSkip visual syntax diagramINGPLEXCDSTYPE=ARMCFRMLOGRLOGRYLOGRZSFMSYSPLEXDETAIL=CHPIDCF1CONsoleDUMPIPLDEL2=IPLRECDSHOW=IPLRECDDISP=IPLRECCOMP=IPLRECWITH=IPLRECLIST= sysnameDSN= dsnSDumpSLIPID= slipidSYSTEM= sysnameSTR3STR_PARMSSVCdumpsysnameREQ4=LISTCOMPDUMPSYStemTARGET=system_namedomain_IDsaplex_nameOUTMODE=LINEAUTONETLOG
IPLRECD
Read syntax diagramSkip visual syntax diagramsysname/ timestamp
IPLREC
Read syntax diagramSkip visual syntax diagramsysname/ timestamp[/ member[/ suffix]]
STR_PARMS
Read syntax diagramSkip visual syntax diagramCONDition=NoYesALL=NoYesTYPE=<CKLS
Notes:
  • 1 For details see INGCF.
  • 2 Line mode only
  • 3 For details, see INGSTR.
  • 4 Line mode only

Parameters

CDS
Displays information about CDSs and supports replacement of the current alternate CDS by a new one as well as making the alternate CDS the new primary. For further information about INGPLEX CDS refer to INGPLEX CDS.
TYPE
Start of changeThe type of CDS that the CDS function is issued for. Possible values are ARM, CFRM, LOGR, LOGRY, LOGRZ, SFM, and SYSPLEX.End of change
DETAIL
If you specify this parameter with the CDS function, the channel paths for the respective CDS type are displayed.
CF
This is the equivalent of the INGCF command.
CONsole
Displays information about consoles.
DUMP
Shows the DUMP submenu.
IPL
Shows and compares IPL information. It can be issued with the following options:
DEL
Deletes a single IPL record and all its related information. Note that the DEL parameter is supported in line mode only.
SHOW
Shows the details panel of the specified IPL record.
DISP
Shows all, one, or particular PARMLIB members used by the IPL of the specified system and at the specified date and time.
COMP
Compares all, one, or particular PARMLIB members used by the IPL of the specified system and at the specified date and time with those specified in the WITH parameter.
LIST
Shows the IPL summary records of the specified system.
WITH
The COMP parameter compares all, one, or particular PARMLIB members used by the IPL of the specified system, at the specified date and time with those specified in parameter WITH.
DSN
Is the name of a VSAM data set that holds IPL records. The default is the data set name associated with the ddname HSAIPL.
sysname
Is the name of the system in the sysplex.
timestamp
Is the IPL date and time. The format is YYYYMMDDhhmm.
member
Is the name of the PARMLIB member without the suffix.
suffix
Is the suffix of the PARMLIB member.
For further information about INGPLEX IPL refer to INGPLEX IPL.
SDUMP
Displays and controls the SDUMP options being set on all systems in the sysplex. For further information about INGPLEX SDUMP refer to INGPLEX SDUMP.
SLIP
Displays and controls all SLIP traps of all systems in the sysplex. Controlling is limited to DISABLE, ENABLE, or REMOVE a SLIP trap. The following parameters are supported:
ID
Limits the line mode output and the initial full screen display to the particular SLIP trap ID.
slipid
Is the ID of a SLIP trap. It can consist of one to four characters. Wildcards are not supported.
SYSTEM
Limits the line mode output and the initial full screen display to the particular system.
For further information about INGPLEX SLIP refer to INGPLEX SLIP.
STR
This parameter is equivalent to the INGSTR command.
CONDition
Defines whether or not the rebuild condition of each structure is to be determined and displayed.
ALL
Defines whether allocated and unallocated structures or just allocated structures are displayed.
TYPE
Defines what type of structures are to be displayed:
C
cache
K
lock
L
list
S
serialized list
(Default: all)
SVCdump
Allows you to issue a multisystem dump of up to 15 address spaces including data spaces owned by the address spaces, structures used by the address spaces, and XCF group members on the same or on other systems in the sysplex of those groups the address spaces have joined. The following parameters are supported:
sysname
Is the name of the system that has joined the XCF group of the NetView that the operator is logged on to.
REQ
Specifies the type of the line-mode request.
LIST
Requests the list of all active address spaces. This is the default when the parameter is omitted.
COMP
Requests the list of all components of the address spaces that are passed to the command.
DUMP
Requests a dump of the address spaces and their components that are passed to the command.
For further information about INGPLEX SVCDUMP refer to INGPLEX SVCdump.
SYStem
Displays information about a member system of the sysplex.
TARGET
For information on the TARGET parameter, refer to TARGET Parameter .
OUTMODE
For information on the OUTMODE parameter, refer to OUTMODE Parameter.

Example

If you specify INGPLEX without parameters, the selection panel shown in Figure 1 is displayed.
Figure 1. INGPLEX Selection Panel
 INGLX000                  SA z/OS  - Command Dialogs                           
 Domain Id . : IPSFP   ------------ INGPLEX -------------   Date . . : 01/26/18
 Operator Id : NETOP1          Sysplex = KEY1PLEX           Time . . : 08:58:40
                                                                                
 SAplex . . . . . . : KEY4PLEX                                                 
                                                                                
 Select the desired command:                                    INGPLEX ...     
                                                                                
   1 Display systems (including ETR & signalling paths)           SYStem        
   2 Display consoles                                             CONsole       
   3 Control coupling facilities (INGCF)                          CF            
   4 Control couple data sets                                     CDS           
                                                                                
   6 Display IPL information                                      IPL           
   7 Control dumps                                                DUMP          
                                                                                
                                                                                
  10 Control all structures (allocated and unallocated) (INGSTR)  STR                     
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
 F1=Help      F2=End       F3=Return                              F6=Roll       
                                                                 F12=Retrieve

Use this panel to launch other command dialogs showing sysplex-related information.

Use one of the following command codes to invoke another command dialog:
1 INGPLEX SYStem
Displays the target sysplex name, its GRS mode and its systems. For each system the following details are shown:
  • System name
  • Status of the system
  • Start of changeStatus of System Recovery Boost End of change
  • SSUM action
  • SSUM interval time
  • SSUM weight
  • SFM failure detection interval
  • WLM query timestamp
  • Total free SUs
  • SUs used
  • SU-consuming resources
  • Free SUs

See INGPLEX SYStem.

2 INGPLEX CONsole
Displays the following details for the target sysplex:
  • Master console name
  • WTO & WTOR buffer utilization
  • Number of queued messages of various types
  • Awaiting mounts and operator requests
  • List of consoles with more details, such as:
    • Name
    • Status
    • Authority
    • Number of WTOR buffers, etc.

See INGPLEX CONsole.

3 INGPLEX CF
Displays the coupling facilities in the sysplex, their spaces, and CF levels. Each coupling facility can be drained and enabled. The structures of each coupling facility can be displayed, rebuilt, and forced. Duplexing can be started and stopped, when supported. The paths of the coupling facility can be displayed and set online or offline.

See INGCFL.

4 INGPLEX CDS
Displays the couple data sets in the sysplex. For each couple data set, paths and more detailed information can be displayed. The couple data sets can be switched and new alternate data sets can be allocated.

See INGPLEX CDS.

6 INGPLEX IPL
Displays and compares IPL information being used during the IPL of an operating system. The information shown or compared can be varied from all available information to the content of a particular PARMLIB member.

See INGPLEX IPL.

7 INGPLEX DUMP
Displays the default dump options as well as the setting of the slip traps for all systems in the sysplex. It also allows you to change the settings either locally, sysplexwide, or for some systems in the sysplex. In addition, the function allows to take multisystem SVC dumps.

See INGPLEX SDUMP, INGPLEX SVCdump, and INGPLEX SLIP.

10 INGSTR
Displays all allocated and unallocated structures, independent of the coupling facility. The structures can be displayed, rebuilt, forced, and duplexing can be started and stopped, when supported. You can also reallocate all structures from their current location to their preferred location if all systems in the sysplex support the XCF REALLOCATE command.

See INGSTR.