Enhancements to Existing Features › Options › Base Product Enhancements › z/OS Component Enhancements › Commands Enhanced for the z/OS Component

Commands Enhanced for the z/OS Component

The following enhancements have been made to existing commands:

ACTIVITY

Displays the system activity.

New data fields:

• Dispatch - The dispatchability of the address space.

  One of the following values:

  • RUNNING - The address space has one or more units of work (tasks or SRBs) running on a processor.
  • READYnnn - The address space has one or more units of work (tasks or SRBs) that are dispatchable but are waiting to run on a processor. The nnn portion is the dispatch priority order up to a maximum of 255.
  • Blank - The address space is not dispatchable.
• PASID - OpenMVS process parent ASID.
• PJobname - OpenMVS process parent jobname.

Changed data fields

• JobClass - Specifies the job input class. This field is filled in for JES3.
• Notify - The NOTIFY field from the job statement of the job. This field is filled in for JES3.
• Programmer - The programmer name from the job statement of the job. This field is filled in for JES3.

ALERTS

Displays the MVS exception alerts.

Syntax:

ALERTS	< WARNing     | NORMal   >
		< THRESH       | ALL      >
		< DETAIL        | SUMMARY  >
		< STATS         | NOSTATS  >
		< DESC          | NODESC   >
		< ACK             | NOACK    >
		< NOXSData    | XSData   >
		< NOXSYStem | XSYStem  >

		< NAME             name     >

		< RESource       resource >
		< RSCE             resource >
		< ARGument       resource >

		< ALIAS             alias    >
		< ALTID             altid    >
		< GROUP           group    >
		< SUBGroup       subgroup >
		< SUMMGRP       summgrp  >

New syntax parameters:

• SUMMGRP summgrp - Limit the display to only those entries with corresponding value in the SummGrp field.

New data fields

• SummGrp - The summarization group ID.

APPLMON

Displays the VTAM application monitor availability summary.

The command has been enhanced to support the library concatenation.

Changed subcommand syntax parameters:

Export definitions to a specific member of a data set.

Syntax:

EXPORT   member
                dsname(member)

Parameters and descriptions

• member - The name of the member to be saved.
• dsname - The data set name where the specified member is saved.

  The data set name can be specified as a fully qualified data set name or using one of the following special keywords.

Keywords and descriptions

• USER - Use the optional data set name that you defined in the user profile for the library type PARMLIB.

  Example: USER(member)

• SITE - Use the optional site PARMLIB date set that is defined in the system configuration options parmlib member GSVXSYSV.

  Example: SITE(member)

• SYSTEM - Use the system PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV.

  Example: SYSTEM(member)

• SITESYSTEM|* - Use the optional site PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV. If the site data set has not been defined, use the system PARMLIB data set name.

  Example:

  SITESYSTEM(member)
                     *(member)
  

ASCANCEL

Cancels an address space.

The ASCANCEL command has been updated to support a new address space TYPE operand.

Syntax:

ASCANCEL <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASCANTSK

Cancel a task within an address space.

The ASCANTSKL command has been updated to support a new address space TYPE operand.

Syntax:

ASCANTSK <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASFORCE

Forces an address space.

The ASFORCE command has been updated to support a new address space TYPE operand.

Syntax:

ASFORCE <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASID

Sets the target address space.

The ASID command has been updated to support a new address space TYPE operand.

Syntax:

ASID <asid<.dspname>> <option> <TYPE astype>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASKILL

Deletes the target address space.

The ASKILL command has been updated to support a new address space TYPE operand.

Syntax:

ASID <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASLIST

Displays the address space information.

New data fields:

• Dispatch - The dispatchability of the address space.

  One of the following values:

  • RUNNING - The address space has one or more units of work (tasks or SRBs) running on a processor.
  • READYnnn - The address space has one or more units of work (tasks or SRBs) that are dispatchable but are waiting to run on a processor. The nnn portion is the dispatch priority order up to a maximum of 255.
  • Blank - The address space is not dispatchable.
• SMC - Number of outstanding Step-Must-Complete requests in the address space.

ASNOSWAP

Set the address space as nonswappable.

The ASNOSWAP command has been updated to support a new address space TYPE operand.

Syntax:

ASNOSWAP <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASOKSWAP

Set the address space as swappable.

The ASOKSWAPL command has been updated to support a new address space TYPE operand.

Syntax:

ASOKSWAP <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASQUERY

Query the address space variables.

The ASQUERY command has been updated to support a new address space TYPE operand.

Syntax:

ASQUERY <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASQUIESC

Set the address space quiesced.

The ASQUIESC command has been updated to support a new address space TYPE operand.

Syntax:

ASQUIESC <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASRESUME

Set the address space unquiesced.

The ASRESUME command has been updated to support a new address space TYPE operand.

Syntax:

ASRESUME <asid> <TYPE astype> <infokwd>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

ASSET

Set the address space attributes.

The ASSET command has been updated to support a new address space TYPE operand.

Syntax:

ASSET <asid> function <value> <options TYPE astype>

Parameters and descriptions

• TYPE astype - Only specify the TYPE parameter when the asid parameter is a jobname or the FIRST, NEXT, PREVIOUS, or LAST keywords.

  This parameter is used to restrict the possible match to a specific address space type.

• astype - Specify one of the following keywords for this value:
  • ANY - (Default) Any address space type.
  • ATX - An APPC transaction.
  • INIT - An initiator.
  • JOB - A batch job.
  • OTX - An OMVS transaction.
  • STC - A started task.
  • SYS - A system task.
  • TSU - A TSO user.

CPU

Displays CPU information.

New Data Field

• PSACLHSE - The contents of the PSACLHSE field (the current locks held string extension).

DSALLOC

Displays the data sets allocated to a job.

New Data Fields:

• DASp - This value is DASp when the DDname has the DD accounting suppressed attribute. Otherwise, it is blank.

  When the DDname accounting is suppressed, the following fields have no value and display blanks.

  • IOCt - The I/O count.
  • IORt - The I/O rate.
  • TCTE - The TCT DD entry address.
• Dest - The system output destination.
• Type - The type of entry displayed.

  Valid Values:

  • DATASET - Data set
  • DUMMY - Dummy data set
  • SYSOUT - SYSOUT data set
  • SYSIN - SYSIN data set
  • TERMINAL - Terminal
  • OMVSPATH - OMVS path name
  • CONSOLE - Console
  • UNKNOWN - Unknown
  • DEVICE- The second through nth device for a multivolume data set.
• Userid - The sysout remote user ID.

DSSERV

Data set services.

The DELETE subcommand supports the deleting of multiple volume and archived data sets.

New Subcommands

• ALCONcat - This service allocates a data set and then concatenates it to a ddname. If the ddname is not already allocated, then this service is the equivalent of the ALLOCATE service.

LISTDIR

Displays the PDS directories.

New data fields:

• Owner - The module identifier owner user ID.

HCHECKER

Displays the Health Checker information.

New line commands:

• History - Invokes the HCLOG command to display historical log records for the selected owner and the checker name.

HCOWNER

Displays the Health Checker owner summary.

New line commands:

• History - Invokes the HCLOG command to display historical log records for the selected owner and the checker name.

HCMSGS

Displays the Health Checker messages.

Syntax:

HCMSGS  owner check <options>

or

HCMSGS  BLOCKID blockid <options>

New syntax parameters:

• BLOCKID - The BLOCKID keyword and value are used to request that the Health Check log stream read a specific message block. The BLOCKID value must 16 hexadecimal characters and must not be all zeros. The BLOCKID keyword and value are only valid when the IBM Health Checker is writing checker output messages to a log stream.

  The HCLOG command displays records written to the Health Checker log stream. The displayed data includes Block ID values. The S<elect> line command on the HCLOG display invokes the HCMSGS command for the selected block ID.

IPLINFO

IPL information.

New data fields for the section: General

• MACHMIG statements

New data fields for the section: IEASYS

• GTZ - Specifies one or more suffixes of the Generic Tracker parmlib member, GTZPRMxx, for the system to use. This parameter is valid only at z/OS 2.1 or higher.
• HZS - This parameter specifies one or more suffixes of the optional IBM Health Checker for the z/OS parmlib member HZSPRMxx, for the system to use.

  The two characters, represented by aa or bb, and so on, are appended to HZSPRM. This forms the name of the HZSPRMxx members when HZSPRM=SYSPARM (or HZSPRM=PREV for IPL-time) is specified in the HZSPROC startup procedure for IBM Health Checker for z/OS. The HZS parameter is valid only at z/OS 2.1 or higher.

• HZSPROC - This parameter specifies the name of the HZSPROC procedure the system uses for automatically starting IBM Health Checker for z/OS at IPL-time.

  Specify this parameter if you want to use a name other than the default, HZSPROC. The specified procedure must reside in an SYS1.PROCLIB data set.

  The HZSPROC parameter is valid only at z/OS 2.1 or higher.

• PAGESCM - This parameter specifies the minimum amount of SCM storage to be made available for use as auxiliary storage. The system reserves this amount of during IPL for subsequent use as auxiliary storage. More space is allocated on an as-needed basis when use of this initial amount of is exceeded. The PAGESCM parameter is valid only at z/OS 2.1 or higher.
• WARNUND - This parameter asks that the system warns you when an undefined system parameter is found rather than prompting for new system parameters. The WARNUND parameter is valid only at z/OS 2.1 or higher.

LGBROWSE

The CA SYSVIEW log stream technology that is used to read and write from the log streams now provides a significant performance boost.

This enhancement provides these benefits:

• Reduced the CPU used to read and write from a log stream.
• Reduced the elapsed time that is required to read many records from a log stream.

The default and maximum value for the LINES parameter has been adjusted.

Parameter

• LINES

  New Default: 25,000

  New Maximum: 1,000,000

  Old Default: 5,000

  Old Maximum: 100,000

  This LINES value is stored in the user profile. You can change the stored default value by issuing the following command from the desired primary command:

  OPTIONS LINE nnnnn
  

LGSTREAM

Displays the log stream definitions.

New data fields:

• WPri - Displays WPRI when WARNPRIMARY(YES) was specified for the log stream definition. Otherwise blank.
• WPRI indicates that log stream monitoring warning messages should be issued for the following conditions:
  • When the log stream primary (interim) storage consumption is 2/3 between the HIGHOFFLOAD value and 100 percent full.
  • For a CF-based log stream, when a 90 percent entry full condition is encountered.
  • When an interim (primary) storage full condition is encountered.

  WPRI is only possible at z/OS 2.1.0 or higher.

• ZAI - ZAI if you want the log stream data sent to the IBM zAware server. Otherwise blank.
• ZAIData - Any log stream-related data that you want passed to the IBM zAware server when the z/OS IBM log stream client is established.

LISTDIR

List PDS directory

New data fields:

• Owner - The module identifier owner user ID.

  This field is only available for selected CA products.

LISTMODS

Product module status

New data fields:

• Owner - The module identifier owner user ID.

  This field is only available for selected CA products.

LSRPOOLS

Displays the local shared resource pools.

New Data Field

• HStg - The total amount of hiperspace storage that the buffers use.

MOBJECTS

Displays the memory objects summary.

New information section fields

• LFArea
• Reconfig
• NonReconfig
• Used

  The large frame area (LFAREA), reconfigurable size, nonreconfigurable sizes, and the total percentage used.

MODULES

Displays information about storage-resident modules.

New Data Field

• Owner - The module identifier owner user ID. This field is only available for selected CA products.

MONITOR

Displays the MVS monitor definitions.

The command has been enhanced to support the library concatenation.

Changed subcommand syntax parameters:

Export definitions to a specific member of a data set.

Syntax:

EXPORT   member
                dsname(member)

Parameters and descriptions

• member - The name of the member to be saved.
• dsname - The data set name where the specified member is saved.

  The data set name can be specified as a fully qualified data set name or using one of the following special keywords.

Keywords and descriptions

• USER - Use the optional data set name that you defined in the user profile for the library type PARMLIB.

  Example: USER(member)

• SITE - Use the optional site PARMLIB date set that is defined in the system configuration options parmlib member GSVXSYSV.

  Example: SITE(member)

• SYSTEM - Use the system PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV.

  Example: SYSTEM(member)

• SITESYSTEM|* - Use the optional site PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV. If the site data set has not been defined, use the system PARMLIB data set name.

  Example:

  SITESYSTEM(member)
                     *(member)
  

PAGEDS

Displays information about the page data sets.

Changed line commands

• Add - Adds a new LOCAL page data set or restores a previously drained LOCAL page data set to read/write mode. The command confirmation has been added.
• DRain - Makes a LOCAL page data set read-only. The command confirmation has been added.
• DElete - Removes a LOCAL page data set from system use. The command confirmation has been added.

PFT

Displays information in the Page Frame Table.

New data fields:

• L - This value is L when the frame is within a group of 256 contiguous frames that can be used to hold a 1-MB page.
• E - This value is E when you want to reform the frame into a group of 256 contiguous frames for holding a 1-MB page.
• M - This value is M when the frame is backing a shared 1M large page.
• H - This value is H when the frame is backing a high virtual shared page.

PLOTLOG

Displays the historical plot log.

The CA SYSVIEW log stream technology that is used to read and write from the log streams now provides a significant performance boost.

This enhancement provides these benefits:

• Reduced the CPU used to read and write from a log stream.
• Reduced the elapsed time that is required to read many records from a log stream.

The default and maximum value for the LINES parameter has been adjusted.

Parameter

• LINES

  New Default: 25,000

  New Maximum: 1,000,000

  Old Default: 5,000

  Old Maximum: 100,000

  This LINES value is stored in the user profile. You can change the stored default value by issuing the following command from the desired primary command:

  OPTIONS LINE nnnnn
  

PROCLIST

Displays the JES procedure libraries.

Support has been added to JES3.

STATES

Displays the state monitor definitions.

The command has been enhanced to support the library concatenation.

Changed subcommand syntax parameters:

Export definitions to a specific member of a data set.

Syntax:

EXPORT   member
                dsname(member)

Parameters and descriptions

• member - The name of the member to be saved.
• dsname - The data set name where the specified member is saved.

  The data set name can be specified as a fully qualified data set name or using one of the following special keywords.

Keywords and descriptions

• USER - Use the optional data set name that you defined in the user profile for the library type PARMLIB.

  Example: USER(member)

• SITE - Use the optional site PARMLIB date set that is defined in the system configuration options parmlib member GSVXSYSV.

  Example: SITE(member)

• SYSTEM - Use the system PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV.

  Example: SYSTEM(member)

• SITESYSTEM|* - Use the optional site PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV. If the site data set has not been defined, use the system PARMLIB data set name.

  Example:

  SITESYSTEM(member)
                     *(member)
  

SYSTEMS

Displays the Systems Overview menu.

New data fields:

• IDMS - The IDMS component is active on the specific system.
• JesN - The primary JES name.

TASK

Displays task information for a job.

Positioning the cursor to the following fields and pressing <ENTER> invokes the MAP command for the selected field and address.

• TCB
• RB
• STCB
• XSB
• OTCB
• OTCBCOPYONFORK
• THLI
• PRLI

Deleted line commands

• MTcb - Invokes the MAP command to map the TCB
• MStcb - Invokes the MAP command to map the STCB
• MRb - Invokes the MAP command to map the RB
• MXsb- Invokes the MAP command to map the XSB
• MOTcb - Invokes the MAP command to map the OTCB
• MOCof - Invokes the MAP command to map the OTCBCOPYONFORK
• MTHli - Invokes the MAP command to map the THLI

New data fields

• ThreadId - The OMVS thread ID.

THRESH

Displays the current threshold definitions.

The command has been enhanced to support the library concatenation.

Changed subcommand syntax parameters:

Export definitions to a specific member of a data set.

Syntax:

EXPORT   member
                dsname(member)

Parameters and descriptions

• member - The name of the member to be saved.
• dsname - The data set name where the specified member is saved.

  The data set name can be specified as a fully qualified data set name or using one of the following special keywords.

Keywords and descriptions

• USER - Use the optional data set name that you defined in the user profile for the library type PARMLIB.

  Example: USER(member)

• SITE - Use the optional site PARMLIB date set that is defined in the system configuration options parmlib member GSVXSYSV.

  Example: SITE(member)

• SYSTEM - Use the system PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV.

  Example: SYSTEM(member)

• SITESYSTEM|* - Use the optional site PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV. If the site data set has not been defined, use the system PARMLIB data set name.

  Example:

  SITESYSTEM(member)
                     *(member)
  

TRACE

Displays the status of the system trace.

New data fields:

• PSACLHSE - The contents of the PSACLHSE field (the current locks held string extension).

UPROCESS

Displays information about the USS processes.

This command has been enabled for cross-system data.

New data fields

• Type - The address space type.
• PASID - The parent process ASID.
• PJobname - The parent process job name.
• PType - The parent process address space type.
• PJobnr - The parent process job number.
• PUserid - The parent process user id.

VARS

Displays the available monitoring variables.

New Data Field:

• SummGrp - The summarization group ID

WMPOLICY

Displays the WLM service policy information.

Renamed Data Field

The new field name: *

The old field name: Field.

XLOG

Displays exception logs.

Syntax:

XLOG	< STREAM     logstream   >
		< TIME       time | *    >
		< DATE       date | *    >
		< LINES      count       >
		< LIMIT      count       >
		< PERIOD     seconds     >
		< JOBName    jobname     >
		< NAME       name        >
		< RSCE1      rsce1       >
		< RSCE2      rsce2       >
		< OWNER      owner       >
		< RULEtype   rule        >
		< SUMMGRP    summgrp     >
		< AUTO | DEFAULT         >
		< CICS                   >

New syntax parameters:

• SUMMGRP - Limit the display to only those entries with corresponding value in the SummGrp field.

The CA SYSVIEW log stream technology that is used to read and write from the log streams now provides a significant performance boost.

This enhancement provides these benefits:

• Reduced the CPU used to read and write from a log stream.
• Reduced the elapsed time that is required to read many records from a log stream.

The default and maximum value for the LINES parameter has been adjusted.

Parameter

• LINES

  New Default: 25,000

  New Maximum: 1,000,000

  Old Default: 5,000

  Old Maximum: 100,000

  This LINES value is stored in the user profile. You can change the stored default value by issuing the following command from the desired primary command:

  OPTIONS LINE nnnnn
  

New data fields:

• SummGrp - The summarization group ID.