Enhancements to Existing Features › Options › Base Product Enhancements › Commands Enhanced

Commands Enhanced

The following enhancements have been made to existing commands.

ASADMIN

Address space administration

Syntax:

ASADMIN <options>

New Data Field:

• RRL - The recovery and retry level.

CLISTLIB

Displays the listed CLIST libraries.

Library concatenation data sets added (if defined):

• User
• Site
• System

CMDACT

Command activity summary

New Data Field:

• IDMS - The number of component IDMS commands issued.

GROUPS

Logical groups definitions.

New logical group type:

• IDMS - This type contains the IDMS job names.

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)
  

LENGTHS

Displays the field length data.

Syntax:

LENGTHS fieldname <rows> <opts>

A new "rows" parameter has been added to allow a subset of data rows to be processed.

New syntax parameters:

• rows - The rows to be included in the processing. Enter this parameter as:

  startrow-endrow
  startrow/numrows
  

  You can use an asterisk (*) to specify the current row number:

  *

  */numrows

  *+numrows/numrows

  Use numeric values from 1 to 999999999 for the startrow, endrow, and numrows.

  All rows are included in the processing when you omit the rows parameter.

LIBS

Displays information about product libraries.

Library concatenation data sets added (if defined):

• User
• Site
• System

New Subcommands:

• Options - You can specify any number of the values in any order. The current settings of all options are always displayed in response to the OPTIONS subcommand.

  The following lists and explains the valid OPTIONS <opts> parameter values:

  • UNSupported, NOUNSupported - Controls the display of unsupported data sets.
  • USer, NOUSer - Controls the display of USER data sets.
  • SIte, NOSIte - Controls the display of SITE data sets.
  • SYstem, NOSYstem - Controls the display of SYSTEM data sets.

New Data Fields:

• Alias - When the defined data set name is an alias. This field displays the original defined alias name and the DatasetName field displays the true name.
• CACHE - This field displays CACHE when the directory of the Dataset-Name field is cached.
• DispCmd - The display command that is used when the Select line is entered on the line.

New Line Command:

• CACHE - The directory is reloaded in to the cache data set.

LIBVIEW

The library viewer displays the contents of a library member.

The command has been enhanced to support the library concatenation.

Syntax:

LIBVIEW type      member
                          dsname(member)

Parameters and descriptions

• member - The name of the member to be saved.
• dsname - The data set name of the library containing the member.

  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)
  

New Subcommands

• USERDIR - Reloads the cached directory list for the specified library type.

  Syntax:

  USERDIR type
  

  type - Specifies the library type.

New information section fields

• Caplib, Clistlib, Helplib, Maplib, Miblib, Panellib, Parmlib, Plotlib, and Template

  The first row under the headers indicates whether caching is active for the library type.

  Possible values:

  • No - Do not cache the members.
  • Yes - Do cache the members.

  The second row under the headers indicates the status of user-defined data sets and the caching of directory lists.

  Possible values:

  • NOUSER - A user data set is not defined.
  • USER - A user data set is defined in the user profile.
  • USERDIR - A user data set is defined in the user profile and currently the directory list for the data set is cached.

New data fields:

• Cache - Indicates whether the member was retrieved from the library cache.

MAPLIB

Displays the contents of your map libraries.

Library concatenation data sets added (if defined):

• User
• Site
• System

MIBLIB

Displays the contents of your MIB libraries.

Library concatenation data sets added (if defined):

• User
• Site
• System

PARMLIB

Displays the contents of your parameter libraries.

Library concatenation data sets added (if defined):

• User
• Site
• System

PLOTLIB

Displays the contents of your PLOTLIB libraries.

Library concatenation data sets added (if defined):

• User
• Site
• System

PLOTLIST

Displays the plot selection list.

The command has been enhanced to support the library concatenation.

Syntax:

PLOTLIST	member
		dsname(member)

Changed syntax parameter

• dsname - The data set name of the library containing the member.

  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)
  

QLIST

Quick list commands

The command has been enhanced to support the library concatenation.

Syntax:

QLIST	<name|ALL|ANY|ORIGIN|OTHER>
		<REBUILD>
		<OPTIONS <opts>>
		<BROWSE <User|SIte|SYstem>>
		<EDIT <User|SIte|SYstem>>
		<VIEW <User|SIte|SYstem>> 

Changed syntax parameters:

• BROWSE <optkwd>
• EDIT <optkwd>
• VIEW <optkwd>

  To invoke these ISPF commands for the QLIST USER, SITE, or SYSTEM PARMLIB member:

  • Enter the QLIST command with BROWSE, EDIT, or VIEW as a parameter.
  • Specify one of the following optional <optkwd> parameters.

Keyword Parameters (Optional)

• User - Request for the QLIST USER PARMLIB member.
• SIte - Request for the QLIST SITE PARMLIB member.
• SYstem - Request for the QLIST SYSTEM PARMLIB member.
• none - Request for the QLIST USER PARMLIB member when the USER PARMLIB data set is defined.

  QLIST uses the SITE PARMLIB member when the USER PARMLIB data set is not defined. QLIST uses the SYSTEM PARMLIB data set when the SITE PARMLIB data set is not defined.

These commands are the same as entering the BROWSE, EDIT, or VIEW subcommands from the QLIST display.

Specifying any other <optkwd> values invokes the ISPF BROWSE, EDIT, or VIEW service with the <optkwd> value passed as a parameter to the ISPF service.

New Subcommands:

• OPTIONS - The following table lists and explains the valid OPTIONS <opts> parameter values. Any number of the values can be specified in any order. The current settings of all options are always displayed in response to the OPTIONS subcommand.
• User, NOUser - Controls whether to read the QLIST member from the USER PARMLIB data set. The default is USER. Rebuild the QLIST data after changing this option by issuing a QLIST REBUILD command or the REBUILD subcommand from within the QLIST display.
• SIte, NOSite - Controls whether to read the QLIST member from the SITE PARMLIB data set. The default is SITE. Rebuild the QLIST data after changing this option by issuing a QLIST REBUILD command or the REBUILD subcommand from within the QLIST display.
• SYstem, NOSYstem - Controls whether to read the QLIST member from the SYSTEM PARMLIB data set. The default is SYSTEM. Rebuild the QLIST data after changing this option by issuing a QLIST REBUILD command or the REBUILD subcommand from within the QLIST display.

ROWDISP

Row display

The ROWDISP command now supports the overtyping of input fields and passing the updated data fields back to the originating command for processing.

Information Section layout

• Old information section layout:

  Command <cmd>     <title>
  Options <options>
  

• New information section layout:

  Options <options>
  Command <cmd>  Title  <title>
  Screen  <scrn> Format <fmtn>  RowCur <currow> RowTot <totrow>
  

New information section fields:

• Options - The list of the current effective options. These options can be the original initial defaults or the defaults that are overridden with the OPTIONS subcommand.
• Command - The originating command name.
• Title- The originating screen title.
• Screen - The originating screen name. When a screen name is not defined, this field displays the command name.
• Format - The originating format name.
• RowCur - The current row number that the ROWDISP command is displaying.
• RowTot - The total number of displayed rows by the originating command.

New Subcommands:

• OPTIONS - The following table lists and explains the valid OPTIONS <opts> parameter values. Any number of the values can be specified in any order. The current settings of all options are always displayed in response to the OPTIONS subcommand.
  • <NO>INFO - Controls the display of the origin information rows of the command.
  • <NO>HEX - Controls the display of hex translation rows.
  • <NO>INPUT - Controls the support of modified input fields.
  • <NO>EXTENDED - Controls the display of extended format data fields.
• CANCEL - Exits the ROWDISP display and returns to the previous command. No input fields that you modified on the ROWDISP screen are propagated back to the originating command.

  Entering the CANCEL subcommand is the same as entering a RETURN command or any other primary display command when:

  • The INPUT option is not in effect.
  • No input fields were modified on the ROWDISP display.
• REFRESH - Refresh display data. REFRESH refreshes the ROWDISP display for any active SELECT or SORT command but does not refresh the actual contents of the data rows. To do that you must return to the originating command, refresh its data and enter the ROWDISP command again.

New data fields:

• T - The row data type indicator.
• M - The modified input field indicator.
• FldType - The field type.
• Input - The input field type.
• Status - STATUS if this field is a condition status field.
• Graph - GRAPH if this field is a bar graph field.
• XSystem - XSYSTEM if this field is an XSystem data field.
• Repeat - REPEAT if this field is a repeated field.
• Scroll - SCROLL if this field is the first horizontal scroll field.
• VLFType - The variable length field type.
• LGType - The logical group type.
• DisL - The length of the displayed field on the origin command screen.
• OutL - The length of the output (data) record field of the origin command.
• InpL - The length of the input record field of the origin command.

New Line Command:

• Restore - Restores a modified input field back to the original contents that existed when the ROWDISP command was first invoked.

  RESTORE is ignored for the following instances:

  • When the rows have no input fields.
  • When the input data was not modified.

SCHEDULE

Schedules the events.

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)
  

SELECT

Set the field selection criteria.

Syntax:

SELECT field oper value <conn <field oper value...>>

New syntax operator parameters

• CW - Contains a word. A word is a string that a nonalphanumeric character precedes and follows.
• NW - Not contains word. A word is a string that a nonalphanumeric character precedes and follows.

The SELECT command supports a field name of * (asterisk). Using the * indicates to use the previous field name that was not an "*". Any field name parameter that is not "*" is saved to be used when the next field name is "*". Any saved field name is cleared for each new SELECT command and by the following SELECT options.

SELECT RESET

SELECT ALL|CLEAR|omitted

SELECT MODIFY

The previous field name is saved when:

• The SELECT command ends with an AND or an OR connector and can be referenced on the next SELECT that continues the pending SELECT.
• The SELECT becomes active and can be referenced when a subsequent SELECT starts with an AND or OR connector to modify an already active SELECT.

Examples:

SELECT jobname eq aaaa or * eq bbbb or * eq ccccc

SELECT jobname eq aaaa or
	     (SELECT is pending)
SELECT * eq bbbb or
	     (SELECT is pending)
SELECT * eq cccc
	     (SELECT is active)

SELECT jobname eq aaaa
	     (SELECT is active)
SELECT or * eq bbbb
	     (SELECT is active)
SELECT or * eq cccc
	     (SELECT is active)

STATUS

Displays the product and environment information.

New data fields:

• Identification
  • User Name - <username>
  • User Id - <userid>
  • Current Profile

    Profile Id - <profid>

    Status - <status>

    Default - <default>

    Owner - <owner>

    Altered - <altered>

    Length - <length>

    Version - <version>

    Update User Id - <lastupduser>

    Update Date - <lastupddate>

    Update Time - <lastupdtime>

  • Initial Profile

    Profile Id - <profid>

    Status - <status>

    Default - <default>

    Owner - <owner>

    Length - <length>

    Version - <version>

    Update User Id - <lastupduser>

    Update Date - <lastupddate>

    Update Time - <lastupdtime>

  • Security

    Group - <groupname>

    Description - <descr>

    Owner - <owner>

    Version - <version>

    Update User Id - <lastupduser>

    Update Date - <lastupddate>

    Update Time - <lastupdtime>

• Data Sets
  • List of library concatenation data sets.
• Environment
  • Channel SSID

TOPICS

The Help topic knowledge base.

The command has been enhanced to support the library concatenation.

Syntax:

TOPICS	member
		dsname(member)

Changed syntax parameters

• dsname - The data set name of the library containing the member. 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)
  

TSFLIST

The Time series facility list.

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.

TOTAL

Calculates and displays the total column data.

Syntax:

TOTAL fieldname <rows> <opts>

A new "rows" parameter has been added to allow a subset of the data rows to be processed.

New syntax parameters

• rows - The rows to be included in the processing. Enter this parameter as:

  startrow-endrow
  startrow/numrows
  

  You can use an asterisk (*) to specify the current row number:

  *

  */numrows

  *+numrows/numrows

  Use numeric values from 1 to 999999999 for the startrow, endrow, and numrows.

  All rows are included in the processing when you omit the rows parameter.

USERS

Displays the product users.

New data fields:

• ELv - The environment level.
• RRL - The recovery and retry level.

VDEFINE

Defines a user variable.

Syntax:

VDEFINE   name <value> <options>

options

This parameter can contain a new keyword value pair: DESCR value.

New syntax parameters:

• options - The options for the variable. The valid values are:
  • Descr value

    This option defines an optional description for the variable. The value can be any string of characters from 1 to 32 characters long. If the value contains blanks or commas then enclose them in character delimiters. The lowercase characters in the value are uppercased unless the value is enclosed in character delimiters and preceded with the chars qualifier ("C").

XSLIST

Displays the cross-system server tasks.

New Data Field:

• JesN - The primary JES name.