This statement is permissible for tape editing or duplication only. It assigns the input tape or MF/MV set. Furthermore the response to errors and the user modules to be connected can be defined for error situations.
ASSIGN-INPUT-TAPE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
VOLUME = list-poss(100): <alphanum-name 1..6>
Volume serial number of the input tape.
In the case of tape duplication, this operand can be used to specify the VSN of an input MF/MV set to be processed.
LINK-NAME = PCIN / <filename 1..8 without-gen>
Internal PERCON link name used for reference in keywords.
END-POSITION =
Specifies how the tape is to be positioned after processing.
END-POSITION = *BEGIN-OF-TAPE
The tape is wound back to BOT.
END-POSITION = *END-OF-TAPE
The position of the tape is not changed after processing.
END-POSITION = *UNLOAD-TAPE
The tape is wound back and unloaded.
CODE =
Specifies the code in which the tape is written. During code conversion it should be noted that all the data (including labels) on the tape is newly encoded.
CODE = *EBCDIC
The tape is written in EBCDI code and processed without code conversion.
CODE = *ISO7
The tape is written in ISO7 code. The input data is converted to EBCDI code.
CODE = *OWN(...)
The contents of the tape are to be converted using the user’s own code conversion table located in the module library assigned via SET-TASKLIB. It contains the 256 hexadecimal encryptions (X’00’ to X’FF’) of the characters to which the input characters are to be converted.
Conversion is based on the hexadecimal value of the input character. This value is added to the start address of the conversion table; the character at the resulting position of the conversion table replaces the input character.
NAME = <name 1..8>
Name of the user module or entry point in the user module containing the code conversion table.
DEVICE-TYPE = TAPE-C4 / <device>
Device type of requested input volumes. Only device types known in the system are accepted. In interactive mode, DEVICE-TYPE=? calls up a list of the available device types.
BUFFER-LENGTH =
Maximum block length of the input tape or MF/MV set. If longer blocks occur, the action specified in the LENGTH-ERROR operand is executed.
BUFFER-LENGTH = *STD / <integer 18..32768>
For the non-privileged user.
Default value *STD: 32768 bytes
BUFFER-LENGTH = *STD / <integer 18..32768>/ *MULTIPLE-OF-2K(...)
Only for system administrators (TSOS or HSMSADM privilege required) and applications which run in the privileged processor state TPR.
Default value *STD: *MULTIPLE-OF-2K(128)
BUFFER-LENGTH = *MULTIPLE-OF-2K(...)
MULTIPLE = <1..128>
In PERCON V2.8A and higher, tape block sizes of more than 32 KB can be processed. A maximum tape block size of 256 KB is supported.
Note
PERCON recognizes that large tape blocks are to be used from the setting for the tape block size in the file control block (FCB), the task file table (TFT) or the HDR1 label.
If the der *MULTIPLE-OF-2K(...) operand is specified by non-privileged users, it is rejected with the OPEN return code DCA.
PARITY-ERROR =
Controls PERCON’s response if a block cannot be read due to a parity error, or if only a part of a block can be read.
PARITY-ERROR = *TERMINATE-ABNORMAL
The conversion step is terminated with an error.
PARITY-ERROR = *IGNORE-ERROR
The error is ignored. PERCON responds as if the block in question could be read. The block is transferred to the output file/output tape with the error.
PARITY-ERROR = *CONTINUE-NEXT-BLOCK
The errored block is transferred.
PARITY-ERROR = *DIALOG
Only for input via the terminal.
PERCON expects instructions from the terminal relating to further processing. The following responses are possible:
H: | The conversion step is terminated with an error. |
I: | The error is ignored. |
S: | The block is skipped. |
If this operand value is specified in a batch job, the entry is ignored, a warning is issued, and the default value goes into effect.
PARITY-ERROR = *MODULE(...)
NAME = <name 1..8>
Name of the user module or entry point in the user module which handles further processing (see “Interface for the recovery of read/length errors”).
LENGTH-ERROR =
Controls the response of PERCON in the event of a length error while reading a block. Length errors can occur with certain processing modalities (e.g. RECF=F and BUFFER-LENGTH small enough) if the length of the block read exceeds that specified in the BUFFER-LENGTH operand.
LENGTH-ERROR = *TERMINATE-ABNORMAL
The conversion step is terminated with an error.
LENGTH-ERROR = *IGNORE-ERROR
The error is ignored and the block in question is transferred.
LENGTH-ERROR = *CONTINUE-NEXT-BLOCK
The errored block is skipped.
LENGTH-ERROR = *DIALOG
Only for input via the terminal.
PERCON expects instructions from the terminal relating to further processing. The following responses are possible:
H: | The conversion step is terminated with an error. |
I: | The error is ignored. |
S: | The block is skipped. |
If this operand value is specified in a batch job, the specification is ignored, a warning is issued and the default value goes into effect.
LENGTH-ERROR = *MODULE(...)
NAME = <name 1..8>
Name of the user module or entry point in the user module which handles further processing (see “Interface for the recovery of read/length errors”).