Displaying ASCH configuration information

Use the DISPLAY ASCH command to display information about the APPC/MVS scheduler configuration (message ASB101I).

D ASCH
 
D ASCH{[,SUMMARY|,SUM|,S ][,{ASID|A}=asid]            }
      { |,LIST|,L              [,{CLASS|C}=classname] }
      { |,ALL|,A          [,LTPN=ltpname]             }
      {                        [,QT=sssss[.ttt]]      }
      {                   [,TPST=schedtype]           }
      {                        [,USERID=userid]}      }

   [,L={a|name|name-a}]
 

The parameters are:

SUMMARY or SUM or S
Indicates that the system is to use the SUMMARY format of output. The resulting message contains the number of classes, active and queued transactions, idle initiators, and total number of initiators. It also shows the global settings for the IBM®-supplied APPC/MVS transaction scheduler, which are specified in ASCHPMxx parmlib member on the TPDEFAULT and SUBSYS keywords.
LIST or L
Indicates that the system is to use the LIST form of output. This output is the same as the SUMMARY output, followed by a list of APPC/MVS transaction scheduler classes. Each entry in the list contains the name of a class, along with related information.
ALL or A
Indicates that the system is to use the ALL form of output. This output is the same as the LIST output, except that the system inserts a sublist after each entry in the list. The sublist contains information about each transaction program assigned to the APPC/MVS transaction scheduler class.
Note: For the output of the DISPLAY ASCH command, see the description of message ASB101I.
The following is a list of keywords that filter the displays. When you specify a filter keyword, the system displays only the data that meets the keyword's criteria.
Note:
  1. The same keyword cannot be used twice with a single command.
  2. A command line cannot exceed 126 characters in length.
ASID or A=asid
The address space identifier of the transaction program. The identifier is a one- to four-digit hexadecimal value.
CLASS or C=classname
The name of the APPC/MVS transaction scheduler class. The class name is one to eight alphanumeric (a-z, 0-9) or special (@,#,$) characters.
LTPN=ltpname
The local transaction program name. This name is one to 64 alphanumeric (a-z, 0-9) or special (@,#,$) characters. The name may also contain the characters in character set 00640, except for the following:
  • comma(,) - used as a keyword delimiter and means that the preceding character is interpreted as the end of the transaction program name
  • blank( ) - interpreted as the end of the command and means that the preceding character is interpreted as the end of the transaction program name
  • asterisk(*) - used to filter the local transaction program name, it can only be used as the last character of the name. It causes the LTPN keyword filter to match every transaction program name which begins with the characters preceding the asterisk.

You can abbreviate the name of the local transaction program by entering the first part of the name, followed by an asterisk. For example, PROCESS* matches every local transaction program name that begins with the letters PROCESS.

You can also specify the asterisk as the last character of the displayable format of a SNA service transaction program name.

The displayable format of a SNA service transaction program name is in the form:
¬X'hh'ccc

Where hh is the hexadecimal value for the first non-displayable character and ccc is a character string (one to three characters) from character set Type A. You can abbreviate the name of the SNA transaction program by entering the first part of the name, followed by an asterisk.

Character sets 00640 and Type A are listed in z/OS MVS Planning: APPC/MVS Management.

QT=sssss[.ttt]
The queue time, in seconds, of a local transaction program waiting for initiation. sssss specifies the number of seconds, from 0 - 99999; ttt specifies the number of thousandths of a second, from .0 - .999. When you specify this keyword, the system displays only transaction programs that have been queued for an amount of time greater than or equal to the value you specify.
TPST=schedtype
The scheduling type of the transaction program. This keyword can have values of: STD, STANDARD, MT, or MULTITRANS.
USERID=userid
The userid of the transaction program that is running because of an allocate request. The system displays only initiators that are running programs on behalf of the userid you specify. The userid is one to ten alphanumeric (a-z,0-9) or special (@,#,$) characters.
L=a, name, or name-a
Specifies the display area (a), console name (name), or both (name-a) where the display is to appear.

If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.