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 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 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 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 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.
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.
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)
The DTAPES command displays all tape devices defined in the system.
Syntax: DTAPES (no operands)
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)
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.
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.
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)
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:
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
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.
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.
The LM command, alias is SHOWDIR, lists all or part of the directory of a partitioned dataset. Return codes produced by LM are:
- 0000 - no errors
- 0004 - no members meet the requirements for listing
- 0008 - output incomplete or output dataset not created
- 0012 - input dataset unreadable or not partitioned
- 0016 - parse error processing user's parameters
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.
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.
The MS (Master Summary) command displays MVS System information.
Syntax:
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.
The PDSBLKS command lists the number of directory blocks allocated and used for a Partitioned dataset.
Syntax:
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.)
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.
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.
The SHOWASM command displays the current auxiliary storage manager slot status and the current page and swap dataset status.
Syntax: SHOWASM (no operands)
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
The SYSTEM command displays the status of the MVS system.
Syntax: SYSTEM (no operands)
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.
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)
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:
This page was last updated on June 15, 2020.
