Preview only show first 10 pages with watermark. For full document please download

Dr Ditto 6.8c Users Guide 20061204

   EMBED


Share

Transcript

Users Guide Version 6 Release 8C Dr. Ditto is an alternative to the VSE/DITTO utility. It provides the basic functions needed in all mainframe environments. Dr. Ditto is compatible with any VSE or VSE/ESA or DOS/MVT/VSE system and supports any disk or tape device supported by those operating systems. Copyright © 2006 by Connectivity Systems, Inc. This documentation applies to Release 6.8C of the program product Dr. Ditto. Original Printing .......................02/15/2000 Last Revised ..............................12/04/2006 TABLE OF CONTENTS Introduction..............................................................................................................................1 Tape Functions .......................................................................................................................1 Disk Functions .........................................................................................................................1 Card Image Functions ..........................................................................................................1 Method of Operation ..............................................................................................................2 Interactive Operation ...........................................................................................................2 Batch Operation....................................................................................................................2 Batch and CICS Interactive Operation .............................................................................2 Parameter Specification ......................................................................................................3 Device Addresses ..................................................................................................................3 Disk Addresses ........................................................................................................................3 Printer Output .........................................................................................................................4 Interrupting Dr. Ditto Functions ............................................................................................4 Ending Dr. Ditto ......................................................................................................................4 Dr. Ditto Help Function/Function List ......................................................................................5 Dr. Ditto Help Function..........................................................................................................5 Dr. Ditto Function List .............................................................................................................6 Tape Functions.........................................................................................................................7 Tape Error Correction............................................................................................................7 Tape Functions for Batch Mode Only.................................................................................8 Tape to Card Image ......................................................................................................8 Print SYSLST Tape..............................................................................................................8 Tape Functions – Batch and Interactive............................................................................9 Tape to Print.....................................................................................................................9 Tape to Tape ...................................................................................................................9 Tape to Tape Reblocked...............................................................................................10 Tape Compare................................................................................................................10 Tape Control....................................................................................................................11 Initialize Tape ...................................................................................................................12 Tape Mapping.................................................................................................................12 Tape Record Scan ..........................................................................................................13 Tape Functions – Interactive Mode Only...........................................................................14 Tape Record Load..........................................................................................................14 Erase Tape........................................................................................................................14 Disk Functions ..........................................................................................................................15 Disk Functions – Batch and Interactive ..............................................................................16 Disk Map Function ..........................................................................................................16 Disk to Printer/Screen......................................................................................................16 Sequential Disk File to Printer/Screen...........................................................................17 VSAM Disk File to Printer/Screen ...................................................................................17 List Print Image Disk File ..................................................................................................18 Disk Record Scan ............................................................................................................19 Disk Functions – Interactive Mode ......................................................................................20 Disk Record Load ............................................................................................................20 Write EOF Record ............................................................................................................20 Alter Disk ID (VOLSER) .....................................................................................................21 TABLE OF CONTENTS Card Functions ........................................................................................................................22 Copy Card Image to Card Image......................................................................................22 Card Image to Printer ...........................................................................................................22 Card Image to Tape .............................................................................................................23 Card Image to Sequential Disk File .....................................................................................23 Dr. Ditto Keywords and Operands .........................................................................................24 Dr. Ditto Messages...................................................................................................................27 Index ........................................................................................................................................30 Dr. Ditto USERS GUIDE Introduction The Dr. Ditto utility system provides basic tape, disk, and card image functions needed for all mainframe computer systems. Tape Functions Dr. Ditto’s tape function capabilities allow you to: • Copy tape files or portions of tape files with or without reblock • Scan, map, list, alter, and compare tape data • Convert tape data to card image format • Initialize tapes with standard VOL and HDR records Disk Functions Dr. Ditto’s disk function capabilities allow you to: • Print, scan, and alter disk data • Alter the disk VOLID • Map the CKD disk, showing the location and ID of the real and virtual disks on each real disk. Card Image Functions Dr. Ditto’s card image function capabilities allow you to: Introduction • Duplicate card images or copy card images to tape • List card images in character or character and hexadecimal format • Copy card images to sequential disk file. Page 1 Dr. Ditto USERS GUIDE Method of Operation Dr. Ditto operates in the following modes: • Batch mode. Control statements and data from the SYSIPT device are processed without operator interaction. • Batch interactive mode. The operator enters free-form commands or command strings in response to partition prompts. Optional SYSLST and SYSPCH output can be generated. • CICS interactive mode. The operator enters free-form commands or command strings to screen prompts. All print out is directed to the screen. Functions using either card input from SYSIPT or output to SYSPCH are not permitted. Interactive Operation Two interactive modes are provided: batch and CICS. In batch mode, you enter commands via normal interaction with the operator console. Under CICS, after initiation by the DRZAP transaction, you enter commands in the same format as batch. However, all printed output is directed to the CICS terminal screen. In batch mode, the Dr. Ditto LOG command directs printed output to the operator screen if desired. In either interactive mode, browse commands are provided to allow forward and backward positioning along with tape and disk scan functions. Batch Operation To operate Dr. Ditto in non-interactive batch mode, submit a job stream that includes the VSE JCL statement // UPSI 1, the // EXEC DRDITTO and the required $$DITTO control statements, read by Dr. Ditto from SYSIPT. Card image data input is also read from SYSIPT and may include any desired format including the '/*' '/&' other JCL and blank cards. The assumed value for end-of-data cards is a blank card, but this can be varied by use of the EOC keyword. You can enter multiple commands in each Dr. Ditto execution. Each Dr. Ditto control statement must contain $$DITTO in columns 1-7 followed by one or more spaces, followed by the command, followed by one or more spaces, followed by the keyword string. The keyword string consists of one or more KEYWORD=OPERAND fields separated by commas with no embedded spaces: $$DITTO CCC KEYWORD1=OPERAND1,KEYWORD2=OPERAND2 Batch and CICS Interactive Operation In batch mode, if the first UPSI bit is off (// UPSI 0), Dr. Ditto prompts the operator with self-explanatory messages via the operator console. Under CICS, a DRZAP transaction must be defined ('DZAP' for instance) that invokes the DRZAPC program, and DIT entered to the DRZAP prompt. Certain DRZAP and Dr. Ditto phases are re-entrant and so may be placed in the SVA to lessen storage Page 2 Method of Operation Dr. Ditto USERS GUIDE requirements in CICS operation. See the install link map to determine which phases are SVA eligible. The commands and parameters may be entered individually or as a command string to minimize console messages and allow rapid execution of functions. Once a command string is entered, it may be repeated as desired by typing R at the DRDITTO FUNCTION? prompt. Parameter Specification In batch mode, parameters are entered via keyword oriented control statements read from the SYSIPT device. In interactive mode, you enter parameters as positional parameters either in response to Dr. Ditto prompts or as strings of commands and parameters separated by commas. If you enter string commands and errors are detected, the Dr. Ditto discards the string and initiates prompting mode. Strings may contain multiple commands plus parameters; the whole string may be repeated by typing R at the DRDITTO FUNCTION? prompt. Before using string commands, consider using prompting mode to gain familiarity with the commands and parameters. Device Addresses If a device address is required for a tape device, you may enter it as CUU/CUUMM or as a SYSnnn (programmer logical unit) assigned to the tape device prior to execution of Dr. Ditto. If a device address is required for a disk device, you may enter it as CUU or as a SYSnnn (programmer logical unit) assigned to the disk device prior to execution of Dr. Ditto. If a six-character field is entered, it is first checked to see if it is the VOLSER of a disk. If so, that disk's CUU is used to access the disk. Disk Addresses Most disk functions require you to specify the area of the disk to be accessed for input or output. In control card batch mode, use the keywords BEGIN and END for this purpose. In interactive mode, prompting is used to request these parameters, or they are entered as positional data in command strings. In either case, the address has a format depending on whether the disk is CKD or FBA. For FBA disk, you enter it as a physical block number (PBN). For CKD disk, you enter it as a track number (prefixed by R) or as a cylinder-head or cylinder-head-record. The cylinder portion of the entry is a 0- to 6-digit number, and the head number is always two digits. When using the CKD record number, you must follow the head with an R plus the record number suffixed to the R (cccccchhRrrr). For example, Cylinder 222, Head 15, Record 3 would be 22215R3. When using relative track addressing, the END address is assumed to be the number of tracks. The UPSI JCL statement modifies batch operation, as follows: • The first UPSI (1xxxxxxx) indicates control card operation. • The second UPSI (x1xxxxxx) suppresses the page heading. • The third UPSI (xx1xxxxx) suppresses the total lines. Method of Operation Page 3 Dr. Ditto USERS GUIDE • The fourth UPSI (xxx1xxxx) suppresses printing of control cards. • The fifth UPSI (xxxx1xxx) suppresses the "SCALE" (same as DATAHEADER=NO). For FBA disk the CISIZE parameter is also required to indicate whether CI or physical block processing is to occur. If physical block processing is desired, enter zero. Printer Output In CICS interactive mode, all print output is directed to the terminal; no printer output is possible. In batch and batch interactive mode, print output is directed to the device assigned to SYSLST unless you enter the LOG command, directing all print output to the operator terminal. If print output is displayed on CICS or on the operator screen, the display pauses at appropriate times to allow viewing or browsing commands. If you wish to discontinue the current operation, type QUIT or Q. If you wish to skip to the next record, type F or Fn to go forward 'n' records. To go backward, type B or Bn to go back 'n' records, where n is a 1- to 5-digit number. Interrupting Dr. Ditto Functions To interrupt batch execution, type the attention routine command MSG pi where pi is the partition identifier. Under batch or CICS, type Q or QUIT wherever Dr. Ditto allows a response. In CICS mode, a 'query threshold' is established so that Dr. Ditto will pause periodically to allow the operation to be terminated, if desired. You can modify this threshold using the QST command. Ending Dr. Ditto In interactive mode, type EOJ or END or E at the DRDITTO FUNCTION ? prompt. In batch mode, the last control statement should be $$DITTO EOJ; end-of-job is assumed if the JCL '/*' is read instead of an expected $$DITTO control card. Page 4 Method of Operation Dr. Ditto USERS GUIDE Dr. Ditto Help Function/Function List Dr. Ditto Help Function The Dr. Ditto HELP function provides a display of all functions, messages, and keywords; a display of function groups; or detailed information about a specific function, message or keyword. Invoke it by typing the HELP (or XXX) command and a parameter specifying the desired information. ALL (or A) DISK (or D) K M TAPE (or T) Z HELP Command Parameters List all commands, keywords, and messages List disk commands Keywords Messages List tape commands List control commands To obtain a full description of an item, type HELP,xxxx where xxxx is the desired topic. The whole topic string is not required, only enough to uniquely identify it. For messages, enter a 1- to 3-digit message number. Dr. Ditto Help Function/Function List Page 5 Dr. Ditto USERS GUIDE Dr. Ditto Function List Dr. Ditto functions are organized around the type of device to be used as input for each: DMP DD DP DDR/DDD DID DRL DRS EOF SFA SFD SPR SDP VPR VDP VC TLB TMP TMC TT TTR TTC TP TPR/TPD TD TDR/TDD TRS TC TRL TFA TFD INT WTM REW RUN FSR BSR FSF BSF CC CP CH / CD CT CTR CSQ CVS CCS BROWSE EOJ/END HELP KEY LOG NOP QST SCE SET Q/QUIT Page 6 DISK FUNCTIONS DISK MAP- LIST REAL, CMS AND OTHER MINI DISKS. DISK TO PRINTER IN CHAR. AND HEX FORMAT UNBLOCKED DISK TO PRINTER IN CHAR. FORMAT UNBLOCKED DISK TO PRINTER IN CHAR. AND HEX FORMAT DEBLOCKED ALTER DISK IDENTIFICATION VOLUME NUMBER DISK RECORD LOAD DISK RECORD SCAN WRITE DISK END OF FILE RECORD PRINT SYSLST DISK FILES TYPE A FORMS CONTROL PRINT SYSLST DISK FILES TYPE D FORMS CONTROL PRINT DISK FILE IN CHARACTER FORMAT PRINT DISK FILE IN CHARACTER AND HEX FORMAT PRINT VSAM FILE IN CHARACTER FORMAT PRINT VSAM FILE IN CHARACTER AND HEX FORMAT PUNCH VSAM FILE TO 80 BYTE CARD FORMAT TAPE FUNCTIONS TAPE LABEL BROWSE/PRINT TAPE MAPPING- LIST BLOCKS- CHARACTER AND HEX FORMAT. TAPE MAPPING- LIST BLOCKS IN CHARACTER FORMAT. TAPE TO TAPE FILES OR BLOCKS TAPE TO TAPE WITH REBLOCK TAPE COMPARE TAPE TO PRINTER UNBLOCKED IN CHARACTER FORMAT TAPE TO PRINTER DEBLOCKED IN CHARACTER FORMAT TAPE TO PRINTER UNBLOCKED IN CHAR. AND HEX FORMAT TAPE TO PRINTER DEBLOCKED IN CHAR. AND HEX FORMAT TAPE RECORD SCAN TAPE TO CARD BLOCKED OR UNBLOCKED TAPE RECORD LOAD PRINT SYSLST TAPES TYPE A FORMS CONTROL PRINT SYSLST TAPES TYPE D FORMS CONTROL INITIALIZE TAPE WRITE TAPE MARK REWIND TAPE REWIND AND UNLOAD TAPE FORWARD SPACE RECORD BACK SPACE RECORD FORWARD SPACE FILE BACK SPACE FILE CARD FUNCTIONS CARD TO CARD CARD TO PRINTER IN CHARACTER FORMAT CARD TO PRINTER IN CHARACTER AND HEX FORMAT CARD TO TAPE UNBLOCKED CARD TO TAPE REBLOCKED CARD TO SEQUENTIAL DISK FILE CARD TO VSAM FILE CARD TO CARD WITH SEQ. NUMBERS AND DECK NAME CONTROL FUNCTIONS MOVE FORWARD OR BACKWARD WHEN PRINTING DISK/TAPE END OF JOB- ENTER EOJ, END, JUST "E", OR JUST "U" (OR XXX) INVOKES THE HELP FUNCTION. ENTER KEYWORD-OPERAND PARAMETERS FOR LATER USE. DIVERT SYSLST OUTPUT TO SYSLOG SUPPRESS SYSLST OUTPUT SET QUERY THRESHHOLD (CICS ONLY) SET CARD END-OF-FILE VALUE SET FORM WIDTH DISCONTINUE THE CURRENT FUNCTION & ISSUE DRDITTO FUNCTION Dr. Ditto Help Function/Function List Dr. Ditto USERS GUIDE Tape Functions Dr. Ditto provides you with tape functions to: • Copy one or more tape files/blocks with or without reblock, and with data modification, if desired • Position the tape and write tapemarks if needed • Print tape data or print-image records • Punch (Copy) tape card image files • Scan for specified data on the tape • Compare tape files. • Initialize a tape with standard VOL and HDR records • Tape mapping in character and/or character and hexadecimal format. All tape functions expect you as the operator to position the tape before the current function is invoked; a tapemark always is seen as end-of-file and end of current function. Leading tapemarks are bypassed. Tape Error Correction In interactive mode, Dr. Ditto permits processing of input tapes with data check errors, with tape errors initially handled by VSE and if unrecoverable, Dr. Ditto then allows the operator to correct or ignore the error or bypass the tape block. Tape Functions Page 7 Dr. Ditto USERS GUIDE Tape Functions for Batch Mode Only Tape to Card Image This function converts tape blocks to unblocked 80-byte records. If the tape is blocked, it must be a multiple of either 80 or 81. If 81-byte records are found, the first byte is treated as a control byte and is ignored. Control statement format $$DITTO TC INPUT=input Interactive command format TC,input,nnnnn/nnnnnB Where: • TC invokes punching of one tape file. • Input defines the input tape. Print SYSLST Tape This Print SYSLST Tape function prints tapes containing print image data where the first byte of each record is either an ASA forms control character (use TFD function) or the assembler CCW command code byte (use TFA function). If the tape is blocked, the blocks must be a multiple of either 121 or 133. Control statement format $$DITTO TFD/TFA INPUT=input Console command format TFD/TFA input Where input is the logical unit assigned to the tape or its CUU. Page 8 Tape Functions Dr. Ditto USERS GUIDE Tape Functions – Batch and Interactive Tape to Print The Tape to Print function prints a portion or all of a tape file in either character- or character-and-hexadecimal format. The tape may be deblocked into logical records for printing by specifying the logical record length or V for variable blocked records. A block or logical record count may be entered to limit the number of records to print. Control statement format $$DITTO TP/TD INPUT=input(,NBLKS=nlr) Interactive command format TP/TD,input,nlr Where: • TP invokes tape printing in character format, with or without deblocking. • TD invokes tape printing in character and hexadecimal format, with or without deblocking . • Input is the logical unit assigned to the tape (SYSxxx) or the CUU. • NlR specifies the number of blocks or logical records to be printed. • Rsize the logical record length. Tape to Tape The Tape to Tape function allows tape files/blocks to be copied from one tape to another. The number of blocks or files is specified by the operator or the batch control statements. Control statement format $$DITTO TT INPUT=input,OUTPUT=output,NFILES/NBLKS=number Interactive command format TT,input,output,nfiles/nblocks Tape Functions Page 9 Dr. Ditto USERS GUIDE Tape to Tape Reblocked The Tape to Tape Reblocked function copies and reblocks tape files. The logical record size and records/block or (for variable blocked) maximum block size are specified to determine output block size and format. Control statement format $$DITTO TTR INPUT=input,OUTPUT=output,RECSIZE=rsize,BLKFACTOR=blkf Interactive command format TTR,input,output,rsize,blkf Where: • Rsize is the logical record size, or specify V for variable. • Blkf is the maximum block size for variable format or the number of logical records per block. Tape Compare The Tape Compare function compares tape files/blocks tape to tape. The number of blocks or files and unequal compare limit are entered by the operator or by the control statement. The unequal blocks are printed along with the position of the first unequal byte. Control statement format $$DITTO TTC INPUT=input,OUT=input2,NFILES=nnn,NBLKS=nnn,LIMIT=nnn Interactive command format TTC,input,output,nfiles/nblocks,limit Page 10 Tape Functions Dr. Ditto USERS GUIDE Tape Control The following functions allow tape positioning and file termination: • Rewind Tape (REW) • Rewind and Unload Tape (RUN) • Forward Space File (FSF) • Backspace File (BSF) • Forward Space Record (FSR) • Backspace Record (BSR) • Write Tape Mark (WTM) Control statement format $$DITTO $$DITTO $$DITTO $$DITTO $$DITTO $$DITTO $$DITTO WTM REW RUN BSF FSF BSR FSR OUTPUT=output,NFILES=number INPUT=input INPUT=input INPUT=input,NFILES=nfiles INPUT=input,NFILES=nfiles INPUT=input,NBLKS=nblks INPUT=input,NBLKS=nblks Interactive command format WTM,output,number REW,input RUN,input BSF,input,nfiles FSF,input,nfiles BSR,input,nblks FSR,input,nblks Where: Tape Functions • nfiles TC is the number of files to go forward or backward; each tapemark is counted as a file.) • Nblks is the number of tape blocks to go forward or backward. Page 11 Dr. Ditto USERS GUIDE Initialize Tape The Initialize Tape function rewinds the specified tape and then writes standard labels on the tape using the user-supplied tape volser ID. The tape is not opened; you are responsible for insuring that the right tape is used. Control statement format $$DITTO INT OUTPUT=output,VOLSER=volid Interactive command format INT,output,volid Where: • Output defines the output tape. • Volid is the six-byte volser to be written in the volume label. Tape Mapping The Tape Mapping function maps the specified tape, listing the specified number of blocks at the beginning of each physical file, for the number of files specified. The portion of each block listed is specified to limit the amount of printout produced (on SYSLST or screen). Control statement format $$DITTO TMP INPUT=input,NFILES=nfiles,NBLKS=nblks,RECSIZE=recsize Interactive command format TMP,input,nfiles,nblks,recsize Where: Page 12 • Input defines the input tape. • Nfiles specifies the number of physical files to map. • Nblks specifies the number of blocks of each file to list. • Recsize specifies the portion of each block to list. Tape Functions Dr. Ditto USERS GUIDE Tape Record Scan The Tape Record Scan function scans tapes for specified data. You can enter up to 35 bytes of hexadecimal or character data along with either a fixed position in each record or zero to indicate to scan the whole record. You can enter a scan match limit to terminate scanning after the specified number is found. When scanning terminates, the tape will be positioned after the last matching block. Matching records are printed in character and hexadecimal format. Fixed and variable format data is supported. Control statement format $$DITTO TRS INP=i,NFILES=f,NBLKS=b,RECSZ=r,SCANARG=a,SCANPOS=p,SCANHITS=h Interactive command format TRS,input,recsize/U/V,scanarg,scanpos,scanhits Where: Tape Functions • Input defines the input tape • Recsize specifies the logical record length for fixed block records. • V specifies variable format. • U specifies undefined format; each block is treated as a record. • Scanarg specifies the scan data as either one character per byte as c'cccccc' or two hexadecimal digits per byte as x'xxxx'. • Scanpos specifies fixed position in each block for matching data, or zero to scan the whole record. • Scanhits specifies the number of matching records to print before function termination. Page 13 Dr. Ditto USERS GUIDE Tape Functions – Interactive Mode Only Tape Record Load The Tape Record Load function allows tape data to be selectively modified while copying tape to tape. The block to be modified is displayed on screen or on SYSLST. You are asked if the block displayed is to be modified. If the correct block is displayed, you are asked for the modification data. Interactive command format TRL,input,output,nblks,direction Where: • Input defines the input tape. • Output defines the output tape. • Nblks specifies the number of blocks to be copied/skipped. • Direction specifies the number of physical files to map. The remaining parameters must be entered individually as replies to prompting messages. Erase Tape The Erase Tape function erases the contents of a tape. You must position the tape before invoking this function. After writing a tape mark, the tape is erased to the end of the tape. Interactive command format ERT,output Where output defines the output tape. Page 14 Tape Functions Dr. Ditto USERS GUIDE Disk Functions The disk functions allow you to: • Map real/physical disk- display real and virtual/CMS disk locations. • Display/Print disk data from SAM/VSAM files or specified areas. • Scan for a specified string of character or hexadecimal data, or end-of-file. • Alter disk data • Alter the disk volser • Write an end-of-file record. All disk devices supported by VSE are supported. Data on an FBA disk can be displayed on a 512-byte FBA block basis or at the logical record level by specifying the CI size in use. Disk Functions Page 15 Dr. Ditto USERS GUIDE Disk Functions – Batch and Interactive Disk Map Function For CKD disks only, this function scans the specified disk and displays the starting cylinder for each real and virtual disk. Control statement format $$DITTO DMP INPUT=input Interactive command format DMP,input Disk to Printer/Screen The disk-to-printer functions display disk blocks or logical records in character or character and hexadecimal format. If logical record format is desired, add the suffix R to the command (DPR/DDR). Control statement format $$DITTO DP INPUT=input,BEGIN=begin,END=end(,CISIZE=csz)(,RECSIZE=size) $$DITTO DD INPUT=input,BEGIN=begin,END=end(,CISIZE=csz)(,RECSIZE=size) Interactive command format DP/DD,input,begin,end(,cisize)(,recsize) Where: Page 16 • DP(R) prints in character format. • DD(R) prints in character and hexadecimal format. • Input specifies the disk to be input. • Begin specifies the starting disk address. • End specifies the ending disk address. • Rsize is the logical record size; V is for variable; U is for undefined recform. • Csize is for FBA disk only and allows for logical record display. Disk Functions Dr. Ditto USERS GUIDE Sequential Disk File to Printer/Screen The Sequential Disk-to-Printer function displays logical records in character or character and hexadecimal format. The physical blocks in the file are deblocked according to the specified recsize or recform. The starting logical record number is entered by the POSITION keyword while the number of records to list is specified by the NLRECS keyword. Control statement format $$DITTO SPR/SDP FILEIN=input(,NLRECS=nlrecs,POS=nlrecs,RECSIZE=rsize) Interactive command format SPR/SDP,input,U/V/rsize,nlrecs Where: • Input specifies the disk file to be input. • Rsize is the logical record size; V is for variable; U is for undefined recform. VSAM Disk File to Printer/Screen The VSAM-File-to-printer functions display logical records in character or character and hexadecimal format. Records to be printed can be selected by their keys using HIKEY/LOKEY, or by their POSITION in the file. The number printed can also be limited by the NLRECS keyword. Control statement format: $$DITTO VDP FILEIN=input,POS=nlrecs,LOW=lowkey,HIKEY=hikey,NLRECS=nnn $$DITTO VPR FILEIN=input,POS=nlrecs,LOW=lowkey,HIKEY=hikey,NLRECS=nnn Interactive command format VDP,input,nlrecs VPR,input,nlrecs print records in character and hex format. print records in character format. Where: Disk Functions • Input specifies the file to be input. • Nlrecs specifies the maximum number of logical records to list. Page 17 Dr. Ditto USERS GUIDE List Print Image Disk File The List Print Image Disk File function prints files containing print image data where the first byte of each record is either an ASA forms control character (use SFD function) or the assembler CCW command code byte (use SFA function). If the file is blocked, the blocks must be a multiple of either 121 or 133. Control statement format $$DITTO SFD/SFA FILEIN=filein Console command format: SFD/SFA filein Where: Filein is the DTF/DDNAME of the input disk file. Page 18 Disk Functions Dr. Ditto USERS GUIDE Disk Record Scan This Disk Record Scan function scans disks for specified data. You can enter up to 35 bytes of hexadecimal or character data along with either a fixed position in each record or zero to indicate to scan the whole record. Enter a scan match limit to terminate scanning after the specified number is found. Matching records are printed in character and hexadecimal format. For a CKD disk, the physical key of each disk block can be scanned, if desired. Variable, fixed, or undefined record format is supported. Control statement format $$DITTO DRS INPUT=i,SCANPOS=p,SCANARG=a,SCANTYPE=t,SCANHITS=h Interactive command format DRS,input,begin,end,type,recsize/u/v/cisize,scanarg,pos,limit Where: Disk Functions • Input specifies the input disk. • Begin is the disk extent begin. • End is the disk extent end. • Type: • E is the scan for end of file. • K is the scan CKD physical block key. • D is the scan data. • Recsize/.. specifies the logical record size; V for variable blocked; U is for undefined; cisize for FBA disk. • Scanarg specifies the scan data as either one character per byte as c'cccccc' or two hexadecimal digits per byte as x'xxxx'. • Pos is the position in each record to scan (zero to scan whole record). • Limit is the maximum number of matching records allowed. Page 19 Dr. Ditto USERS GUIDE Disk Functions – Interactive Mode Disk Record Load The Disk Record Load alters the data within a disk record or its key (but not its length. The disk record displays for verification before being altered. The alteration data is entered in either character or hexadecimal format. After each change the user is asked if changes are complete. If changes are complete, the record is displayed and then written back to the disk. Command format DRL,output,addr,position,bytes,h/c,data Where: • Output is the disk device. • Addr is the disk record address as ccccchhRn for CKD disk or bbbbbbb for FBA disk. • Position is the starting position in key/record, relative to one. • Bytes is the length of the change data. • H/C determines whether hexadecimal or character. H is for hexadecimal; C is for character. • Data is the scan data as either one character per byte or two hexadecimal digits per byte. Write EOF Record This Write EOF Record function writes end-of-file at the specified disk address. Interactive command format EOF,output,addr(,cisize) Where: Page 20 • Output specifies the disk to be used. • Addr is the disk record address as either ccccchhRr or BBBBBBB. • Cisize is the CI size for FBA disks Disk Functions Dr. Ditto USERS GUIDE Alter Disk ID (VOLSER) This Alter Disk ID (VOLSER) function allows the VOLSER (disk ID) of a disk to be changed. Interactive command format DID,output,volid Where: Disk Functions • Output specifies the output disk. • Volid is the new disk volser. Page 21 Dr. Ditto USERS GUIDE Card Functions The card functions include functions to: • Copy card image data card to card • List card image data • Copy card image data to tape • Copy card image data to a SAM file. The input card image data is input from SYSIPT and may be terminated by a blank card or a designated end-of-card indicator such as '/*', specified by the EOC= keyword. The card to card function copies card images to the device assigned to SYSPCH, while the card to tape function writes to the tape device specified. All card functions may be invoked in batch and console operation, but not in CICS mode. Copy Card Image to Card Image Control statement format $$DITTO CC (EOC=XX) Console command format CC Card Image to Printer The Card Image to Printer function lists card images in character (CP) or character and hexadecimal format (CH). Control statement format $$DITTO CP (EOC=XX) $$DITTO CH (EOC=XX) Console command format: CP CH Page 22 invokes printing in character format. invokes printing in character and hex format. Card Functions Dr. Ditto USERS GUIDE Card Image to Tape This Card Image to Tape function copies card image data to tape with reblocking if desired. The tape must be positioned prior to copying and a tape mark is written after the last tape block. Control statement format $$DITTO CT OUTPUT=output,BLKFACTOR=blkf Console command format CT,output,blkf Where: • Output specifies the output tape. • Blkf is the number of card images per tape block. Card Image to Sequential Disk File This Card Image to Sequential Disk File function copies card image data to disk file with reblocking, if desired. Control statement format $$DITTO CSQ FILEOUT=output,BLKFACTOR=blkf Console command format CSQ,output,blkf Where: Card Functions • Output defines the output disk file. • Blkf is the number of card images per tape block. Page 23 Dr. Ditto USERS GUIDE Dr. Ditto Keywords and Operands ASCII=xxxxxxx This keyword specifies ASCII tape format. It is used to specify ASCII tape processing. The assumed value NO specifies that neither input nor output tape is in ASCII format. If YES or INPUT is specified, tapes being read are converted from ASCII to EBCDIC before display or copying. If OUTPUT is specified, tape blocks are converted to ASCII before being written. Specifying BOTH is equivalent to entering INPUT and OUTPUT. BEGIN=xxxxxxx This keyword specifies a starting disk address as cylinder and head; cylinder, head and record; relative track; relative track and record; or FBA physical block number (PBN). Leading zeros are not required for the cylinder or FBA PBN. The head number must always be a two digit number. Relative track is indicated by prefixing the track number with R. If the record number is specified, it must be prefixed with R and added to the right of the relative track or cylinder-head. BLKFACTOR=xxxxxx This keyword sets the number of records per block for the current function. This keyword is used to specify the number of logical records to be output in each physical block. Use in conjunction with the RECSIZE keyword. CISIZE=xxxxx This keyword specifies the CISIZE for FBA extents. If zero, a non-CI format is assumed. This keyword allows the CISIZE to be specified for FBA disk to allow logical record processing. DATAHEADER=xxx This keyword allows suppression of the scale/ruler/dataheader. If DAT=N is specified, the data header is suppressed, thereby reducing the printed output. END=xxxxxxx This keyword specifies an ending disk address as cylinder and head; cylinder, head and record; for relative track the number of tracks; or FBA physical block number (PBN). Leading zeros are not required for the cylinder or FBA PBN. The head number must always be a two digit number. EOC/EOD=xx This keyword allows the end of cards indicator to be varied. A blank card is assumed to be the end of card. Example: EOC=/* to use the usual VSE EOC indicator. FILEIN=xxxxxx This keyword specifies the DLBL name of the input file. It allows the 1- to 7-character DLBL name to be entered so that the file can be opened for input processing. FILEOUT=xxxxxx This keyword specifies the DLBL name of the output file. It allows the 1- to 7-character DLBL name to be entered so that the file can be opened for output processing. Page 24 Dr. Ditto Keywords and Operands Dr. Ditto USERS GUIDE HEADERPG=xxxxxxx This keyword suppresses page headings on printed output. HIKEY=xxxxxx For VSAM KSDS files, this keyword specifies the ending key. It allows VSAM KSDS records to be selected by key or key range. Use in conjunction with LOWKEY/ NLRECS. If the key contains spaces, enclose it in quotes ('). If you wish to enter it in hexadecimal enter it as x'........'. INPUT=xxxxxx This keyword specifies the Disk, or Tape device to be input. The CUU, SYSXXX, or disk volser is specified to define the input device. If a six-character field is entered, it is first checked to see if it is a disk volser. If it is not a disk volser, and begins with SYS, then the device assigned to that SYSXXX is used. If the entry begins with V, then the next characters are assumed to be a disk volser. LIMIT=nnnnnn This keyword is used to limit the number of match/no match occurrences. LOWKEY=XXXXXXXXX For VSAM KSDS files, specifies the starting key. Allows VSAM KSDS records to be selected by KEY or KEY RANGE. Use in conjunction with HIKEY/NLRECS. If the key contains spaces, enclose it in quotes ('). If you wish to enter it in hexadecimal format, enter it as x'........'. NBLKS=nnnnnn This keyword specifies the number of blocks to be processed by the current function. It allows the number of physical tape or disk blocks to be limited to a desired number. NFILES=nnnnn This keyword specifies the number of files to be processed by the current function. It allows the number of tape files to be limited to a desired number. NLRECS=nnnn This keyword specifies number of logical records for reblocking functions. It allows the number of logical records to be limited to a desired number. NTMKS=nnnn This keyword specifies the number of tapemarks to be written. It allows the number of tapemarks to be written on a tape to be specified. OUTPUT=xxxxxx This keyword specifies the CUU, SYSxxx, or a disk volser of the device to be used as output or second input for the current operation. PASSWORD=xxxxxx This keyword specifies password for accessing VSAM files. Dr. Ditto Keywords and Operands Page 25 Dr. Ditto USERS GUIDE POSITION=xxx This keyword specifies number of blocks/records to be skipped. The specified number of blocks or logical records is skipped before printing begins. PRINTLEN=xxx This keyword specifies the width of the print output. It allows the print width to be varied between 25 and 132 print positions. This is useful in fitting the print output to a particular screen or form size. RECSIZE=xxxxxx This keyword specifies the logical record size for (de)blocking. For deblocking tape or disk blocks, or for blocking output blocks, specifies the logical record size. SCANARG=c/x'cccccc' This keyword specifies the scan argument for the TRS or DRS function, entered as either x'xxxxxx' or c'ccccccc'. Up to 35 bytes may be scanned. SCANHITS=n This keyword specifies the number of matching records to print before function termination. SCANPOS=n This keyword specifies the position in each record to compare the scanarg. Zero indicates to scan the whole record. SCANTYP=D/K/E For disk scanning, this keyword specifies whether to scan the data or key, or for the first end-of-file record. TYPE=xxxxxx Used with TLB Function to limit output. If SHORT is entered, then only the VOL and HDR tape records are listed. Otherwise the VOL, HDR, and TRAILER records are listed. UPSI=xxxxxxxx JCL statement modifies batch operation, as follows: • The first UPSI (1xxxxxxx) indicates control card operation. • The second UPSI (x1xxxxxx) suppresses the page heading. • The third UPSI (xx1xxxxx) suppresses the total lines. • The fourth UPSI (xxx1xxxx) suppresses the printing of control cards. • The fifth UPSI (xxxx1xxx) suppresses the SCALE (same as DATAHEADER=NO). VOLSER=xxxxxx This keyword specifies the VOLSER for tape initialization or disk VOLSER alteration. (Function INT or DID). Page 26 Dr. Ditto Keywords and Operands Dr. Ditto USERS GUIDE Dr. Ditto Messages DRDITTO001 COLUMNS 1-7 OF CONTROL CARD NOT $$DITTO Explanation: Running in batch mode, a control card was read that does not have $$DITTO in columns 1-7. This may be due to failure to specify the proper end of data indicator (EOD=) or the lack of an EOD. Action: Correct the control card; use the EOC/EOD keyword to specify the correct end of card. DRDITTO002 UNRECOGNIZED KEYWORD Explanation: A keyword entered is either misspelled or not in the set allowed by Dr. Ditto. Action: Correct the keyword. DRDITTO003 NUMERIC FIELD NON-NUMERIC Explanation: An entered value is expected to be numeric but the value entered is not fully numeric. Action: Correct the value. DRDITTO004 INVALID DISK ADDRESS Explanation: The disk address entered is invalid for the device specified. If a CKD device is in use, the head number may exceed the maximum, the cylinder may exceed the limit for the real or virtual disk, or the record number may exceed 255. If a FBA disk is in use, the physical block number is non-numeric or exceeds the limit for the real or virtual disk. Action: Correct the value. DRDITTO005 INVALID DEVICE ADDRESS Explanation: The device specified by the CUU, SYSxxx, or (for disk) by the VOLSER entered is a non-existent device, the SYSxxx is not assigned, or the device is not the right type for the operation specified. Action: Correct the control card. DRDITTO006 NUMBER OF BLOCKS NON-NUMERIC OR ZERO Explanation: The number of blocks or logical records entered is invalid. Action: Correct the control card. DRDITTO007 INVALID DECK TYPE Explanation: Deck type must be 'BAL', 'COB', or 'RPG' Action: Correct the control card. DRDITTO008 INVALID BLOCKING FACTOR Explanation: The Blocking factor entered is non-numeric, zero, or in combination with the logical record size, results in an invalid physical block size. Action: Correct the control card. DRDITTO009 INVALID RECORD SIZE Explanation: The entered record size is non-numeric, zero, or exceeds maximum. Action: Correct the control card. DRDITTO010 INVALID FORM WIDTH Explanation: Specified width is not in range of 25-132, the value 'N' (80 column), or the value 'W' (132 column). Action: Correct the control card. DRDITTO011 INTERACTIVE FUNCTI0N NOT ALLOWED IN BATCH Explanation: The specified function is only allowed in interactive mode. Action: Reissue command in interactive mode. DRDITTO012 UNABLE TO OBTAIN STORAGE FOR BUFFERS Explanation: Memory is not available for allocation of input/output buffers. Dr. Ditto Messages Page 27 Dr. Ditto USERS GUIDE Action: If running in batch mode, add SIZE=AUTO to the EXEC DRDITTO or run in a larger partition. DRDITTO013 INVALID BLOCKING FACTOR OR MAXIMUM BLOCK SIZE. Explanation: The entered or computed blocksize exceeds the allowable maximum. If no deblocking, specify U (undefined) or V (Variable) blocked. Action: Correct the control card. DRDITTO014 DATA FORMAT INVALID FOR SPECIFIED REBLOCK Explanation: Tape reblock is specified, but the data is not in the required format. If 'V' was specified, the data is not in variable format. If fixed format was specified, the input block is not an even multiple of the logical record length. Action: Correct the control card. DRDITTO015 INVALID LIMIT Explanation: The record limit or scan match limit entered is zero or non-numeric. Action: Correct the control card. DRDITTO016 INVALID NFILES/NBLKS ENTERED Explanation: The value entered is zero or non-numeric. Action: Correct and rerun the job. DRDITTO017 FUNCTION NOT SUPPORTED FOR FBA DISK Explanation: A function not yet supported on FBA disk has been requested. Action: Function is canceled. DRDITTO018 VOLSER NOT ENTERED FOR TAPE INITIALIZATION Explanation: Tape initialization is requested, but the VOLSER to be written in the VOL1 was not entered. Action: Correct the control card. DRDITTO019 FILE DLBL NAME NOT ENTERED Explanation: A file-oriented function is invoked, but no file DLBL name was entered. Action: Correct the control card. DRDITTO020 POSITION PARAMEETER INVALID Explanation: The entered block/record skip count is either zero or non-numeric. Action: Correct the control card. DRDITTO021 BLOCK PRINT SIZE LIMIT INVALID Explanation: The size specified is either zero, non-numeric, or exceeds the maximum. Action: Correct the control card. DRDITTO022 VSAM FILE OPEN ERROR NNN, RETURN CODE IS NNN Explanation: The VSAM file specified cannot be opened due to the error and return code specified. Refer to VSAM messages and codes for an explanation of the codes. Action: The function is canceled. DRDITTO023 VSAM FILE GET/PUT ERROR nnn, RETURN CODE FROM GET/PUT IS mmm Explanation: While reading or writing a VSAM file, a GET/PUT error has occurred. Refer to VSAM messages and codes (keyword VSAMREQU for VSE/Explain facility) for an explanation of the codes. Action: Page 28 nnn is the VSAM return code mmm is the GET/PUT error code The function is canceled. Dr. Ditto Messages Dr. Ditto USERS GUIDE DRDITTO024 PRINT FILE NOT PRINT IMAGE FORMAT Explanation: The tape or disk file being printed by the TFA/TFD or SFA/SFD function is not in required format. Either the blocksize is not a multiple of 133 or 121 or the first byte of each 121/133 print image record is not a proper forms control character. Action: The function is canceled DRDITTO025 PRODUCT AUTHORIZATION HAS EXPIRED Explanation: Dr. Ditto is protected with an Expiration Password. This message is displayed if that Password has expired. Action: Contact your BIM product sales representative for a new Expiration Password. DRDITTO026 WARNING - PRODUCT AUTHORIZATION EXPIRES IN 30 DAYS OR LESS Explanation: This message is displayed if the copy of Dr. Ditto you are using is about to expire. Action: Contact your BIM product sales representative for a new Expiration Password. DRDITTO027 TAPE NOT CARD IMAGE FORMAT Explanation: The tape being processed has blocks that are not a multiple of either 80 or 81. Possibly the wrong tape is in use or is not positioned correctly. Action: The function is canceled DRDITTO028 FUNCTION INVALID OR NOT SUPPORTED Explanation: An invalid or unsupported function has been entered. Backup/Restore/Copy functions provided in utilities such as Dr. D, FASTCOPY, and REPRO are not provided in Dr. Ditto. Action: The function is canceled DRDITTO029 CANNOT OPEN SPECIFIED FILE Explanation: The DTF/DLBL name entered cannot be opened for one of several reasons: 1) No DLBL/EXTENT is provided for the name entered. 2) The file does not exist as the FILE-ID in the DLBL. 3) The "SYS" number in the extent statement(s) is not assigned to the correct disk. 4) The file type does not match the DLBL file type. Action: The function is canceled DRDITTO030 INVALID ASCII= PARAMETER ENTERED Explanation: The entered parameter was not Y (YES), N (NO), I (INPUT), O (OUTPUT), or B (BOTH). Action: Correct the control card. DRDITTO031 INVALID SCAN ARGUMENT ENTERED Explanation: The entered scan argument is invalid because it is not properly defined as character or hexadecimal format, exceeds 35 bytes in length, or is not an even number of hexadecimal digits. Action: Correct the control card. DRDITTO032 INVALID SCAN TYPE ENTERED Explanation: The entered scan type is not E (EOF), K (KEY), or D (DATA). Action: Correct the control card. Dr. Ditto Messages Page 29 Dr. Ditto USERS GUIDE Index Batch and CICS Interactive Operation, 2 Batch Operation, 2 Card Functions, 23–24 Card Image to Printer, 23 Console command format:, 23 Control statement format, 23 Card Image to Sequential Disk File, 24 Console command format, 24 Control statement format, 24 Card Image to Tape, 24 Console command format, 24 Control statement format, 24 Copy Card Image to Card Image, 23 Console command format, 23 Control statement format, 23 Device Addresses, 3 Disk Addresses, 3 Disk Functions, 15–22 Alter Disk ID (VOLSER), 22 Interactive command format, 22 Disk Map Function, 16 Control statement format, 16 Interactive command format, 16 Disk Record Load, 21 Command format, 21 Disk Record Scan, 20 Control statement format, 20 Interactive command format, 20 Disk to Printer/Screen, 16 Control statement format, 16 Interactive command format, 16 List Print Image Disk File, 19 Console command format, 19 Control statement format, 19 Sequential Disk File to Printer/Screen, 17 Control statement format, 17 Interactive command format, 17 VSAM Disk File to Printer/Screen, 17 Control statement format, 17 Interactive command format, 17 Write EOF Record, 21 Interactive command format, 21 Disk Functions, Batch and Interactive, 16–20 Disk Functions, Interactive Mode, 21–22 Ending Dr. Ditto, 4 Function List, 6 Help Function, 5 Interactive Operation, 2 Interrupting Dr. Ditto Functions, 4 Keywords and Operands, 25–27 Page 30 ASCII=, 25 BEGIN, 25 BLKFACTOR, 25 CISIZE, 25 DATAHEADER, 25 END, 25 EOC/EOD, 25 FILEIN, 25 FILEOUT, 25 HEADERPG, 26 HIKEY, 26 INPUT, 26 LIMIT, 26 LOWKEY, 26 NBLKS, 26 NFILES, 26 NLRECS, 26 NTMKS, 26 OUTPUT, 26 PASSWORD, 26 POSITION, 27 PRINTLEN, 27 RECSIZE, 27 SCANARG, 27 SCANHITS, 27 SCANPOS, 27 SCANTYP, 27 TYPE, 27 UPSI, 27 VOLSER, 27 Messages, 30 Method of Operation, 4 Parameter Specification, 3 Printer Output, 4 Tape Error Correction, 7 Tape Functions Erase Tape, 14 Interactive command format, 14 Initialize Tape, 12 Control statement format, 12 Print SYSLST Tape, 8 Console command format, 8 Control statement format, 8 Tape Compare, 10 Control statement format, 10 Interactive command format, 10 Tape Control, 11 Control statement format, 11 Interactive command format, 11, 12 Tape Mapping, 12 Index Dr. Ditto Control statement format, 12 Interactive command format, 12 Tape Record Load, 14 Interactive command format, 14 Tape Record Scan, 13 Control statement format, 13 Interactive command format, 13 Tape to Card Image, 8 Control statement format, 8 Interactive command format, 8 Tape to Print, 9 Control statement format, 9 Index USERS GUIDE Interactive command format, 9 Tape to Tape, 9 Control statement format, 9 Interactive command format, 9 Tape to Tape Reblocked, 10 Control statement format, 10 Interactive command format, 10 Tape Functions, 7–14 Tape Functions, Batch and Interactive Mode, 9– 13 Tape Functions, Batch Mode Only, 8 Tape Functions, Interactive Mode Only, 14 Page 31