BIM-Dr · BIM-Dr.DITTO USERS GUIDE INTRODUCTION The Dr. Ditto utility system provides basic functions needed in all mainframe computer systems: TAPE FUNCTIONS • Tape files or portions

(COPYRIGHT © 2000 B I MOYLE ASSOCIATES, INC.)

BIM-Dr.DITTO is a proprietary product of B I Moyle Associates, Inc. It cannot be reproduced, changed, copied, or stored in any form (including, but not limited to, copies on magnetic media) without the express prior written permission of B I Moyle Associates, Inc.

BIM-Dr.DITTO

DISK UTILITY SYSTEM

USERS GUIDE

Release 6.7

This documentation applies to Release 6.7 of the program product BIM-

Original Printing .......................02/15/2000

Dr.DITTO. Last Revised ...............................02/15/2000

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 DRDITTO FUNCTIONS....................................................................................4 ENDING DRDITTO....................................................................................................................4

DRDITTO HELP FUNCTION / FUNCTION LIST .............................................................................5 DRDITTO HELP FUNCTION ......................................................................................................5 DRDITTO 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

DRDITTO KEYWORDS AND OPERANDS ....................................................................................24

DRDITTO MESSAGES .................................................................................................................27

BIM-Dr.DITTO USERS GUIDE

INTRODUCTION

The Dr. Ditto utility system provides basic functions needed in all mainframe computer systems:

TAPE FUNCTIONS

• Tape files or portions of tape files can be copied with or without reblock, scanned, mapped, listed, altered and compared.

• Tape data can be converted to card image format.

• Tapes can be intialized with standard VOL and HDR records.

DISK FUNCTIONS

• Disk data can be printed, scanned, and altered.

• Disk VOL ID can be altered.

• CKD disk can be 'mapped' showing the location and ID of the real and virtual disks on each real disk.

CARD IMAGE FUNCTIONS

• Card images can be duplicated or copied to tape.

• Card images can be listed in character, or character and hex format.

• Card images can be copied to sequential disk file.

INTRODUCTION Page 1


METHOD OF OPERATION

DRDITTO operates in three modes: batch, batch interactive, and CICS interactive:

Batch mode control statements and data from the SYSIPT device are processed without operator interaction.

Batch interactive mode free form commands or command strings are entered to partition prompts by the operator. SYSLST and SYSPCH output are produced if desired.

CICS interactive mode free form commands or command strings are entered to screen prompts by the operator. All print output is directed to the screen. Functions using either card input from SYSIPT or output to SYSPCH are not allowed.

INTERACTIVE OPERATION

Two interactive modes are provided: batch and CICS. In batch mode, commands are entered via normal interaction with the operator console. Under CICS, after initiation by the DRZAP transaction, commands are entered in the same format as batch, but all printed output is directed to the CICS terminal screen. In batch the DRDITTO '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 DRDITTO in non-interactive batch mode, submit a job stream that includes the VSE JCL statement // UPSI 1, the // EXEC DRDITTO and the necessary $$DITTO control statements, read by DRDITTO 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. Multiple commands can be entered in each execution of DRDITTO.

Each DRDITTO 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) then DRDITTO will prompt 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 DRDITTO phases are re-entrant and so may be placed in the SVA to lessen storage

Page 2 METHOD OF OPERATION


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 entering an 'R' to 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, parameters are entered as positional parameters entered either as responses to DRDITTO prompts or as strings of commands and parameters separated by commas. If string commands are used and errors are detected, the string is discarded and prompting mode is initiated.

Strings may contain multiple commands and their parameters, and the whole string may be repeated by entering 'R' to the next DRDITTO FUNCTION? prompt. Before using string commands, you may want to use prompting mode to gain familiarity with the commands and parameters.

DEVICE ADDRESSES

If a device address is required for a tape device, it may be entered as CUU/CUUMM or as a SYSnnn (programmer logical unit) that is assigned to the tape device prior to execution of DRDITTO.

If a device address is required for a disk device, it may be entered as CUU or as a SYSnnn (programmer logical unit) that is assigned to the disk device prior to execution of DRDITTO. If a six character field is entered it is first checked to see if it is the VOLSER of a disk, and if it is, that disk's CUU is used to access the disk.

DISK ADDRESSES

Most disk functions require that the user specify the area of the disk to be accessed for input or output. In control card batch mode, the keywords 'BEGIN' and 'END' are used for this purpose. In interactive mode prompting is used to request these parameters, or they are entered as positional data in command strings. In any case, the address has a format depending on whether the disk is CKD or FBA. For FBA disk, it is entered as a physical block number (PBN). For CKD disk, it is entered 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-6 digit number, and the head number is always two digits. If the CKD record number is used, an 'R' must follow the head with the record number suffixed to the 'R' (cccccchhRrrr). Cylinder 222 head 15 record 3 would, for example, be 22215R3. If relative track addressing is used, the 'END' address is assumed to be the number of tracks.

The UPSI JCL statement modifies batch operation. The first UPSI (1xxxxxxx) indicates control card operation. The second UPSI (x1xxxxxx) supresses the page heading. The third UPSI (xx1xxxxx) supresses the total lines. The fourth UPSI (xxx1xxxx) supresses the printing of control cards. The fifth UPSI (xxxx1xxx) supresses the "SCALE" (same as DATAHEADER=NO).

METHOD OF OPERATION Page 3


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 user's terminal, and no printer output is possible. In batch and batch interactive mode, print output is directed to the device assigned to SYSLST, unless the user enters the 'LOG' command, directing all print output to the operator terminal.

If print output is displayed on CICS or operator screen, the display will pause at appropriate times to allow viewing, or browsing commands. If you wish to discontinue the current operation, enter 'QUIT' or just 'Q'. If you wish to skip to the next record, enter 'F' or 'Fn' to go forward 'n' records. If you wish to go backward, enter 'B' or 'Bn' to go back 'n' records ('n' is a 1-5 digit number).

INTERRUPTING DRDITTO FUNCTIONS

To interrupt batch execution, enter the attention routine command 'MSG pi' where 'pi' is the partition identifier. Under batch or CICS, enter 'QUIT' or just 'Q' at any point that a response is allowed by DRDITTO. In CICS mode, a 'query threshold' is established so that DRDITTO will pause periodically to allow the operation to be terminated if desired. This threshold can be modified through use of the 'QST' command.

ENDING DRDITTO

In interactive mode, enter 'EOJ' or 'END' or just 'E' to the DRDITTO FUNCTION ? prompt.

In batch mode, the last control statement should be $$DITTO EOJ, but end of job is assumed if the JCL '/*' is read instead of an expected $$DITTO control card.

Page 4 METHOD OF OPERATION


DRDITTO HELP FUNCTION / FUNCTION LIST

DRDITTO HELP FUNCTION

The DRDITTO 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. It is invoked by issuing the HELP (or XXX) command, and a parameter specifying the information desired. If ALL (or A) is entered, a list of all commands, keywords, and messages is displayed. If DISK commands are desired, enter "D". If tape commands are desired, enter "T". If control commands are needed, enter "z". If keywords are to be listed, enter "K". If messages are wanted, enter "M". If a full description of an item is needed, enter "HELP,xxxx" where "xxxx" is the item desired. The whole item is not required, only enough to uniquely identify it. For messages, enter a 1-3 digit message number.

DRDITTO HELP FUNCTION / FUNCTION LIST Page 5


DRDITTO FUNCTION LIST

DRDITTO functions are organized around the type of device to be used as input for each:

DISK FUNCTIONS DMP DISK MAP- LIST REAL, CMS AND OTHER MINI DISKS. DD DISK TO PRINTER IN CHAR. AND HEX FORMAT UNBLOCKED DP DISK TO PRINTER IN CHAR. FORMAT UNBLOCKED DDR/DDD DISK TO PRINTER IN CHAR. AND HEX FORMAT DEBLOCKED DID ALTER DISK IDENTIFICATION VOLUME NUMBER DRL DISK RECORD LOAD DRS DISK RECORD SCAN EOF WRITE DISK END OF FILE RECORD SFA PRINT SYSLST DISK FILES TYPE A FORMS CONTROL SFD PRINT SYSLST DISK FILES TYPE D FORMS CONTROL SPR PRINT DISK FILE IN CHARACTER FORMAT SDP PRINT DISK FILE IN CHARACTER AND HEX FORMAT VPR PRINT VSAM FILE IN CHARACTER FORMAT VDP PRINT VSAM FILE IN CHARACTER AND HEX FORMAT VC PUNCH VSAM FILE TO 80 BYTE CARD FORMAT

TAPE FUNCTIONS TLB TAPE LABEL BROWSE/PRINT TMP TAPE MAPPING- LIST BLOCKS- CHARACTER AND HEX FORMAT. TMC TAPE MAPPING- LIST BLOCKS IN CHARACTER FORMAT. TT TAPE TO TAPE FILES OR BLOCKS TTR TAPE TO TAPE WITH REBLOCK TTC TAPE COMPARE TP TAPE TO PRINTER UNBLOCKED IN CHARACTER FORMAT TPR/TPD TAPE TO PRINTER DEBLOCKED IN CHARACTER FORMAT TD TAPE TO PRINTER UNBLOCKED IN CHAR. AND HEX FORMAT TDR/TDD TAPE TO PRINTER DEBLOCKED IN CHAR. AND HEX FORMAT TRS TAPE RECORD SCAN TC TAPE TO CARD BLOCKED OR UNBLOCKED TRL TAPE RECORD LOAD TFA PRINT SYSLST TAPES TYPE A FORMS CONTROL TFD PRINT SYSLST TAPES TYPE D FORMS CONTROL INT INITIALIZE TAPE WTM WRITE TAPE MARK REW REWIND TAPE RUN REWIND AND UNLOAD TAPE FSR FORWARD SPACE RECORD BSR BACK SPACE RECORD FSF FORWARD SPACE FILE BSF BACK SPACE FILE

CARD FUNCTIONS CC CARD TO CARD CP CARD TO PRINTER IN CHARACTER FORMAT CH / CD CARD TO PRINTER IN CHARACTER AND HEX FORMAT CT CARD TO TAPE UNBLOCKED CTR CARD TO TAPE REBLOCKED CSQ CARD TO SEQUENTIAL DISK FILE CVS CARD TO VSAM FILE CCS CARD TO CARD WITH SEQ. NUMBERS AND DECK NAME

CONTROL FUNCTIONS BROWSE MOVE FORWARD OR BACKWARD WHEN PRINTING DISK/TAPE EOJ/END END OF JOB- ENTER EOJ, END, JUST "E", OR JUST "U" HELP (OR XXX) INVOKES THE HELP FUNCTION. KEY ENTER KEYWORD-OPERAND PARAMETERS FOR LATER USE. LOG DIVERT SYSLST OUTPUT TO SYSLOG NOP SUPPRESS SYSLST OUTPUT QST SET QUERY THRESHHOLD (CICS ONLY) SCE SET CARD END-OF-FILE VALUE SET SET FORM WIDTH Q/QUIT DISCONTINUE THE CURRENT FUNCTION & ISSUE DRDITTO FUNCTION

Page 6 DRDITTO HELP FUNCTION / FUNCTION LIST


TAPE FUNCTIONS

Included are 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 tape with standard VOL and HDR records.

• Tape mapping in character and or character and hex format.

All tape functions expect the user/operator to position the tape before the current function is invoked, and a tapemark always is seen as end-of-file and end of current function. Leading tapemarks are bypassed.

TAPE ERROR CORRECTION

In interactive mode, DRDITTO permits processing of input tapes with data check errors, with tape errors initially handled by VSE and if unrecoverable, DRDITTO then allows the operator to correct or ignore the error or bypass the tape block.

TAPE FUNCTIONS Page 7


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 function allows the printing of 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.


$$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


TAPE FUNCTIONS - BATCH and INTERACTIVE

TAPE TO PRINT

This function prints portions or all of a tape file in either character or character and hex format. 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.


$$DITTO TP/TD INPUT=input(,NBLKS=nlr)


TP/TD,input,nlr

Where: TP invokes tape printing in character format, with or without deblocking.

TD invokes tape printing in character and hex 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 is the logical record length.

TAPE TO TAPE

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.


$$DITTO TT INPUT=input,OUTPUT=output,NFILES/NBLKS=number


TT,input,output,nfiles/nblocks



TAPE TO TAPE REBLOCKED

Allows tape files to be copied and reblocked. The logical record size and records/block or (for variable blocked) maximum block size are specified to determine output block size and format.


$$DITTO TTR INPUT=input,OUTPUT=output,RECSIZE=rsize,BLKFACTOR=blkf


TTR,input,output,rsize,blkf

Where: rsize 'V' for variable or the logical record size.

Blkf the maximum block size for variable format or the number of logical records per block.

TAPE COMPARE

Allows tape files/blocks to be compared 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.


$$DITTO TTC INPUT=input,OUT=input2,NFILES=nnn,NBLKS=nnn,LIMIT=nnn


TTC,input,output,nfiles/nblocks,limit



TAPE CONTROL

These functions allow tape positioning and file termination:

REW Rewind Tape

RUN Rewind and Unload Tape

FSF Forward Space File

BSF Backspace File

FSR Forward Space Record

BSR Backspace Record

WTM Write Tape Mark


$$DITTO WTM OUTPUT=output,NFILES=number $$DITTO REW INPUT=input $$DITTO RUN INPUT=input $$DITTO BSF INPUT=input,NFILES=nfiles $$DITTO FSF INPUT=input,NFILES=nfiles $$DITTO BSR INPUT=input,NBLKS=nblks $$DITTO FSR INPUT=input,NBLKS=nblks


WTM,output,number REW,input RUN,input BSF,input,nfiles FSF,input,nfiles BSR,input,nblks FSR,input,nblks

Where: nfiles the number of files to go forward or backward (each tapemark is counted as a file).

Nblks the number of tape blocks to go forward or backward.



INITIALIZE TAPE

The tape specified is rewound and then standard labels are written on the tape using the user supplied tape volser (id). The tape is not opened- the user is responsible for insuring that the right tape is used.


$$DITTO INT OUTPUT=output,VOLSER=volid


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 specified is mapped, 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).


$$DITTO TMP INPUT=input,NFILES=nfiles,NBLKS=nblks,RECSIZE=recsize


TMP,input,nfiles,nblks,recsize

Where: 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 RECORD SCAN

Allows tapes to be scanned for specified data. Up to 35 bytes of hex or character data can be entered along with either a fixed position in each record or zero to indicate to scan the whole record. A scan match limit is entered to terminate scanning after the specified number are found. When scanning terminates, the tape will be positioned after the last matching block. Matching records are printed in character and hex format. Fixed and variable format data is supported.


$$DITTO TRS INP=i,NFILES=f,NBLKS=b,RECSZ=r,SCANARG=a,SCANPOS=p,SCANHITS=h


TRS,input,recsize/U/V,scanarg,scanpos,scanhits


Recsize for fixed blocked records specifies logical record length.

V specifies variable format.

U specifies undefined format (each block is treated as a record).

Scanarg the scan data as either one character per byte as c'cccccc' or two hex digits per byte as x'xxxx'.

Scanpos fixed position in each block for matching data, or zero to scan the whole record.

Scanhits number of matching records to print before function termination.



TAPE FUNCTIONS - INTERACTIVE MODE ONLY

TAPE RECORD LOAD

Allows tape data to be selectively modified while copying tape to tape. The block to be modified is displayed on screen or SYSLST and the user is asked if the block displayed is to be modified. If the correct block is displayed, then the user is asked for the modification data.


TRL,input,output,nblks,direction


Output defines the output tape.

Nblks is the number of blocks to be copied/skipped.

Direction specifies whether to copy forward or backward (F/B).

The remaining parameters must be entered individually as replies to prompting messages.

ERASE TAPE

The user must position the tape before invoking this function. After writing a tape mark, the tape is erased to the end of the tape.


ERT,output




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 hex 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 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


DISK FUNCTIONS - BATCH AND INTERACTIVE

DISK MAP FUNCTION

For CKD disk only, this function scans the specified disk and displays the starting cylinder for each real and virtual disk.


$$DITTO DMP INPUT=input


DMP,input

DISK TO PRINTER/SCREEN

The disk-to-printer functions allow you to display disk blocks or logical records in character or character and hex format. If logical record format is desired, add the suffix 'R' to the command (DPR/DDR).


$$DITTO DP INPUT=input,BEGIN=begin,END=end(,CISIZE=csz)(,RECSIZE=size) $$DITTO DD INPUT=input,BEGIN=begin,END=end(,CISIZE=csz)(,RECSIZE=size)


DP/DD,input,begin,end(,cisize)(,recsize)

Where DP(R) prints in character format.

DD(R prints in character and hex format.

Input specifies the disk to be input.

Begin starting disk address.

End ending disk address.

Rsize logical record size, or 'V' for variable, or 'U' for undefined recform.

Cisize for FBA disk only, allows logical record display.

Page 16 DISK FUNCTIONS


SEQUENTIAL DISK FILE TO PRINTER/SCREEN

The sequential disk-to-printer function allows you to display logical records in character or character and hex format. The physical blocks in the file are deblocked according to the recsize or recform specified. The starting logical record number is entered by the POSITION keyword while the number of records to list is specified by the NLRECS keyword.


$$DITTO SPR/SDP FILEIN=input(,NLRECS=nlrecs,POS=nlrecs,RECSIZE=rsize)


SPR/SDP,input,U/V/rsize,nlrecs

Where: inpu specifies the disk file to be input.

Rsize logical record size, or 'V' for variable, or 'U' for undefined recform.

VSAM DISK FILE TO PRINTER/SCREEN

The VSAM-file-to-printer functions allow you to display logical records in character or character and hex 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.


$$DITTO VDP FILEIN=input,POS=nlrecs,LOW=lowkey,HIKEY=hikey,NLRECS=nnn $$DITTO VPR FILEIN=input,POS=nlrecs,LOW=lowkey,HIKEY=hikey,NLRECS=nnn


VDP,input,nlrecs print records in character and hex format. VPR,input,nlrecs print records in character format.

Where: input specifies the file to be input.

Nlrecs specifies the maximum number of logical records to list.



LIST PRINT IMAGE DISK FILE

This function allows the printing of 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.


$$DITTO SFD/SFA FILEIN=filein


SFD/SFA filein

Where: filein is DTF/DDNAME of the input disk file.



DISK RECORD SCAN

Allows disks to be scanned for specified data. Up to 35 bytes of hex or character data can be entered along with either a fixed position in each record or zero to indicate to scan the whole record. A scan match limit is entered to terminate scanning after the specified number are found. Matching records are printed in character and hex format. For CKD disk, the physical key of each disk block can be scanned, if desired. Variable, fixed, or undefined record format is supported.


$$DITTO DRS INPUT=i,SCANPOS=p,SCANARG=a,SCANTYPE=t,SCANHITS=h


DRS,input,begin,end,type,recsize/u/v/cisize,scanarg,pos,limit

Where: input specifies the input disk.

Begin disk extent begin.

End disk extent end.

Type E scan for end of file.

K scan CKD physical block key.

D scan data

recsize/.. logical record size or 'u' for undefined, or 'v' for variable blocked, or the cisize for FBA disk.

Scanarg the scan data as either one character per byte as c'cccccc' or two hex digits per byte as x'xxxx'.

Pos the position in each record to scan (zero to scan whole record).

Limit the maximum number of matching records allowed.



DISK FUNCTIONS - INTERACTIVE MODE

DISK RECORD LOAD

Allows the data within a disk record or its key (but not its length) to be altered. The disk record is displayed for verification before being altered. The alteration data is entered in either character or hex 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 starting position in key/record, relative to one.

Bytes length of the change data.

h/c enter 'H' for data entered in hex, 'C' for data entered in character format.

Data the scan data as either one character per byte or two hex digits per byte.

WRITE EOF RECORD

This function writes end-of-file at the specified disk address.


EOF,output,addr(,cisize)

Where: output specifies the disk to be used.

Addr is the disk record address as either ccccchhRr or BBBBBBB

Cisize CI size for FBA disks.



ALTER DISK ID (VOLSER)

Allows the VOLSER (disk ID) of a disk to be changed.


DID,output,volid

Where: output specifies the output disk.

Volid the new disk volser.



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


$$DITTO CC (EOC=XX)


CC

CARD IMAGE TO PRINTER

Card images are listed in character (CP) or character and hex format (CH).


$$DITTO CP (EOC=XX) $$DITTO CH (EOC=XX)


CP invokes printing in character format. CH invokes printing in character and hex format.

Page 22 CARD FUNCTIONS


CARD IMAGE TO TAPE

Allows card image data to be copied 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.


$$DITTO CT OUTPUT=output,BLKFACTOR=blkf


CT,output,blkf


Blkf number of card images per tape block.

CARD IMAGE TO SEQUENTIAL DISK FILE

Allows card image data to be copied to disk file with reblocking if desired.


$$DITTO CSQ FILEOUT=output,BLKFACTOR=blkf


CSQ,output,blkf

Where: output defines the output disk file.

Blkf number of card images per tape block.

CARD FUNCTIONS Page 23


DRDITTO KEYWORDS AND OPERANDS ASCII=xxxxxxx

Specifies ASCII tape format. This keyword is used to specify ASCII tape processing. The assumed value "NO" specifies that neither input nor output tape are 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 bein written. Specifying "BOTH" is equivalent to entering "INPUT" and "OUTPUT".

BEGIN=xxxxxxx

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 specfied, it must be prefixed with 'R' and added to the right of the relative track or cylinder-head.

BLKFACTOR=xxxxxx

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

Specifies the CISIZE for FBA extents. If zero, non-ci format is assumed. Allows the CISIZE to be specified for FBA disk to allow logical record processing.

DATAHEADER=xxx

Allows suppression of the scale/ruler/dataheader. If 'DAT=N' is specified, the data header is supressed, thereby reducing the printed output.

END=xxxxxxx

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

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

Specifies the DLBL name of the input file. Allows the 1-7 character DLBL name to be entered so that the file can be opened for input processing.

FILEOUT=xxxxxx

Specifies the DLBL name of the output file. Allows the 1-7 character DLBL name to be entered so that the file can be opened for output processing.

Page 24 DRDITTO KEYWORDS AND OPERANDS


HEADERPG=xxxxxxx

Suppresses page headings on printed output.

HIKEY=xxxxxx

For VSAM KSDS files, specifies the ending key. 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 hexidecimal enter it as x'........'.

INPUT=xxxxxx

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

Used to limit the number of match/nomatch occurences.

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 hexidecimal enter it as x'........'.

NBLKS=nnnnnn

Specifies the number of blocks to be processed by the current function. Allows the number of physical tape or disk blocks to be limited to a desired number.

NFILES=nnnnn

Specifies the number of files to be processed by the current function. Allows the number of tape files to be limited to a desired number.

NLRECS=nnnn

Specifies number of logical records for reblocking functions. Allows the number of logical records to be limited to a desired number.

NTMKS=nnnn

Specifies the number of tapemarks to be written. Allows the number of tapemarks to be written on a tape to be specified.

OUTPUT=xxxxxx

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

Specifies password for accessing VSAM files.

DRDITTO KEYWORDS AND OPERANDS Page 25


POSITION=xxx

Specifies number of blocks/records to be skipped. The specified number of blocks or logical records is skipped before printing begins.

PRINTLEN=xxx

Specifies the width of the print output. 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

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'

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

Specifies the number of matching records to print before function termination.

SCANPOS=n

Specifies the position in each record to compare the scanarg. Zero indicates to scan the whole record.

SCANTYP=D/K/E

For disk scanning, 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. 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

Specifies the VOLSER for tape initialization or disk VOLSER alteration. (Function 'INT' or 'DID').

Page 26 DRDITTO KEYWORDS AND OPERANDS


DRDITTO 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 DRDITTO. 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.

DRDITTO MESSAGES Page 27


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' for

undefined or 'V' for 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. nnn is the VSAM return code mmm is the GET/PUT error code Action: The function is canceled.

Page 28 DRDITTO MESSAGES


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: BIM-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 BIM-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 DRDITTO. 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', 'N', 'I', 'O', or 'B' (indicating 'YES', 'NO', 'INPUT', 'OUTPUT', or

'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.

DRDITTO MESSAGES Page 29

Documents

BIM-Dr · BIM-Dr.DITTO USERS GUIDE INTRODUCTION The Dr. Ditto utility system provides basic functions needed in all mainframe computer systems: TAPE FUNCTIONS • Tape files or portions