Commands Enhanced

Enhancements to Existing Features › Options › Option for IMS › Commands Enhanced

Commands Enhanced

The following enhancements have been made to existing commands.

IMSALERT

Displays the IMS exception alerts.

Syntax:

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

		< NAME          name     >

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

		< ID            id       >
		< GROUP         group    >
		< SUBGroup      subgroup >
		< SUMMGRP       summgrp  >

New syntax parameter

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

New Data Field

SummGrp - The summarization group ID.

IMSDAILY

IMS daily usage

The command has been enabled for system-wide and cross-system data.

Syntax

IMSDAILY	< REGion    | SYStem    >
		< XSYStem | NOXSYStem >
		< XSData    | NOXSData  >
		< GROUP  name >

New Syntax Keywords

REGion - Display only the current target address space. This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
SYStem - Display all IMS address spaces currently being monitored on the current system.
XSYStem, XSData - Display all IMS address spaces for all systems. This keyword forces the cross system data collection to be set on for this execution. The current profile setting of XSDATA is maintained.
NOXSYStem, NOXSData - This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
GROUP - An argument is to follow specifying the group name that contains the list of IMS subsystems to be displayed. The list of available groups with the type IMSID can be found on the GROUPS command. A group name of "*" can be entered to indicate that no group processing is required.

IMSLIST

IMS control regions

The command has been enabled for cross-system data.

Syntax

IMSDAILY	< XSYStem | NOXSYStem >
		< XSData  | NOXSData  >
		< GROUP  name >
		< MONitored >

New Syntax Keywords

XSYStem, XSData - Display all IMS address spaces for all systems. This keyword forces the cross system data collection to be set on for this execution. The current profile setting of XSDATA is maintained.
NOXSYStem, NOXSData - This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
GROUP - An argument is to follow specifying the group name that contains the list of IMS subsystems to be displayed. The list of available groups with the type IMSID can be found on the GROUPS command. A group name of "*" can be entered to indicate that no group processing is required.
MONitored - Only monitored IMS control regions display. Monitored IMS IDs can be found on the IMSMON display.

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.

IMSLOCKS

Displays IMS IRLM locks.

The command has been enabled for system-wide and cross-system data.

Syntax

IMSDAILY	< REGion    | SYStem    >
		< XSYStem | NOXSYStem >
		< XSData    | NOXSData  >
		< GROUP  name >

New Syntax Keywords

REGion - Display only the current target address space. This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
SYStem - Display all IMS address spaces currently being monitored on the current system.
XSYStem, XSData - Display all IMS address spaces for all systems. This keyword forces the cross system data collection to be set on for this execution. The current profile setting of XSDATA is maintained.
NOXSYStem, NOXSData - This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
GROUP - An argument is to follow specifying the group name that contains the list of IMS subsystems to be displayed. The list of available groups with the type IMSID can be found on the GROUPS command. A group name of "*" can be entered to indicate that no group processing is required.

IMSLOGRS

Displays the IMS loggers.

The command has been enabled for cross-system data.

Syntax

IMSLOGRS	< XSYStem | NOXSYStem >
		< XSData    | NOXSData  >
		< GROUP  name >

New syntax keywords

XSYStem, XSData - Display all IMS address spaces for all systems. This keyword forces the cross system data collection to be set on for this execution. The current profile setting of XSDATA is maintained.
NOXSYStem, NOXSData - This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
GROUP - An argument is to follow specifying the group name that contains the list of IMS subsystems to be displayed. The list of available groups with the type IMSID can be found on the GROUPS command. A group name of "*" can be entered to indicate that no group processing is required.

New line commands

DDUMP - Dump the IMSLOGR dataspace for the selected IMSLOGR.
SLGR - Start the IMSLOGR for the selected control region.
PLGR - Stop the IMSLOGR for the selected control region.

IMSMON

Displays IMS 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)
```

IMSOMAT

IMS OM audit trail

The CA SYSVIEW log stream technology that reads and writes 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
```

IMSRACT

Displays IMS-dependent region detail.

New data fields

SSA - Shows the first 48 bytes of the SSA work area.
I/O Area - Shows the first 80 bytes of the current I/O area.

IMSREGNS

Displays IMS-dependent regions.

The command has been enabled for system-wide and cross-system data.

Syntax

IMSDAILY	< REGion    | SYStem    >
		< XSYStem | NOXSYStem >
		< XSData    | NOXSData  >
		< GROUP  name >
		< MONitored >

New Syntax Keywords

REGion - Display only the current target address space. This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
SYStem - Display all IMS address spaces currently being monitored on the current system.
XSYStem, XSData - Display all IMS address spaces for all systems. This keyword forces the cross system data collection to be set on for this execution. The current profile setting of XSDATA is maintained.
NOXSYStem, NOXSData - This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
GROUP - An argument is to follow specifying the group name that contains the list of IMS subsystems to be displayed. The list of available groups with the type IMSID can be found on the GROUPS command. A group name of "*" can be entered to indicate that no group processing is required.
MONitored - Only monitored IMS control regions display. Monitored IMS IDs can be found on the IMSMON display.

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.
ProcTime - Specifies the transaction processing time. This value is the current time minus the transaction schedule time.
InQTime - Specifies the transaction input queue time. This value is the schedule time minus the transaction enqueue time.
Note: FASTPATH response time components are extracted from fields in the IMS x'59' log record. IBM stores the time in milliseconds and values less than 1 millisecond appears as a BLANK on the display.
SQ6Time - Specifies the total amount of time the region waited on the scheduler queue for the current transaction to arrive. This field applies to WFI and PWFI transactions.

IMSRSLOG

Displays the IMS region summary log.

The CA SYSVIEW log stream technology that reads and writes 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
```

IMSSTATE

Displays the IMS state 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)
```

IMSTHRSH

Displays the IMS 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)
```

IMSTLOG

Displays IMS transaction logs.

The CA SYSVIEW log stream technology that reads and writes 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 Field

SQ6time - The total amount of time that the region spent on the scheduler queue for the transaction to arrive. This field only applies to WFI and PWFI transactions.

New data fields in section: ESS Trace

Object name
MQ call type

IMSWAITS

Displays the available IMS monitor variables.

The command has been enabled for system-wide and cross-system data.

Syntax

IMSDAILY	< REGion    | SYStem    >
		< XSYStem | NOXSYStem >
		< XSData    | NOXSData  >
		< GROUP  name >

New syntax keywords

REGion - Display only the current target address space. This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
SYStem - Display all IMS address spaces currently being monitored on the current system.
XSYStem, XSData - Display all IMS address spaces for all systems. This keyword forces the cross system data collection to be set on for this execution. The current profile setting of XSDATA is maintained.
NOXSYStem, NOXSData - This keyword forces the cross system data collection to be set off for this execution. The current profile setting of XSDATA is maintained.
GROUP - An argument is to follow specifying the group name that contains the list of IMS subsystems to be displayed. The list of available groups with the type IMSID can be found on the GROUPS command. A group name of "*" can be entered to indicate that no group processing is required.