Using OSINFO System Information API Commands - ironstream_for_micro_focus_omi - 7.2

Ironstream for Micro Focus® OMi for IBM Z® Administration

Product type
Software
Portfolio
Integrate
Product family
Ironstream
Product
Ironstream > Ironstream for Micro Focus® OMi
Version
7.2
Language
English
Product name
Ironstream for Micro Focus OMi for IBM Z
Title
Ironstream for Micro Focus® OMi for IBM Z® Administration
Copyright
2021
First publish date
2007
ft:lastEdition
2023-08-23
ft:lastPublication
2023-08-23T16:21:59.136387

The OSINFO subtask of the VP390 agent task will gather various z/OS operating system statistics and present the data in a format that can be parsed by a script on the OMi server. OSINFO data are requested using destination 46 of the ev390hostcmd utility. (See the section Using the ev390hostcmd Command Interface general syntax of ev390hostcmd.)

The OSINFO data are requested by specifying a two-digit code followed by a vertical bar and additional parameter information depending on the selected code. For example, to gather DASD information (code 01) for a volume named:”DISK99” on mainframe “s390.mysite.com,” the ev390hostcmd syntax is:

Windows: ev390hostcmd 46 "01|DISK99.S390.mysite.com"

Linux: ev390hostcmd 46 01\|DISK99.S390.mysite.com

Because the Windows/DOS shell interprets the vertical bar as a pipe symbol, the vertical bar will need to be escaped by enclosing everything after the last space inside double quotation marks.

Output lines will be returned with values separated by a vertical bar. One line will be generated for each

record found, representing one job, device, etc. The last line will be the text “EOF”.

Note: Codes 06, 07, and 08 require SDSF to be running on the mainframe agent and will require the extra DD cards ISFIN and ISFOUT to be uncommented in the VP390 startup JCL.

Note: Codes 110, 111, 112, 113, and 114 require a temporary dataset to hold the TSO output. The dataset should be created with parameters DCB=(DSORG=PS,RECFM=FB,LRECL=1028,BLKSIZE=6144),SPACE=(TRK,(1,1,0)). This

dataset can be defined in three ways and will be searched in the following order:

  1. The dataset name is defined in the SYSIN parameter cards on a card labeled “TSOUTPUT”. The dataset must exist and be cataloged before the VP390 job is started.

  2. The dataset is defined in the VP390 startup JCL with a DDname of “TSOUTPUT”.

  3. A dataset named “EV390.TSOUTPUT” will be created when a 110-114 command is called and will persist after the VP390 job has ended.

TSO options (110-114) require that the “NETSTAT” command is not in the list of TSO authorized commands. (Verify that “NETSTAT” is not listed in the AUTHCMD section of the IKJTSOxx member of PARMLIB.)

The available OSINFO codes are:

  1. DASD Utilization Statistics

Description

Collects DASD volume statistics. The DASD must be online at the time of the request.

Parameters

DASD volume name, or a regular expression to look for multiple volumes, or * for all volumes

Output

One line for each DASD volume found, in the format:

VolSer | Number of tracks | Tracks per cylinder | Free extents | Free tracks | Largest free extent | Percent used | DSCBs

Sample Command

ev390hostcmd 46 01\|O..*.s390.mysite.com

Sample Output

OS390M1|50085|15|8|3374|1230|93|1364 WORK01|50085|15|23|16450|15928|67|3704 EOF
  1. RMF Address Space Resource Statistics

Description

Collects statistics from RMF for a specified address space(s). RMF must be running on the system for this option to collect.

Parameters

Address space name, or a prefix of address space with an * to find multiple address spaces with the same starting characters.

Output

One line for each address space found in the format:

Job Name | Device connect time in milliseconds |Number of fixed frames located below the 16M real line | Number of non-LSQA fixed frames | LSQA pages in real storage | Total TCB time for this step in milliseconds | Total CPU time consumed on behalf of this address space in milliseconds | EXCP count for this step

Sample Command

ev390hostcmd 46 02\|VTAM.s390.mysite.com

Sample Output

VTAM |4589|0|29|66|333806|411134|4234

EOF

  1. Current CPU Snapshot for System and a Specific Address Space

Description

Collects CPU and memory usage for the system and a specific address space by scheduling an SRB to execute in the target address space.

Parameters

Address space name.

Output

One line of values in the format:

Current total LPAR CPU utilization percentage | Percentage of CPU used by specified address space | Total CPU time used by address space in seconds | Real storage used by address space in kilobytes | Extended stage used by address space in kilobytes | Region size requested in kilobytes | Private storage allocated under the 16M line | Private storage allocated above the 16M line | Private storage used under the 16M line | Private storage used above the 16M line

Sample Command

ev390hostcmd 46 03\|LLA.s390.mysite.com

Sample Output

4.14| 0.00| 7.53| 1776| 464| 0| 940| 21424| 849| 21115

EOF

  1. Current Active Jobs

Description

Collects a list of active address spaces.

Parameters

Regular expression filter of address space names to be displayed, or “*” for all

Output

One line for each address space found, in the format:

Job name | Step name | Proc step | Job ID | Owner | Position | Performance Group number | Priority | Current real storage usage (in frames)

Sample Command

ev390hostcmd 46 04\|^V..*.s390.mysite.com

Sample Output

VLF |VLF |VLF | | |N/S|0|FE|3679 VTAM |VTAM |VTAM |STC00766|VTAM |N/S|0|FE|835 VMCF |VMCF |IEFPROC | | |N/S|0|FE|35 VP390V55|STEP1 | |STC01381|IBMUSER |N/S|0|FE|1702 VP390 |VP390 |VP390 |STC01104|IBMUSER |N/S|0|FE|1262 EOF

  1. System statistics from RMF

Description

Collects current system statistics as reported by RMF type 79 subtype 3, subtype 4, and subtype 9 records. RMF must be running to get a valid output.

Parameters

none

Output

One line of output in the format:

System CPU utilization percentage | System demand paging rate | Number of system common (LPA+CSA) pages in | Number of swaps (out) | Number of pages swapped in | Number of pages swapped out | Number of private pages swapped in | Number of private pages swapped out | High UIC count | System LPA pages in | Number of pages to extended storage | Number of extended storage slots available and not in use | Number of pages migrated from extended storage to auxiliary storage | Number of available frames | I/O activity rate: average I/O requests per second | I/O response time: average milliseconds needed to complete an I/O request | ISOQ time: average milliseconds an I/O request must wait on an IOS queue | Number of fixed SQA frames | Number of common (LPA+CSA) frames | Number of private non-LSQA fixed frames | Number of address spaces in storage | Number of total LPA frames | Number of total CAS frames | Number of LPA fixed frames | Number of CSA fixed frames | Number of fixed LSQA frames | Number of address spaces logically swapped out|Current time in seconds from the beginning of the 1970 epoch

Sample Command

ev390hostcmd 46 05.s390.mysite.com

Sample Output

5|0|40672|3762|159116|148700|286378|216962|254|26391|8772189|

6352|2058999|328|0|3|0|4491|581|1455|52|3281|2052|68|513|4968

|9|1089391325

EOF

  1. JES2 Input Queue

Description

Collects a list of jobs on the JES2 Input Queue. See the note in section “Using OSINFO System Information API Commands” for extra SDSF requirements to run this option.

Parameters

Job name, or a prefix of a job name with an * to find multiple jobs with the same starting characters.

Output

One line for each job found, in the format:

Job name | Job ID | Owner | JES2 input queue priority | JES2 input class | Position within JES2 input queue class | Print designating name

| Print routing | Print node | System affinity (if any)

Sample Command

ev390hostcmd 46 06\|*.s390.mysite.com

Sample Output

COPYJOB |JOB01817|USER1 | 9|A| |LOCAL | | | EOF

06 JES2 Output Queue

Description

Collects a list of jobs on the JES2 Output Queue. See the note in section “Using OSINFO System Information API Commands” for extra SDSF requirements to run this option.

Parameters

Job name, or a prefix of a job name with an * to find multiple jobs with the same starting characters.

Output

One line for each job found, in the format:

Job name | Job ID | Owner | JES2 output group priority | JES2 output class | Output form number | Print destination name | Output total record count (lines) | Output creation due

Sample Command

ev390hostcmd 46 07\|*.s390.mysite.com

Sample Output

SDSF |STC00024|START2 |144|A|STD |LOCAL |223 |05/13/2004 SMFDUMP |JOB00091|USER42 |144|A|STD |LOCAL |50 |05/14/2004 SYSLOG |STC01405|+MASTER+| 96|L|STD |LOCAL |20682 |06/09/2004 COMPRESS|JOB00166|IBMUSER |144|T|STD |LOCAL |6283 |10/19/2004

EOF

08 JES2 Held Queue

Description

Collects a list of jobs on the JES2 Held Queue. See the note in section “Using OSINFO System Information API Commands” for extra SDSF requirements to run this option.

Parameters

Job name, or a prefix of a job name with an * to find multiple jobs with the same starting characters.

Output

One line for each job found, in the format:

Job name | Job ID | Owner | JES2 output group priority | JES2 output class | JES2 output disposition | Print destination name | Output total record count (lines) | Output creation date

Sample Command

ev390hostcmd 46 08\|T*.s390.mysite.com

Sample Output

TCPIP |STC00577|TCPIP |144|K|HOLD |LOCAL |22 |10/19/2004 TSO |STC00803|++++++++|144|K|HOLD |LOCAL |12 |10/19/2004

EOF

10 Dataset Display

Description

Displays the contents of a sequential dataset, dataset member, or HFS file. If a partitioned dataset name is given without a member name, this command will return a list of all members in the dataset. This command cannot display VSAM datasets or datasets with unformatted records.

Parameters

Dataset or file name. For PDS members, specify the member name in parentheses. For HFS files, give the full path to the filename. (If the first character of the name is a forward slash (/), it is assumed that an HFS file is being described.) Remember that the syntax of the ev390hostcmd requires two consecutive periods to denote one period in any parameter. Optionally, specify "maxsize=n" as a second parameter to limit the number of lines of output. The default maxsize is 5000 lines. If the maximum number of lines is exceeded, an EVO140 message will be written to the output.

Output

One line for each line of the file.

Sample Command

  1. Display all the lines of the /etc/hosts HFS file:

ev390hostcmd 46 10\|/etc/hosts.s390.mysite.com

  1. Display all the lines of the VP390 member in the USER.PROCLIB dataset:

ev390hostcmd 46 10\|USER..PROCLIB(VP390).s390.mysite.com

  1. Display all the members of the USER.PROCLIB partitioned dataset:

ev390hostcmd 46 10\|USER..PROCLIB.s390.mysite.com

  1. Display all the lines of the THOMAS.DAILY.LOG sequential dataset:

ev390hostcmd 46 10\|THOMAS..DAILY..LOG.s390.mysite.com

  1. Display only the first 4 lines of the THOMAS.DAILY.LOG sequential dataset:

ev390hostcmd 46 10\|THOMAS..DAILY..LOG\|maxsize=4.s390.mysite.com

Sample Output

Line 1 of log Line 2 of log Line 3 of log Line 4 of log

EVO140 Maximum lines of output exceeded (4) EOF

12 Execute REXX Program

Description

Run the named REXX program. The named program must reside in a dataset identified by the SYSEXEC DD in the VP390 startup JCL.

Parameters

The first parameter is the name of the REXX program to run, followed by any parameters that are to be passed to the REXX program. Separate the program name from the program parameters with a vertical bar and separate the program parameters with white space. Up to 50 program parameters may be specified. Optionally, specify "maxsize=n" as the last parameter to limit then number of bytes of output that are returned. The default maxsize is 5000 bytes.

Output

The value of the REXX return statement will be sent as the output. Normally this will be one line, but multiple lines can be created by inserting carriage return (x'0A') characters into the value that is returned.

Sample Command

The following REXX program is saved as "TEST" in a SYSEXEC DD library:

/* REXX program that accepts two whole numbers and returns */

/* two lines of output: the numbers and the sum of the numbers */ parse upper arg parm1 parm2 .

if DATATYPE(parm1,'W') \= 1 | DATATYPE(parm2,'W') \= 1 then do

n = 'Inputs must be whole numbers' return n

exit end

linefeed = X2C('0A')

n = 'Input numbers:' parm1 parm2 linefeed 'sum is:' parm1 + parm2 return n

exit

Run the program with the parameters "111" and "222" with a maximum output of 6000 bytes. Note that the X2C('0A') function inserts a line break into the output:

ev390hostcmd 46 12\|TEST\|111 222\|maxsize=6000.s390.mysite.com

Sample Output

Input numbers: 111 222

sum is: 333 EOF

20 Machine Type and LPAR Capacity

Description

Displays the mainframe machine type and the LPAR capacity of the LPAR where the mainframe agent is running.

Parameters

None

Output

One line in the format:

Machine type | Machine Model ID | Machine Capacity | LPAR Name | LPAR ID | LPAR Capacity

The “Machine Capacity” and “LPAR Capacity” values represent the maximum

service rates in millions of service units per hour.

Sample Command

ev390hostcmd 46 "20.s390.mysite.com"

Sample Output

2098|D02 |11|ZOS2 |2|11 EOF

40 Active Jobs and Program Name

Description

Collects a list of active address spaces including the program name of the current step.

Parameters

Regular expression filter of job names to be displayed, or "*" for all.

Output

One line for each address space found, in the format:

Job name | Step name | Proc step | Job ID | Owner | Position | Performance Group number | Priority | Current real storage usage in frames | Program Name

If Program Name is not available, the field is filled in with “*NA”.

Sample Command

ev390hostcmd 46 "40|A.s390.mysite.com"

Sample Output

*MASTER*| | |STC05258|+MASTER+|N/S|0|FF|295|IEEMB860

PCAUTH |PCAUTH | | | |N/S|0|FB|40|*NA RASP |RASP | | | |N/S|0|FF|161|*NA TRACE |TRACE | | | |N/S|0|FB|41|*NA

IOSAS |IOSAS |IEFPROC | | |N/S|0|FF|1013|IOSVROUT LLA |LLA |LLA | | |N/S|0|FE|865|CSVLLCRE VTAM |VTAM |VTAM |STC05255|START1 |N/S|0|FE|1483|ISTINM01 RACF |RACF |RACF |STC05270|START2 |N/S|0|FE|58|IRRSSM00

JES2AUX |JES2AUX | | | |N/S|0|FB|50|*NA PORTMAP |PORTMAP |PMAP |STC05368|START2 |OUT|0|FF|330|PORTMAP RMFGAT |RMFGAT |IEFPROC |STC05358|START2 |N/S|0|FE|9695|ERB3GMFC

EOF

41 Display IMS Subsystem Name

Description

Displays the IMS subsystem name for the given job.

Parameters

Regular expression filter of job names to be displayed, or “*” for all.

Output

One line for each address space found, in the format: Job name | Subsystem name

If the given job is not an IMS job (that is, the job is not running program

DFSMVRC0), the subsystem name field is filled in with “*NA”.

Sample Command

ev390hostcmd 46 "41|^IMS.s390.mysite.com"

Sample Output

IMS10RL1|*NA IMS10CR1|IVP1 IMS10DL1|IVP1 IMS10RC1|IVP1

EOF

42 Display Program Name and PARM Value

Description

Displays the program name and any PARM value from the startup JCL of the named job.

Parameters

Regular expression filter of job names to be displayed.

Output

One line for each address space found, in the format: Job name | Program name | PARM value

Sample Command

ev390hostcmd 46 "42|^CICS.s390.mysite.com"

Sample Output

CICSA |DFHSIP |START=INITIAL,SYSIN EOF

43 Display DDNames of Job

Description

Displays the DD names and associated dataset names for the named job.

Parameters

Regular expression filter of job names to be displayed.

Output

One line for each dataset name found, in the format: Job name | DDName | Dataset name

DD names with several datasets concatenated will be displayed with a separate line for each dataset name. DD names that point to partitioned dataset members will show the member name in parentheses immediately after the dataset name.

Sample Command

ev390hostcmd 46 "43|VTAM.s390.mysite.com"

Sample Output

VTAM |VTAMLST |USER.VTAMLST VTAM |VTAMLST |SYS1.VTAMLST VTAM |VTAMLIB |USER.VTAMLIB VTAM |VTAMLIB |SYS1.VTAMLIB VTAM |SISTCLIB|SYS1.SISTCLIB

VTAM |ACYGDMO |SYS1.SISTGDMO(ACYGDMO)

VTAM |SYSABEND|START1.VTAM.STC06385.D0000101.? VTAM |TRSDB |SYS1.TRSDB

EOF

50 Execute WebSphere MQ Command

Description

Executes a WebSphere MQ command and displays the command output.

Parameters

MQ Manager name followed by the WebSphere MQ command to be executed. Optionally, specify "maxsize=n" as a third parameter to limit the number of lines of output. The default maxsize is 64000 bytes. If the maximum number of bytes is exceeded, an EVO141 message will be written to the output.

Output

One line for each line of command output.

Sample Command

ev390hostcmd 46 "50|CSQ7|DISPLAY CHANNEL(*).s390.mysite.com"

ev390hostcmd 46 "50|CSQ7|DISPLAY CHANNEL(*)|maxsize=70000.s390.mysite.com"

Sample Output

CSQN205I COUNT= 13, RETURN=00000000, REASON=00000000 CSQM410I %CSQ7 CHANNEL(mars.to.venus) CHLTYPE(SDR) QSGDISP(QMGR)

CSQM412I %CSQ7 CHANNEL(venus.to.mars) CHLTYPE(RCVR) QSGDISP(QMGR)

CSQM417I %CSQ7 CHANNEL(SYSTEM.DEF.CLUSRCVR) CHLTYPE(CLUSRCVR) QSGDISP(QMGR)

CSQM418I %CSQ7 CHANNEL(SYSTEM.DEF.CLUSSDR) CHLTYPE(CLUSSDR) QSGDISP(QMGR)

CSQM412I %CSQ7 CHANNEL(SYSTEM.DEF.RECEIVER) CHLTYPE(RCVR) QSGDISP(QMGR)

CSQM413I %CSQ7 CHANNEL(SYSTEM.DEF.REQUESTER) CHLTYPE(RQSTR) QSGDISP(QMGR)

CSQM410I %CSQ7 CHANNEL(SYSTEM.DEF.SENDER) CHLTYPE(SDR) QSGDISP(QMGR)

CSQM411I %CSQ7 CHANNEL(SYSTEM.DEF.SERVER) CHLTYPE(SVR) QSGDISP(QMGR)

CSQM415I %CSQ7 CHANNEL(SYSTEM.DEF.SVRCONN) CHLTYPE(SVRCONN) QSGDISP(QMGR)

CSQM412I %CSQ7 CHANNEL(VENUS.TO.MARS) CHLTYPE(RCVR) QSGDISP(QMGR)

CSQ9022I %CSQ7 CSQMDRTS ' DISPLAY CHANNEL' NORMAL COMPLETION EOF

60 Display TCP/IP Connections

Description

Displays “netstat” type information from a mainframe TCP/IP stack.

Parameters

[stack|*][|protocol[,protocol]...][|stat][,stat]...][|verbosity] where:

stack

An 8-character TCP/IP jobname, or “*” for first active stack

(default=*)

protocol

TCP|UDP|ALL Display TCP only, UDP only, or both (default=ALL)

stat

CONN|LISTEN|ALL Display connected or listening ports, or both (default=ALL)

verbosit y

SHORT|LONG The LONG output requires slightly more processing time to gather the additional information (default=SHORT)

Output

One line for each active port, in the format (depending on the verbosity requested):

SHORT Output:

Protocol | IP Family | Local Address | Local Port | Remote Address | Remote Port | Bytes Received | Bytes Sent | State

LONG Output:

Protocol | IP Family | Local Address | Local Port | Remote Address | Remote Port | Bytes Received | Bytes Sent | State |Connection Time (seconds) | Idle Time (seconds) | Owning Jobname

Sample Command

ev390hostcmd 46 "60|TCPIP.s390.mysite.com"

ev390hostcmd 46 "60|*|ALL|ALL|LONG.s390.mysite.com"

Sample Output

TCP|IPV4|192.168.0.210 | 6106|192.168.0.174 |64940| 0| 5404|ESTABLISH |203|3|EV390V70

TCP|IPV4|192.168.0.210 | 6107|192.168.0.174 |64939| 367| 15|ESTABLISH |206|0|EV390V70

TCP|IPV6|::ffff:192.168.0.210| 23|::ffff:192.168.1.128|52017| 4949| 159675|ESTABLISH|11866| 160|TN3270

UDP|IPV4|192.168.0.222 |12000|0.0.0.0 | 0| 0| 0|UDP|1370650|1370650|VTAM

UDP|IPV4|192.168.0.222 |12004|0.0.0.0 | 0| 0| 0|UDP|1370650|1370650|VTAM

TCP|IPV6|:: | 23|:: | 0| 0| 0|LISTEN|1371721|2091|TN3270

TCP|IPV6|:: | 21|:: | 0| 0| 0|LISTEN|1371713|736247| FTPD1

UDP|IPV4|0.0.0.0 | 111|0.0.0.0 | 0| 0| 0|UDP|1370642|1370642|PORTMAP

EOF

  1. Display Network Interfaces

Description

Displays list of defined interfaces and devices for a TCP/IP stack.

Availability

Agent running z/OS V1R12 and later.

Parameters

Regular expression filter of job names to be displayed, or “*” for all.

Output

One line for each interface found, in the format:

Interface Name | Interface Associated Name | MAC Address | PhysVirt

| Status | Interface Type

The PhysVirt value will be either “P” to indicate that the MAC address listed is a Physical MAC address, or ”V” to indicate a configured or OSA-generated VMAC address.

Sample Command

ev390hostcmd 46 "61|*.s390.mysite.com"

Sample Output

LOOPBACK |LOOPBACK |00-00-00-00-00-00|P|ACTIVE |LOOPBACK |IPV4|127.0.0.1| LOOPBACK6 | |00-00-00-00-00-00|P|ACTIVE |LOOPBACK |IPV6|::1||LOOPBACK| VLINK2 |VIPA2 |00-00-00-00-00-00|P|ACTIVE |STATIC-VIRT

|IPV4|192.168.0.222|PRIMARY

OSDL |ADM1ETP |00-14-5E-B8-81-95|P|ACTIVE |ETHERNET-OSD |IPV4|192.168.0.218| OSDL6 |ADM1ETP |00-14-5E-B8-81-95|P|ACTIVE |ETHERNET-OSD

|IPV6|fe80::14:5e00:1b8:8195| AUTOCONFIG|LINK_LOCAL|

OSDL6 |ADM1ETP |00-14-5E-B8-81-95|P|ACTIVE |ETHERNET-OSD

|IPV6|fda5:3ad7:3471:5::218| |GLOBAL|

EZASAMEMVS |IUTSAMEH |00-00-00-00-00-00|P|ACTIVE |MPC-P2P-SAME |IPV4|192.168.0.212| EZAXCF2A |Z113SSCP |00-00-00-00-00-00|P|ACTIVE |MPC-P2P-XCF |IPV4|192.168.0.212| VIPLC0A801DB |VIPLC0A801DB |00-00-00-00-00-00|P|ACTIVE |DYNAMIC-VIRT IPV4|192.168.0.219| EOF

110 TSO-Generated Netstat Connections

Description

Displays the network configuration and status of a TCP/IP stack via a “netstat” request to TSO. This option requires a temporary dataset to hold the TSO output (see the note in section “Using OSINFO System Information API Commands”).

Parameters

An 8-character TCP/IP jobname, or “*” for first active stack (default=*) (Optional) “APPLDATA” to show detailed information concerning application

data for TCP connections.

Output

TSO-styled “NETSTAT ALLConn” output. Note that the format of the output

changed after z/OS V1R10.

Sample Command

ev390hostcmd 46 “110|*.s390.mysite.com”

ev390hostcmd 46 “110|*|APPLDATA.s390.mysite.com”

Sample Output

MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPIP 22:03:36

User Id Conn State

BPXOINIT 00000024 Listen

Local Socket: 0.0.0.0..10007

Foreign Socket: 0.0.0.0..0

CICSWUIP 00000050 Listen

Local Socket: ::..12345

Foreign Socket: ::..0

Application Data: DFHIWUINCM01CWXNHTTP EYUWUI CICSWUIP 00000052 Listen

Local Socket: ::..12346

Foreign Socket: ::..0

Application Data: DFHIWUINCM01CWXNHTTP EYUCMCIT

EV390V70 0004ED53 Establish

Local Socket: 192.168.1.210..6107

Foreign Socket: 192.168.1.174..64939 EV390V70 0004ED55 Establish

Local Socket: 192.168.1.210..6106

Foreign Socket: 192.168.1.174..64940

FTPD1 00000022 Listen

Local Socket: ::..21

Foreign Socket: ::..0 Application Data: EZAFTP0D

EOF

110 TSO-Generated Netstat Home Addresses

Description

Displays the IP address and associated links or interface name via a “netstat” request to TSO. This option requires a temporary dataset to hold the TSO output (see the note in section “Using OSINFO System Information API Commands”).

Parameters

An 8-character TCP/IP jobname, or “*” for first active stack (default=*)

Output

TSO-styled “NETSTAT HOME” output. Note that the format of the output

changed after z/OS V1R10.

Sample Command

ev390hostcmd 46 "111|TCPIP.s390.mysite.com"

Sample Output

MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPIP 15:25:19

Home address list: LinkName: VLINK2

Address: 192.168.1.222

Flags: Primary LinkName: EZASAMEMVS

Address: 192.168.1.212

Flags:

LinkName: VIPLC0A801DB Address: 192.168.1.219

Flags:

LinkName: EZAXCF2A Address: 192.168.1.212

Flags:

LinkName: LOOPBACK Address: 127.0.0.1

Flags:

IntfName: OSDL

Address: 192.168.1.210

Flags:

IntfName: OSDL6

Address: fda5:3ad7:3471:5::210 Type: Global

Flags:

Address: fe80::14:5e00:1b8:8195 Type: Link_Local

Flags: Autoconfigured IntfName: LOOPBACK6

Address: ::1 Type: Loopback Flags:

EOF

  1. TSO-Generated Netstat Routing Table

Description

Displays the TCP/IP routing table for the named TCP/IP stack via a “netstat” request to TSO. This option requires a temporary dataset to hold the TSO output (see the note in section “Using OSINFO System Information API Commands”).

Parameters

An 8-character TCP/IP jobname, or “*” for first active stack (default

(Optional) “APPLDATA” to show detailed information concerning application

data for TCP connections.

Output

TSO-styled “NETSTAT ARP” output. Note that prior to z/OS V1R12, only IPV4 destinations are displayed. Beginning with z/OS V1R12, both IPV4 and IPV6 destinations are listed.

Sample Command

ev390hostcmd 46 "112|*.s390.mysite.com"

ev390hostcmd 46 "112|*|APPLDATA.s390.mysite.com"

Sample Output

MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPIP 15:28:34

IPv4 Destinations

Destination Gateway Flags Refcnt Interface

----------- ------- ----- ------ --------- Default 192.168.1.1 UGS 0000000000 OSDL

127.0.0.1/32 0.0.0.0 UH 0000000000 LOOPBACK

192.168.1.0/24 0.0.0.0 US 0000000007 OSDL

192.168.1.210/32 0.0.0.0 UH 0000000000 OSDL

192.168.1.211/32 0.0.0.0 UHS 0000000000 EZAXCF2A

192.168.1.212/32 0.0.0.0 UH 0000000000 EZASAMEMVS

192.168.1.212/32 0.0.0.0 UH 0000000000 EZAXCF2A

192.168.1.219/32 0.0.0.0 UH 0000000000 VIPLC0A801DB

192.168.1.222/32 0.0.0.0 UH 0000000000 VLINK2

IPv6 Destinations DestIP: Default

Gw: fda5:3ad7:3471:5::1

Intf: OSDL6 Refcnt: 0000000000

Flgs: UGS MTU: 1500

DestIP: ::1/128 Gw: ::

Intf: LOOPBACK6 Refcnt: 0000000002

Flgs: UH MTU: 65535

DestIP: fda5:3ad7:3471:5::/64 Gw: ::

Intf: OSDL6 Refcnt: 0000000000

Flgs: US MTU: 1500

DestIP: fda5:3ad7:3471:5::210/128 Gw: ::

Intf: OSDL6 Refcnt: 0000000000

Flgs: UH MTU: 1500

DestIP: fe80::14:5e00:1b8:8195/128 Gw: ::

Intf: OSDL6 Refcnt: 0000000000

Flgs: UH MTU: 1500

EOF

  1. TSO-Generated Netstat ARP Cache

Description

Displays the IPV4 ARP cache for the named TCP/IP stack via a “netstat” request to TSO. This option requires a temporary dataset to hold the TSO output (see the note in section “Using OSINFO System Information API Commands”)

Parameters

An 8-character TCP/IP jobname, or “*” for first active stack (default=*)

(Optional) Display the ARP cache for a specific network address (in the format

nnn.nnn.nnn.nnn) or “ALL”. “ALL” is the default.

Output

TSO-styled “NETSTAT ARP” output

Sample Command

ev390hostcmd 46 "113|*.s390.mysite.com"

ev390hostcmd 46 "113|192..168..1..102.s390.mysite.com"

(Remember that period characters must be doubled in the command portion of an ev390hostcmd to differentiate it from the destination agent name.)

Sample Output

MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPIP 15:37:48

Querying ARP cache for address 192.168.1.52 Interface: OSDL ETHERNET: 00145EB88185

Querying ARP cache for address 192.168.1.53 Interface: OSDL ETHERNET: 00145EB88185

Querying ARP cache for address 192.168.1.54 Interface: OSDL ETHERNET: 00145EB88185

Querying ARP cache for address 192.168.1.55 Interface: OSDL ETHERNET: 00145EB88185

Querying ARP cache for address 192.168.1.1 Interface: OSDL ETHERNET: 00A0CC65D8A2

EOF

  1. TSO-Generated Netstat Device Links

Description

Displays the devices, links, and interfaces defined to a TCP/IP stack via a “netstat” request to TSO. This option requires a temporary dataset to hold the TSO output (see the note in section “Using OSINFO System Information API Commands”).

Parameters

An 8-character TCP/IP jobname, or “*” for the first active stack (default=*)

Output

TSO-styled “NETSTAT DEVLINKS” output

Sample Command

ev390hostcmd 46 "114|*.s390.mysite.com"

Sample Output

MVS TCP/IP NETSTAT CS V2R1 TCPIP Name: TCPIP 15:51:23

DevName: LOOPBACK DevType: LOOPBACK DevStatus: Ready

LnkName: LOOPBACK LnkType: LOOPBACK LnkStatus: Ready ActMtu: 65535

Routing Parameters:

MTU Size: n/a Metric: 00

DestAddr: 0.0.0.0 SubnetMask: 0.0.0.0 Multicast Specific:

Multicast Capability: No Link Statistics:

BytesIn = 119485313

Inbound Packets = 1896986

Inbound Packets In Error = 0

Inbound Packets Discarded = 0 Inbound Packets With No Protocol = 0 BytesOut = 119485313

Outbound Packets = 1896986

Outbound Packets In Error = 0

Outbound Packets Discarded = 0

IntfName: OSDL IntfType: IPAQENET IntfStatus: Ready PortName: ADM1ETP Datapath: 0402 DatapathStatus: Ready CHPIDType: OSD SMCR: Disabled (GLOBALCONFIG NOSMCR)

PNetID: *None* Speed: 0000000100

IpBroadcastCapability: No

CfgRouter: Non ActRouter: Non

ArpOffload: Yes ArpOffloadInfo: Yes

CfgMtu: None ActMtu: 1492 IpAddr: 192.168.1.210/24

VLANid: None VLANpriority: Disabled ReadStorage: GLOBAL (4096K)

InbPerf: Balanced

ChecksumOffload: Yes SegmentationOffload: No

SecClass: 255 MonSysplex: No

Isolate: No OptLatencyMode: No Multicast Specific:

Multicast Capability: Yes

Group RefCnt SrcFltMd

----- ------ --------

224.0.0.1 0000000001 Exclude

SrcAddr: None Interface Statistics:

BytesIn = 5900185389

Inbound Packets = 13211764

Inbound Packets In Error = 15390

Inbound Packets Discarded = 0 Inbound Packets With No Protocol = 0

BytesOut = 1089099540

Outbound Packets = 10967466

Outbound Packets In Error = 0

Outbound Packets Discarded = 0

DevName: VIPDC0A801DB DevType: VIPA DevStatus: Ready

LnkName: VIPLC0A801DB LnkType: VIPA LnkStatus: Ready Routing Parameters:

MTU Size: n/a Metric: 01

DestAddr: 0.0.0.0 SubnetMask: 255.255.255.0 Multicast Specific:

Multicast Capability: No

IPv4 LAN Group Summary LanGroup: 00002

Name Status ArpOwner VipaOwner

---- ------ -------- ---------

OSDL Active OSDL Yes IPv6 LAN Group Summary

LanGroup: 00001

Name Status NDOwner VipaOwner

---- ------ ------- ---------

OSDL6 Active OSDL6 Yes

OSA-Express Network Traffic Analyzer Information:

No OSA-Express Network Traffic Analyzer interfaces are defined EOF