Using TSO Commands from CBT

June, 2020

 

There are quite a few very useful TSO command processors that may be used on MVS 3.8j running under Hercules to make the TSO user experience easier and more enjoyable.  The files necessary to install the TSO command processors and, many times, the TSO help information, have been pulled from various versons of the CBT tape, from 249 to the present version.  If you have a current version of the SYSCPK 3350 DASD volume installed on your system, I have added the jobstreams in SYSC.CBT.SOURCE to install the TSO command executable and help onto your system.  I have created this page to share some information about these TSO commands and how to use them.

Note:  These commands are not installed on your system, ready to use, just because you have installed the latest version of SYSCPK which contains the source for the commands.  For any particular command to function on your system, you must submit the installation jobstream from SYSC.CBT.SOURCE.  Each jobstream installs the load module(s) for the single command contained in the SYSC.CBT.SOURCE member, along with the help text.  The load module(s) for the command are installed into SYS2.CMDLIB and the help text is installed into SYS2.HELP.  The TSO commands cannot be executed from SYSCPK directly.

ALIST
ALLOCA
BLKDISK
CATLG
DD
DDUCB
DTAPES
DUDASD
FIND
FINDFILE
FREEALL
INSTREAM
LISTDD
LISTSPC
LISTVOL
LM
MEMBER
MS
PDSBLKS
PRINTOFF
PRINTON
RLSE
SCRATCH
SHOWASM
SHOWDS
SYSTEM
UNCATLG
VOLS
VTOC
WHOHAS

ALIST - Source: CBT V498 File #830 

ALIST provides a better, or at least a different view of allocated files than the standard LISTALC command:

The ALIST command will list all allocated files for your TSO session in the format:

DDNAME   DSO FFFFFFFF DSPoVVVVVV DSNAME
|        |   |        |   |      |
|        |   |        |   |      +Dataset name
|        |   |        |   +Volume
|        |   |        +Disposition (followed by lowercase o if open)
|        |   +Flags (see below)
|        +Organization
+DD Name

Flags indicate: FFFFFFFF
                ||||||||
                |||||||J-JOBCAT/STEPCAT dataset
                ||||||C-dataset is a catalog
                |||||V-VIO dataset
                ||||I-dataset is in use
                |||C-convertible
                ||D-dynamically converted
                |P-permanently allocated
                D-dynamically allocated

ALIST takes no operands.


 

ALLOCA - Source: CBT V249 File #300

ALLOCA is like a shorthand ALLOC command.  Note, this command was called DD (with a DDN alias) on the CBT tape, but there was already a DD TSO command installed on my system, and probably on a lot of other systems, too.  So I renamed it ALLOCA, which I think of as ALLOC Alias.

It is similar to the standard TSO ALLOC command, except the filename (DD Name) and dataset name are required positional operands instead of keyword operands.  For example, instead of typing:

ALLOC FI(SYSPROC) DA(CLIST) SHR

you can type:

ALLOCA SYSPROC CLIST

If the filename (DD Name) is currently allocated, it will be freed and reused.

Not all operands of ALLOC are availabe in the ALLOCA command.  Some operands are new functions not available in the ALLOC command.

Syntax:

     ALLOCA 'FILENAME' 'DSNAME'  SHR/OLD/MOD/NEW  USING('ATTR')      
                                 UNIT('UNITNAME') VOLUME('VOLUME')   
                                 SPACE('PRIME','SEC')  DIR('NUMBER') 
                                 TRACKS/CYLINDERS/BLOCKS('SIZE')     
                                 DATASET  FORM('ID')  FCB('ID') HOLD 
                                 COPIES('NUMBER')  DEST('ID')        
                                 RECFM('X')  LRECL('N') BLKSIZE('N') 
                                 DSORG(PS/PO/DA/PSU/POU/DAU)         
REQUIRED - 'FILENAME', 'DSNAME'                                       
DEFAULTS - SHR (UNLESS SPACE, DIR, OR TRACKS/CYL/BLOCKS SPECIFIED,    
               IN WHICH CASE THE DEFAULT IS NEW)                     
           FOR NEW DATA SETS, IF 'SPACE' IS NOT SPECIFIED AND         
           SPACE TYPE (TRACKS, CYL, BLOCK) IS NOT SPECIFIED, THEN     
           THE SYSTEM DEFAULT SPACE VALUES WILL BE USED.              
           THESE ARE CURRENTLY SPACE(10,50) BLOCKS(1000) RLSE.        


 

BLKDISK - Source: CBT V597 File #296

BLKDISK computes optimum block sizes for DASD datasets.  The load module is BLKDISK, but aliases are assigned for each DASD type you expect to use in your system.  There are also help members created for each of the aliases.

The report for the given LRECL includes a range of possible blocksizes and a recommended optimum blocksize to use. 

The recommended blocksize value is for datasets in which the predominant access is sequential; for datasets where random access time is critical or the usual access is random, a small blocksize (500-2000 bytes) should probably be used.  The recommended blocksize will usually tend to be near a half-track figure as this is considered to be the most efficient in terms of the trade-offs among buffer size, secondary storage requirements, channel use, number of input/outputs and overall processing time.  This figure is only a general guide; for maximal efficiency considering other factors, study the generated blocksize summary report or a track capacity report.

The program's recommendations assume a fairly large amount of data is to be stored; data sets which occupy only a few tracks should probably be placed in partitioned datasets.  In cases where this is not feasible, the use of a small blocksize (2400-4000 bytes) may be a good alternative practice.

Syntax:

        BLK????  'LRECL'  KEYLENGTH('INTEGER')                        
                          TRACKCAP / NOTRACKCAP                       
                          BLKSIZE('INTEGER')                          
                          NUMBER('INTEGER') / RECORDS('INTEGER')      
                          VERIFY                                      
 REQUIRED - LRECL                                                     
 DEFAULTS - KEYLENGTH(0),                                             
            NOTRACKCAP,                                               
            BLKSIZE(RECOMMENDED VALUE),                               
            NUMBER(100000)                                            
OPERANDS -                                                          
		 'LRECL'  - THE LOGICAL RECORD LENGTH OF THE DATA WHICH IS TO BE       
		            PLACED IN THE DATA SET.                                    
		 KEYLENGTH('INTEGER')                                                 
		          - THE KEY LENGTH, IN BYTES, OF THE KEYS TO BE USED IN THE    
		            DATA SET.  THE MAXIMUM LEGAL KEY LENGTH IS 255.            
		 TRACKCAP                                                             
		          - SPECIFIES THAT A TRACK CAPACITY REPORT IS TO BE PROVIDED   
		            FOR THE DEVICE USING THE SPECIFIED (OR DEFAULT) KEY LENGTH.
		 NOTE THAT A TRACK CAPACITY REPORT IS ALSO PROVIDED IF      
	         NOTRACKCAP IS NOT SPECIFIED AND LRECL EXCEEDS THE MAXIMUM  
	         BLOCKSIZE FOR A TRACK OR BLKSIZE EXCEEDS THE MAXIMUM       
	         BLOCKSIZE FOR A TRACK.                                     

 		 NOTRACKCAP                                                           
		           - SPECIFIES THAT A TRACK CAPACITY REPORT IS NOT DESIRED.     

		 BLKSIZE('INTEGER')                                                   
		           - THE BLOCKSIZE TO USE FOR THE ALLOCATION COMPUTATION; IF    
		             BLKSIZE IS NOT ENTERED (OR ZERO IS ENTERED), THE PROGRAM'S 
		             RECOMMENDED BLOCKSIZE WILL BE USED.                        

		 NUMBER('INTEGER')                                                    
		           - THE NUMBER OF LOGICAL RECORDS THAT WILL BE IN THE DATA SET.

		 RECORDS('INTEGER')                                                   
		           - THE NUMBER OF LOGICAL RECORDS THAT WILL BE IN THE DATA SET.

		 VERIFY    - SPECIFIES THAT THE MVS "TRKCALC" ROUTINE IS TO BE USED TO  
		             VERIFY TRACK CAPACITY CALCULATIONS.  IF VERIFY IS USED,    
		             THE NUMBER OF CALLS TO "TRKCALC" TO DETERMINE A TRACK      
		 NOTE: WITH VERIFY ON, A MINIMUM OF 34 CALLS IS REQUIRED TO  
		       DETERMINE A TRACK CAPACITY TABLE; OTHERWISE A MINIMUM OF    
		       17 CALLS IS REQUIRED TO DETERMINE THE TRACK CAPACITY TABLE. 
	               CAPACITY TABLE IS OUTPUT AT THE END OF THE OUTPUT.         



CATLG (also UNCATLG and SCRATCH) - Source: CBT V430 File #163

CATLG performs CATLG, UNCATLG, and SCRATCH functions similar to IEHPROGM.

Syntax:

      CATLG  dsname                      REQUIRED                     
             VOL(volser)                 REQUIRED                     
             UNIT(unitname)              OPTIONAL                     
                                                                      
OPERANDS -                                                         
	DSNAME                                                              
           - REQUIRED.  DATASET NAME TO BE CATALOGED.  NORMAL TSO     
             DATASET NAMING CONVENTIONS APPLY.                        

	VOL(volser)                                                         
           - REQUIRED.  VOLUME SERIAL YOU WANT THE DATASET CATALOGED  
             ON.                                                      

	UNIT(unitname)                                                      
           - OPTIONAL.  IF THE VOLUME SERIAL IS THAT OF A CURRENTLY   
             MOUNTED DIRECT-ACCESS VOLUME, THE DEFAULT VALUE IS       
             TAKEN FROM THE VOLUME'S UCB.  OTHERWISE THE OPERAND      
             IS REQUIRED.                                             

      SCRATCH dsname                      REQUIRED                     
              VOL(volser)                 OPTIONAL                     
                                                                   
OPERANDS -                                                          
	DSNAME                                                               
           - REQUIRED.  DATASET NAME TO BE SCRATCHED.  NORMAL TSO      
             DATASET NAMING CONVENTIONS APPLY.                         

	VOL(volser)                                                          
           - OPTIONAL.  VOLUME SERIAL YOU WANT THE DATASET SCRATCHED   
             FROM.  IF NOT SPECIFIED, THE dataset MUST BE CATALOGED,   
             AND THE VOLUME SERIAL IS TAKEN FROM THE CATALOG ENTRY.    

      UNCATLG dsname                      REQUIRED                    
                                                                      
OPERANDS -                                                         
	DSNAME                                                              
           - REQUIRED.  DATASET NAME TO BE SCRATCHED.  NORMAL TSO     
             DATASET NAMING CONVENTIONS APPLY.                       


 

DD - Source: CBT V430 File #163

The DD command displays information on a dataset.  At a minimum the catalog information is displayed (Volume Serial and device types), and if the dataset is on a mounted DASD, device information from the dataset's DSCB is displayed.

Syntax:

         DD 'DATASET-NAME'  PARTIAL OR                                
                            GENERATION(number) OR                     
                            VOLUME(name)                              
                                                                      
  DEFAULTS -  DATASET-NAME DEFAULTS TO TSO USERID PREFIX              

  ALIAS    -  DDX  (DOES CLEAR COMMAND BEFORE DISPLAY)                

  ABBREVIATIONS -  PARTIAL    ===> P                                  
		   GENERATION ===> G                                   
                   VOLUME     ===> V                                   
                                                                       
OPERAND -                                                           
	  'dataset-name'                                                       
        	 - SPECIFIES THE COMPLETE OR PARTIAL NAME OF THE DATA SET      
	           WHICH IS TO BE SAERCHED FOR.                                
                                                                       
	  PARTIAL             - SPECIFIES A PARTIAL DATA SET NAME SEARCH                   
	  GENERATION(number)  - LISTS DATA SET' DSCB INFORMATION FOR THE       
                                GENERATION LEVEL SPECIFIED.                    
	  VOLUME(name)        - SPECIFIES THE VOLUME NAME ON WHICH THE DATA SET       
	                        RESIDES.  IF A VOLUME NAME IS ENTERED, SYSALLDA IS    
		                ASSUMED AS THE UNIT NAME; OTHERWISE, THE UNIT NAME    
                		FROM THE CATALOG IS USED.                             
                                                                       
		NOTE:  THIS PARAMETER SHOULD BE USED IF THE DATA SET  
                IS NOT CATALOGED OR IF THE CATALOG ENTRY IS NOT TO BE USED.                                                 
                                                                       


 

DDUCB - Source: NaSPA 1998

The DDUCB command will display the attributes of all online DASD devices. It scans the UCB's and displays such information as Unit Address, Vol Serial, Mount Attributes, Reserves, Etc. 

Syntax:  DDUCB (no operands)


 

DTAPES - Source: CBT V428 Overflow File #301 

The DTAPES command displays all tape devices defined in the system.

Syntax: DTAPES (no operands)


 

DUDASD - Source: CBT V249 File #300

The DUDASD command displays all DASD devices defined in the system.  If the volume is online, additional information is displayed for the DASD address: Volume Serial Number, Allocation Status (O=unallocated, A=allocated, P=offline pending), Reserved if the TSO system has successfully reserved the device, and Status (RSV=reserved on the system, RSD=system resident)

Syntax: DUDASD (no operands)


 

FIND - Source: CBT V430 File #166

The FIND command searches for a character string in a PDS (Partitioned Dataset) and displays the number of occurrences found in each member.

Syntax:

          FIND 'DSNAME' S('CHARACTER STRING')                              
                        GROUP(XX)                                          
                        LOWER                                              
                        QUICK                                              

	REQUIRED - 'DSNAME'  S('Character string')                                  
	DEFAULTS -  None                                                            
                                                                              
OPERAND -                                                                  
                                                                              
	'DSNAME'      - Name of the partitioned Data Set to be                        
        	        searched.  Omit the single quotes and the first               
                	data set qualifier if it is your own data set.                
                                                                              
	S('Character string')                                                       
               	      - The string of characters to be searched for.  Could be a      
                	program name, data set name, or text data, etc..              
                                                                             
	GROUP(XX)     - Optional Keyword.  Used to limit the search on only           
                	members having name beginning with XX.                        

	LOWER 	      - Optional Keyword.  Used to search for lowercase TEXT        
	                character string.  If this keyword is not used, the         
        	        character string will be converted into uppercase before    
	                the search is being performed.                              
                                                                            
	QUICK         - Optional Keyword.  Used to stop command from reading        
                        the entire member after the first occurrence found.         
                        Process continues to the next member.                       


 

FINDFILE - Source: CBT V249 File #300

The FINDFILE command displays where a dataset is catalogued and lists all mount DASD volumes on which the dataset resides.

Syntax: 

     FINDFILE 'DSNAME'                                       
                                                                    
            ALIAS  -  LOCDSN                                        

OPERANDS:                                                  
               DSNAME - THE DATA SET NAME YOU WISH TO LOCATE        
                        USING STANDARD TSO NAMING CONVENTIONS.      


 

FREEALL - Source: CBT V430 File #300

The FREEALL command is used to free all dynamically allocated datasets which have been allocated by a TSO user.  It will free all datasets which:

Syntax:  FREEALL  (no operands)


INSTREAM - Source: CBT V430 File #300

The INSTREAM command allocates a temporary dataset for utility control statements, and copies subsequent CLIST or terminal input to that dataset.  The copying continues until an 'END' statement is encountered.  This is useful in CLISTs that call utility programs that require 80-character control statement input.  Since the control statements are part of the CLIST, their contents can be set by variables in the CLIST.

Syntax:

	INSTREAM FILE('DDNAME') END('STRING') BLKSIZE('SIZE') 
	         REUSE CONTIN INSERT 

	REQUIRED - NONE 

	DEFAULTS - FILE(SYSIN) END(END) BLKSIZE(400) 

OPERANDS - 
	FILE('DDNAME') - THE DDNAME TO WHICH THE NEW TEMPORARY           
        	         DATA SET IS TO BE ALLOCATED.  IF NOT SPECIFIED,       
	                 FILE(SYSIN) IS USED.  THE DDNAME MUST NOT BE          
	                 CURRENTLY ALLOCATED, UNLESS 'REUSE' IS SPECIFIED.     

	REUSE          - THIS KEYWORD INDICATES THAT IF THE DDNAME IS          
	                 CURRENTLY ALLOCATED, IT IS TO BE FREED AND THEN       
            	         RE-ALLOCATED TO THE NEW TEMPORARY DATA SET.           

	BLOCK('SIZE')  - THE BLOCKSIZE OF THE TEMPORARY DATA SET.         
 	                 IF NOT SPECIFIED, 400 IS USED.                        

	END('STRING')  - THE STRING THAT WILL REPLACE 'END' AS THE        
	                 DELIMITER OF THE INPUT DATA.                          

	INSERT         - THIS KEYWORD SPECIFIES THAT IF AN INPUT LINE          
	                 STARTS WITH THE CHARACTERS 'I' OR 'IN' OR 'INSERT'    
            	         FOLLOWED BY A BLANK, ONLY THE DATA FOLLOWING THE      
	                 BLANK WILL BE COPIED.  THIS ALLOWS YOU TO INDENT      
	                 YOUR CLIST AND STILL CONTROL LEADING BLANKS IN YOUR   
	                 INPUT DATA.                                           

	CONTIN         - THIS KEYWORD INDICATES THAT THE FIRST BYTE OF DATA    
	                 IN EACH INPUT LINE IS TO BE PUT IN COLUMN 72, AND     
            	         BYTES 2 THRU 72 SHIFTED OVER TO 1 THRI 71.            
			 USEFUL IF THE UTILITY PROGRAM USES COLUMN 72            
		         FOR CONTINUATION.                                       

	NOTES	       - THIS IS NOT AN OPERAND, BUT SOME AIDS TO USING          
	                 THE INSTREAM COMMAND.                                   
	       ... LEADING BLANKS ...                                  
          	         LEADING BLANKS ARE NORMALLY REMOVED FROM A              
	                 CLIST STATEMENT AT THE TIME IT IS EXECUTED.             
	                 THIS CAN BE PREVENTED BY PLACING THE STATEMENT          
	                 BETWEEN A 'DATA' AND 'ENDDATA' STATEMENT (SEE           
	                 THE TSO COMMAND LANGUAGE REFERENCE MANUAL).             
	                 THESE TWO STATEMENTS WILL BE INVISIBLE TO INSTREAM      
	                 AND NOT COPIED TO THE TEMPORARY DATA SET.               
	                 ANOTHER WAY TO COPY A LEADING BLANK IS TO USE THE       
	                 'INSERT' KEYWORD AND BEGIN EACH INPUT LINE WITH         
	                 THE WORD 'INSERT' FOLLOWED BY A BLANK FOLLOWED BY       
	                 YOUR LEADING BLANK(S).  THIS GIVES YOU THE FREEDOM      
 	                 TO CODE YOUR CLIST WITH INDENTATION FOR READABILITY.     

An example of a CLIST that uses INSTREAM:

PROC 2 INFILE FINDSTR DUMP(Y)         
FREE FI(SYSIN)                        
FREE FI(SYSUT1)                       
FREE FI(SYSUT2)                       
FREE FI(SYSPRINT)                     
ALLOCA SYSUT1 &INFILE SHR             
ALLOCA SYSUT2 DUMMY                   
ALLOCA SYSPRINT *                     
INSTREAM                              
DUMP=&DUMP.,FIND=&FINDSTR.,GO         
END                                   
CALL 'SYSC.LINKLIB(SUPERGEN)'          


 

LISTDD - Source: CBT V498 File #830

The LISTDD command will list the attributes for the dataset whose DD Name is specified or for all allocated DD Names.  Fields displayed are DD Name, disposition, Volume Serial Number, and dataset name.

Syntax:

          LISTDD <DDNAME>                                              

OPERANDS -                                                          
          <DDNAME> | *                                                 
                                                                       
          <DDNAME> INFORMATION WILL BE DISPLAYED FOR THE SPECIFIC      
                   DDNAME ENTERED                                      
                                                                       
          *        INFORMATION WILL BE DISPLAYED FOR ALL ALLOCATED     



 

LISTSPC - Source: CBT V129 File #49

The LISTSPC command lists the tracks allocated, tracks unused, and number of extents for catalogued disk datasets, individually or in small groups.

Syntax:

    LISTSPC   DATASET('DSNAME-LIST')  LEVEL('INDEX-LEVEL')                
              VOLUME('VOLUME-LIST')  EXTENTS                              

    REQUIRED - DATESET('DSNAME') OR LEVEL('INDEX-LEVEL') OR               
               VOLUME('VOLUME')                                           

    DEFAULTS - NONE                                                       

OPERANDS -                                                             
	DATASET('DSNAME-LIST') -                                                
        		       - SPECIFIES A LIST OF DATA SET NAMES ABOUT WHICH YOU WISH  
		                 TO HAVE SPACE INFORMATION DISPLAYED.                     

	LEVEL('INDEX-LEVEL')   - SPECIFIES AN INDEX LEVEL IN THE CATALOG FOR
				 WHICH YOU WANT SPACE INFORMATION. THIS MAY BE        
		                 A DSNAME CONTAINING ONE EMBEDDED ASTERISK.           

	VOLUME('VOLUME-LIST')  - IF USED WITH THE DATASET PARAMETER, SPECIFIES THE    
		                 VOLUME THE DATA SET RESIDES ON. NO CATALOG SEARCH    
                		 WILL BE PERFORMED.                                   
		                 IF SPECIFIED ALONE, SPECIFIES A LIST OF VOLUMES FOR  
                		 WHICH FREE SPACE INFORMATION WILL BE PRODUCED.       

	EXTENTS		      - IF SPECIFIED, THEN THE EXTENTS FOR EACH DATA SET WILL
                 		BE DISPLAYED WITH HEXADECIMAL ADDRESSES.             


 

LISTVOL - Source: CBT V129 File #48

The LISTVOL command lists the volumes of catalogued datasets.

Syntax:

    LISTVOL   LEVEL('DSNAME')         DA('DSLIST')                   
              VOL('SER')                                             

    DEFAULTS - LEVEL(USERID)                                         

OPERANDS -                                                       
	LEVEL('DSNAME')   - SPECIFIES EITHER HIGHER LEVEL QUALIFIERS OF           
                            CATALOG STRUCTURE OR CONTAINS EMBEDDED ASTERISK       
                            AS PART OF THE NAME.                                  
	DATASET('DSLIST') - SPECIFIES A DSNAME LIST FOR WHICH YOU DESIRE TO       
                            HAVE VOLUME INFORMATION LISTED.                       

	VOLUME('VOLSER')  - SPECIFIES LEADING CHARACTERS OF VOLUME SERIAL.  ONLY  
                            DATASETS CATALOGED ON VOLUMES BEGINNING WITH THE      
                            SPECIFIED CHARACTERS WILL BE LISTED.                  


 

LM - Source: CBT V249 File #300

The LM command, alias is SHOWDIR, lists all or part of the directory of a partitioned dataset.  Return codes produced by LM are:

Syntax:

        LM  'DSNAME'   LINESIZE('SIZE')    MASK('MASK')           
              DA('DSN')  ALIAS/NOALIAS                             

  REQUIRED - DSNAME                                                

  DEFAULTS - LINESIZE=7    MASK=ALL        ALIAS                   

ALIAS    - SHOWDIR, LISTMEM                                          

OPERANDS -                                                          
	   'DSNAME'         - THE PARTITIONED DATA SET FOR WHICH THE DIRECTORY 
        	              LISTING IS REQUIRED.                             

	   LINESIZE('SIZE') - THE NUMBER OF MEMBER NAMES TO BE DISPLAYED        
           	              ON A SINGLE LINE. MAXIMUM IS 9.                  
                   	      IF THE 'DA' OPTION IS TAKEN, THE FIRST           
	                      MEMBER NAME ON EACH LINE WILL BEGIN IN           
          	              POSITION 1.                                      

	   MASK('MASK')    - AN OPTIONAL MASK OR PREFIX  USED AS A SEARCH MASK.  
		             UP TO EIGHT CHARACTERS ON WHICH TO COMPARE              
		             FOR EQUAL BEFORE PRINTING. AN ASTERISK (*), IN ANY      
		             POSITION MAKES IT A NON-COMPARE POSITION.               
		             EXAMPLES:                                               
			               MASK(BPS)    WILL RETURN ANY MEMBER NAME           
                        	                    THAT BEGINS WITH 'BPS'.             
	                               PRE(*****XYS)  WILL RETURN ANY MEMBER NAME THAT    
                                                      ENDS IN 'XYZ' IN COLUMNS 6-8.       
		                       M(BPS****7)   WILL RETURN ANY MEMBER NAME THAT     
                                                     BEGINS 'BPS' AND ENDS IN A '7'.     
                                                                       
	   PREFIX('MASK') - SAME AS MASK PARAMETER                           
                                                                       
	   DA('DSN')      - WILL RETURN THE LIST OF MEMBER NAMES IN               
		            A SEQUENTIAL DATA SET NAMED, 'USERID.(DSN).DATA'.       
		            A DSNAME IN QUOTES WILL BE RESPECTED, AS WILL A VALID   
		            QUALIFIER (ASM,CLIST,CNTL,COBOL,DATA,FORT,PLI OR SPIT). 
		            THE DATA SET WILL HAVE SEQUENCE NUMBERS IN EDIT FORMAT. 
		            NOTE - DA(*) WILL BE TREATED AS IF THE DA               
	                    PARAMETER WAS NOT ENTERED AT ALL (OUTPUT WILL GO TO     
	                    THE USER'S TERMINAL).                                   
                                                                       
	   DS('DSN')      - SAME AS DA PARAMETER                                     
                                                                       
	   ALIAS/NOALIAS  - 'NOALIAS' WILL SUPPRESS THE SPECIAL FORMATTING    
		            GIVEN TO ALIAS NAMES. 'ALIAS' IS THE DEFAULT.           
		            NOTE -- AN '*ORPHAN*' IS AN ALIAS NAME THAT             
			    MATCHES NO MAIN MEMBER NAME.                           
		            A SPURIOUS *ORPHAN* WILL BE GENERATED WHEN             
		            AN ALIAS MEMBER NAME MATCHES THE SEARCH MASK,          
		            BUT THE MAIN NAME DOES NOT. ALSO, AN ALIAS WILL NOT    
		            BE SHOWN IF IT DOES NOT MATCH THE SEARCH MASK          
		            EVEN THOUGH THE MAIN MEMBER NAME MATCHES AND           
		            IS DISPLAYED.                                          


 

MEMBER - Source: CBT V430 File #300

The MEMBER command displays information about a member of a partitioned dataset from the PDS directory.

For members created by ISPF edit, the statistics in the directory are formatted.  For load modules, information from the directory is interpreted and formatted, including module size, attributes, and SSI information.  For load modules, information from the ESD and IDR records can be listed.  The command can also be used to search the system link libraries for a specified load module.

Syntax:

         MEMBER  'DSNAME(MEMBER)'  ESOTERIC  LIST  MAP  IDR  CSECT(ID) 
                                   PLUS('MEMBERS')  DATA  OUTFILE('DD')
                                   UNIT('UNITNAME')  VOLUME('VOLSER')  
OR                                                                 
         MEMBER  'MEMBER'  SYS     ESOTERIC  WHERE                      
                                   PLUS('MEMBERS')  DATA  OUTFILE('DD') 

  REQUIRED - 'DSNAME(MEMBER)'  (OR 'MEMBER' AND 'SYS')                  

  ALIAS    - MEM                                                        

OPERANDS -                                                           
	  'DSNAME(MEMBER)' THE DATA SET AND MEMBER TO BE DISPLAYED.             
        	           (OR JUST A MEMBER NAME IF 'SYS' IS ALSO SPECIFIED).        
	                   THIS OPERAND MAY OPTIONALLY BE A LIST IN PARENTHESES.      

	  ESOTERIC - FOR LOAD MODULES, A SECOND LINE OF DIRECTORY               
	             INFORMATION, WHICH IS RARELY OF INTEREST, IS TO            
         	     BE DISPLAYED.                                              

	  LIST     - FOR LOAD MODULES, THE FIRST 48 BYTES OF THE                
                     TEXT WILL BE DISPLAYED.  USEFUL IF THE PROGRAM             
                     HAD IDENTIFYING INFORMATION SUCH AS DATE-ASSEMBLED         
                     IN ITS 'SAVE' MACRO.  NOT VALID WITH 'SYS'.                

	  MAP      - FOR LOAD MODULES, THE CSECT NAMES FROM THE CESD            
	             RECORD(S) WILL BE DISPLAYED.  NOT VALID WITH 'SYS'.        

          IDR      - FOR LOAD MODULES, THE IDR RECORD CONTAINING THE            
		     DATE OF LINKEDIT IS DISPLAYED.                             
                     IF IDR(ZAP) IS SPECIFIED, IDR ZAP RECORDS ARE DISPLAYED.   
                     IF IDR(TRAN) IS SPECIFIED, IDR TRANSLATOR RECORDS, CON-    
                     TAINING THE DATE OF ASSEMBLY OR COMPILATION, ARE DISPLAYED.
                     IDR(PLS) IS THE SAME AS IDR(TRANS), EXCEPT PLS TRANSLATOR  
                     INFORMATION IS ALSO DISPLAYED.                             
                     IF IDR(IDENT) IS SPECIFIED, IDR IDENTIFY RECORDS, CREATED  
                     BY THE LINKEDIT 'IDENTIFY' STATEMENT, ARE DISPLAYED.       
                     IF IDR(SPACE) IS SPECIFIED, THE NUMBER OF AVAILABLE        
                     SLOTS FOR ZAP ENTRIES IS DISPLAYED.                        
                     IF IDR(ALL) IS SPECIFIED, ALL IDR RECORDS ARE DISPLAYED,   
                     BUT NOT THE ZAP SPACE AVAILABLE.  USE IDR(ALL SPACE).      

	PLUS(MEMBERS) - ADDITIONAL MEMBER NAMES TO BE PROCESSED.              

	CSECT(ID) - IF THE NAME OF A CSECT IS SPECIFIED HERE, THE             
                    'MAP' AND 'IDR' INFORMATION WILL BE RESTRICTED TO          
                    THE SPECIFIED CSECT.                                       

	SYS      - THE 'SYS' KEYWORD INDICATES THAT THE FIRST                 
                   OPERAND IS A MEMBER NAME AND THE SYSTEM LINK LIBRARIES     
                   (OR SESSION STEPLIB) ARE TO BE SEARCHED FOR IT.            
                   THIS OPERAND CANCELS THE 'LIST', 'MAP' AND 'IDR' OPERANDS, 
                   WHICH REQUIRE A DATA SET NAME IN THE 1ST OPERAND.          

 	WHERE    - VALID ONLY WITH 'SYS', THIS CAUSES THE CONCATENATION       
                   NUMBER OF THE LINKLIST (OR STEPLIB) LIBRARY TO BE          
                   DISPLAYED.  USEFUL FOR DETERMINING WHICH LIBRARY           
                   A MEMBER IS LOCATED IN.                                    

	LOAD     - FOR LOAD MODULES, THE COMMAND WILL LOAD THE MEMBER INTO    
                   MEMORY USING THE 'LOAD' MACRO, AND REPORT WHETHER IT WAS   
                   SUCCESSFUL OR NOT.  USEFUL FOR CHECKING SYSTEM 106 ABENDS. 

	DATA     - REQUESTS A RAW HEX DISPLAY OF THE DIRECTORY ENTRY.         

	UNIT(UNIT) - FOR UNCATALOGED DATA SETS, THE UNIT TYPE.                

	VOLUME(VOLSER) - FOR UNCATALOGED DATA SETS, THE VOLUME.               

	OUTFILE(DD) - REDIRECTS THE DISPLAY TO THE FILE PRE-ALLOCATED TO      
                      THE SPECIFIED DDNAME.                                      


 

MS - Source: SHARE MVS MODS V80-007 07-28-1980 FILES #49/#51/#53

The MS (Master Summary) command displays MVS System information.

Syntax:

     MS                                                   
OPERANDS - THERE ARE NO OPERANDS FOR THE MS COMMAND.            
                                                          
SUBCOMMANDS                                              

   SS - THE SS SUBCOMMAND DISPLAYS SYSTEM STATISTICS.        
                                                          
   LP - THE LP SUBCOMMAND DISPLAYS LINK PACK INFORMATION.    
                                                          
   TS - THE TS COMMAND DISPLAYS TSO STATISTICS.              
                                                          
   I  - THE I SUBCOMMAND DISPLAYS INITIATORS.                          
                                                                    
   J  - THE J SUBCOMMAND DISPLAYS JOBS.                                
                                                                    
   S  - THE S COMMAND DISPLAYS STARTED TASKS.                          
                                                                    
   T  - THE T SUBCOMMAND DISPLAYS A COUNT OF THE NUMBER OF TSO USERS.  
                                                                    
   E  - THE E COMMAND EXITS FROM MS.                                   


 

PDSBLKS - Source: GODDARD TAPE FILES #9/#12

The PDSBLKS command lists the number of directory blocks allocated and used for a Partitioned dataset.

Syntax:

          PDSBLKS  'DATA SET NAME'                                     

  REQUIRED - DATA SET NAME                                             

OPERANDS -                                                          

	  DATA SET NAME - NAME OF THE PDS FOR WHICH THE NUMBER OF DIRECTORY BLOCKS 
		          IS TO BE LISTED.                                         


 

PRINTOFF - Source: CBT V430 File #325

The PRINTOFF command creates a printed copy of datasets through foreground copying to SYSOUT.  The command prints datasets which are sequential or partitioned, block or unblocked, with fixed, variable, or undefined length records of any length up to 32,760.

Syntax:

   PRINTOFF (dslist)/*  DDNAME(ddname)/FILE(ddname)                     
            UNIT(unit-type)  VOLUME(volser)     NOMESSAGES/NOMSGS       
            CLASS(class)     DEST(destination)  COPIES(nnn)             
            HOLD/NOHOLD      LIST/NOLIST        PRINT/NOPRINT           
            FORMS(form)      FCB(fcb)           TRAIN(image)/UCS(image) 
            HEADING/NOHEADING                   CAPS/ASIS/FOLD/NOFOLD   
            NOCC/SINGLESPACE/SS/DOUBLESPACE/DS  ASA                     
            LINELENGTH(nnn)/LL(nnn)             PAGELENGTH(nnn)/PL(nnn) 
            BURST/NOBURST    FLASH(flash-name)  CHARS(charset-name(s))  
            PROG(progname)   UDKFONT(font-name)                         

   Required -- dslist or * if DDNAME(...)                               

   Aliases  -- PRINTO, PO                                               

   Defaults -- CLASS(A), COPIES(1), NOHOLD, LIST, PRINT, FORM($TST),    
               HEADING, ASIS, LINELENGTH(132), PAGELENGTH(60), NOBURST, 
	       SINGLESPACE if PAGELENGTH(...) or if input RECFM not A/M 

Operands -                                                           

	DSLIST - Data set list contains the names of data sets to be printed 
                 or punched.  The names should follow TSO convention, in     
                 quotes if the primary index differs from your profile       
                 prefix, or without quotes and with the primary index        
                 omitted if it is the same as your profile prefix.           
                 Enclosing parenthesis are required if there is more than    
                 one name in the list.                                       
                 If DDNAME(...) is specified, the dslist must end with an  
                 asterisk (or contain only an asterisk) as a place holder.   

	ASA     - Output is to be printed using input data column 1 as ASA    
        	  carriage control characters even though the DCB record      
	          format does not specify RECFM=..A                           

	ASIS    - Output is not to be converted to upper case prior to        
           	  printing. (It is left as it is.) NOFOLD is an alias for ASIS.                                

	BURST   - Output is to be trimmed and burst. ===> VALID FOR 3800 ONLY 

	NOBURST - Output will be printed on continuous forms.                 

	CAPS    - Output is to be converted to upper case prior to            
	          printing. FOLD is an alias for CAPS.                        

	CHARS(charset-name(s)) - Character set(s) to be used to print the     
                                 output. (1-4 names, each name 1-4 characters.)  If more     
                                 than one character set name is given, the input data should 
                                 have the character set id specified in the second character 
                                 of each line. OPTCD=J is assumed. See the JCL reference     
                                 manual for more information. ===> VALID FOR 3800 ONLY       

	CLASS(class) - SYSOUT class in which output is to be printed. Default is A.                                               

	COPIES(nnn) - Number of copies to be printed.  Default is 1.          

	DEST(destination) - The destination to where SYSOUT is to be routed.  
                            Destination can be a JES remote line, a JES local or remote 
                            printer, or a network node and userid. Local and remote     
                            names are 1-8 characters. Network names are 3-17 characters 
                            (node.userid) with the period required as a separator.      
                            DEST(node.userid) is mutually exclusive with                
                            PROG(progname).                                             

	DDNAME(ddname) - DD name of a previously allocated dataset. If DDNAME 
                         is specified, the last (or only) dataset name in dslist     
                         must be an asterisk. The DD will not be freed after being   
                         printed. FILE is an alias for DDNAME.                       

	FCB(fcb) - Forms Control Buffer to be used when the data set is       
                   printed.  (1-4 character FCB name)                          

	FLASH(flashname) - The name of the forms flash overlay which is to be 
                           flashed on all output. ===> VALID FOR 3800 ONLY             

	FORMS(form) - Form to be used when the data set is printed.           
                      Default is $TST. (1-4 character form name)                  
	HEADING - Output is to have a heading containing the data set name.   

	NOHEADING - Output is not to have heading information.                
	HOLD    - Output is to be placed on a hold queue upon deallocation.   
	NOHOLD  - Output is not to be placed on a hold queue upon             
                  deallocation.                                               

	LINELENGTH(nnn) - Number of characters on each line of printed        
                          output. (1-208 characters with a default of 132.)  Input    
                          lines longer than specified linelength will be printed on   
                          multiple lines.  LL(...) is an alias for LINELENGTH(...).   

	LIST    - A separate listing of member names processed is to be       
                  created and printed with the data set output.               

	NOLIST  - No list of member names is to be created.                   

	NOMESSAGES - Non-error messages are not to be written to the TSO      
                     terminal. NOMSGS is an alias of NOMESSAGES. The default is  
                     to write informational messages to the terminal before and  
                     after printing.                                             

	PAGELENGTH(nnn) - Number of lines per page.  (1-120 lines with a      
                          default of 60.)  Carriage control in input records is       
                          ignored (even if ASA is specified) and SINGLESPACE is used. 
                          PL(...) is an alias for PAGELENGTH(...).                    

	PRINT   - Members are to be printed. (Whether they are also listed    
                  is controlled by LIST/NOLIST.)                              

	NOPRINT - Members are not to be printed. (Whether they are to be      
                  listed is controlled by LIST/NOLIST.)                       

	PROG(progname) - The name of the special 'external writer' program    
                         that is to process the output. PROG(progname) is mutually   
                         exclusive with DEST(node.userid).                           

	TRAIN(image) - Print image to be used when the data set is printed.   
                       UCS is an alias for TRAIN. (1-4 character print image name) 

	UCS(image) - Print image to be used when the data set is printed.     
                     UCS is an alias for TRAIN. (1-4 character print image name) 

	SINGLESPACE - Output is to be single spaced.  Carriage control in     
                      input data is ignored even if ASA is specified.             
                      NOCC and SS are aliases for SINGLESPACE.                    

	DOUBLESPACE - Output is to be double spaced between lines.  Carriage  
                      control in input data is ignored even if ASA is specified.  
                      DS is an alias for DOUBLESPACE.  (Multiple line records     
                      will not be split between pages.)                           

	UNIT(unit-type) - Unit type of the specified VOLUME(volser). UNIT is  
                          ignored if VOLUME is not also specified. UNIT is required   
                          only when the dataset is not cataloged, or when the dataset 
                          is cataloged to a different volume than the specified       
                          VOLUME and the volume cannot be accessed through your TSO   
                          default unit type.                                          

	VOLUME(volser) - Volume serial of volume on which data sets to be     
                         printed are found.  This volume serial will be used for all 
                         data sets specified in the data set list.                   

	UDKFONT(font-name) - Output is intended to be printed on a XEROX 2700 
                             or 3700.  PRINTOFF will insert Xerox User Defined Key (UDK) 
                             statements in the output to select the specified font.  No  
                             validation is performed on the font name before it is sent  
                             to the printer, so the full font name must be specified in  
                             upper/lower case exactly as expected by the XEROX printer.  
                             (PRINTOFF uses the left brace character, {, hex C0, as the  
                             UDK.  Input data containing this character will be          
                             interpreted by the printer as a Xerox command, and may      
                             produce undesired results.)                                 


 

PRINTON - Source: CBT V498 File #860

The PRINTON command prints the contents of one or more datasets to the TSO terminal.

Syntax:

   PRINTON (Dataset list) LIST/NOLIST PRINT/NOPRINT                 
                                                                    
        Required - (Dataset list)                                   

        DEFAULTS - LIST PRINT                                       
                                                                    
Operands -                                                       

	Dataset list - one or more datasets to print.                     

	LIST         - list members of partitioned dataset.               

	NOLIST       - do not list members of partitioned dataset.        

	PRINT        - print contents of dataset/PDS members.             

	NOPRINT      - do not print contents of dataset/PDS members.      


 

RLSE - Source: CBT V249 File #300

The RLSE command is used to free up unused space from an existing dataset.

Syntax:

         RLSE  'DATASET-NAME'  LEAVE('TRACKS')  EXTENTS          

  REQUIRED - 'DATASET-NAME'                                      

  DEFAULTS - ALL UNUSED TRACKS ARE RELEASED IF NEITHER           
             'LEAVE' NOR 'EXTENTS' IS SPECIFIED.                 

OPERAND -                                                     
	  'DATASET-NAME' - SPECIFIES THE NAME OF THE DATASET WHICH IS TO HAVE    
                           ITS UNUSED SPACE RELEASED.                            

	  LEAVE('TRACKS') - 'TRACKS' IS THE NUMBER OF UNUSED TRACKS      
                            NOT TO BE FREED.                                      

	  EXTENTS - THIS KEYWORD INDICATES THAT ONLY UNUSED SECONDARY    
                    EXTENTS ARE TO BE FREED.  THE PRIMARY EXTENT AND      
                    ANY PARTIALLY USED SECONDARY EXTENTS ARE NOT FREED,   
                    EVEN IF THEY CONTAIN UNUSED SPACE.                    
                    THIS KEYWORD AND 'LEAVE' ARE MUTUALLY EXCLUSIVE.      


 

SHOWASM - Source: CBT V499 Overflow File #301

The SHOWASM command displays the current auxiliary storage manager slot status and the current page and swap dataset status.

Syntax: SHOWASM     (no operands)


 

SHOWDS - Source: CBT V249 Overflow File #300

The SHOWDS command displays a datasets attributes and space usage information.

Syntax:

         SHOWDS  'NAME'  VOLUME('VOLUME')   DIR  EXT  FILE           

  REQUIRED - 'NAME'                                                  

  ALIAS    - SDS                                                     

OPERANDS -                                                        

	  'NAME'   - THE NAME OF THE DATA SET WHOSE ATTRIBUTES               
        	     ARE TO BE DISPLAYED, OR IF THE 'FILE' KEYWORD           
	             IS ALSO SPECIFIED, THE 8-CHARACTER FILENAME (DDNAME)    
        	     ALLOCATED TO THE DATA SET WHOSE ATTRIBUTES ARE          
	             TO BE DISPLAYED.                                        

	VOLUME('VOLUME') - IF THE FIRST OPERAND IS THE NAME OF AN          
        	           UNCATALOGED DATA SET, THIS KEYWORD SPECIFIES            
	                   THE VOLUME ON WHICH THE DATA SET RESIDES.               
	                   THE VOLUME KEYWORD IS IGNORED IF 'FILE' IS              
	                   SPECIFIED.                                              

	DIR      - DISPLAY INFORMATION ABOUT THE DIRECTORY OF              
	           THE PARTITIONED DATA SET.                            

	EXTENTS  - DISPLAY THE EXTENTS OF THE DATA SET (THE BEGINNING   
	           AND ENDING CYLINDER/TRACK LOCATIONS).                

	FILE     - THIS KEYWORD INDICATES THAT THE FIRST OPERAND        
        	   IS TO BE TREATED AS A FILENAME (DDNAME) INSTEAD      
	           OF A DATA SET NAME.  THE COMMAND WILL DETERMINE      
	           WHICH DATA SET IS CURRENTLY ALLOCATED TO THE         
	           SPECIFIED FILENAME AND DISPLAY ITS ATTRIBUTES.       
	           THIS ALLOWS ATTRIBUTES OF TEMPORARY DATA SETS        
	           TO BE DISPLAYED.                                     

ALIAS NAME=SDS                                                 


 

SYSTEM - Source: CBT V249 File #300

The SYSTEM command displays the status of the MVS system.

Syntax:  SYSTEM    (no operands)


 

VOLS - Source: CBT V490 File #360

The VOLS command will display the online DASD volumes and how much freespace there is on each volume.

Syntax:

   VOLS Type('voltype')                                         
             DEVIcetype   DEVT('devicetype')                    
             Attribute('volattr')                               
        Volume('volser')   Serial('volser')                     
        Ucbaddr('device-cuu')   Address('device-cuu')           
        Clear                                                   
                                                                
        Default  - TYPE(ALL)                                    
                                                                
  NOTE: Devicetype, Devt, and Attribute are aliases for Type.   
        Serial is an alias for Volume.                          
        Address is an alias for Ucbaddr.                        
                                                                
Operands -                                                   

	TYPE       - Specifies selection criteria.                    
               Valid entries for TYPE are:                      
                     All     - select ALL devices -- DEFAULT    
                     PRivate - select PRIVATE devices           
                     PUblic  - select PUBLIC devices            
                     Storage - select STORAGE devices           
                     3390    - select 3390 devices              
                     3380    - select 3380 devices              
                     3375    - select 3375 devices              
                     3350    - select 3350 devices              
                     3340    - select 3340 devices              
                     3311    - select 3311 devices              
                     3330    - select 3330 devices              
                     2314    - select 2314 devices              

	DEVICETYPE - Specifies selection criteria - alias for TYPE.   

	DEVT       - Specifies selection criteria - alias for TYPE.   

	ATTRIBUTE  - Specifies selection criteria - alias for TYPE.   
                                                                
	VOLUME     - Specifies selection by volume serial number.     
		     The VOLUME parameter may be a specific volser or        
                     some level of volser up to 6 characters in length.      
                     If a level is specified all devices that have serial    
                     numbers beginning with that level will be displayed.    

	SERIAL     - Specifies selection criteria - alias for VOLUME.        
                                                                       
	UCBADDR    - Specifies selection by the device address.              
                     The UCBADDR parameter may be a spedific address or      
                     some level of address up to 3 characters in length.     
                     if a level is specified all devices that have addresses 
                     beginning with that level will be displayed.            

	ADDRESS    - Specifies selection criteria - alias for UCBADDR.       
                                                                       
	CLEAR      - Clears the screen if executing on a display video and   
                     redisplays the headings on the top of all subsequent    
                     screens.                                                


 

VTOC - Source: CBT V129 File #112

The VTOC command displays selected datasets on a disk or a set of disks.  

Syntax:

         VTOC     'VOLUME-LIST'           LEVEL('DSNAME-START')       
                                          CONTAINING('DSNAME-STRING') 
                                          ENDING('DSNAME-END')        
                                          BREAK('BREAK-CHARS')        
                                          CAT                                                 
                                          NOSORT/SORT('SORT-FIELDS')                          
                                          NOPRINT/PRINT('PRINT-OP' ('PRINT-ITEM-LIST'))       
                                          LIMIT('KEYWORD' 'OPER' 'VALUE')                     
                                          AND1/OR1('KEYWORD' 'OPER' 'VALUE')                  
                                          AND2/OR2('KEYWORD' 'OPER' 'VALUE')                  
                                          AND3/OR3('KEYWORD' 'OPER' 'VALUE')                  
                                          CHARS('CHARS-PER-LINE')                             
                                          CONTAINING('DSNAME-STRING') 
                                          ENDING('DSNAME-END')        
                                          BREAK('BREAK-CHARS')        
                                          LINES('LINES-PER-PAGE')                             
                                          NOHEADING/HEADING('TEXT')                           
                                          DSNLEN('LENGTH')                                    

  REQUIRED - 'VOLUME-LIST'                                            

  DEFAULTS - LIST ALL DATA SETS ON THE VOLUME(S) SELECTED.            
             SORT, PRINT                                              

OPERANDS -                                                         
	'VOLUME-LIST'     - A VOLUME SERIAL NUMBER OR A LIST OF VOLUMES.    
                            IF THE FIRST ONE TO FIVE CHARACTERS OF A VOLUME         
                            SERIAL NUMBER ARE ENTERED, ALL VOLUMES THAT ARE          
                            MOUNTED ON THE MACHINE WHICH START WITH THOSE            
                            CHARACTERS WILL BE LISTED.                               
                            IF 'ALL' IS SPECIFIED, ALL NON-VIRTUAL VOLUMES           
                            WHICH ARE ONLINE AND READY WILL BE PROCESSED.            
                            IF 'ALV' IS SPECIFIED, ALL VIRTUAL VOLUMES               
                            WHICH ARE ONLINE AND READY WILL BE PROCESSED,            
                            IF THEY ARE MOUNTED PRIVATE/RESERVED OR                  
                            PRIVATE/RESIDENT.                                        

	LEVEL('DSNAME-START')  - SPECIFIES THE HIGH LEVEL QUALIFIERS TO BE   
                                 SEARCHED.  THIS WILL NOT BE PREFIXED BY YOUR USERID OR        
                                 PREFIX.  ONLY DATA SETS STARTING WITH THESE PREFIXES WILL     
                                 BE LISTED.                                                    

	CONTAINING('DSNAME-STRING') - SPECIFIES A CHARACTER STRING CONTAINED 
                                      IN THE DATA SET NAME.  AT LEAST ONE OF THE STRINGS MUST       
                                      BE IN THE DSNAME FOR THE DATA SET TO BE LISTED.               
                                      THESE STRINGS MUST CONFORM TO DSNAME STANDARDS.               
                                      THEY CANNOT BEGIN WITH A PERIOD OR A NUMBER.                  

	ENDING('DSNAME-END')  - SPECIFIES THE ENDING CHARACTERS OF THE       
                                DSNAME.  THE FINAL NONBLANK CHARACTERS OF THE DSNAME MUST     
                                BE ONE OF THESE STRINGS TO ALLOW THE DATA SET TO BE LISTED.   
                                THESE STRINGS MUST CONFORM TO DSNAME STANDARDS.               

	CAT      -  A LOCATE IS DONE FOR EACH DSNAME ON THE VOLUMES LISTED   
                    AND STATUS IS INDICATED.  NOTE -  THIS OPTION USES A          
                    CONSIDERABLE AMOUNT OF PROCESSING TIME.                       
                      C -  CATALOGGED ON THIS VOLUME                                
                      N -  NOT CATALOGGED                                           
                      W -  CATALOGGED ON ANOTHER VOLUME                             
                      E -  CATALOG PROCESSING ERROR                                 

	NOSORT   -  THE DATA SETS ARE NOT SORTED.  THEY ARE OUTPUT AS THEY   
                    ARE FOUND.                                               

	SORT('SORT-FIELDS') DATA SETS ARE SORTED INTO ALPHABETICAL ORDER,    
                            BASED UPON THE SORT FIELDS SPECIFIED.                    
                            DSNAME,VOLUME,ALLOC,USED,UNUSED,PCT,EX,DSO,RFM,          
                            LRECL,BLKSZ,CDATE,EXPDT,REFDT ARE VALID SORT FIELDS.     
                            'A/D'   ARE REQUIRED AFTER EACH SORT FIELD TO INDICATE   
                            ASCENDING/DESCENDING SEQUENCE.                           

	BREAK('BREAK-CHARS') - THE LISTING WILL CONTAIN A NEW HEADER,        
                               ( ON A NEW PAGE IF THE VTOCOUT DD CARD OPTION IS USED ), 
                               WHENEVER THE SPECIFIED NUMBER OF CHARACTERS DIFFERS      
                               FROM THE PRECEDING DATA SET.  THIS OPTION FUNCTIONS      
                               ONLY WITH THE SORT OPTION.                               

	CHARS('CHARS-PER-LINE') - SPECIFIES THE NUMBER OF CHARACTERS ON EACH 
                                  LINE OF OUTPUT.  THE DEFAULT IS 150 FOR PRINT AND THE    
                                  LINESIZE OF THE TERMINAL FOR TSO SESSIONS.               
                                  YOU CAN GET MORE INFORMATION BY SPECIFYING A LARGER      
                                  NUMBER OF CHARACTERS PER LINE OR YOU CAN LIMIT THE       
                                  PRINTING BY SETTING A SMALLER NUMBER OF CHARACTERS       
                                  PER LINE OF OUTPUT.                                      

	LINES('LINES-PER-PAGE') - SPECIFIES THE NUMBER OF LINES BEFORE A NEW 
                                  TITLE LINE IS PRODUCED.  IT DEFAULTS TO 60 FOR PRINT     
                                  AND TO THE SCREEN SIZE FOR TSO SESSIONS.                 

	NOHEADING   - DO NOT PRODUCE A HEADING.  THE HEADING WILL ONLY BE    
                      OUTPUT IF THE VTOCOUT DD STATEMENT IS PRESENT.           

	HEADING('TEXT') - IF A DD STATEMENT WITH A DDNAME OF VTOCOUT IS      
                          PRESENT, THIS TEXT WILL BE USED TO BEGIN EVERY PAGE.     
                          CARRIAGE CONTROL SHOULD BE INCLUDED ( ASA ).  THE        
                          DEFAULT HEADER CONSISTS OF VTOC COMMAND VERSION 02       
                          AND THE COMMAND THAT WAS ENTERED.                        

	DSNLEN('LENGTH') - SPECIFIES THE LENGTH OF THE DSNAME TO PRINT.      
                           THE REST OF THE DSNAME IS TRUNCATED.  THE CHARS PARAMETER 
                           WILL ALSO CAUSE THE DSNAME TO BE TRUNCATED, IF THE NAME   
                           AND THE PRECEDING INFORMATION EXCEEDS THE PRINT LINE.     

	NOPRINT     - SPECIFIES THAT INDIVIDUAL ITEMS ARE NOT TO BE LISTED.   
                      THE COMMAND CAN BE USED TO CALCULATE TOTALS.              

	PRINT('PRINT-OP' ('PRINT-ITEM-LIST')) - SPECIFIES THE ITEMS TO PRINT.  THE 'PRINT-OP' IS THE      
                                                OPERATION TO BE DONE.  THEY INCLUDE THE FOLLOWING.        
                                                NEW - THE 'PRINT-ITEM-LIST' IS A COMPLETE LIST OF WHAT  
                                                      TO PRINT.                                         
                                                REP - THE FIRST 'PRINT-ITEM' WILL BE REPLACED WITH THE  
				                      REST OF THE ITEMS ON THE LIST.                    
				                ADD - THE REST OF THE 'PRINT-ITEM-LIST' WILL BE ADDED   
				                      AFTER THE FIRST ITEM ON THE LIST.                 
				                DEL - THE ITEMS ON THE 'PRINT-ITEM-LIST' WILL NOT BE    
				                      PRINTED.                                          
				                THE 'PRINT-ITEM-LIST' NAMES ARE THE SAME KEYWORDS USED    
				                IN LIM, AND, AND OR FUNCTIONS AND ARE ALSO THE TITLES     
				                AS PRINTED.                                               
				                THE ADD, DEL, AND REP PRINT OPERATIONS REFER TO THE       
						DEFAULT PRINT LIST.  THE DEFAULT LIST IS ALLOC, UNUSED,  
					        PCT, EX, DSO, RFM, BLKSZ, LRECL, REFDT, CDATE, VOLUME,   
				                DSNAME, EXPDT, SECQ, SECT, ROUND, PASS, ACTION,          
				                AND TYPE.  AS NOTED UNDER CHARS ABOVE, ONLY THE ITEMS    
				                THAT WILL FIT ON THE PRINT LINE WILL BE LISTED.          

	LIMIT('VALUE' 'OPER' 'KEYWORD') - SPECIFIES WHICH DATA SETS ARE TO   
        			          BE LISTED.  ONLY DATA SETS THAT SATISFY THE RELATION     
				          ARE LISTED.                                              

	'KEYWORD'   - IS THE NAME OF A DATA SET FIELD.  THE LIST OF CURRENTLY
                      PROVIDED FIELDS FOLLOWS.  THE KEYWORDS AND THEIR VALUES
                      ARE THE SAME AS IN THE VTOC OUTPUT.                    
                                                                       
                      ALLOC      DATA SET ALLOCATION                   
                                    NUMBER OF KILOBYTES, TRACKS,       
                                    CYLINDERS, OR MEGABYTES ALLOCATED. 
                                    DEFAULT IS KILOBYTES.              
                      UNUSED     AMOUNT OF UNUSED SPACE IN THE DATA    
                                    SET.  SAME UNITS AS IN ALLOC.      
                      USED       AMOUNT OF SPACE USED IN THE DATA SET. 
                                    SAME UNITS AS IN ALLOC.            
	              PCT        PERCENTAGE OF SPACE USED IN THE DATA  
                                    USED.                              
                      EX         NUMBER OF EXTENTS IN THE DATA SET.    
                      DSO        DATA SET ORGANIZATION                 
                                    PS = SEQUENTIAL   PO = PARTITIONED 
                                    VS = VSAM         IS = ISAM        
                                    DA = DIRECT ACCESS  U = UNMOVEABLE 
                      RFM        RECORD FORMAT                         
                                    F  = FIXED        V  = VARIABLE    
                                    U  = UNDEFINED    B  = BLOCKED     
                                    T  = TRACK OVERFLOW                
                                    S  = SPANNED OR STANDARD           
                                    A  = ASA CARRIAGE CONTROL          
                                    M  = MACHINE CARRIAGE CONTROL      
                      BLKSZ      BLOCKSIZE FOR PHYSICAL BLOCKS OF      
                                    DATA.                              
                      LRECL      LOGICAL RECORD LENGTH IN BYTES.       
                      CDATE      CREATION DATE IN THE FORM YYDDD,      
                                    SOMETIMES CALLED JULIAN.           
                      EXPDT      EXPIRATION DATE IN THE SAME FORM.     
				 THIS FIELD IS RARELY USED HERE.     
                      REFDT      LAST USE DATE IN THE SAME FORM.        
                                    THIS DATE IS WHEN THE DATA SET WAS  
                                    LAST OPENED.                        
                      SECT       TYPE OF ALLOCATION                     
                                    A  = ABSOLUTE TRACK                 
                                    B  = BLOCKS                         
                                    T  = TRACKS                         
                                    C  = CYLINDERS                      
                      PASS       PROTECTION INDICATORS                  
                                    N  = NONE                           
                                    R  = READ AND WRITE PROTECTION      
                                    W  = WRITE PROTECTION               
                      ROUND      SPACE ROUNDED UP TO CYLINDERS          
                                    R  = ROUND                          
                                    N  = NO ROUND                       
                      CCHH       CYLINDER AND HEAD ADDRESS, IN 4 OR 8   
                                    HEXADECIMAL DIGITS.  IF 4 DIGITS    
                                    ARE USED, ONLY THE CYLINDER IS USED 
                                    FOR COMPARISON, OTHERWISE, THE CYL  
				    AND TRACK ARE COMPARED.           
                      VOLUME     VOLUME SERIAL NUMBER OR DISK NAME    
                      DSNAME     NAME OF THE DATA SET                 
                      ACTION     SOME ERROR INDICATIONS               
                      TYPE       RESERVED FOR EXIT USAGE.             

	'OPER'      - IS AN OPERATOR.  THE LIST OF OPERATORS FOLLOWS.       
                        EQ       IS EQUAL TO                          
                        NE       IS NOT EQUAL TO                      
                        LE       IS LESS THAN OR EQUAL TO             
                        LT       IS LESS THAN                         
                        GE       IS GREATER THAN OR EQUAL TO          
                        GT       IS GREATER THAN                      

	'VALUE'     - GIVES THE VALUE OF THE ITEM FOR COMPARISON, SUCH AS   
                      FB, PS, R, OR A NUMBER.                                 

	AND1('VALUE' 'OPER' 'KEYWORD') -  SPECIFIES WHICH DATA SETS ARE TO  
                                          BE LISTED.  BOTH THE LIMIT AND THIS CONDITION MUST   
                                          BE TRUE TO ALLOW THE LISTING.                        

	OR1('VALUE' 'OPER' 'KEYWORD') -   SPECIFIES WHICH DATA SETS ARE TO  
                                          BE LISTED.  EITHER THE LIMIT OR THIS CONDITION MUST  
                                          BE TRUE TO ALLOW THE LISTING.                        

	AND2('VALUE' 'OPER' 'KEYWORD') -  SPECIFIES WHICH DATA SETS ARE TO   
                                          BE LISTED.  BOTH THE PREVIOUS RESULT AND THIS          
                                          CONDITION MUST BE TRUE TO ALLOW THE LISTING.          

	OR2('VALUE' 'OPER' 'KEYWORD') -   SPECIFIES WHICH DATA SETS ARE TO   
                                          BE LISTED.  EITHER THE PREVIOUS RESULT OR THIS        
                                          CONDITION MUST BE TRUE TO ALLOW THE LISTING.          

	AND3('VALUE' 'OPER' 'KEYWORD') -  SPECIFIES WHICH DATA SETS ARE TO   
                                          BE LISTED.  BOTH THE PREVIOS RESULT AND THIS          
                                          CONDITION MUST BE TRUE TO ALLOW THE LISTING.          

	OR3('VALUE' 'OPER' 'KEYWORD') -   SPECIFIES WHICH DATA SETS ARE TO   
                                          BE LISTED.  EITHER THE PREVIOUS RESULT OR THIS        
                                          CONDITION MUST BE TRUE TO ALLOW THE LISTING.          
	EXAMPLES -                                                           
	  LIST ALL DATA SETS ON VOL             VTOC VOL                       
	  LIST ALL DATA SETS ON ALL VOLUMES     VTOC ALL                       
	  LIST ALL DATA SETS THAT START 
               WITH  XXX   
               ON ANY MVXXXX VOLUME             VTOC MV LEV(XXX)               
	  LIST ALL RECENTLY CREATED DATA SETS   VTOC VOL LIM(CDATE GT 79001)   
	  LIST DATA SETS WITH UNUSED SPACE      VTOC VOL LIM(PCT LT 50)  -     
                                                 OR1(UNUSED GT 30)      
	  LIST DATA SETS WITH MULTIPLE EXTENTS  VTOC VOL LIM(EX GT 1)          
	  LIST ALL OF USER'S DATA ON TSO001     VTOC TSO001 LEVEL(TMTCEXX)       
	  LIST ALL DATA SETS OVER 100 TRKS      VTOC VOL LIM(ALLOC GT 100)     
	  LIST DATA SETS UNDER THE FIXED HEADS  VTOC VOL LIM(CC EQ 0001) -     
                                                 OR1(CC EQ 0002)       
	  LIST USED SPACE INSTEAD OF UNUSED,                                   
               IN TRACKS.                       VTOC VOL PRINT(REP (UNUSED USED)) TRK 
	  LIST CLIST DATA SETS                  VTOC VOL END(CLIST)                   
	  LIST ALL OF THE INFORMATION ABOUT                                    
               USER'S DATA SETS AT A 3270.      VTOC VOL CHAR(150)                
	  CHECK IF DATASETS ARE CATALOGED
               ON THIS VOLUME.                  VTOC VOL CAT PRINT(NEW (ALLOC PCT CAT DSNAME))       
	  LIST ALL DATA SETS ON 335XXX VOLUMES
               SORTED BY ALLOC IN DESCENDING
               SEQUENCE, VOLUME AND DSNAME IN
               ASCENDING SEQUENCE.              VTOC 335 SORT(ALLOC,D,VOLUME,A,DSNAME,A)                        


WHOHAS - Source: CBT V249 File #300

The WHOHAS command lists all users and/jor jobs that have enqueued on the specified dataset name(s).

Syntax:

         WHOHAS  'DATA SET NAME LIST'  OLD                              

  DEFAULTS - 'SHR' AND 'OLD' ENQUED DATA SETS.                          

  ALIAS    - DSN                                                        

  **NOTE** - IF THE DATA SET NAME IS NOT SPECIFIED, ONLY THE USER ID    
             IS USED.                                                   
OPERANDS -                                                           
  'DATA SET NAME LIST' - SPECIFIES THE DATA SET NAME(S) ON WHICH USERS AND/OR      
                         JOBS HAVE ENQUED.                                         

  OLD       - SPECIFIES THAT ONLY DATA SETS ALLOCATED AS 'OLD' ARE TO BE LISTED.                                         


I hope that you have found my instructions useful.  If you have questions that I can answer to help expand upon the information I have included here, please don't hesitate to send them to me:


Return to Site Home Page 

This page was last updated on June 15, 2020.