OMVSDATA subcommand — format z/OS UNIX data

Use the OMVSDATA subcommand to generate diagnostic reports about z/OS UNIX System Services (z/OS UNIX) users and resources.
  • Syntax
        OMVSDATA 

    -------- Data Selection Parameters -------------------------

                    [ COMMUNICATIONS ]
                    [ FILE ]
                    [ IPC ]
                    [ PROCESS ]
                    [ STORAGE ] 

    -------- Report Type Parameters ----------------------------

                    [ DETAIL ]
                    [ EXCEPTION ]
                    [ SUMMARY ] 

    -------- Address Space Selection Parameters ----------------

                    [ ASIDLIST(asidlist) ]
                    [ USERLIST(userlist) ] 

    -------- SETDEF-Defined Parameters -------------------------
    Note: You can override the following SETDEF parameters.
    See SETDEF subcommand — set defaults.

                   [ ACTIVE | MAIN | STORAGE          ]
                   [ DSNAME(dsname) | DATASET(dsname) ]
                   [ FILE(ddname) | DDNAME(ddname)    ]
                   [ PATH(path-name)     ]
                   [ FLAG(severity) ]
                   [ PRINT | NOPRINT ]
                   [ TERMINAL | NOTERMINAL ]
                   [ TEST | NOTEST ]
  • Data Selection Parameters
    Use these parameters to limit the scope of the data in the report. IPCS produces a report for each data selection parameter. If you omit a data selection parameter, the default is PROCESS.
    COMMUNICATIONS
    Specifies that communication services information appears in the report.
    FILE
    Specifies that file systems information appears in the report.
    IPC
    Specifies that the report is to contain information about interprocess communication for shared memory, message queues, and semaphores.
    PROCESS
    Specifies that information about all dubbed processes appears in the report. The report includes information about serialization, signaling, and, if the DETAIL parameter is also specified, open files.
    STORAGE
    Specifies that storage services information appears in the report.
  • Report Type Parameters
    Use these parameters to select the type of report. If you omit a report type parameter, the default is SUMMARY.
    DETAIL
    Requests the detail report, which includes detailed information about the data area selected.
    EXCEPTION
    Requests the exception report, which contains exceptional or unusual conditions for the data area selected. The exception report contains diagnostic information for IBM® use.
    SUMMARY
    Requests a summary report for the data area selected.
  • Address Space Selection Parameters
    Use these parameters to obtain data from particular address spaces, which you specify by their address space identifiers (ASIDs) or by the TSO/E user IDs associated with the address space.
    ASIDLIST(asidlist)
    Specifies a list of ASIDs for the address spaces for which you want IPCS to process the requested data.

    The asidlist can be a single ASID, a range of ASIDs, or a list of noncontiguous ASIDs, When you specify a range, separate the first and last ASIDs in the range with a colon. When you specify a list, separate the list members with commas.

    An ASID can be 1 through 65535. An ASID can be expressed in the notation X'nnn', F‘nnn’, or B'nnn'. An unqualified number is assumed to be fixed.

    USERLIST(userlist)
    Specifies a list of TSO/E user IDs associated with the address spaces for which you want IPCS to process the requested data. The userlist can be a single user ID or a list of user IDs. When you specify a list, separate the list members with commas. For example:
    USERLIST(userid)
    
    USERLIST(userid,userid...,userid)
  • Return Codes

    See Standard subcommand return codes for a description of the return codes produced by the OMVSDATA subcommand.

  • Example: See z/OS MVS Diagnosis: Reference for examples of the OMVSDATA subcommand and its output.